# jennifer-thiery/projet-dev2 architecture

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

- Interactive diagram: https://gitdiagram.com/jennifer-thiery/projet-dev2
- Repository: https://github.com/jennifer-thiery/projet-dev2

## Overview

This is a French-language terminal application for managing a sports tournament. The main workflow starts at the TUI menu: organizers manage participants, generate level-based brackets and pools, inspect pool matches, and save or display tournament data. Participant records are persisted separately from tournament snapshots. The domain separates players, brackets, pools, and matches. The README documents only installation and launch; capabilities are inferred from the sampled source. Some edges are omitted where the excerpts do not establish a caller or data flow.

Main entry points: [`interface/tui_mvp.py`](https://github.com/jennifer-thiery/projet-dev2/blob/main/interface/tui_mvp.py) (Tournament menu), [`domain/tournament.py`](https://github.com/jennifer-thiery/projet-dev2/blob/main/domain/tournament.py) (Tournament state), [`interface/player/menu.py`](https://github.com/jennifer-thiery/projet-dev2/blob/main/interface/player/menu.py) (Participant menu), [`domain/player.py`](https://github.com/jennifer-thiery/projet-dev2/blob/main/domain/player.py) (Player eligibility)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Terminal interface"]
  node_entry["Application entry<br/>[main.py]"]
  node_mainmenu["Tournament menu<br/>[tui_mvp.py]"]
  node_playermenu["Participant menu<br/>[menu.py]"]
  node_playerforms["Participant forms<br/>[forms.py]"]
  node_playerview["Participant list<br/>[view.py]"]
  node_poolui["Pool manager<br/>[pool_manager.py]"]
  node_clearscreen["Screen utility<br/>[tools.py]"]
end

subgraph group_domain["Tournament domain"]
  node_tournament["Tournament state<br/>[tournament.py]"]
  node_player["Player eligibility<br/>[player.py]"]
  node_bracket["Bracket generation<br/>[bracket.py]"]
  node_pool["Pool scheduling<br/>[pool.py]"]
  node_match["Match model<br/>[match.py]"]
  node_enums["Tournament classifications<br/>[enums.py]"]
end

subgraph group_storage["JSON persistence"]
  node_playerstore["Player JSON access"]
  node_playersjson[("Player records<br/>[all_players.json]")]
  node_snapshotstore["Tournament snapshot access"]
  node_tournamentjson[("Tournament snapshot<br/>[tournament.json]")]
end

node_organizer(("Organizer"))

node_organizer -->|"uses"| node_mainmenu
node_entry -->|"starts"| node_mainmenu
node_mainmenu -->|"initializes"| node_tournament
node_mainmenu -->|"opens"| node_playermenu
node_mainmenu -->|"opens"| node_poolui
node_mainmenu -->|"saves and loads"| node_snapshotstore
node_mainmenu -->|"clears screen"| node_clearscreen
node_playermenu -->|"opens forms"| node_playerforms
node_playermenu -->|"shows players"| node_playerview
node_playermenu -->|"clears screen"| node_clearscreen
node_playerforms -->|"manages participants"| node_tournament
node_playerforms -->|"creates players"| node_player
node_playerview -->|"reads players"| node_tournament
node_poolui -->|"clears screen"| node_clearscreen
node_tournament -->|"loads and updates"| node_playerstore
node_playerstore -->|"reads and writes"| node_playersjson
node_snapshotstore -->|"reads and writes"| node_tournamentjson
node_tournament -->|"creates brackets"| node_bracket
node_tournament -->|"checks eligibility"| node_player
node_player -->|"classifies ranking"| node_enums
node_bracket -->|"uses match types"| node_enums
node_bracket -->|"creates pools"| node_pool
node_pool -->|"creates matches"| node_match
node_match -->|"holds players"| node_player
node_poolui -->|"displays pool data"| node_pool

click node_entry "https://github.com/jennifer-thiery/projet-dev2/blob/main/main.py"
click node_mainmenu "https://github.com/jennifer-thiery/projet-dev2/blob/main/interface/tui_mvp.py"
click node_playermenu "https://github.com/jennifer-thiery/projet-dev2/blob/main/interface/player/menu.py"
click node_playerforms "https://github.com/jennifer-thiery/projet-dev2/blob/main/interface/player/forms.py"
click node_playerview "https://github.com/jennifer-thiery/projet-dev2/blob/main/interface/player/view.py"
click node_poolui "https://github.com/jennifer-thiery/projet-dev2/blob/main/interface/pool_manager.py"
click node_clearscreen "https://github.com/jennifer-thiery/projet-dev2/blob/main/lib/tools.py"
click node_tournament "https://github.com/jennifer-thiery/projet-dev2/blob/main/domain/tournament.py"
click node_player "https://github.com/jennifer-thiery/projet-dev2/blob/main/domain/player.py"
click node_bracket "https://github.com/jennifer-thiery/projet-dev2/blob/main/domain/bracket.py"
click node_pool "https://github.com/jennifer-thiery/projet-dev2/blob/main/domain/pool.py"
click node_match "https://github.com/jennifer-thiery/projet-dev2/blob/main/domain/match.py"
click node_enums "https://github.com/jennifer-thiery/projet-dev2/blob/main/domain/enums.py"
click node_playerstore "https://github.com/jennifer-thiery/projet-dev2/blob/main/data/action_db_players.py"
click node_playersjson "https://github.com/jennifer-thiery/projet-dev2/blob/main/data/all_players.json"
click node_snapshotstore "https://github.com/jennifer-thiery/projet-dev2/blob/main/data/action_db_tounament.py"
click node_tournamentjson "https://github.com/jennifer-thiery/projet-dev2/blob/main/data/tournament.json"

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_entry,node_mainmenu,node_playermenu,node_playerforms,node_playerview,node_poolui,node_clearscreen toneBlue
class node_tournament,node_player,node_bracket,node_pool,node_match,node_enums toneAmber
class node_playerstore,node_playersjson,node_snapshotstore,node_tournamentjson toneMint
class node_organizer toneIndigo
```

## Components

### Terminal interface

- [Application entry](https://github.com/jennifer-thiery/projet-dev2/blob/main/main.py): `main.py`
- [Tournament menu](https://github.com/jennifer-thiery/projet-dev2/blob/main/interface/tui_mvp.py): `interface/tui_mvp.py`
- [Participant menu](https://github.com/jennifer-thiery/projet-dev2/blob/main/interface/player/menu.py): `interface/player/menu.py`
- [Participant forms](https://github.com/jennifer-thiery/projet-dev2/blob/main/interface/player/forms.py): `interface/player/forms.py`
- [Participant list](https://github.com/jennifer-thiery/projet-dev2/blob/main/interface/player/view.py): `interface/player/view.py`
- [Pool manager](https://github.com/jennifer-thiery/projet-dev2/blob/main/interface/pool_manager.py): `interface/pool_manager.py`
- [Screen utility](https://github.com/jennifer-thiery/projet-dev2/blob/main/lib/tools.py): `lib/tools.py`

### Tournament domain

- [Tournament state](https://github.com/jennifer-thiery/projet-dev2/blob/main/domain/tournament.py): `domain/tournament.py`
- [Player eligibility](https://github.com/jennifer-thiery/projet-dev2/blob/main/domain/player.py): `domain/player.py`
- [Bracket generation](https://github.com/jennifer-thiery/projet-dev2/blob/main/domain/bracket.py): `domain/bracket.py`
- [Pool scheduling](https://github.com/jennifer-thiery/projet-dev2/blob/main/domain/pool.py): `domain/pool.py`
- [Match model](https://github.com/jennifer-thiery/projet-dev2/blob/main/domain/match.py): `domain/match.py`
- [Tournament classifications](https://github.com/jennifer-thiery/projet-dev2/blob/main/domain/enums.py): `domain/enums.py`

### JSON persistence

- [Player JSON access](https://github.com/jennifer-thiery/projet-dev2/blob/main/data/action_db_players.py): `data/action_db_players.py`
- [Player records](https://github.com/jennifer-thiery/projet-dev2/blob/main/data/all_players.json): `data/all_players.json`
- [Tournament snapshot access](https://github.com/jennifer-thiery/projet-dev2/blob/main/data/action_db_tounament.py): `data/action_db_tounament.py`
- [Tournament snapshot](https://github.com/jennifer-thiery/projet-dev2/blob/main/data/tournament.json): `data/tournament.json`

### Other components

- **Organizer**

## Connections

- Organizer → Tournament menu: uses (evidence: `interface/tui_mvp.py`)
- Application entry → Tournament menu: starts (evidence: `main.py`)
- Tournament menu → Tournament state: initializes (evidence: `interface/tui_mvp.py`)
- Tournament menu → Participant menu: opens (evidence: `interface/tui_mvp.py`)
- Tournament menu → Pool manager: opens (evidence: `interface/tui_mvp.py`)
- Tournament menu → Tournament snapshot access: saves and loads (evidence: `interface/tui_mvp.py`)
- Tournament menu → Screen utility: clears screen (evidence: `interface/tui_mvp.py`)
- Participant menu → Participant forms: opens forms (evidence: `interface/player/menu.py`)
- Participant menu → Participant list: shows players (evidence: `interface/player/menu.py`)
- Participant menu → Screen utility: clears screen (evidence: `interface/player/menu.py`)
- Participant forms → Tournament state: manages participants (evidence: `interface/player/forms.py`)
- Participant forms → Player eligibility: creates players (evidence: `interface/player/forms.py`)
- Participant list → Tournament state: reads players (evidence: `interface/player/view.py`)
- Pool manager → Screen utility: clears screen (evidence: `interface/pool_manager.py`)
- Tournament state → Player JSON access: loads and updates (evidence: `domain/tournament.py`)
- Player JSON access → Player records: reads and writes (evidence: `data/action_db_players.py`)
- Tournament snapshot access → Tournament snapshot: reads and writes (evidence: `data/action_db_tounament.py`)
- Tournament state → Bracket generation: creates brackets (evidence: `domain/tournament.py`)
- Tournament state → Player eligibility: checks eligibility (evidence: `domain/tournament.py`)
- Player eligibility → Tournament classifications: classifies ranking (evidence: `domain/player.py`)
- Bracket generation → Tournament classifications: uses match types (evidence: `domain/bracket.py`)
- Bracket generation → Pool scheduling: creates pools (evidence: `domain/bracket.py`)
- Pool scheduling → Match model: creates matches (evidence: `domain/pool.py`)
- Match model → Player eligibility: holds players (evidence: `domain/match.py`)
- Pool manager → Pool scheduling: displays pool data (evidence: `interface/pool_manager.py`)
