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 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 agencyGET agencies/:id— chi tiết agencyPOST agencies/:id/suspend— suspend agencyPOST agencies/:id/activate— activate agency
Bạn có thể làm gì trong Agency Management?
| Hành động | Mô tả |
|---|---|
| Xem danh sách agency | Tất cả agency trên platform |
| Filter theo status | Lọc active / suspended |
| Xem agency detail | Thông tin agency, roster DJ, báo cáo |
| Suspend agency | Tạm khóa agency |
| Activate agency | Mở lại agency đã suspend |
| Trigger daily report | Chạ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 |
|---|---|
| Agency | Tên agency, logo, liên hệ |
| Status | active / suspended |
| DJ count | Số DJ thuộc agency (roster) |
| Total revenue | Tổng doanh thu DJ trong agency |
| Registered | Ngày đăng ký agency |
| Last report | Lần gửi daily report gần nhất |
| Actions | Nú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ần | Nội dung |
|---|---|
| Agency info | Tên, logo, mô tả, liên hệ, ngày đăng ký |
| Roster DJ | Danh sách DJ thuộc agency, kèm status từng DJ |
| Revenue | Tổng doanh thu agency, chia theo DJ |
| Reports | Lịch sử daily report đã gửi |
| Payout history | Lịch sử payout cho agency |
| Status log | Lị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.