TF
T-Fluencers Docs
Quay lại SRS

15. Quản lý chiến dịch / Thử thách (Event)#

Mục tiêu#

Cho phép Admin tạo, cấu hình và quản lý các chiến dịch/thử thách truyền thông.

Luồng nghiệp vụ#

  1. Admin truy cập "Quản lý chiến dịch".
  2. Tạo mới chiến dịch với thông tin:
    • Tên, mô tả, ảnh bìa
    • Thời gian bắt đầu – kết thúc
    • Loại chiến dịch (ViewBased, Other)
    • Điều kiện tham gia
    • Hashtag bắt buộc
  3. Cấu hình cơ cấu thưởng (Event Reward):
    • Loại: BY_VIEW (theo lượt xem) / BY_TASK (theo nhiệm vụ)
    • Mốc thưởng, số tiền tương ứng
    • Quy tắc tính (RewardRule — JSON)
  4. Quản lý Event Schema: Tạo các template cấu trúc cho chiến dịch.
  5. Quản lý Event Category: Phân loại chiến dịch theo danh mục.
  6. Thay đổi trạng thái: DRAFT → ACTIVE → ENDED / CANCELLED.
  7. Chặn bài đăng mới / Chặn tạo thưởng khi cần.
  8. Xem thống kêbiểu đồ chiến dịch.

API đã triển khai#

  • POST /events — Tạo chiến dịch
  • GET /events — Danh sách
  • GET /events/:id — Chi tiết
  • PUT /events/:id — Cập nhật
  • PATCH /events/:id/status — Đổi trạng thái
  • GET /events/:id/statistic — Thống kê
  • GET /events/:id/chart — Biểu đồ
  • PATCH /events/:id/block-user-submit-content — Chặn submit
  • PATCH /events/:id/block-create-reward — Chặn tạo thưởng
  • GET /events/report-statistic — Báo cáo thống kê
  • CRUD cho Event Schema, Event Category, Event Bonus

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

#Tiêu chíĐiều kiện đạt
AC-15.1Tạo chiến dịchNhập đầy đủ thông tin → tạo thành công với trạng thái DRAFT
AC-15.2Cấu hình cơ cấu thưởngTạo reward BY_VIEW hoặc BY_TASK → mốc thưởng và số tiền lưu chính xác
AC-15.3Kích hoạt chiến dịchĐổi trạng thái DRAFT → ACTIVE → Creator nhìn thấy trên Cổng Influencer
AC-15.4Kết thúc chiến dịchĐổi ACTIVE → ENDED → Creator không submit content mới được
AC-15.5Chặn submit contentBật chặn → Creator không gửi bài mới cho chiến dịch này
AC-15.6Thống kê & biểu đồTrang chi tiết hiển thị thống kê: tổng content, tổng view, biểu đồ phân bố
AC-15.7Validate thời gianThời gian kết thúc phải sau thời gian bắt đầu