TF
T-Fluencers Docs
Quay lại Wiki

Quản lý mã CBNV Techcombank#

Mục tiêu: Admin quản lý danh sách mã CBNV — codes dành cho nhân viên Techcombank (TCB) dùng để unlock thử thách onlyStaff.

Mục tiêu#

  • Tạo mã CBNV đơn lẻ.
  • Import hàng loạt từ Excel.
  • Theo dõi mã nào đã/chưa được sử dụng.

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

  • Quyền Quản lý mã CBNV.

Các khái niệm#

  • 1 mã = 1 lần sử dụng. Sau khi CBNV nhập để tham gia thử thách, mã isUsed=true.
  • Mã gắn với partner (thường Techcombank).

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

1. Xem danh sách#

  1. Vào /manage-code.
  2. Bảng hiển thị:
CộtÝ nghĩa
Mã code
PartnerTechcombank
Đã sử dụngBoolean
Người dùngCBNV đã nhập
Ngày sử dụng
Ngày tạo
Ngày cập nhật

2. Tạo mã đơn lẻ#

  1. Bấm Tạo mới.
  2. Điền:
    • Partner (bắt buộc) — chọn TCB
    • Code (bắt buộc, unique) — ví dụ: TCB_EMP_ABC123
  3. Lưu.

3. Import hàng loạt từ Excel#

  1. Bấm Import.
  2. Chọn Partner.
  3. Upload file Excel với cột code (mỗi dòng 1 mã).
  4. Submit → hệ thống tạo các records.
  5. Kết quả: số thành công / duplicate.

4. Xóa mã#

Action Delete trên row. Chỉ nên xóa mã chưa sử dụng (isUsed=false).

5. Filter danh sách#

  • isUsed — đã/chưa dùng.
  • Partner.
  • Search code.

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

CBNV sử dụng mã như thế nào?#

  1. CBNV xem thử thách onlyStaff trên Creator Portal.
  2. Bấm Tham gia → được yêu cầu nhập mã.
  3. Nhập mã → backend verify.
  4. Match + chưa used → cho phép tham gia + isUsed=true.
  5. Sai/hết → báo lỗi.

Generate mã auto#

Hiện tại phải tạo/import manual. Có thể generate random code rồi import.

Ví dụ script tạo 100 mã:

import secrets
codes = [f"TCB_{secrets.token_hex(4).upper()}" for _ in range(100)]
# Xuất ra Excel với cột "code"

Phân phối mã cho CBNV#

  • Bulk email — Finance gửi cá nhân hóa cho từng CBNV.
  • HR portal — integrate với HR system (nếu có).
  • In-person — workshops, events.

Audit#

Khi CBNV sử dụng mã, log ghi:

  • Mã gì, dùng bởi user ID nào, thời điểm, thử thách nào.

Lỗi thường gặp#

1. Tạo mã báo "đã tồn tại"#

  • Mã trùng. Chọn mã khác.

2. Import Excel fail#

  • Cột không tên code.
  • Format .xls thay vì .xlsx.
  • Mã trùng với đã có.

3. CBNV nhập đúng mã nhưng bị từ chối#

  • Mã đã được user khác dùng (isUsed=true).
  • Mã thuộc partner khác.
  • Thử thách đã đóng.

4. Mất track mã đã phát ra#

→ Export danh sách mã (filter partner, isUsed) → Excel. Lưu file để tra cứu.

5. Mã bị leaked ra ngoài Techcombank#

  • User không phải CBNV vẫn nhập được → reward sai.
  • Cách xử lý:
    • Xóa mã leaked.
    • Ban user dùng sai mã (nếu xác minh được).
    • Generate mã mới cho CBNV chưa dùng.

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

Mã có thời hạn không?

Hiện tại chưa có field expiry. Mã valid cho đến khi used hoặc deleted.

1 CBNV dùng nhiều mã được không?

Technical: được (mỗi mã 1 thử thách khác nhau). Business: nên 1 CBNV 1 mã để tracking rõ.

Có bulk revoke không?

Chưa có. Phải delete từng mã. Workaround: filter isUsed=false + delete manually.

Mã có nhiều lần dùng (multi-use)?

Không. Mã 1 lần dùng. Nếu cần multi-use, design khác (ví dụ: segment-based gating).

Partner khác TCB có dùng feature này?

Có thể, nếu partner đó có nhân viên nội bộ cần gating tương tự.

Liên kết liên quan#

Tham khảo SRS: admin-portal/14-code