# erriswheel/funbling architecture

> Architecture diagram of the GitHub repository erriswheel/funbling, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/erriswheel/funbling
- Repository: https://github.com/erriswheel/funbling

## Overview

Funbling is a browser-based gaming and virtual-currency platform. Users authenticate, enter a dashboard, play casino or multiplayer games, and manage currency, items, trades, and marketplace activity; battles, HuntBot, daily rewards, profiles, and administration are additional product areas. The backend exposes feature routes backed by controllers, Prisma persistence, and Socket.IO updates. Several feature modules are unsampled, so their nodes reflect the repository tree and documented route wiring; no unsupported internal calls are inferred.

Main entry points: [`backend/src/index.js`](https://github.com/erriswheel/funbling/blob/main/backend/src/index.js) (API and socket server), [`backend/src/prisma.js`](https://github.com/erriswheel/funbling/blob/main/backend/src/prisma.js) (Database access), [`backend/src/realtime.js`](https://github.com/erriswheel/funbling/blob/main/backend/src/realtime.js) (Realtime events), [`frontend/src/App.tsx`](https://github.com/erriswheel/funbling/blob/main/frontend/src/App.tsx) (Application routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_web["Application routes<br/>[App.tsx]"]
  node_authui["Auth context<br/>[AuthContext.tsx]"]
  node_authhook["Auth hook<br/>[useAuth.ts]"]
  node_multiplayerui["Multiplayer tables"]
  node_api["Multiplayer API<br/>[multiplayer.ts]"]
  node_socketclient["Socket client<br/>[socket.ts]"]
end

subgraph group_identity["Identity and accounts"]
  node_server["API and socket server<br/>[index.js]"]
  node_authroutes["Authentication routes<br/>[auth.js]"]
  node_authcontroller["Authentication<br/>[authController.js]"]
  node_authmw["Token middleware<br/>[auth.js]"]
  node_verify["Email verification"]
end

subgraph group_games["Games and competition"]
  node_gameui["Casino games"]
  node_multiplayercontroller["Multiplayer rooms"]
  node_baccarat["Baccarat rooms"]
  node_battle["Battles"]
  node_gamecontroller["Game play<br/>[gameController.js]"]
  node_huntbot["HuntBot"]
end

subgraph group_economy["Economy and platform"]
  node_economy["Wallet and marketplace"]
  node_dashboard["Dashboard and activity"]
  node_daily["Daily rewards<br/>[dailyController.js]"]
  node_transactions["Transactions"]
  node_admin["Administration<br/>[adminController.js]"]
  node_prisma[("Database access<br/>[prisma.js]")]
  node_realtime["Realtime events<br/>[realtime.js]"]
end

node_player(("Player"))

node_player -->|"uses"| node_web
node_web -->|"reads auth"| node_authui
node_web -->|"routes to"| node_gameui
node_web -->|"routes to"| node_multiplayerui
node_authhook -->|"reads context"| node_authui
node_authui -->|"connects and listens"| node_socketclient
node_multiplayerui -->|"calls"| node_api
node_multiplayerui -->|"uses"| node_socketclient
node_server -->|"mounts"| node_authroutes
node_authroutes -->|"routes to"| node_authcontroller
node_authroutes -->|"uses"| node_authmw
node_server -->|"mounts multiplayer routes"| node_multiplayercontroller
node_server -->|"mounts Baccarat routes"| node_baccarat
node_server -->|"mounts battle routes"| node_battle
node_server -->|"mounts game routes"| node_gamecontroller
node_server -->|"mounts HuntBot routes"| node_huntbot
node_server -->|"mounts economy routes"| node_economy
node_server -->|"mounts dashboard routes"| node_dashboard
node_server -->|"mounts daily routes"| node_daily
node_server -->|"mounts transaction routes"| node_transactions
node_server -->|"mounts verification routes"| node_verify
node_server -->|"mounts admin routes"| node_admin
node_authcontroller -->|"queries"| node_prisma
node_authcontroller -->|"invokes"| node_verify
node_authmw -->|"loads user"| node_prisma
node_multiplayercontroller -->|"reads and writes"| node_prisma
node_multiplayercontroller -->|"emits room updates"| node_realtime
node_baccarat -->|"reads and writes"| node_prisma
node_baccarat -->|"emits room updates"| node_realtime
node_battle -->|"reads and writes"| node_prisma
node_battle -->|"emits updates"| node_realtime
node_gamecontroller -->|"reads and writes"| node_prisma
node_gamecontroller -->|"emits updates"| node_realtime
node_huntbot -->|"reads and writes"| node_prisma
node_huntbot -->|"emits updates"| node_realtime
node_economy -->|"reads and writes"| node_prisma
node_economy -->|"emits updates"| node_realtime
node_dashboard -.->|"queries"| node_prisma
node_daily -.->|"queries"| node_prisma
node_transactions -.->|"queries"| node_prisma
node_admin -.->|"queries"| node_prisma
node_api -.->|"requests rooms"| node_multiplayercontroller

click node_web "https://github.com/erriswheel/funbling/blob/main/frontend/src/App.tsx"
click node_authui "https://github.com/erriswheel/funbling/blob/main/frontend/src/contexts/AuthContext.tsx"
click node_authhook "https://github.com/erriswheel/funbling/blob/main/frontend/src/hooks/useAuth.ts"
click node_multiplayerui "https://github.com/erriswheel/funbling/blob/main/frontend/src/pages/MultiplayerGame.tsx"
click node_api "https://github.com/erriswheel/funbling/blob/main/frontend/src/api/multiplayer.ts"
click node_socketclient "https://github.com/erriswheel/funbling/blob/main/frontend/src/api/socket.ts"
click node_server "https://github.com/erriswheel/funbling/blob/main/backend/src/index.js"
click node_authroutes "https://github.com/erriswheel/funbling/blob/main/backend/src/routes/auth.js"
click node_authcontroller "https://github.com/erriswheel/funbling/blob/main/backend/src/controllers/authController.js"
click node_authmw "https://github.com/erriswheel/funbling/blob/main/backend/src/middleware/auth.js"
click node_verify "https://github.com/erriswheel/funbling/blob/main/backend/src/controllers/verificationController.js"
click node_gameui "https://github.com/erriswheel/funbling/tree/main/frontend/src/pages"
click node_multiplayercontroller "https://github.com/erriswheel/funbling/blob/main/backend/src/controllers/multiplayerController.js"
click node_baccarat "https://github.com/erriswheel/funbling/blob/main/backend/src/controllers/baccaratController.js"
click node_battle "https://github.com/erriswheel/funbling/blob/main/backend/src/controllers/battleController.js"
click node_gamecontroller "https://github.com/erriswheel/funbling/blob/main/backend/src/controllers/gameController.js"
click node_huntbot "https://github.com/erriswheel/funbling/blob/main/backend/src/controllers/huntBotController.js"
click node_economy "https://github.com/erriswheel/funbling/blob/main/backend/src/controllers/economyController.js"
click node_dashboard "https://github.com/erriswheel/funbling/blob/main/backend/src/controllers/dashboardController.js"
click node_daily "https://github.com/erriswheel/funbling/blob/main/backend/src/controllers/dailyController.js"
click node_transactions "https://github.com/erriswheel/funbling/blob/main/backend/src/controllers/transactionController.js"
click node_admin "https://github.com/erriswheel/funbling/blob/main/backend/src/controllers/adminController.js"
click node_prisma "https://github.com/erriswheel/funbling/blob/main/backend/src/prisma.js"
click node_realtime "https://github.com/erriswheel/funbling/blob/main/backend/src/realtime.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_web,node_authui,node_authhook,node_multiplayerui,node_api,node_socketclient toneBlue
class node_server,node_authroutes,node_authcontroller,node_authmw,node_verify toneAmber
class node_gameui,node_multiplayercontroller,node_baccarat,node_battle,node_gamecontroller,node_huntbot toneMint
class node_economy,node_dashboard,node_daily,node_transactions,node_admin,node_prisma,node_realtime toneRose
class node_player toneIndigo
```

## Components

### Web client

- [Application routes](https://github.com/erriswheel/funbling/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Auth context](https://github.com/erriswheel/funbling/blob/main/frontend/src/contexts/AuthContext.tsx): `frontend/src/contexts/AuthContext.tsx`
- [Auth hook](https://github.com/erriswheel/funbling/blob/main/frontend/src/hooks/useAuth.ts): `frontend/src/hooks/useAuth.ts`
- [Multiplayer tables](https://github.com/erriswheel/funbling/blob/main/frontend/src/pages/MultiplayerGame.tsx): `frontend/src/pages/MultiplayerGame.tsx`
- [Multiplayer API](https://github.com/erriswheel/funbling/blob/main/frontend/src/api/multiplayer.ts): `frontend/src/api/multiplayer.ts`
- [Socket client](https://github.com/erriswheel/funbling/blob/main/frontend/src/api/socket.ts): `frontend/src/api/socket.ts`

### Identity and accounts

- [API and socket server](https://github.com/erriswheel/funbling/blob/main/backend/src/index.js): `backend/src/index.js`
- [Authentication routes](https://github.com/erriswheel/funbling/blob/main/backend/src/routes/auth.js): `backend/src/routes/auth.js`
- [Authentication](https://github.com/erriswheel/funbling/blob/main/backend/src/controllers/authController.js): `backend/src/controllers/authController.js`
- [Token middleware](https://github.com/erriswheel/funbling/blob/main/backend/src/middleware/auth.js): `backend/src/middleware/auth.js`
- [Email verification](https://github.com/erriswheel/funbling/blob/main/backend/src/controllers/verificationController.js): `backend/src/controllers/verificationController.js`

### Games and competition

- [Casino games](https://github.com/erriswheel/funbling/tree/main/frontend/src/pages): `frontend/src/pages`
- [Multiplayer rooms](https://github.com/erriswheel/funbling/blob/main/backend/src/controllers/multiplayerController.js): `backend/src/controllers/multiplayerController.js`
- [Baccarat rooms](https://github.com/erriswheel/funbling/blob/main/backend/src/controllers/baccaratController.js): `backend/src/controllers/baccaratController.js`
- [Battles](https://github.com/erriswheel/funbling/blob/main/backend/src/controllers/battleController.js): `backend/src/controllers/battleController.js`
- [Game play](https://github.com/erriswheel/funbling/blob/main/backend/src/controllers/gameController.js): `backend/src/controllers/gameController.js`
- [HuntBot](https://github.com/erriswheel/funbling/blob/main/backend/src/controllers/huntBotController.js): `backend/src/controllers/huntBotController.js`

### Economy and platform

- [Wallet and marketplace](https://github.com/erriswheel/funbling/blob/main/backend/src/controllers/economyController.js): `backend/src/controllers/economyController.js`
- [Dashboard and activity](https://github.com/erriswheel/funbling/blob/main/backend/src/controllers/dashboardController.js): `backend/src/controllers/dashboardController.js`
- [Daily rewards](https://github.com/erriswheel/funbling/blob/main/backend/src/controllers/dailyController.js): `backend/src/controllers/dailyController.js`
- [Transactions](https://github.com/erriswheel/funbling/blob/main/backend/src/controllers/transactionController.js): `backend/src/controllers/transactionController.js`
- [Administration](https://github.com/erriswheel/funbling/blob/main/backend/src/controllers/adminController.js): `backend/src/controllers/adminController.js`
- [Database access](https://github.com/erriswheel/funbling/blob/main/backend/src/prisma.js): `backend/src/prisma.js`
- [Realtime events](https://github.com/erriswheel/funbling/blob/main/backend/src/realtime.js): `backend/src/realtime.js`

### Other components

- **Player**

## Connections

- Player → Application routes: uses (evidence: `frontend/src/App.tsx`)
- Application routes → Auth context: reads auth (evidence: `frontend/src/App.tsx`)
- Application routes → Casino games: routes to (evidence: `frontend/src/App.tsx`)
- Application routes → Multiplayer tables: routes to (evidence: `frontend/src/App.tsx`)
- Auth hook → Auth context: reads context (evidence: `frontend/src/hooks/useAuth.ts`)
- Auth context → Socket client: connects and listens (evidence: `frontend/src/contexts/AuthContext.tsx`)
- Multiplayer tables → Multiplayer API: calls (evidence: `frontend/src/pages/MultiplayerGame.tsx`)
- Multiplayer tables → Socket client: uses (evidence: `frontend/src/pages/MultiplayerGame.tsx`)
- API and socket server → Authentication routes: mounts (evidence: `backend/src/index.js`)
- Authentication routes → Authentication: routes to (evidence: `backend/src/routes/auth.js`)
- Authentication routes → Token middleware: uses (evidence: `backend/src/routes/auth.js`)
- API and socket server → Multiplayer rooms: mounts multiplayer routes (evidence: `backend/src/index.js`)
- API and socket server → Baccarat rooms: mounts Baccarat routes (evidence: `backend/src/index.js`)
- API and socket server → Battles: mounts battle routes (evidence: `backend/src/index.js`)
- API and socket server → Game play: mounts game routes (evidence: `backend/src/index.js`)
- API and socket server → HuntBot: mounts HuntBot routes (evidence: `backend/src/index.js`)
- API and socket server → Wallet and marketplace: mounts economy routes (evidence: `backend/src/index.js`)
- API and socket server → Dashboard and activity: mounts dashboard routes (evidence: `backend/src/index.js`)
- API and socket server → Daily rewards: mounts daily routes (evidence: `backend/src/index.js`)
- API and socket server → Transactions: mounts transaction routes (evidence: `backend/src/index.js`)
- API and socket server → Email verification: mounts verification routes (evidence: `backend/src/index.js`)
- API and socket server → Administration: mounts admin routes (evidence: `backend/src/index.js`)
- Authentication → Database access: queries (evidence: `backend/src/controllers/authController.js`)
- Authentication → Email verification: invokes (evidence: `backend/src/controllers/authController.js`)
- Token middleware → Database access: loads user (evidence: `backend/src/middleware/auth.js`)
- Multiplayer rooms → Database access: reads and writes (evidence: `backend/src/controllers/multiplayerController.js`)
- Multiplayer rooms → Realtime events: emits room updates (evidence: `backend/src/controllers/multiplayerController.js`)
- Baccarat rooms → Database access: reads and writes (evidence: `backend/src/controllers/baccaratController.js`)
- Baccarat rooms → Realtime events: emits room updates (evidence: `backend/src/controllers/baccaratController.js`)
- Battles → Database access: reads and writes (evidence: `backend/src/controllers/battleController.js`)
- Battles → Realtime events: emits updates (evidence: `backend/src/controllers/battleController.js`)
- Game play → Database access: reads and writes (evidence: `backend/src/controllers/gameController.js`)
- Game play → Realtime events: emits updates (evidence: `backend/src/controllers/gameController.js`)
- HuntBot → Database access: reads and writes (evidence: `backend/src/controllers/huntBotController.js`)
- HuntBot → Realtime events: emits updates (evidence: `backend/src/controllers/huntBotController.js`)
- Wallet and marketplace → Database access: reads and writes (evidence: `backend/src/controllers/economyController.js`)
- Wallet and marketplace → Realtime events: emits updates (evidence: `backend/src/controllers/economyController.js`)
- Dashboard and activity → Database access: queries
- Daily rewards → Database access: queries
- Transactions → Database access: queries
- Administration → Database access: queries
- Multiplayer API → Multiplayer rooms: requests rooms
