TF
T-Fluencers Docs
Quay lại SRS

6. Quản lý hồ sơ Influencer (Profiles)#

Mục tiêu#

Cho phép Admin xem danh sách, tìm kiếm, lọc, đánh giá và xuất dữ liệu hồ sơ Influencer.

Luồng nghiệp vụ#

Danh sách Profiles:

  1. Admin truy cập trang Profiles.
  2. Lọc theo: Nền tảng (multi-select), Trạng thái (multi-select), Tier (multi-select), Engagement Tier (multi-select), Tìm kiếm theo tên/handle.
  3. Bảng hiển thị danh sách với sort đa cột, phân trang 20 dòng/trang.
  4. Click nút Export → dialog chọn format (CSV/Excel) → tạo job export → toast thông báo.
  5. Click vào Influencer → vào trang chi tiết.

Chi tiết Profile:

  1. Tab Tổng quan:
    • Hàng KPI: Followers, Video, Lượt xem, Tỷ lệ tương tác, CPV, Thanh toán
    • Thông tin hồ sơ: Avatar, tên, bio, link, nền tảng, badge trạng thái
    • Creator Score: Điểm chất lượng kèm breakdown tiêu chí
    • Demographics: Biểu đồ phân bố Tuổi / Giới tính / Địa lý
    • Sibling profiles: Các tài khoản MXH khác của cùng Creator
  2. Tab Đánh giá (Reviews):
    • Danh sách đánh giá từ staff (rating + nội dung)
    • Nút "Thêm đánh giá" → mở modal:
      • Rating 5 sao cho từng tiêu chí
      • Nội dung đánh giá (text)
      • Preset lý do từ chối
    • Submit thiếu rating hoặc nội dung → báo lỗi, không cho submit
    • Review mới xuất hiện trong danh sách

API đã triển khai#

  • GET /profiles — Danh sách Profile (hỗ trợ filter, sort, phân trang)
  • GET /profiles/:id — Chi tiết Profile
  • GET /profiles/:id/demographics — Dữ liệu nhân khẩu học
  • GET /profiles/:id/reviews — Danh sách đánh giá
  • POST /profiles/:id/reviews — Tạo đánh giá mới
  • POST /data-exports/profiles — Tạo job export Profiles

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

#Tiêu chíĐiều kiện đạt
AC-DB.6.1Danh sách ProfilesHiển thị đầy đủ thông tin, có sort/phân trang
AC-DB.6.2Lọc Profile đa điều kiệnKết hợp Nền tảng / Trạng thái / Tier (multi-select) → dữ liệu lọc đúng
AC-DB.6.3Tìm kiếm ProfileGõ từ khóa → tìm theo tên/handle, có debounce
AC-DB.6.4Export ProfileClick Export → dialog chọn CSV/Excel → tạo job, hiển thị toast
AC-DB.6.5Chi tiết Profile — Tab Tổng quanHiển thị đủ KPI, thông tin hồ sơ, score, demographics, sibling profiles
AC-DB.6.6Demographics chartBar chart Tuổi / Giới tính / Địa lý với tỷ lệ đúng
AC-DB.6.7Sibling profilesHiển thị tài khoản cùng Creator trên các nền tảng khác
AC-DB.6.8Chi tiết Profile — Tab Đánh giáHiển thị danh sách đánh giá với rating + nội dung + người đánh giá + thời gian
AC-DB.6.9Thêm đánh giáMở modal → chọn rating + nhập nội dung → submit → đánh giá mới thêm vào danh sách
AC-DB.6.10Validate đánh giáSubmit thiếu rating hoặc nội dung → báo lỗi, không cho submit