Admin Portal — Tổng quan
kioskgaming_admin là panel quản trị nội bộ cho toàn bộ nền tảng KioskGaming. Admin có quyền truy cập theo role và permission — quản lý players, giao dịch, rút tiền, ví đa tầng, super agents/agents/shops, cấu hình game providers, domains, fraud và thông báo toàn hệ thống.
Repo: kioskgaming_admin/
Vai trò trong hệ thống
Admin là tầng cao nhất — vận hành và giám sát toàn bộ platform:
Admin (internal) ──► Backend API ──► Super Agent → Agent → Shop → Player
Khác với các portal CDN (super agent, agent, shop), Admin Portal:
- Dùng permission-based access control (14 permission codes + 5 roles)
- Có React Query cho server state
- Quy mô lớn hơn (~40 routes, ~150 API methods)
Roles
| Role | Mô tả |
|---|---|
system_admin | Toàn quyền hệ thống |
super_admin | Toàn quyền + trang superAdminOnly |
platform_admin | Dashboard, players, wallets, transactions, tickets |
finance_admin | Tài chính, withdrawals, manual deposits |
support_admin | Dashboard, support tickets |
Tính năng chính (theo nhóm)
| Nhóm | Chức năng |
|---|---|
| Dashboard | Thống kê users, wallet, transactions, withdrawals, tickets |
| Payment & Withdrawals | Giao dịch thanh toán, duyệt rút tiền, flagged withdrawals, refund |
| Wallets | Game wallets, USD wallets, Credit wallets — ledger, sync, recall |
| Account management | Admins, super agents, agents, shops, cashiers, players |
| Platform config | Domains, game providers, VFX, transaction limits, provider fees |
| Support | Tickets, reply, status |
| Notifications | Global broadcasts, in-app popups (super admin) |
| Monitoring | Integration API logs (game/payment/webhooks) |
Sidebar navigation
Top-level: Dashboard, Payment transactions, Withdrawal Requests, Flagged Withdrawals, Manual Game Deposits, Support Tickets
Nhóm collapsible:
- Wallets — Game / USD / Credit wallets
- Account management — Admins, Super Agents, Agents, Shops, Cashiers, Players
- Platform configuration — Domains, VFX, Game Providers, Limits & Fraud, Provider Fees, API Logs
- Notifications — Broadcasts, In-app popups
Tài liệu trong section này
| Trang | Nội dung |
|---|---|
| Kiến trúc & Tech stack | Cấu trúc dự án, React Query, permissions, deploy |
| Routes & Permissions | Toàn bộ route, sidebar, permission matrix |
| Tích hợp API | Endpoint backend theo domain |
| Tính năng nghiệp vụ | Luồng vận hành chính |