# sharone-12/16-0-ipl-sim architecture

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

- Interactive diagram: https://gitdiagram.com/sharone-12/16-0-ipl-sim
- Repository: https://github.com/sharone-12/16-0-ipl-sim

## Overview

16-0 is a browser-based IPL fantasy drafting and season-simulation game, with franchise, multiplayer, and auction modes alongside its core solo flow. Players configure a run, draft and arrange an XI, then simulate a league and playoffs to view and share results. The README documents the leaderboard and verified-link capabilities; source excerpts also show multiplayer room/draft handoff and auction-room synchronization. Some subsystems are represented at their exact file paths but were not sampled, so their internal connections are not inferred.

Main entry points: [`simulation.js`](https://github.com/sharone-12/16-0-ipl-sim/blob/main/simulation.js) (Season Simulator), [`auction-room.js`](https://github.com/sharone-12/16-0-ipl-sim/blob/main/auction-room.js) (Live Auction Room), [`script.js`](https://github.com/sharone-12/16-0-ipl-sim/blob/main/script.js) (Game Setup), [`draft-franchise.js`](https://github.com/sharone-12/16-0-ipl-sim/blob/main/draft-franchise.js) (Franchise Draft)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_solo["Solo Game"]
  node_setup["Game Setup<br/>[script.js]"]
  node_modes["Mode Selection<br/>[modes.js]"]
  node_standard_draft["Standard Draft<br/>[draft.js]"]
  node_franchise_draft["Franchise Draft<br/>[draft-franchise.js]"]
end

subgraph group_engine["Game Engines"]
  node_franchise_data["Franchise Season Pool<br/>[franchise_data.js]"]
  node_ratings["Calibrated Ratings"]
  node_name_map["Player Name Mapping<br/>[mapped_names.csv]"]
  node_season_sim["Season Simulator<br/>[simulation.js]"]
  node_auction_data["Auction Lot Builder<br/>[auction_data.js]"]
end

subgraph group_multiplayer["Multiplayer"]
  node_mp_players(("Multiplayer Players"))
  node_lobby["Room Lobby<br/>[lobby.js]"]
  node_mp_draft["Multiplayer Draft<br/>[draft-mp.js]"]
  node_mp_sim["Multiplayer Season<br/>[sim-mp.js]"]
  node_auction_room["Live Auction Room<br/>[auction-room.js]"]
end

subgraph group_services["Results and Services"]
  node_leaderboard["Global Leaderboard<br/>[leaderboard.html]"]
  node_share_view["Shared Result Viewer<br/>[r.js]"]
  node_supabase[("Hosted Database")]
  node_report["Issue Reporting<br/>[report.js]"]
end

node_player(("Player"))

node_player -->|"configures"| node_setup
node_setup -->|"opens draft"| node_standard_draft
node_setup -->|"selects mode"| node_modes
node_modes -.->|"starts franchise draft"| node_franchise_draft
node_standard_draft -->|"passes XI"| node_season_sim
node_franchise_draft -->|"builds season pool"| node_franchise_data
node_franchise_draft -->|"hands off XI"| node_season_sim
node_season_sim -->|"loads ratings"| node_ratings
node_season_sim -->|"submits results"| node_leaderboard
node_season_sim -->|"creates share link"| node_share_view
node_leaderboard -->|"reads rankings"| node_supabase
node_share_view -->|"verifies result"| node_supabase
node_player -.->|"reports issue"| node_report
node_mp_players -->|"creates or joins room"| node_lobby
node_lobby -->|"syncs room state"| node_supabase
node_lobby -->|"routes to draft"| node_mp_draft
node_mp_draft -->|"starts season"| node_mp_sim
node_auction_room -->|"syncs auction"| node_supabase
node_auction_room -->|"derives lots"| node_auction_data
node_auction_room -->|"starts simulation"| node_mp_sim

click node_setup "https://github.com/sharone-12/16-0-ipl-sim/blob/main/script.js"
click node_modes "https://github.com/sharone-12/16-0-ipl-sim/blob/main/modes.js"
click node_standard_draft "https://github.com/sharone-12/16-0-ipl-sim/blob/main/draft.js"
click node_franchise_draft "https://github.com/sharone-12/16-0-ipl-sim/blob/main/draft-franchise.js"
click node_franchise_data "https://github.com/sharone-12/16-0-ipl-sim/blob/main/franchise_data.js"
click node_ratings "https://github.com/sharone-12/16-0-ipl-sim/blob/main/ipl_master_calibrated.csv"
click node_name_map "https://github.com/sharone-12/16-0-ipl-sim/blob/main/mapped_names.csv"
click node_season_sim "https://github.com/sharone-12/16-0-ipl-sim/blob/main/simulation.js"
click node_leaderboard "https://github.com/sharone-12/16-0-ipl-sim/blob/main/leaderboard.html"
click node_share_view "https://github.com/sharone-12/16-0-ipl-sim/blob/main/r.js"
click node_report "https://github.com/sharone-12/16-0-ipl-sim/blob/main/report.js"
click node_lobby "https://github.com/sharone-12/16-0-ipl-sim/blob/main/lobby.js"
click node_mp_draft "https://github.com/sharone-12/16-0-ipl-sim/blob/main/draft-mp.js"
click node_mp_sim "https://github.com/sharone-12/16-0-ipl-sim/blob/main/sim-mp.js"
click node_auction_data "https://github.com/sharone-12/16-0-ipl-sim/blob/main/auction_data.js"
click node_auction_room "https://github.com/sharone-12/16-0-ipl-sim/blob/main/auction-room.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_setup,node_modes,node_standard_draft,node_franchise_draft toneBlue
class node_franchise_data,node_ratings,node_name_map,node_season_sim,node_auction_data toneAmber
class node_mp_players,node_lobby,node_mp_draft,node_mp_sim,node_auction_room toneMint
class node_leaderboard,node_share_view,node_supabase,node_report toneRose
class node_player toneIndigo
```

## Components

### Solo Game

- [Game Setup](https://github.com/sharone-12/16-0-ipl-sim/blob/main/script.js): `script.js`
- [Mode Selection](https://github.com/sharone-12/16-0-ipl-sim/blob/main/modes.js): `modes.js`
- [Standard Draft](https://github.com/sharone-12/16-0-ipl-sim/blob/main/draft.js): `draft.js`
- [Franchise Draft](https://github.com/sharone-12/16-0-ipl-sim/blob/main/draft-franchise.js): `draft-franchise.js`

### Game Engines

- [Franchise Season Pool](https://github.com/sharone-12/16-0-ipl-sim/blob/main/franchise_data.js): `franchise_data.js`
- [Calibrated Ratings](https://github.com/sharone-12/16-0-ipl-sim/blob/main/ipl_master_calibrated.csv): `ipl_master_calibrated.csv`
- [Player Name Mapping](https://github.com/sharone-12/16-0-ipl-sim/blob/main/mapped_names.csv): `mapped_names.csv`
- [Season Simulator](https://github.com/sharone-12/16-0-ipl-sim/blob/main/simulation.js): `simulation.js`
- [Auction Lot Builder](https://github.com/sharone-12/16-0-ipl-sim/blob/main/auction_data.js): `auction_data.js`

### Multiplayer

- **Multiplayer Players**
- [Room Lobby](https://github.com/sharone-12/16-0-ipl-sim/blob/main/lobby.js): `lobby.js`
- [Multiplayer Draft](https://github.com/sharone-12/16-0-ipl-sim/blob/main/draft-mp.js): `draft-mp.js`
- [Multiplayer Season](https://github.com/sharone-12/16-0-ipl-sim/blob/main/sim-mp.js): `sim-mp.js`
- [Live Auction Room](https://github.com/sharone-12/16-0-ipl-sim/blob/main/auction-room.js): `auction-room.js`

### Results and Services

- [Global Leaderboard](https://github.com/sharone-12/16-0-ipl-sim/blob/main/leaderboard.html): `leaderboard.html`
- [Shared Result Viewer](https://github.com/sharone-12/16-0-ipl-sim/blob/main/r.js): `r.js`
- **Hosted Database**
- [Issue Reporting](https://github.com/sharone-12/16-0-ipl-sim/blob/main/report.js): `report.js`

### Other components

- **Player**

## Connections

- Player → Game Setup: configures (evidence: `README.md`)
- Game Setup → Standard Draft: opens draft (evidence: `README.md`)
- Game Setup → Mode Selection: selects mode (evidence: `README.md`)
- Mode Selection → Franchise Draft: starts franchise draft
- Standard Draft → Season Simulator: passes XI (evidence: `README.md`)
- Franchise Draft → Franchise Season Pool: builds season pool (evidence: `draft-franchise.js`)
- Franchise Draft → Season Simulator: hands off XI (evidence: `draft-franchise.js`)
- Season Simulator → Calibrated Ratings: loads ratings (evidence: `simulation.js`)
- Season Simulator → Global Leaderboard: submits results (evidence: `README.md`)
- Season Simulator → Shared Result Viewer: creates share link (evidence: `README.md`)
- Global Leaderboard → Hosted Database: reads rankings (evidence: `README.md`)
- Shared Result Viewer → Hosted Database: verifies result (evidence: `README.md`)
- Player → Issue Reporting: reports issue
- Multiplayer Players → Room Lobby: creates or joins room (evidence: `lobby.js`)
- Room Lobby → Hosted Database: syncs room state (evidence: `lobby.js`)
- Room Lobby → Multiplayer Draft: routes to draft (evidence: `lobby.js`)
- Multiplayer Draft → Multiplayer Season: starts season
- Live Auction Room → Hosted Database: syncs auction (evidence: `auction-room.js`)
- Live Auction Room → Auction Lot Builder: derives lots (evidence: `auction-room.js`)
- Live Auction Room → Multiplayer Season: starts simulation (evidence: `auction-room.js`)
