# kanishkiiitd/discord-gambling-bot architecture

> Architecture diagram of the GitHub repository kanishkiiitd/discord-gambling-bot, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kanishkiiitd/discord-gambling-bot
- Repository: https://github.com/kanishkiiitd/discord-gambling-bot

## Overview

Playdex is a guild-scoped gambling, economy, and collection platform with a React dashboard, Discord bot, and Express API backed by MongoDB. Users interact through either the web app or Discord; requests reach API routes that handle authentication, games, bets, user economy, Pokémon battles, and item systems, then persist domain state. The README documents additional games and collection capabilities whose individual implementations were not sampled. Edges below are limited to relationships visible in excerpts, the source index, or README; unsampled feature links are omitted.

Main entry points: [`discord-bot/index.js`](https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/discord-bot/index.js) (Command runtime), [`backend/routes/userRoutes.js`](https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/backend/routes/userRoutes.js) (User and economy API), [`backend/index.js`](https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/backend/index.js) (API server), [`frontend/src/hooks/useQueryHooks.js`](https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/frontend/src/hooks/useQueryHooks.js) (Queries and mutations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web dashboard"]
  node_app["Web application<br/>[App.js]"]
  node_webquery["Queries and mutations<br/>[useQueryHooks.js]"]
  node_webapi["API client<br/>[api.js]"]
  node_guildstate["Guild state<br/>[useGuildStore.js]"]
end

subgraph group_bot["Discord bot"]
  node_botruntime["Command runtime<br/>[index.js]"]
  node_usercommands["Economy commands<br/>[work.js]"]
  node_collectioncommands["Collection commands<br/>[pokedex.js]"]
  node_gamblecommands["Game commands<br/>[duel.js]"]
end

subgraph group_api["Backend API"]
  node_apiapp["API server<br/>[index.js]"]
  node_auth["Authentication<br/>[auth.js]"]
  node_userapi["User and economy API<br/>[userRoutes.js]"]
  node_betapi["Betting API<br/>[betRoutes.js]"]
  node_gameapi["Gambling API<br/>[gamblingRoutes.js]"]
  node_discordservice["Discord guild lookup<br/>[discordClient.js]"]
end

subgraph group_domain["Game domains"]
  node_battleapi["Pokémon battle API<br/>[battleRoutes.js]"]
  node_cs2service["CS2 case service<br/>[cs2Service.js]"]
  node_cs2data["CS2 data service<br/>[cs2DataService.js]"]
  node_pokemonapi["Pokémon data lookup<br/>[pokeApi.js]"]
end

subgraph group_data["Persistent data"]
  node_battlemodel[("Battle sessions<br/>[BattleSession.js]")]
  node_userstore[("User records<br/>[User.js]")]
  node_walletstore[("Wallet records<br/>[Wallet.js]")]
  node_betstore[("Bet records<br/>[Bet.js]")]
  node_transactions[("Transactions<br/>[Transaction.js]")]
end

node_webuser(("Dashboard user"))
node_discorduser(("Discord member"))

node_webuser -->|"uses"| node_app
node_app -->|"loads data"| node_webquery
node_webquery -->|"reads guild"| node_guildstate
node_webquery -->|"requests data"| node_webapi
node_webquery -->|"calls user endpoints"| node_userapi
node_discorduser -->|"uses commands"| node_botruntime
node_botruntime -->|"dispatches"| node_usercommands
node_botruntime -->|"dispatches"| node_collectioncommands
node_botruntime -->|"dispatches"| node_gamblecommands
node_botruntime -->|"requests profile"| node_userapi
node_botruntime -->|"plays blackjack"| node_gameapi
node_apiapp -->|"mounts routes"| node_userapi
node_apiapp -->|"mounts routes"| node_betapi
node_apiapp -->|"mounts routes"| node_gameapi
node_apiapp -->|"mounts routes"| node_battleapi
node_auth -->|"loads user"| node_userstore
node_auth -->|"checks guilds"| node_discordservice
node_userapi -->|"reads and writes"| node_userstore
node_userapi -->|"reads wallets"| node_walletstore
node_betapi -->|"manages bets"| node_betstore
node_betapi -->|"updates balance"| node_walletstore
node_betapi -->|"records activity"| node_transactions
node_gameapi -->|"updates balance"| node_walletstore
node_gameapi -->|"loads player"| node_userstore
node_battleapi -->|"persists sessions"| node_battlemodel
node_battleapi -->|"looks up Pokémon"| node_pokemonapi
node_cs2service -->|"uses data service"| node_cs2data

click node_app "https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/frontend/src/App.js"
click node_webquery "https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/frontend/src/hooks/useQueryHooks.js"
click node_webapi "https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/frontend/src/services/api.js"
click node_guildstate "https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/frontend/src/store/useGuildStore.js"
click node_botruntime "https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/discord-bot/index.js"
click node_usercommands "https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/discord-bot/commands/work.js"
click node_collectioncommands "https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/discord-bot/commands/pokedex.js"
click node_gamblecommands "https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/discord-bot/commands/duel.js"
click node_apiapp "https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/backend/index.js"
click node_auth "https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/backend/middleware/auth.js"
click node_userapi "https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/backend/routes/userRoutes.js"
click node_betapi "https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/backend/routes/betRoutes.js"
click node_gameapi "https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/backend/routes/gamblingRoutes.js"
click node_battleapi "https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/backend/routes/battleRoutes.js"
click node_cs2service "https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/backend/services/cs2Service.js"
click node_cs2data "https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/backend/services/cs2DataService.js"
click node_battlemodel "https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/backend/models/BattleSession.js"
click node_userstore "https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/backend/models/User.js"
click node_walletstore "https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/backend/models/Wallet.js"
click node_betstore "https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/backend/models/Bet.js"
click node_transactions "https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/backend/models/Transaction.js"
click node_discordservice "https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/backend/utils/discordClient.js"
click node_pokemonapi "https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/backend/utils/pokeApi.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_app,node_webquery,node_webapi,node_guildstate,node_webuser toneBlue
class node_botruntime,node_usercommands,node_collectioncommands,node_gamblecommands toneAmber
class node_apiapp,node_auth,node_userapi,node_betapi,node_gameapi,node_discordservice toneMint
class node_battleapi,node_cs2service,node_cs2data,node_pokemonapi toneRose
class node_battlemodel,node_userstore,node_walletstore,node_betstore,node_transactions,node_discorduser toneIndigo
```

## Components

### Web dashboard

- [Web application](https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/frontend/src/App.js): `frontend/src/App.js`
- [Queries and mutations](https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/frontend/src/hooks/useQueryHooks.js): `frontend/src/hooks/useQueryHooks.js`
- [API client](https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`
- [Guild state](https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/frontend/src/store/useGuildStore.js): `frontend/src/store/useGuildStore.js`

### Discord bot

- [Command runtime](https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/discord-bot/index.js): `discord-bot/index.js`
- [Economy commands](https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/discord-bot/commands/work.js): `discord-bot/commands/work.js`
- [Collection commands](https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/discord-bot/commands/pokedex.js): `discord-bot/commands/pokedex.js`
- [Game commands](https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/discord-bot/commands/duel.js): `discord-bot/commands/duel.js`

### Backend API

- [API server](https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/backend/index.js): `backend/index.js`
- [Authentication](https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/backend/middleware/auth.js): `backend/middleware/auth.js`
- [User and economy API](https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/backend/routes/userRoutes.js): `backend/routes/userRoutes.js`
- [Betting API](https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/backend/routes/betRoutes.js): `backend/routes/betRoutes.js`
- [Gambling API](https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/backend/routes/gamblingRoutes.js): `backend/routes/gamblingRoutes.js`
- [Discord guild lookup](https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/backend/utils/discordClient.js): `backend/utils/discordClient.js`

### Game domains

- [Pokémon battle API](https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/backend/routes/battleRoutes.js): `backend/routes/battleRoutes.js`
- [CS2 case service](https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/backend/services/cs2Service.js): `backend/services/cs2Service.js`
- [CS2 data service](https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/backend/services/cs2DataService.js): `backend/services/cs2DataService.js`
- [Pokémon data lookup](https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/backend/utils/pokeApi.js): `backend/utils/pokeApi.js`

### Persistent data

- [Battle sessions](https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/backend/models/BattleSession.js): `backend/models/BattleSession.js`
- [User records](https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/backend/models/User.js): `backend/models/User.js`
- [Wallet records](https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/backend/models/Wallet.js): `backend/models/Wallet.js`
- [Bet records](https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/backend/models/Bet.js): `backend/models/Bet.js`
- [Transactions](https://github.com/kanishkiiitd/discord-gambling-bot/blob/main/backend/models/Transaction.js): `backend/models/Transaction.js`

### Other components

- **Dashboard user**
- **Discord member**

## Connections

- Dashboard user → Web application: uses
- Web application → Queries and mutations: loads data (evidence: `frontend/src/App.js`)
- Queries and mutations → Guild state: reads guild (evidence: `frontend/src/hooks/useQueryHooks.js`)
- Queries and mutations → API client: requests data (evidence: `frontend/src/hooks/useQueryHooks.js`)
- Queries and mutations → User and economy API: calls user endpoints (evidence: `frontend/src/hooks/useQueryHooks.js`)
- Discord member → Command runtime: uses commands
- Command runtime → Economy commands: dispatches (evidence: `discord-bot/index.js`)
- Command runtime → Collection commands: dispatches (evidence: `discord-bot/index.js`)
- Command runtime → Game commands: dispatches (evidence: `discord-bot/index.js`)
- Command runtime → User and economy API: requests profile (evidence: `discord-bot/index.js`)
- Command runtime → Gambling API: plays blackjack (evidence: `discord-bot/index.js`)
- API server → User and economy API: mounts routes (evidence: `backend/index.js`)
- API server → Betting API: mounts routes (evidence: `backend/index.js`)
- API server → Gambling API: mounts routes (evidence: `backend/index.js`)
- API server → Pokémon battle API: mounts routes (evidence: `backend/index.js`)
- Authentication → User records: loads user (evidence: `backend/middleware/auth.js`)
- Authentication → Discord guild lookup: checks guilds (evidence: `backend/middleware/auth.js`)
- User and economy API → User records: reads and writes (evidence: `backend/routes/userRoutes.js`)
- User and economy API → Wallet records: reads wallets (evidence: `backend/routes/userRoutes.js`)
- Betting API → Bet records: manages bets (evidence: `backend/routes/betRoutes.js`)
- Betting API → Wallet records: updates balance (evidence: `backend/routes/betRoutes.js`)
- Betting API → Transactions: records activity (evidence: `backend/routes/betRoutes.js`)
- Gambling API → Wallet records: updates balance (evidence: `backend/routes/gamblingRoutes.js`)
- Gambling API → User records: loads player (evidence: `backend/routes/gamblingRoutes.js`)
- Pokémon battle API → Battle sessions: persists sessions (evidence: `backend/routes/battleRoutes.js`)
- Pokémon battle API → Pokémon data lookup: looks up Pokémon (evidence: `backend/routes/battleRoutes.js`)
- CS2 case service → CS2 data service: uses data service (evidence: `backend/services/cs2Service.js`)
