Super Agent Portal — Tổng quan

kioskgaming_superagent là ứng dụng web SPA dành cho Super Agent CDN — cấp trên của Agent trong hệ sinh thái KioskGaming. Super Agent quản lý toàn bộ cây phân cấp agents → shops → players, ví credit/USD, giao dịch, fraud và thông báo.

Repo: kioskgaming_superagent/

note

package.json đặt tên kioskgaming-agent nhưng thư mục và API prefix là Super Agent (/super-agent/*), khác với kioskgaming_agent.

---

Vai trò trong hệ thống

Admin → Super Agent → Agent → Shop → Player

Portal	Đối tượng sử dụng
Super Agent Portal	Đối tác phân phối khu vực — quản lý agents
Agent Portal	Đại lý CDN — quản lý shops
Shop Portal	Chủ shop — quản lý players

---

Hai loại ví

Ví	Mục đích
Credits wallet	Mua credit, phân phối xuống managed agents/shops
USD online balance	Mua credits hoặc rút crypto

---

Tính năng chính

Nhóm	Chức năng
Dashboard	Tổng quan, hierarchy tree, số dư, thống kê
Agents	Tạo, suspend, cost rate, game mappings, phân phối/rút credit
Shops	Danh sách toàn hệ thống, chi tiết, di chuyển shop giữa agents
Players	Danh sách, di chuyển player giữa shops
Transactions	Sổ credits, export CSV
USD wallet	Sổ USD, rút crypto, export
Provider fees	Xem phí provider (read-only)
Fraud indicators	Cờ gian lận player, resolve
Communication	Broadcast/popup (nếu có quyền delegate)
Settings	Cost rate, cảnh báo số dư, 2FA

---

Menu điều hướng

Route	Label	Mobile bottom nav
/dashboard	Overview	✅
/agents	Agents	✅
/shops	Shops	✅
/players	Players	✅
/transactions	Credit transactions
/online-transactions	USD wallet transactions
/provider-fees	Provider fees
/fraud-indicators	Fraud indicators
/popups/send	Send popup	Chỉ khi can_delegate_popups
/broadcasts/send	Send broadcast	Chỉ khi can_delegate_popups
/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, deploy
Routes & Pages	Toàn bộ route và components
Tích hợp API	Endpoint backend
Tính năng nghiệp vụ	Luồng quản lý hierarchy, credit, rút tiền

---

Liên kết tài liệu liên quan

• Agent Portal — portal tầng dưới
• System Overview