TF
T-Fluencers Docs
Quay lại Wiki

Quản lý người dùng (Influencer)#

Mục tiêu: Admin quản lý danh sách Influencer — tra cứu, ban/unban, xem thống kê, huỷ hợp đồng khi vi phạm.

Mục tiêu#

  • Tìm Influencer qua filter/search.
  • Xem chi tiết hồ sơ.
  • Ban (khóa) user khi vi phạm, kèm lý do.
  • Unban khi giải quyết.
  • Huỷ hợp đồng (TOS) khi nghiêm trọng.

Điều kiện tiên quyết#

  • Quyền Quản lý người dùng.

Các bước thực hiện#

1. Tìm user#

  1. Vào Người dùng (/user).
  2. Filter:
    • Keyword — search name, email, phone.
    • Status — Hoạt động / Đã khóa.
    • Ngày tham gia (from-to).
    • Partner (nếu AT multi-partner).

2. Xem bảng#

Cột hiển thị:

CộtÝ nghĩa
Avatar
Tên
Ngày ký TOS
Ngày tạoNgày đăng ký
Trạng tháiActive / Banned
ActionsBan/Unban, Thống kê, Hủy hợp đồng, Audit

3. Ban user#

  1. Click action Ban trên row (hoặc chi tiết).
  2. Modal yêu cầu lý do ban (bắt buộc).
  3. Submit → banned=true, status badge Đã bị khóa.
  4. User không login được, không xem/submit thử thách.

4. Unban user#

  1. Action Un-banbanned=false.
  2. User login lại bình thường.

5. Huỷ hợp đồng (Reject Contract)#

Khi vi phạm nghiêm trọng:

  1. Action Hủy hợp đồng.
  2. Nhập lý do.
  3. Submit → TOS chuyển trạng thái REJECT.
  4. User phải ký lại nếu muốn tiếp tục rút tiền.

6. Xem chi tiết user#

Click vào tên → trang detail, gồm:

  • Thông tin cá nhân — name, email, phone, avatar, tax, CCCD.
  • Hợp đồng — TOS status, confirmedAt.
  • Socials — danh sách kênh MXH đã link.
  • Thống kê — tổng bài, views, tiền.
  • Audit log — action history.

Chi tiết từng bước#

User fields#

  • name — tên hiển thị
  • email
  • phone{countryCode, number, full, verified, verifiedAt}
  • avatar
  • banned / bannedReason
  • code — mã unique của user
  • referral — mã bạn đã nhập khi đăng ký
  • contract{status, name, taxNumber, identificationNumber, confirmedAt}

Ban vs Reject Contract — khác gì?#

BanReject Contract
LoginKhông đượcĐược
Xem thử tháchKhông
Submit bàiKhôngKhông
Rút tiềnKhôngKhông (vì TOS invalid)
Mức độNặngTrung bình

Ban là giải pháp cuối, Reject Contract là bước trung gian.

Phone verified#

phone.verified = true khi user xác nhận OTP. Unverified phone có thể gây lỗi khi gửi OTP rút tiền.

Audit log#

Mọi ban/unban/reject contract đều log: actor, timestamp, reason. Xem qua action Audit.

Lỗi thường gặp#

1. Ban rồi user vẫn login#

  • Cache session. Check JWT TTL — có thể chờ vài phút.
  • Force logout: trong detail có action "Force logout all sessions".

2. Search không ra user mới#

  • Check filter đang áp dụng. Clear filter.
  • User tạo gần đây (vài phút) — backend index chưa kịp, chờ.

3. Ban không cho lý do#

  • Backend check lý do bắt buộc. Nhập text ≥ 1 ký tự.

4. Unban xong vẫn không vào được#

  • Kiểm tra đã clear flag khác (contract reject).
  • User xóa app/browser cache.

5. User khiếu nại "tôi không vi phạm sao bị ban"#

  • Xem Audit log — ai ban, lý do.
  • Nếu sai → unban và xin lỗi.

Câu hỏi thường gặp (FAQ)#

Ban có tự động khi vi phạm X bài?

Chưa có auto-ban. Admin chủ động ban.

Bao lâu sau khi ban thì xóa dữ liệu?

Không xóa. Data giữ cho audit. GDPR request xóa → quy trình riêng qua Legal.

Reject Contract xong user có refund tiền đã kiếm không?

Không rõ — tùy case. Tiền trong ví đã earned vẫn thuộc về user, nhưng không rút được vì TOS invalid. Cần ký lại TOS để unlock rút.

Ban user có ảnh hưởng bài đã duyệt?

Không. Bài đã duyệt giữ nguyên, tiền đã cộng vẫn ở ví. Chỉ block future action.

Làm sao biết user nào đã ký TOS?

Filter theo contract.status = SIGNED hoặc xem cột Ngày ký TOS — có giá trị = đã ký.

Liên kết liên quan#


Tham khảo SRS: admin-portal/05-nguoi-dung