📚 Repo Docs — Backend & 5 Client Apps

Tài liệu phân tích 6 repo cốt lõi của platform. Mỗi repo có 2 bản: Tổng quan (kiến trúc, tính năng, đánh giá) và Chi tiết kỹ thuật (code-level). Tất cả mở trong tab mới.

🔧

Backend — Core API

API trung tâm của toàn platform: xác thực đa portal, ví & giao dịch, tích hợp game provider. Node.js ≥18 · Express · PostgreSQL/Sequelize · Redis · RabbitMQ · PM2.

Tổng quan →Chi tiết kỹ thuậtSetup Guide

🛠️

Admin — Bảng điều khiển nội bộ

Nền tảng vận hành cho đội ngũ KioskGaming: quản lý người dùng, duyệt rút tiền, cấu hình provider, dashboard. React 18.3 · CRA + CRACO.

Tổng quan →Chi tiết kỹ thuật

👑

Super Agent — Cổng Siêu Đại Lý

Tầng cao nhất trong hệ thống phân phối — quản lý nhiều đại lý, phân bổ credits. React 18 · TypeScript · PWA-ready.

Tổng quan →Chi tiết kỹ thuật

🤝

Agent — Cổng Đại Lý

Nhà phân phối khu vực: quản lý mạng lưới shop, mua & phân phối credits. React 18 · TypeScript · Tailwind · @kioskgaming/ui.

Tổng quan →Chi tiết kỹ thuật

🏪

Shop — Cổng chủ cửa hàng

B2B portal cho chủ cửa hàng gaming kiosk: quản lý player, cashier & ca làm việc, nạp/rút credits. React 18 · Capacitor 7 (Android APK).

Tổng quan →Chi tiết kỹ thuật

💵

Cashier — Ứng dụng thu ngân

App Android cho thu ngân tại quầy: quản lý ca làm việc, đếm tiền mặt theo mệnh giá, giao dịch credits với player. React 18 · Capacitor.

Tổng quan →Chi tiết kỹ thuật

⚙️ Setup & Run

Tài liệu	Mô tả
Backend Setup Guide	Cài đặt Node.js, PostgreSQL, migration, cấu hình .env
Client Apps Setup	Setup & chạy 5 client app (CRA) + Kiosk Next.js

Liên quan — Hạ tầng production (server, nginx, data services): xem 🏗️ Server Architecture. Feature guides theo module: xem mục guides trong sidebar.