Shop Portal — Tổng quan
kioskgaming_shop là ứng dụng web SPA dành cho Shop CDN (Content Delivery Network) trong hệ sinh thái KioskGaming. Shop dùng portal này để quản lý player, nạp/rút credits, duyệt rút tiền, cấu hình phí provider, quản lý cashier và marketing kiosk URL.
Repo: kioskgaming_shop/
Vai trò trong hệ thống
Shop nằm ở tầng thứ tư trong phân cấp tài khoản:
Admin → Super Agent → Agent → Shop → Player
Shop Portal chỉ gọi API backend qua HTTPS. Không có giao tiếp trực tiếp giữa các frontend.
| Portal | Đối tượng sử dụng |
|---|---|
Shop Portal (kioskgaming_shop) | Chủ shop / quản lý shop CDN |
| Cashier App (riêng) | Nhân viên thu ngân tại quầy |
| Player Web | Người chơi cuối |
Đăng nhập cashier trên Shop Portal bị chặn — cashier được redirect sang Cashier App. Shop Portal chỉ quản lý tài khoản cashier (tạo, suspend, terminate, xem báo cáo).
Hai loại ví của Shop
| Ví | Tên field | Mục đích |
|---|---|---|
| Credits wallet | credit_balance | Số dư chính để cấp credits cho player |
| 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 agent đặt).
Tính năng chính
| Nhóm | Chức năng |
|---|---|
| Dashboard | Số dư credits/USD, số player, mua credits nhanh |
| Players | Danh sách, tạo player, deposit/redeem credits, ban/unban |
| Withdrawals | Duyệt/từ chối yêu cầu rút tiền của player |
| Transactions | Sổ credits (ledger), export CSV |
| Online transactions | Sổ USD wallet, rút crypto, export CSV |
| Provider fees | Bật/tắt phương thức thanh toán, xem phí gateway |
| Cashiers | Tạo/suspend/terminate cashier, xem báo cáo & shifts |
| Fraud indicators | Chỉ số gian lận cashier và player |
| Kiosk URL | Quản lý subdomain kiosk + tải poster quảng cáo |
| Communication | Gửi popup/broadcast tới player (nếu có quyền delegate) |
| Settings | Cost rate, cảnh báo số dư thấp, bật 2FA |
Menu điều hướng
Sidebar hiển thị các mục sau (mobile: bottom nav cho mục primary):
| Route | Label | Ghi chú |
|---|---|---|
/ | Dashboard | |
/withdrawals | Withdrawals | |
/transactions | Transactions | |
/online-transactions | Online transactions | |
/provider-fees | Provider fees | |
/players | Players | |
/cashiers | Cashiers | |
/fraud-indicators | Fraud indicators | |
/kiosk-domain | Kiosk URL | |
/popups/send | Send popup | Chỉ khi can_delegate_popups === true |
/broadcasts/send | Send broadcast | Chỉ khi can_delegate_popups === true |
/settings | Settings |
Quyền popup/broadcast phụ thuộc hierarchy: Super Agent delegation + agent flag + shop flag.
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à Shop gọi |
| Tính năng nghiệp vụ | Chi tiết luồng mua credits, player, rút tiền, cashier |
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ể
- Cashier Management — quản lý cashier, shift, đối soát tiền mặt
- Shop USD Wallet — Test Cases — QC ví USD shop
- Forgot Password (Super Agent / Agent / Shop)