# zubair-2121/auction-eleven architecture

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

- Interactive diagram: https://gitdiagram.com/zubair-2121/auction-eleven
- Repository: https://github.com/zubair-2121/auction-eleven

## Overview

Auction Eleven is a browser-based football squad auction game. Players create or join rooms, bid on footballers, build squads, and arrange formations; the server coordinates room and match state while the web client presents the game. The README specifically highlights manual formation swaps and synchronized player-card updates. The graph includes the indexed game, AI, player-data, guessing, and image modules. Some runtime wiring is unsampled, so uncertain connections are omitted.

Main entry points: [`apps/server/src/roomManager.ts`](https://github.com/zubair-2121/auction-eleven/blob/main/apps/server/src/roomManager.ts) (Room and auction state), [`packages/shared/src/index.ts`](https://github.com/zubair-2121/auction-eleven/blob/main/packages/shared/src/index.ts) (Shared game types), [`apps/server/src/index.ts`](https://github.com/zubair-2121/auction-eleven/blob/main/apps/server/src/index.ts) (HTTP and socket entry), [`apps/server/src/ai/simulations.ts`](https://github.com/zubair-2121/auction-eleven/blob/main/apps/server/src/ai/simulations.ts) (Bot match simulations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_web["Game interface<br/>[main.tsx]"]
end

subgraph group_server["Game server"]
  node_runtime["HTTP and socket entry<br/>[index.ts]"]
  node_rooms["Room and auction state<br/>[roomManager.ts]"]
  node_legacyrooms["Legacy room manager<br/>[roomManager.ts]"]
end

subgraph group_domain["Game domain"]
  node_shared["Shared game types<br/>[index.ts]"]
  node_rules["Auction and lineup rules<br/>[gameEngine.ts]"]
  node_legacyrules["Legacy lineup rules<br/>[gameEngine.ts]"]
  node_bots["Bot bidding strategy<br/>[botEngine.ts]"]
  node_simulations["Bot match simulations<br/>[simulations.ts]"]
  node_tournament["Bot tournaments<br/>[tournament.ts]"]
  node_blind["Blind reveal stages<br/>[blindReveal.ts]"]
  node_guessing["Player guess matching<br/>[guessing.ts]"]
end

subgraph group_support["Player data and images"]
  node_footballers["Footballer catalogue<br/>[footballers.ts]"]
  node_images["Local player images"]
  node_photos["Photo resolution<br/>[photoResolver.ts]"]
end

node_manager(("Player / manager"))
node_wikimedia["Wikimedia services"]

node_manager -.->|"plays through"| node_web
node_web -->|"uses types"| node_shared
node_runtime -->|"routes room events"| node_rooms
node_runtime -->|"serves catalogue"| node_footballers
node_runtime -->|"requests photos"| node_photos
node_runtime -->|"renders reveal"| node_blind
node_rooms -->|"uses game rules"| node_rules
node_rooms -->|"looks up players"| node_footballers
node_rooms -->|"uses guess matching"| node_guessing
node_rooms -->|"records bid behavior"| node_bots
node_rules -->|"uses definitions"| node_shared
node_bots -->|"calculates slot fit"| node_rules
node_bots -->|"uses game settings"| node_shared
node_simulations -->|"evaluates decisions"| node_bots
node_simulations -->|"builds lineups"| node_rules
node_simulations -->|"uses game settings"| node_shared
node_tournament -->|"runs simulations"| node_simulations
node_tournament -->|"uses player data"| node_footballers
node_blind -->|"uses local images"| node_images
node_guessing -->|"indexes player names"| node_footballers
node_photos -->|"resolves photos"| node_wikimedia
node_legacyrooms -->|"validates bids"| node_legacyrules
node_legacyrules -->|"uses game definitions"| node_shared

click node_web "https://github.com/zubair-2121/auction-eleven/blob/main/apps/web/src/main.tsx"
click node_shared "https://github.com/zubair-2121/auction-eleven/blob/main/packages/shared/src/index.ts"
click node_runtime "https://github.com/zubair-2121/auction-eleven/blob/main/apps/server/src/index.ts"
click node_rooms "https://github.com/zubair-2121/auction-eleven/blob/main/apps/server/src/roomManager.ts"
click node_rules "https://github.com/zubair-2121/auction-eleven/blob/main/apps/server/src/gameEngine.ts"
click node_legacyrules "https://github.com/zubair-2121/auction-eleven/blob/main/apps/server/gameEngine.ts"
click node_legacyrooms "https://github.com/zubair-2121/auction-eleven/blob/main/apps/server/roomManager.ts"
click node_bots "https://github.com/zubair-2121/auction-eleven/blob/main/apps/server/src/ai/botEngine.ts"
click node_simulations "https://github.com/zubair-2121/auction-eleven/blob/main/apps/server/src/ai/simulations.ts"
click node_tournament "https://github.com/zubair-2121/auction-eleven/blob/main/apps/server/src/ai/tournament.ts"
click node_blind "https://github.com/zubair-2121/auction-eleven/blob/main/apps/server/src/blindReveal.ts"
click node_guessing "https://github.com/zubair-2121/auction-eleven/blob/main/apps/server/src/guessing.ts"
click node_footballers "https://github.com/zubair-2121/auction-eleven/blob/main/apps/server/src/footballers.ts"
click node_images "https://github.com/zubair-2121/auction-eleven/blob/main/apps/server/src/localPlayerImages.ts"
click node_photos "https://github.com/zubair-2121/auction-eleven/blob/main/apps/server/src/photoResolver.ts"

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 toneBlue
class node_runtime,node_rooms,node_legacyrooms toneAmber
class node_shared,node_rules,node_legacyrules,node_bots,node_simulations,node_tournament,node_blind,node_guessing toneMint
class node_footballers,node_images,node_photos toneRose
class node_manager,node_wikimedia toneIndigo
```

## Components

### Web client

- [Game interface](https://github.com/zubair-2121/auction-eleven/blob/main/apps/web/src/main.tsx): `apps/web/src/main.tsx`

### Game server

- [HTTP and socket entry](https://github.com/zubair-2121/auction-eleven/blob/main/apps/server/src/index.ts): `apps/server/src/index.ts`
- [Room and auction state](https://github.com/zubair-2121/auction-eleven/blob/main/apps/server/src/roomManager.ts): `apps/server/src/roomManager.ts`
- [Legacy room manager](https://github.com/zubair-2121/auction-eleven/blob/main/apps/server/roomManager.ts): `apps/server/roomManager.ts`

### Game domain

- [Shared game types](https://github.com/zubair-2121/auction-eleven/blob/main/packages/shared/src/index.ts): `packages/shared/src/index.ts`
- [Auction and lineup rules](https://github.com/zubair-2121/auction-eleven/blob/main/apps/server/src/gameEngine.ts): `apps/server/src/gameEngine.ts`
- [Legacy lineup rules](https://github.com/zubair-2121/auction-eleven/blob/main/apps/server/gameEngine.ts): `apps/server/gameEngine.ts`
- [Bot bidding strategy](https://github.com/zubair-2121/auction-eleven/blob/main/apps/server/src/ai/botEngine.ts): `apps/server/src/ai/botEngine.ts`
- [Bot match simulations](https://github.com/zubair-2121/auction-eleven/blob/main/apps/server/src/ai/simulations.ts): `apps/server/src/ai/simulations.ts`
- [Bot tournaments](https://github.com/zubair-2121/auction-eleven/blob/main/apps/server/src/ai/tournament.ts): `apps/server/src/ai/tournament.ts`
- [Blind reveal stages](https://github.com/zubair-2121/auction-eleven/blob/main/apps/server/src/blindReveal.ts): `apps/server/src/blindReveal.ts`
- [Player guess matching](https://github.com/zubair-2121/auction-eleven/blob/main/apps/server/src/guessing.ts): `apps/server/src/guessing.ts`

### Player data and images

- [Footballer catalogue](https://github.com/zubair-2121/auction-eleven/blob/main/apps/server/src/footballers.ts): `apps/server/src/footballers.ts`
- [Local player images](https://github.com/zubair-2121/auction-eleven/blob/main/apps/server/src/localPlayerImages.ts): `apps/server/src/localPlayerImages.ts`
- [Photo resolution](https://github.com/zubair-2121/auction-eleven/blob/main/apps/server/src/photoResolver.ts): `apps/server/src/photoResolver.ts`

### Other components

- **Player / manager**
- **Wikimedia services**

## Connections

- Player / manager → Game interface: plays through
- Game interface → Shared game types: uses types (evidence: `apps/web/src/main.tsx`)
- HTTP and socket entry → Room and auction state: routes room events (evidence: `apps/server/src/index.ts`)
- HTTP and socket entry → Footballer catalogue: serves catalogue (evidence: `apps/server/src/index.ts`)
- HTTP and socket entry → Photo resolution: requests photos (evidence: `apps/server/src/index.ts`)
- HTTP and socket entry → Blind reveal stages: renders reveal (evidence: `apps/server/src/index.ts`)
- Room and auction state → Auction and lineup rules: uses game rules (evidence: `apps/server/src/roomManager.ts`)
- Room and auction state → Footballer catalogue: looks up players (evidence: `apps/server/src/roomManager.ts`)
- Room and auction state → Player guess matching: uses guess matching (evidence: `apps/server/src/roomManager.ts`)
- Room and auction state → Bot bidding strategy: records bid behavior (evidence: `apps/server/src/roomManager.ts`)
- Auction and lineup rules → Shared game types: uses definitions (evidence: `apps/server/src/gameEngine.ts`)
- Bot bidding strategy → Auction and lineup rules: calculates slot fit (evidence: `apps/server/src/ai/botEngine.ts`)
- Bot bidding strategy → Shared game types: uses game settings (evidence: `apps/server/src/ai/botEngine.ts`)
- Bot match simulations → Bot bidding strategy: evaluates decisions (evidence: `apps/server/src/ai/simulations.ts`)
- Bot match simulations → Auction and lineup rules: builds lineups (evidence: `apps/server/src/ai/simulations.ts`)
- Bot match simulations → Shared game types: uses game settings (evidence: `apps/server/src/ai/simulations.ts`)
- Bot tournaments → Bot match simulations: runs simulations (evidence: `apps/server/src/ai/tournament.ts`)
- Bot tournaments → Footballer catalogue: uses player data (evidence: `apps/server/src/ai/tournament.ts`)
- Blind reveal stages → Local player images: uses local images (evidence: `apps/server/src/blindReveal.ts`)
- Player guess matching → Footballer catalogue: indexes player names (evidence: `apps/server/src/guessing.ts`)
- Photo resolution → Wikimedia services: resolves photos (evidence: `apps/server/src/photoResolver.ts`)
- Legacy room manager → Legacy lineup rules: validates bids (evidence: `apps/server/roomManager.ts`)
- Legacy lineup rules → Shared game types: uses game definitions (evidence: `apps/server/gameEngine.ts`)
