IX. Quy tắc nghiệp vụ (Business Rules)#
1. Quy tắc hoa hồng#
| # | Quy tắc | Mô tả |
|---|---|---|
| BR-1.1 | Chỉ content APPROVED mới tính hoa hồng | Content ở trạng thái PENDING hoặc REJECTED không phát sinh hoa hồng |
| BR-1.2 | Hoa hồng theo mốc (BY_VIEW) | Mỗi mốc view (vd: 10K, 50K, 100K views) có số tiền thưởng tương ứng, cấu hình trong Event Reward |
| BR-1.3 | Hoa hồng theo nhiệm vụ (BY_TASK) | Hoàn thành nhiệm vụ (vd: đăng video, đạt engagement) → nhận hoa hồng cố định |
| BR-1.4 | Mốc thưởng tích lũy | Creator đạt mốc 50K views → nhận thưởng mốc 10K + 50K (nếu chưa nhận mốc 10K trước đó) |
| BR-1.5 | Không tính trùng | 1 video chỉ tính hoa hồng 1 lần cho mỗi mốc. Đạt mốc rồi thì không tính lại |
| BR-1.6 | Hoa hồng dự kiến vs thực nhận | Hoa hồng tính tự động = dự kiến. Chỉ trở thành thực nhận sau khi đối soát (Reconciliation) xác nhận |
| BR-1.7 | Làm tròn | Số tiền hoa hồng làm tròn xuống đến đơn vị VNĐ (không có phần thập phân) |
2. Quy tắc ngân sách (Budget)#
| # | Quy tắc | Mô tả |
|---|---|---|
| BR-2.1 | Budget cap là hard limit | Tổng hoa hồng thực nhận không được vượt budget cap của chiến dịch |
| BR-2.2 | Tính budget usage | Budget usage = (Tổng hoa hồng đã đối soát + Tổng hoa hồng dự kiến) / Budget cap × 100% |
| BR-2.3 | Ngưỡng 75% — Cảnh báo | Gửi email cảnh báo cho Admin. Không ảnh hưởng hoạt động |
| BR-2.4 | Ngưỡng 95% — Chặn submit | Tự động bật flag block-user-submit-content → Creator không gửi content mới |
| BR-2.5 | Ngưỡng 100% — Ngừng tính hoa hồng | Hệ thống không lưu hoa hồng dự kiến mới. Hoa hồng đã lưu trước đó vẫn giữ |
| BR-2.6 | Kiểm tra budget trước khi lưu hoa hồng | Mỗi lần cron tính hoa hồng → kiểm tra budget trước → nếu vượt 100% thì không lưu |
| BR-2.7 | Tần suất giám sát | Cron kiểm tra budget mỗi 30 phút |
3. Quy tắc đối soát (Reconciliation)#
| # | Quy tắc | Mô tả |
|---|---|---|
| BR-3.1 | Chỉ đối soát content APPROVED | Content PENDING hoặc REJECTED không xuất hiện trong đợt đối soát |
| BR-3.2 | Đợt đã đóng không thể mở lại | Trạng thái CLOSED là terminal, đảm bảo tính toàn vẹn tài chính |
| BR-3.3 | Cập nhật số dư khi đóng đợt | Khi CLOSED → số dư "đã đối soát" của user tăng tương ứng |
| BR-3.4 | Snapshot kiểm toán | Khi đóng đợt → tạo snapshot dữ liệu tại thời điểm đó → không thay đổi sau |
| BR-3.5 | Excel = source of truth | Dữ liệu xuất Excel phải khớp 100% với dữ liệu hiển thị trên giao diện |
4. Quy tắc thanh toán (Transfer)#
| # | Quy tắc | Mô tả |
|---|---|---|
| BR-4.1 | Chỉ thanh toán hoa hồng đã đối soát | Chỉ số dư "đã đối soát, chưa thanh toán" mới được đưa vào đợt thanh toán |
| BR-4.2 | Yêu cầu hợp đồng | Creator phải có hợp đồng đã ký (qua Service TOS) mới nhận thanh toán |
| BR-4.3 | Yêu cầu eKYC | Creator phải có eKYC APPROVED mới nhận thanh toán |
| BR-4.4 | Yêu cầu thẻ ngân hàng | Creator phải có ít nhất 1 thẻ ngân hàng đã đăng ký |
| BR-4.5 | Retry policy | Push TOS thất bại → retry mỗi 30 phút, tối đa theo cấu hình hệ thống |
| BR-4.6 | Cập nhật số dư khi hoàn tất | COMPLETED → số dư "đã thanh toán" tăng, "chưa thanh toán" giảm tương ứng |
5. Quy tắc hồ sơ social#
| # | Quy tắc | Mô tả |
|---|---|---|
| BR-5.1 | Mỗi nền tảng 1 hồ sơ APPROVED | User không có 2 hồ sơ APPROVED cho cùng 1 nền tảng |
| BR-5.2 | Hashtag xác minh quyền sở hữu | Hệ thống sinh hashtag duy nhất → user phải thêm vào profile → hệ thống verify |
| BR-5.3 | Ngưỡng followers cấu hình | Ngưỡng tối thiểu followers cấu hình qua Admin (Conditions), khác nhau theo nền tảng và chiến dịch |
| BR-5.4 | TikTok xác thực tự động | OAuth → lấy data API → verify ngay. Không cần Admin duyệt thủ công |
| BR-5.5 | YouTube xác thực bán tự động | URL + hashtag + YouTube API → verify ngay |
| BR-5.6 | FB/IG/Threads duyệt thủ công | PENDING → Admin crawl + verify → kết quả trong 1 ngày làm việc |
6. Quy tắc content#
| # | Quy tắc | Mô tả |
|---|---|---|
| BR-6.1 | Link video phải public | Video private hoặc restricted → không hợp lệ |
| BR-6.2 | Hashtag bắt buộc | Content phải chứa hashtag của chiến dịch, kiểm tra khi submit và khi crawl |
| BR-6.3 | Nền tảng phải khớp | Link TikTok chỉ submit cho hồ sơ TikTok, YouTube cho YouTube, v.v. |
| BR-6.4 | Auto reject | Content không tìm thấy trên nền tảng sau X ngày → tự động REJECTED (cron 04:30) |
| BR-6.5 | Warning tag | Content vi phạm (views bất thường, engagement giả) → gắn cờ cảnh báo tự động (cron 05:30) |
| BR-6.6 | Crawl thống kê | Content APPROVED → bắt đầu crawl views/engagement định kỳ (mỗi 4 giờ) |
Tài liệu đặc tả yêu cầu phần mềm v2.1 Ngày: 01/11/2025