TF
T-Fluencers Docs
Quay lại SRS

7. Quản lý chiến dịch (Campaigns)#

Mục tiêu#

Cho phép Admin tạo, xem, chỉnh sửa chiến dịch và quản lý Influencer tham gia thông qua thuật toán matching.

Luồng nghiệp vụ#

Danh sách Campaigns:

  1. Admin truy cập trang Campaigns.
  2. Lọc theo Trạng thái, Tìm kiếm theo từ khóa.
  3. Bảng hiển thị: Tên chiến dịch, badge trạng thái, Ngày tạo, Số Influencer đã chọn.
  4. Click nút Tạo chiến dịch → vào trang tạo mới.

Tạo/Chỉnh sửa Campaign:

  1. Form điền thông tin chiến dịch: Tên, mô tả, trạng thái, ngày bắt đầu/kết thúc, ngân sách.
  2. Bảng chọn Influencer (multi-select).
  3. Nút Save / Cancel.

Chi tiết Campaign — 3 tab:

  1. Tab Thông tin (Info): Tên, mô tả, trạng thái, ngày, ngân sách, nút Chỉnh sửa.
  2. Tab Matching:
    • Bảng kết quả matching (thuật toán ghép Influencer-Campaign)
    • Click vào dòng → modal "Chi tiết điểm matching" hiển thị breakdown điểm theo tiêu chí
    • Nút "Chạy Matching" → trigger thuật toán → kết quả cập nhật
    • Lịch sử các lần chạy
  3. Tab Influencers:
    • Danh sách Influencer đã chọn
    • Thêm/xóa Influencer
    • Hiệu suất từng Influencer trong chiến dịch (Lượt xem, Tương tác, Doanh thu)

API đã triển khai#

  • GET /campaigns — Danh sách chiến dịch
  • GET /campaigns/:id — Chi tiết chiến dịch
  • POST /campaigns — Tạo chiến dịch mới
  • PUT /campaigns/:id — Cập nhật chiến dịch
  • POST /campaigns/:id/matching — Chạy thuật toán matching
  • GET /campaigns/:id/matching-results — Kết quả matching
  • GET /campaigns/:id/influencers — Danh sách Influencer đã chọn
  • POST /campaigns/:id/influencers — Thêm Influencer
  • DELETE /campaigns/:id/influencers/:influencerId — Xóa Influencer

Tiêu chí chấp nhận#

#Tiêu chíĐiều kiện đạt
AC-DB.7.1Danh sách CampaignsHiển thị với badge trạng thái, filter/search hoạt động, phân trang đúng
AC-DB.7.2Tạo chiến dịchĐiền form → submit → chiến dịch mới xuất hiện trong danh sách
AC-DB.7.3Validate formThiếu trường bắt buộc → báo lỗi, không cho submit
AC-DB.7.4Chỉnh sửa chiến dịchLưu thay đổi → dữ liệu cập nhật, không mất dữ liệu cũ
AC-DB.7.53 tab chi tiếtChuyển Info / Matching / Influencers → nội dung tương ứng hiển thị đúng
AC-DB.7.6Modal điểm matchingClick vào dòng trong bảng matching → modal hiện chi tiết điểm theo tiêu chí
AC-DB.7.7Chạy matchingClick "Chạy Matching" → loading → kết quả cập nhật, lịch sử lưu lại
AC-DB.7.8Thêm/xóa InfluencerTab Influencers → thêm hoặc xóa → danh sách cập nhật ngay
AC-DB.7.9Hiệu suất InfluencerMỗi Influencer trong chiến dịch hiển thị số liệu hiệu suất