Quản lý đối soát hoa hồng#

Mục tiêu: Admin thực hiện đợt đối soát theo từng thử thách/mốc thời gian để chốt số tiền phí quảng cáo trả Influencer.

Mục tiêu#

Tạo đợt đối soát mới, chọn loại và phạm vi.
Duyệt/từ chối từng content (bài dự thi) trong đợt.
Override phân loại tự động khi cần.
Chuyển đợt đối soát qua các trạng thái đến Hoàn thành.

Điều kiện tiên quyết#

Có quyền Đối soát trong RBAC.
Thử thách (Event) đã kết thúc hoặc đã đến kỳ đối soát.
Dữ liệu view/engagement đã được đồng bộ.

Quy trình tổng thể#

New → Processing → Processed → Running (cộng tiền) → Completed
                                         ↓
                                      Rejected (nếu fail)

Các bước thực hiện#

1. Tạo đợt đối soát mới#

Vào menu Đối soát trong admin.
Bấm nút Tạo mới (top-right bảng).
Điền form:
- Tiêu đề (bắt buộc) — ví dụ: "Đối soát Campaign XYZ T4/2026"
- Loại (bắt buộc) — chọn 1 trong 3:
  - Event Reward — đối soát phí thưởng bài/views
  - Event Reward Statistic — đối soát theo statistic
  - Event Reward Milestone — đối soát theo mốc milestone
- Đến ngày (bắt buộc) — cutoff date cho đợt đối soát
- Đối tác (bắt buộc nếu là AT admin multi-partner)
- Event (bắt buộc) — chọn thử thách cần đối soát
Bấm Lưu. Đợt đối soát được tạo với trạng thái New (cam).

2. Mở chi tiết đợt#

Từ bảng, click icon 👁 / link để vào trang chi tiết. Chi tiết có các tab:

Nội dung — danh sách bài dự thi trong đợt
Milestone — danh sách mốc thưởng (nếu type là milestone)
Tổng quan — số tổng, thống kê

3. Đánh giá checklist#

Trước khi duyệt từng bài, hệ thống có thể chạy checklist tự động:

Bấm nút Đánh giá checklist (nếu có).
Hệ thống phân loại từng bài vào 1 trong 3 nhóm:
- Đã tự động duyệt (xanh lá) — match tất cả rule.
- Đã tự động từ chối (đỏ) — vi phạm rule cứng.
- Cần kiểm duyệt (vàng) — có điều kiện cần người review.

4. Duyệt/từ chối từng content#

Quick actions (mỗi row trong bảng Nội dung):

Duyệt nhanh — bấm icon ✓ → set status Đã duyệt (xanh dương).
Từ chối nhanh — bấm icon ✗ → chọn lý do từ chối → Đã từ chối (đỏ).
Override — ghi đè phân loại tự động. Chọn status mới + lý do.
Xác nhận trạng thái — confirm status sau review.

Các cột bảng Nội dung:

Cột	Ý nghĩa
Nội dung	Link/preview bài
Trạng thái	Pending/Approved/Completed/Rejected
Tổng lượt xem
Tổng lượt thích
Tổng lượt bình luận
Engagement
Phân loại	Auto Approved / Auto Rejected / Needs Review

5. Các trạng thái content#

Status	Màu	Ý nghĩa
Pending	Cam	Chưa duyệt
Approved	Xanh dương	Đã duyệt, chờ cộng tiền
Completed	Xanh lá	Đã cộng tiền vào ví Influencer
Rejected	Đỏ	Từ chối, không cộng tiền

6. Chuyển đợt đối soát sang Completed#

Đảm bảo tất cả content trong đợt đã xử lý (không còn Pending).
Bấm nút Change Status trên đợt → chọn Processed hoặc Running.
Running: hệ thống chạy job cộng tiền cho các content Approved.
Sau khi chạy xong → trạng thái đợt chuyển thành Completed.

Chi tiết từng bước#

Các trạng thái đợt đối soát#

Status	Màu	Ý nghĩa
New	Cam	Vừa tạo, chưa bắt đầu
Processing	Cyan	Đang xử lý
Processed	Cam	Đã xử lý, chờ cộng tiền
Running	Cyan	Job cộng tiền đang chạy
Completed	Xanh lá	Hoàn tất
Rejected	Đỏ	Bị từ chối

Filter + search trong bảng Đối soát#

Filter bar có:

Tìm kiếm — keyword
Trạng thái — filter theo status
Loại — 3 type
Đối tác (nếu AT)
Event

Override phân loại tự động#

Khi AI/checklist phân loại sai (ví dụ: auto-reject một bài hợp lệ), Admin có thể:

Mở modal Override.
Chọn status mới (Approved/Rejected).
Nhập lý do override — bắt buộc để audit trail.
Confirm.

Các lần override đều được ghi vào Audit Log.

Mốc thưởng (Milestone)#

Nếu đợt type Event Reward Milestone:

Tab Milestone hiển thị danh sách các mốc (1k views, 5k views, 10k views, ...).
Mỗi mốc có số Influencer đạt được và tiền thưởng.
Admin duyệt/từ chối theo mốc thay vì theo bài.

Lỗi thường gặp#

1. Không tạo được đợt đối soát#

Thiếu field bắt buộc (Tiêu đề, Loại, Đến ngày, Event).
Thử thách đã có đợt đối soát active — không cho tạo trùng.

2. Danh sách content trống#

Chưa đồng bộ dữ liệu từ MXH.
Cutoff date quá sớm — không có bài nào được duyệt trong khoảng.

3. Chạy Running nhưng trạng thái kẹt#

Job backend lỗi. Kiểm tra Audit Log.
Liên hệ DevOps kiểm tra queue.

4. Override không lưu#

Thiếu lý do override. Nhập reason rồi submit lại.
Không có quyền override (role thấp hơn).

5. Content bị Auto Rejected nhầm#

→ Admin Override về Approved, kèm lý do. Đồng thời báo team ML để fine-tune rule.

Câu hỏi thường gặp (FAQ)#

Một thử thách có thể có nhiều đợt đối soát không?

Có. Ví dụ: đối soát theo tuần/tháng. Mỗi đợt có cutoff date riêng.

Sau khi Completed có thể sửa không?

Không. Đợt đã completed là chốt số. Nếu có nhầm, tạo đợt đối soát bổ sung hoặc liên hệ team kỹ thuật xử lý manually.

Làm sao biết đợt đã cộng tiền đúng?

Cross-check:

Sum số Approved content × rate.
Xem balance Influencer trước/sau.
Xem Audit Log của đợt.

Checklist tự động dựa trên tiêu chí gì?

Rule cấu hình trong hệ thống — bao gồm: hashtag, độ dài caption, chất lượng video (AI phân tích), không vi phạm blacklist. Chi tiết xem SRS và rule config.

Đợt đối soát có liên quan gì đến Snapshot không?

Có. Trước khi chạy Running (cộng tiền), hệ thống thường tạo snapshot để chốt số liệu views/engagement tại thời điểm đó. Xem Snapshot đối soát.

Liên kết liên quan#

Tham khảo SRS: admin-portal/06-doi-soat