Tổng quan

App Ads Updater giúp đội ngũ Zitga xem, chỉnh sửa và theo dõi lịch sử thay đổi file app-ads.txt cho từng store — có xác thực qua Google (@zitga.com.vn), lưu lại mỗi lần thay đổi thành 1 phiên bản (version), và có thể khôi phục về bất kỳ phiên bản nào trước đó.

Phân quyền

Mỗi tài khoản được gán 1 trong 3 role:

• •Viewer — chỉ xem: Store Detail, nội dung file, Histories, diff. Không thấy nút Modify, không Restore được.
• •Operator — như Viewer, cộng thêm Modify (Save) và Restore.
• •Admin — như Operator, cộng thêm nút Quản lý người dùng trên màn Home để xem toàn bộ user và đổi role cho bất kỳ ai (kể cả cấp quyền Admin cho người khác).

Chọn Store

• 1Sau khi đăng nhập, màn Home hiện danh sách tất cả store.
• 2Click vào 1 store để vào màn Store Detail của store đó.

Xem nội dung

Màn Store Detail chia làm 2 phần:

• •Bên trái: thông tin store (số dòng, lần sửa gần nhất, người sửa gần nhất) và 2 nút Modify / Histories.
• •Bên phải: toàn bộ nội dung file app-ads.txt hiện tại, có số dòng, scroll được, và nút Copy để sao chép nhanh.
• •Cạnh tiêu đề "app-ads.txt" có nút Xem file thật (icon mũi tên đi ra) — mở file app-ads.txt thật trên domain của store ở tab mới, để đối chiếu xem nội dung đã cập nhật đúng ngoài thực tế chưa.

Chỉnh sửa (Modify)

• 1Bấm Modify từ màn Store Detail.
• 2Sửa trực tiếp trong khung soạn thảo (có số dòng bên trái), hoặc bấm Upload .txt to overwrite để chọn 1 file .txt và ghi đè toàn bộ nội dung khung soạn thảo.
• 3Dùng Undo / Redo để hoàn tác hoặc làm lại thao tác vừa sửa.
• 4Khung Changes preview bên dưới tự động tô xanh dòng thêm, đỏ dòng xóa so với bản gốc — chỉ hiện vùng thay đổi kèm vài dòng xung quanh, không hiện lại cả file.
• 5Bấm Save: hệ thống kiểm tra định dạng file trước; nếu hợp lệ sẽ hiện popup xác nhận — xác nhận xong mới thật sự ghi đè file gốc và tạo 1 version mới trong lịch sử.

Lịch sử & Restore

• •Chỉ Modify (Save) mới tạo version mới, đánh số tăng dần v1, v2, ... Dòng Save hiển thị dạng v{current lúc đó} → v{version mới}.
• •Restore không tạo version mới — chỉ đưa nội dung hiện tại về đúng 1 version cũ đã có. Dòng Restore hiển thị dạng v{current lúc đó} → v{version cũ}, và nút Restore của chính dòng đó sẽ bị tắt (không restore-vào-1-restore được).
• •Version đang thực sự nằm trên file (live) được đánh dấu badge Current — không thể bấm Restore vào chính version Current.
• •Bấm View để xem diff giữa 2 phía liên quan, dạng giống git diff.
• •Nếu 1 version từng được restore tới, dòng đó sẽ có ghi chú "Đã restore X trước".

Định dạng file app-ads.txt

Mỗi dòng (không tính dòng trống hoặc dòng bắt đầu bằng #) phải có 3 hoặc 4 trường phân tách bởi dấu phẩy: