How satyamsk05/3334game works
334Game is a real-money wheel game with player authentication, wallets, deposits and withdrawals, live round updates, and administrative management. The principal flow is player login, funding a wallet, placing bets, receiving a round result and payout, then optionally requesting a withdrawal. The tree also shows a separate Next.js admin panel. The README describes documentation rather than product behavior, and sampled backend excerpts are incomplete, so links for unsampled implementations are limited to relationships explicitly visible in the app wiring or documented by module names.
Main entry points: app.ts HTTP app · page.tsx Admin panel · RingOfFutureEngine.ts Round engine · payment.routes.ts Payment routes
Components 34
Player experience
- Game page
backend/src/routes/gamePage.ts - Deposit page
backend/src/routes/depositPage.ts - Auth routes
backend/src/modules/auth/auth.routes.ts - Auth controller
backend/src/modules/auth/auth.controller.ts - Auth service
backend/src/modules/auth/auth.service.ts
Game runtime
- Round engine
backend/src/game/RingOfFutureEngine.ts - Game client
backend/public/game/pixi-wheel.js - Game WebSocket
backend/src/websocket/GameWebSocketServer.ts - Socket server
backend/src/sockets/socket.server.ts
Wallet and payments
- Wallet routes
backend/src/modules/wallet/wallet.routes.ts - Wallet controller
backend/src/modules/wallet/wallet.controller.ts - Wallet service
backend/src/modules/wallet/wallet.service.ts - Wallet ledger
backend/src/services/WalletLedger.ts - Payment routes
backend/src/modules/payments/payment.routes.ts - Deposit controller
backend/src/modules/payments/deposit.controller.ts - Withdrawal controller
backend/src/modules/payments/withdraw.controller.ts - Payment service
backend/src/modules/payments/payment.service.ts
Administration
- Admin panel
admin-panel/src/app/page.tsx - Admin guard
admin-panel/src/components/layout/AdminGuard.tsx - Admin API client
admin-panel/src/services/api.ts - Payment views
admin-panel/src/app/payments/deposits/page.tsx - User management
admin-panel/src/app/users/page.tsx - Reports
admin-panel/src/app/reports/page.tsx - Payment service
admin-panel/src/services/paymentService.ts - User service
admin-panel/src/services/userService.ts - User routes
backend/src/modules/users/user.routes.ts - User controller
backend/src/modules/users/user.controller.ts - User service
backend/src/modules/users/user.service.ts
Backend platform
- HTTP app
backend/src/app.ts - Server bootstrap
backend/src/server.ts - Database config
backend/src/config/db.config.ts
Other components
- Player
- UPI payment
- Administrator
Connections 35
- Player → Game page: opens game
- Player → Deposit page: opens deposits
- Player → Auth routes: requests login
- HTTP app → Auth routes: mounts
- HTTP app → Wallet routes: mounts
- HTTP app → Payment routes: mounts
- HTTP app → User routes: mounts
- HTTP app → Database config: checks health
- Auth routes → Auth controller: dispatches
- Auth controller → Auth service: calls
- Auth service → Database config: persists users
- Game page → Game WebSocket: connects live
- Server bootstrap → Round engine: starts engine
- Server bootstrap → Socket server: initializes
- Round engine → Socket server: broadcasts state
- Round engine → Wallet ledger: records bets and payouts
- Wallet routes → Wallet controller: dispatches
- Wallet controller → Wallet service: calls
- Payment routes → Deposit controller: dispatches
- Payment routes → Withdrawal controller: dispatches
- Deposit controller → Payment service: calls
- Withdrawal controller → Payment service: calls
- Deposit page → UPI payment: initiates payment
- Administrator → Admin panel: uses
- Admin panel → Admin guard: guards access
- Admin panel → Payment service: uses
- Admin panel → User service: uses
- Payment service → Admin API client: requests data
- User service → Admin API client: requests data
- Admin API client → HTTP app: calls backend
- Payment service → Payment views: serves views
- User service → User management: serves views
- Admin panel → Reports: provides reports
- User routes → User controller: dispatches
- User controller → User service: calls