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
Production infrastructure: 5 Hetzner servers behind Cloudflare — system diagram, deep dive, migration plan, and target architecture. View overview →
System Diagram
One-page blueprint: Cloudflare → nginx-lb → 5 servers + nginx configuration cards.
Infrastructure Deep Dive
Layer-by-layer details, port tables, health-check playbook, 14 risks & recommendations.
Comparison & Migration Plan
Guideline vs. current state, roadmap 0A → 3C (firewall, SPOF, PgBouncer…).
Target System
Post-migration architecture: 2 gateways, before/after, failure modes, acceptance criteria.
📚 Repo Docs — Backend & 5 Client Apps
Analysis docs for 6 core repos — each with an Overview + Technical Detail. View overview →
Backend — Core API
Node.js · Express · PostgreSQL · Redis · RabbitMQ — multi-portal auth, wallet & transactions.
Overview →DetailSetupAdmin
Internal control panel: user management, withdrawal approval, provider configuration.
Overview →DetailSuper Agent
Super Agent portal — top tier of the distribution hierarchy, manages multiple agents.
Overview →DetailAgent
Agent portal — manage shop network, buy & distribute credits.
Overview →DetailShop
Shop owner portal: players, cashier & shifts, credit deposit/withdrawal.
Overview →DetailCashier
Android cashier app: shifts, cash denomination counting, credit transactions.
Overview →DetailFeature Guides
Feature documentation by 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 | Cash reconciliation when selling credits (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