📘 Về tài liệu này — SRS được tổ chức theo module. Mỗi module có trang
Tổng quan moduleriêng:
- Trang Creator — Cổng Influencer
- Trang Admin — Cổng quản trị vận hành
- Trang Thống kê — Dashboard phân tích cho Brand
- Hệ thống nền — Cron, queue, AI, webhook
- Quy tắc chung — Data model, NFR, Business Rules, State Diagrams
TÀI LIỆU ĐẶC TẢ YÊU CẦU PHẦN MỀM#
Dự án: Techcombank Influencer Platform (T-Fluencers)#
Phiên bản: 2.2
Ngày phát hành: 23/04/2026
Lịch sử thay đổi#
| Phiên bản | Ngày | Người thay đổi | Mô tả |
|---|---|---|---|
| 1.0 | — | AT Dev Team | Bản SRS gốc |
| 2.0 | 11/03/2026 | AT Dev Team | Cập nhật toàn bộ theo phạm vi đã triển khai |
| 2.1 | 12/03/2026 | AT Dev Team | Bổ sung Acceptance Criteria, NFR, State Diagram, Business Rules. Bỏ đăng nhập Facebook (Creator) và đăng nhập Google (Admin) |
| 2.2 | 23/04/2026 | AT Dev Team | Bổ sung mô tả Snapshot đối soát (Reconciliation Snapshot) — cơ chế tạo, dữ liệu ghi nhận và cách sử dụng trong quy trình đối soát |
Bảng thuật ngữ#
| Thuật ngữ | Định nghĩa |
|---|---|
| Creator / Influencer | Người dùng cuối — nhà sáng tạo nội dung tham gia chiến dịch |
| Thử thách (Event) | Một chiến dịch truyền thông mà Creator tham gia, đăng nội dung và nhận hoa hồng |
| Content | Bài tham gia của Creator (thường là video trên MXH) cho một thử thách |
| Đối soát (Reconciliation) | Quy trình kiểm tra, xác nhận hoa hồng phát sinh cho Creator |
| Snapshot đối soát (Reconciliation Snapshot) | Ảnh chụp số liệu hiệu suất content (view, like, comment, share) tại thời điểm cụ thể, dùng làm bằng chứng ghi nhận không thay đổi trong quá trình đối soát |
| Thanh toán (Transfer) | Đợt chi trả hoa hồng đã đối soát cho Creator |
| Hồ sơ social (User Social) | Tài khoản MXH đã đăng ký và xác thực trên hệ thống |
| eKYC | Xác minh danh tính điện tử bằng CCCD/CMND |
| AT-Core | Dịch vụ trung gian của AccessTrade, cung cấp dữ liệu enrichment cho influencer profile |
| Service TOS | Hệ thống cộng tác viên AccessTrade, xử lý ký hợp đồng và rút tiền |
| Budget Cap | Ngưỡng ngân sách tối đa cho một chiến dịch |
| Mốc thưởng (Milestone) | Ngưỡng hiệu suất (vd: 10.000 views) để Creator nhận hoa hồng tương ứng |
| Segment | Nhóm phân khúc Creator phục vụ lọc, gửi thông báo, quản lý chiến dịch |
| RBAC | Role-Based Access Control — phân quyền dựa trên vai trò |
Giả định & Ràng buộc#
Giả định#
- Creator có thiết bị kết nối Internet và trình duyệt web hiện đại (Chrome, Safari, Firefox phiên bản gần nhất).
- Creator đã có tài khoản MXH hợp lệ trước khi đăng ký hệ thống.
- API của các nền tảng MXH (TikTok, YouTube, Instagram, Facebook, Threads) khả dụng và ổn định.
- Dịch vụ AT-Core và Service TOS hoạt động liên tục; nếu gián đoạn, hệ thống sẽ retry theo cơ chế đã thiết kế.
- Đội vận hành AT duyệt hồ sơ social và content trong vòng 1 ngày làm việc.
Ràng buộc#
- Hệ thống chỉ hỗ trợ tiếng Việt trên Cổng Influencer và Cổng quản trị; Dashboard phân tích hỗ trợ thêm tiếng Anh.
- Thanh toán hoa hồng phải qua Service TOS (AccessTrade), không chi trả trực tiếp.
- Dữ liệu cá nhân tuân thủ Nghị định 13/2023/NĐ-CP (Việt Nam) về bảo vệ dữ liệu cá nhân.
- Hệ thống triển khai trên hạ tầng do AT quản lý (Docker, MongoDB, Redis, MinIO).
Phụ thuộc bên ngoài#
| Dịch vụ | Mục đích | Ảnh hưởng khi không khả dụng |
|---|---|---|
| TikTok OAuth API | Đăng nhập + đăng ký kênh TikTok | Creator không đăng nhập/đăng ký kênh TikTok được |
| Google OAuth API | Đăng nhập Google | Creator không đăng nhập Google được |
| YouTube Data API | Xác thực kênh YouTube | Không xác thực kênh YouTube được |
| AT-Core (influence-meter) | Enrichment profile, thông số kênh | Dữ liệu influencer profile không cập nhật; hệ thống vẫn hoạt động với dữ liệu cache |
| Service TOS (AccessTrade) | eKYC, ký hợp đồng, rút tiền | Creator không ký hợp đồng và không nhận được tiền; retry tự động mỗi 30 phút |
| Google Vertex AI | Đánh giá nội dung AI | Admin đối soát thủ công thay vì có hỗ trợ AI; không ảnh hưởng chức năng chính |
| SendGrid | Gửi email | Thông báo email không gửi được; thông báo in-app vẫn hoạt động |
| eSMS | Gửi SMS/OTP | SMS không gửi được |
| Firebase (FCM) | Push notification | Push notification không gửi được; thông báo in-app vẫn hoạt động |