Agent Portal — Tổng quan
kioskgaming_agent là ứng dụng web SPA dành cho CDN Agent (đại lý) trong hệ sinh thái KioskGaming. Agent dùng portal này để quản lý shops, players, nạp/rút credits, phân phối credit xuống shop, cấu hình game mappings và gửi broadcast/popup.
Repo: kioskgaming_agent/
Vai trò trong hệ thống
Agent nằm ở tầng thứ ba trong phân cấp tài khoản:
Admin → Super Agent → Agent → Shop → Player
| Portal | Đối tượng sử dụng |
|---|---|
Agent Portal (kioskgaming_agent) | Đại lý CDN — quản lý shops và players |
Shop Portal (kioskgaming_shop) | Chủ shop — quản lý player tại shop |
| Player Web | Người chơi cuối |
Agent Portal chỉ gọi API backend qua HTTPS. Không có giao tiếp trực tiếp giữa các frontend.
Hai loại ví của Agent
| Ví | Tên field | Mục đích |
|---|---|---|
| Credits wallet | credit_balance | Số dư chính — mua credit, phân phối xuống shop |
| USD online balance | online_balance_net | Ví USD riêng — mua credits hoặc rút crypto |
Công thức chuyển đổi: credits = USD ÷ cost_rate (cost rate do super agent/admin đặt).
Tính năng chính
| Nhóm | Chức năng |
|---|---|
| Dashboard | Số dư credits/USD, thống kê shops/players, mua credit, phân phối credit |
| Shops | Danh sách, tạo shop, suspend/unsuspend, phân phối/rút credit |
| Shop detail | Overview, security, credit/USD ledger, game mappings |
| Players | Danh sách players thuộc shops của agent, chi tiết + lịch sử |
| Transactions | Sổ credits (ledger), export CSV |
| Online transactions | Sổ USD wallet, rút crypto, export CSV |
| Provider fees | Xem bảng phí provider (read-only) |
| Fraud indicators | Cờ gian lận player, phân tích withdrawal, resolve |
| Communication | Gửi popup/broadcast tới shop/player (nếu có quyền delegate) |
| Settings | Cost rate (read-only), cảnh báo số dư thấp, bật 2FA |
Menu điều hướng
| Route | Label | Mobile bottom nav |
|---|---|---|
/ | Home | ✅ |
/shops | Shops | ✅ |
/players | Players | ✅ |
/transactions | Transactions | ✅ |
/online-transactions | Online transactions | |
/provider-fees | Provider fees | |
/fraud-indicators | Fraud indicators | |
/popups/send | Send popup | Chỉ khi can_delegate_popups === true |
/broadcasts/send | Send broadcast | Chỉ khi can_delegate_popups === true |
/settings | Settings |
Tài liệu trong section này
| Trang | Nội dung |
|---|---|
| Kiến trúc & Tech stack | Cấu trúc dự án, dependencies, state management, deploy |
| Routes & Pages | Toàn bộ route, component, luồng auth |
| Tích hợp API | Danh sách endpoint backend mà Agent gọi |
| Tính năng nghiệp vụ | Chi tiết luồng shop, credit, player, rút tiền |
Liên kết tài liệu liên quan
- System Overview — phân cấp role và kiến trúc tổng thể
- Shop Portal — portal tầng dưới agent
- Forgot Password (Super Agent / Agent / Shop)