KioskGaming Docs
Internal technical documentation for the KioskGaming system — a gaming kiosk platform consisting of a backend, admin panel, frontend, and related services.
🏗️ Server Architecture
Hạ tầng production: 5 server Hetzner sau Cloudflare — sơ đồ, deep dive, kế hoạch chuyển đổi và kiến trúc đích. Xem trang tổng hợp →
Sơ đồ hệ thống
Blueprint 1 trang: Cloudflare → nginx-lb → 5 server + card cấu hình nginx.
Deep Dive hạ tầng
Chi tiết từng tầng, bảng port, playbook health-check, 14 rủi ro & khuyến nghị.
So sánh & Kế hoạch chuyển đổi
Đối chiếu guideline với hiện trạng, lộ trình 0A → 3C (firewall, SPOF, PgBouncer…).
Hệ thống đích
Kiến trúc sau chuyển đổi: 2 gateway, trước/sau, failure modes, tiêu chí nghiệm thu.
📚 Repo Docs — Backend & 5 Client Apps
Tài liệu phân tích 6 repo cốt lõi, mỗi repo gồm bản Tổng quan + Chi tiết kỹ thuật. Xem trang tổng hợp →
Backend — Core API
Node.js · Express · PostgreSQL · Redis · RabbitMQ — xác thực đa portal, ví & giao dịch.
Tổng quan →Chi tiếtSetupAdmin
Bảng điều khiển nội bộ: quản lý user, duyệt rút tiền, cấu hình provider.
Tổng quan →Chi tiếtSuper Agent
Cổng Siêu Đại Lý — tầng cao nhất hệ phân phối, quản lý nhiều đại lý.
Tổng quan →Chi tiếtAgent
Cổng Đại Lý — quản lý mạng lưới shop, mua & phân phối credits.
Tổng quan →Chi tiếtShop
Cổng chủ cửa hàng: player, cashier & ca làm việc, nạp/rút credits.
Tổng quan →Chi tiếtCashier
App thu ngân Android: ca làm việc, đếm tiền mặt, giao dịch credits.
Tổng quan →Chi tiếtFeature Guides
Tài liệu tính năng theo module (sidebar guides):
| Module | Description |
|---|---|
| Backend | Backend code review · Database review |
| Admin | Admin portal guides |
| Super Agent | Super Agent portal guides |
| Agent | Agent portal guides |
| Shop | Shop portal guides |
| Cash Settlement | Đối soát cash khi bán credit hierarchy |
How to use this documentation
Docs are organized by feature. Each feature covers:
- Overview and purpose
- Database / API design
- Request flow
- Configuration and operations