TF
T-Fluencers Docs
Quay lại Wiki

Blacklist & Auto-approval#

Mục tiêu: Admin giảm workload bằng cách (1) chặn từ khóa cấm và (2) tự động duyệt bài đạt điều kiện rõ ràng.

Mục tiêu#

  • Quản lý Blacklist Keyword — danh sách từ cấm xuất hiện trong bài.
  • Cấu hình Auto-Approve Rule — điều kiện cho auto-approve/reject.
  • Import blacklist từ Excel.

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

  • Quyền Blacklist và Auto-approval Rule.

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

1. Quản lý Blacklist Keyword#

  1. Vào /blacklist-keyword.
  2. Bảng hiển thị các keyword đã cấu hình:
    • Keyword
    • Trạng thái (active/inactive)
    • Người tạo
    • Ngày tạo/cập nhật
  3. Thêm keyword mới:
    • Click Tạo mới.
    • Nhập keyword (ví dụ: tên ngân hàng đối thủ, từ nhạy cảm).
    • Tick Active.
    • Lưu.
  4. Edit/Delete/Toggle status qua action trên row.

2. Import blacklist từ Excel#

  1. Chuẩn bị file Excel với cột keyword (mỗi dòng 1 từ).
  2. Bấm Import → upload file.
  3. Kết quả: số keyword thành công + duplicate.

3. Cấu hình Auto-Approve Rule#

Trong trang /auto-approve-rule:

Các field:

  • minView — view tối thiểu để auto-approve.
  • minEngagement — engagement rate tối thiểu.
  • contentAge — đã đăng bao lâu (giây) mới apply rule.
  • rejectConditions — list auto-reject conditions (xem Matching Influencer).
  • message — message hiển thị.

Ví dụ:

minView: 5000
minEngagement: 0.03 (3%)
contentAge: 86400 (1 ngày)

Bài sau 1 ngày có ≥ 5000 views và engagement ≥ 3% → auto-approve.

4. Logic áp dụng#

1. Bài dự thi submit
   ↓
2. Check blacklist: contains keyword? → Auto-reject
   ↓
3. Chờ contentAge
   ↓
4. Check auto-approve conditions → Auto-approve
   ↓
5. Check auto-reject conditions → Auto-reject
   ↓
6. Nếu không match rule nào → Chờ Admin manual review

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

Match keyword — case sensitive?#

Case-insensitive. "Casino" và "casino" đều match.

Blacklist có áp cho hashtag?#

Có. Blacklist check caption + mô tả, bao gồm hashtags.

Thứ tự check#

Blacklist check trước mọi rule khác. Nếu có blacklist → reject ngay, bỏ qua auto-approve.

Auto-approve khi tắt OpsHub?#

Có thể dùng Auto-Approve Rule riêng (không cần OpsHub). Rule này áp dụng sau contentAge khi AI chưa kết luận.

Lỗi thường gặp#

1. Bài bị auto-reject nhưng không có blacklist keyword#

  • Check auto-reject conditions của thử thách.
  • Check AI verdict nếu OpsHub bật.

2. Keyword active nhưng không match#

  • Đảm bảo keyword không có khoảng trắng thừa.
  • Kiểm tra trường check (caption/hashtag/description).

3. Auto-approve nhưng bài vẫn chờ duyệt#

  • contentAge chưa đạt.
  • View/engagement dưới threshold.
  • Check cron: job auto-approve có chạy không?

4. Import file Excel fail#

  • Cột không đúng (phải là keyword).
  • Format file (phải .xlsx, không .xls).
  • Keyword trùng → skip.

5. Keyword deactivate vẫn chặn?#

→ Check cache. Backend có cache 5 phút. Chờ hoặc clear cache.

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

Blacklist áp cho toàn hệ thống hay từng thử thách?

Toàn hệ thống. Mọi bài đều check. Nếu muốn allow-list cho thử thách cụ thể, cần custom rule (Product team).

Auto-approve có nguy hiểm không?

Có nếu config lỏng. Bài chất lượng kém có thể lọt. Luôn:

  • Set contentAge đủ lớn.
  • Kết hợp với AI moderation.
  • Review định kỳ log auto-approve.

Blacklist có log khi match không?

Có. Audit log ghi keyword match, content ID, timestamp. Check để audit.

Có regex match không?

Hiện tại chỉ substring match. Không support regex. Nếu cần pattern phức tạp, báo Product.

Bài cũ chưa duyệt, thêm keyword mới vào blacklist → bài có bị reject?

Không tự động. Blacklist chỉ check khi bài submit. Admin muốn apply retroactive cần chạy script riêng.

Liên kết liên quan#

Tham khảo SRS: admin-portal/04-noi-dung