20. Đối soát hoa hồng#

Mục tiêu#

Cho phép Admin thực hiện đối soát hoa hồng cho Influencer theo chiến dịch.

Luồng nghiệp vụ#

1. Admin truy cập "Đối soát hoa hồng".
2. Xem danh sách đợt đối soát / tạo mới.
3. Khi tạo mới: chọn thử thách, loại hoa hồng, thời gian.
4. Hệ thống tổng hợp: tổng user, tổng video, tổng tiền.
5. Admin xem chi tiết:
   • Tab nội dung: Danh sách content cần đối soát
   • Tab mốc thưởng: Milestone tracking
   • Tab thưởng bổ sung: Event bonus
   • Tab tổng quan: Overview
6. Hệ thống đánh giá tự động bằng checklist:
   • Phân loại content (classification)
   • Quick approve / Quick reject
   • Override phân loại nếu cần
   • Reset checklist
7. Xuất Excel để kiểm tra thủ công.
8. Xác nhận / Hủy từng khoản.
9. Kết thúc đợt: khóa, tự động cập nhật số dư người dùng.

Cấu trúc Excel xuất#

• BY_VIEW: ID user, tên, ID video, link, view đầu kỳ/trong kỳ/cuối kỳ, mốc, số tiền, trạng thái, ghi chú
• BY_TASK: ID user, tên, số tiền, trạng thái, ghi chú

API đã triển khai#

• GET /reconciliations — Danh sách
• POST /reconciliations — Tạo mới
• GET /reconciliations/:id — Chi tiết
• GET /reconciliations/:id/content — Content items
• GET /reconciliations/:id/milestone — Milestone items
• GET /reconciliations/:id/bonus — Bonus items
• PATCH /reconciliations/:id/change-status — Đổi trạng thái
• POST /reconciliations/:id/evaluate — Đánh giá checklist
• POST /reconciliations/:id/apply-classification — Phân loại
• POST /reconciliations/:id/content/:itemId/quick-approve — Duyệt nhanh
• POST /reconciliations/:id/content/:itemId/quick-reject — Từ chối nhanh
• PATCH /reconciliations/events/:eventId/close — Kết thúc đợt

Tiêu chí chấp nhận (Acceptance Criteria)#

#	Tiêu chí	Điều kiện đạt
AC-20.1	Tạo đợt đối soát	Chọn thử thách + loại hoa hồng + thời gian → tạo thành công, hiển thị tổng user/video/tiền
AC-20.2	Xem chi tiết tabs	4 tab hiển thị đúng: Nội dung, Mốc thưởng, Thưởng bổ sung, Tổng quan
AC-20.3	Đánh giá checklist	Chạy evaluate → phân loại content tự động, hiển thị kết quả AI (nếu có)
AC-20.4	Quick approve/reject	Duyệt/Từ chối nhanh từng content item → trạng thái cập nhật ngay
AC-20.5	Xuất Excel	Nhấn xuất → tạo file Excel đúng cấu trúc (BY_VIEW hoặc BY_TASK), tải thành công
AC-20.6	Kết thúc đợt	Khóa đợt → số dư user cập nhật chính xác, không thao tác thêm được trên đợt đã khóa
AC-20.7	Tính toán chính xác	Tổng tiền đối soát = tổng các mốc thưởng đã đạt + thưởng bổ sung, khớp với Excel xuất ra

---