RESOTài liệu

Quản Lý Agency

Quản lý agency trên Reso — xem danh sách agency, lọc theo trạng thái, xem chi tiết agency, tạm dừng/kích hoạt agency, và kích hoạt công việc báo cáo hàng ngày.

Quản Lý Agency

Agency Dashboard

Agency Management là nơi admin quản lý các agency — đối tác quản lý roster DJ trên Reso. Agency có quyền riêng so với DJ thông thường: họ quản lý nhiều DJ, xem báo cáo tổng hợp, và nhận payout theo thỏa thuận riêng.

Trang Agency kéo dữ liệu từ các endpoint:

  • GET agencies — danh sách agency
  • GET agencies/:id — chi tiết agency
  • POST agencies/:id/suspend — suspend agency
  • POST agencies/:id/activate — activate agency

Bạn có thể làm gì trong Agency Management?

Hành độngMô tả
Xem danh sách agencyTất cả agency trên platform
Filter theo statusLọc active / suspended
Xem agency detailThông tin agency, roster DJ, báo cáo
Suspend agencyTạm khóa agency
Activate agencyMở lại agency đã suspend
Trigger daily reportChạy job báo cáo hằng ngày cho agency

Danh sách agency

Khi vào /admin/agency, bạn thấy danh sách tất cả agency. Mỗi row hiển thị:

TrườngÝ nghĩa
AgencyTên agency, logo, liên hệ
Statusactive / suspended
DJ countSố DJ thuộc agency (roster)
Total revenueTổng doanh thu DJ trong agency
RegisteredNgày đăng ký agency
Last reportLần gửi daily report gần nhất
ActionsNút xem detail, suspend/activate

Filter danh sách agency

  • Active: agency đang hoạt động, DJ trong agency phát stream bình thường
  • Suspended: agency bị tạm khóa, DJ trong agency không thể phát stream

Tìm theo tên agency, email liên hệ, hoặc agency ID. Hữu ích khi agency liên hệ support.

Xem Chi Tiết Agency

Click vào một agency để xem chi tiết. Endpoint GET agencies/:id trả về:

PhầnNội dung
Agency infoTên, logo, mô tả, liên hệ, ngày đăng ký
Roster DJDanh sách DJ thuộc agency, kèm status từng DJ
RevenueTổng doanh thu agency, chia theo DJ
ReportsLịch sử daily report đã gửi
Payout historyLịch sử payout cho agency
Status logLịch sử suspend/activate

Mở agency cần xem

Từ danh sách, click vào agency.

Kiểm tra roster DJ

Xem danh sách DJ thuộc agency. Đảm bảo tất cả DJ đều đã KYC approved. Nếu có DJ pending KYC, phối hợp team KYC duyệt.

Kiểm tra revenue

Xem doanh thu agency và từng DJ. Nếu anomaly (DJ trong agency doanh thu giảm đột biến), điều tra.

Kiểm tra reports

Đảm bảo daily report được gửi đều đặn. Nếu có ngày thiếu, có thể trigger lại (xem dưới).

Tạm Dừng Agency

Khi agency vi phạm chính sách hoặc có vấn đề, admin có thể suspend — tạm khóa toàn bộ agency. Endpoint: POST agencies/:id/suspend.

Mở agency cần suspend

Tìm agency từ danh sách.

Kiểm tra context

Xem agency detail, roster DJ, reports. Đảm bảo suspend là quyết định có cơ sở.

Nhấp "Tạm Dừng"

Nút "Suspend" sẽ mở dialog nhập lý do.

Nhập lý do suspend

Ghi lý do rõ ràng — ví dụ "Agency chưa submit báo cáo tài chính Q1, tạm khóa đến khi nộp". Lý do gửi cho agency và ghi audit log.

Xác Nhận suspend

Confirm. Agency status chuyển sang suspended. Tất cả DJ thuộc agency cũng không thể phát stream — suspend agency ảnh hưởng toàn roster.

Suspend agency = suspend toàn bộ DJ trong agency. Đây là action mạnh. Trước khi suspend, xem xét chỉ suspend DJ vi phạm cụ thể qua DJ Management thay vì cả agency.

Kích Hoạt Agency

Khi agency đã suspend đủ thời gian hoặc đã giải quyết vấn đề, admin có thể activate. Endpoint: POST agencies/:id/activate.

Tìm agency đã suspend

Filter status = suspended.

Mở agency detail

Click vào agency cần activate.

Đánh giá

Kiểm tra agency đã giải quyết lý do suspend chưa (nộp báo cáo, sửa vi phạm, cam kết...).

Nhấp "Kích Hoạt"

Nút "Activate" sẽ mở dialog xác nhận.

Nhập lý do activate

Ghi lý do — ví dụ "Agency đã nộp báo cáo tài chính, khôi phục hoạt động". Lý do ghi audit log.

Xác Nhận activate

Confirm. Agency status chuyển lại active. DJ trong agency có thể phát stream lại.

Trigger daily report job

Agency nhận daily report tự động mỗi ngày (doanh thu DJ, session count, v.v.). Đôi khi job bị lỗi hoặc agency cần report lại, admin có thể trigger tay.

Mở agency cần trigger

Tìm agency từ danh sách, mở detail.

Nhấp "Kích Hoạt Báo Cáo Hàng Ngày"

Nút "Trigger daily report" sẽ chạy job gửi report cho agency ngay lập tức.

Xác Nhận

Confirm. Job chạy async — report sẽ gửi qua email agency trong vài phút.

Kiểm tra delivery

Xem trong Reports history của agency để confirm report đã gửi thành công.

Mẹo: Đầu tháng, nếu agency chưa nhận report tháng trước, trigger tay thay vì đợi job tự chạy lại. Tiết kiệm thời gian support.

Workflow quản lý agency

Mở Agency Management định kỳ

Kiểm tra danh sách. Filter suspended để review agency nào có thể activate.

Kiểm tra roster DJ

Mỗi agency, đảm bảo roster DJ đều KYC approved và active. DJ pending KYC → phối hợp team KYC.

Theo dõi reports

Đảm bảo daily report gửi đều. Nếu thiếu, trigger tay.

Xử lý vi phạm agency

Agency vi phạm → suspend. Nhưng xem xét suspend DJ cụ thể trước (qua DJ Management) nếu chỉ 1-2 DJ vi phạm.

Cuối tháng — review payout

Phối hợp finance team đảm bảo payout agency đúng hạn và đúng số lượng.

Câu Hỏi Thường Gặp

Agency khác DJ thông thường ở đâu? Agency quản lý nhiều DJ (roster), nhận payout tổng, xem báo cáo tổng hợp. DJ thuộc agency vẫn phát stream bình thường, nhưng payout đi qua agency (agency chia lại cho DJ theo thỏa thuận nội bộ).

Suspend agency có ảnh hưởng wallet DJ không? Không. Wallet DJ vẫn giữ nguyên. Suspend agency chỉ khóa quyền phát stream của DJ trong roster, không ảnh hưởng tiền đã có.

Tôi có thể thêm DJ vào agency không? Hiện tại DJ join agency qua flow đăng ký trong app hoặc qua agency invite. Admin có thể reassign DJ sang agency khác qua User Management → change role, nhưng cần cẩn thận.

Sẵn sàng xem system analytics? Xem Analytics.