# gabehowell11/roster-manager architecture

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

- Interactive diagram: https://gitdiagram.com/gabehowell11/roster-manager
- Repository: https://github.com/gabehowell11/roster-manager

## Overview

Roster Manager is a Windows desktop football-roster editor. A user selects a saved team, downloads an NFL roster, or imports a CSV/JSON roster; the app saves team data locally and opens an interactive offense, defense, or special-teams view. From there, users inspect formations and backups, edit player details and ratings, and reorder depth charts. The graph follows startup and the documented user workflow, with separate import, persistence, roster-editing, and presentation responsibilities. Some subsystem links rely on documented capabilities because their implementation was not excerpted.

Main entry points: [`src/rostermanager/services/roster_service.py`](https://github.com/gabehowell11/roster-manager/blob/main/src/rostermanager/services/roster_service.py) (Roster service), [`src/rostermanager/ui/team_view.py`](https://github.com/gabehowell11/roster-manager/blob/main/src/rostermanager/ui/team_view.py) (Team view), [`src/rostermanager/models/depth_chart.py`](https://github.com/gabehowell11/roster-manager/blob/main/src/rostermanager/models/depth_chart.py) (Roster models), [`src/rostermanager/ui/field_view.py`](https://github.com/gabehowell11/roster-manager/blob/main/src/rostermanager/ui/field_view.py) (Field renderer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_entry["App startup<br/>[__main__.py]"]
end

subgraph group_roster["Roster data"]
  node_custom["Custom roster import<br/>[custom_import.py]"]
  node_nfl["NFL roster download<br/>[nflverse.py]"]
  node_models["Roster models<br/>[depth_chart.py]"]
  node_player["Player model<br/>[player.py]"]
  node_team["Team model<br/>[team.py]"]
  node_repository["Roster repository<br/>[repository.py]"]
  node_database[("Local SQLite store")]
end

subgraph group_logic["Roster logic"]
  node_service["Roster service<br/>[roster_service.py]"]
  node_editing["Depth editing<br/>[depth_editing.py]"]
  node_formations["Formation layouts<br/>[formations.py]"]
  node_fieldlayout["Depth chart layout<br/>[field_layout.py]"]
  node_listlogic["Roster list logic<br/>[roster_list.py]"]
end

subgraph group_ui["Desktop interface"]
  node_home["Team home<br/>[home_screen.py]"]
  node_teamview["Team view<br/>[team_view.py]"]
  node_field["Field renderer<br/>[field_view.py]"]
  node_cards["Player cards<br/>[player_card.py]"]
  node_editor["Player editor<br/>[player_dialog.py]"]
  node_rosterpanel["Roster list<br/>[roster_panel.py]"]
end

node_user(("User"))
node_nflsource(("NFL roster source"))
node_customfile["Roster file"]

node_user -->|"chooses team"| node_home
node_entry -->|"opens"| node_home
node_entry -->|"starts"| node_teamview
node_home -->|"requests roster actions"| node_service
node_home -->|"selects team"| node_teamview
node_user -->|"provides roster"| node_customfile
node_customfile -->|"reads CSV or JSON"| node_custom
node_service -->|"imports roster"| node_custom
node_user -->|"requests team"| node_nflsource
node_nflsource -->|"provides depth chart"| node_nfl
node_service -->|"downloads or refreshes"| node_nfl
node_service -->|"loads and saves"| node_repository
node_repository -->|"reads and writes"| node_database
node_custom -->|"creates roster"| node_models
node_nfl -->|"creates roster"| node_models
node_repository -->|"loads and saves"| node_models
node_teamview -->|"loads and edits"| node_service
node_teamview -->|"renders team"| node_field
node_teamview -->|"opens editor"| node_editor
node_teamview -->|"shows roster list"| node_rosterpanel
node_field -->|"renders players"| node_cards
node_field -->|"positions slots"| node_fieldlayout
node_field -->|"selects formation"| node_formations
node_editor -->|"saves player changes"| node_service
node_service -->|"applies depth edits"| node_editing
node_formations -->|"uses field spots"| node_fieldlayout
node_rosterpanel -->|"groups players"| node_listlogic
node_editing -->|"rebuilds roster"| node_models
node_formations -->|"selects roster players"| node_models
node_fieldlayout -->|"lays out depth chart"| node_models

click node_entry "https://github.com/gabehowell11/roster-manager/blob/main/src/rostermanager/__main__.py"
click node_home "https://github.com/gabehowell11/roster-manager/blob/main/src/rostermanager/ui/home_screen.py"
click node_teamview "https://github.com/gabehowell11/roster-manager/blob/main/src/rostermanager/ui/team_view.py"
click node_field "https://github.com/gabehowell11/roster-manager/blob/main/src/rostermanager/ui/field_view.py"
click node_cards "https://github.com/gabehowell11/roster-manager/blob/main/src/rostermanager/ui/player_card.py"
click node_editor "https://github.com/gabehowell11/roster-manager/blob/main/src/rostermanager/ui/player_dialog.py"
click node_rosterpanel "https://github.com/gabehowell11/roster-manager/blob/main/src/rostermanager/ui/roster_panel.py"
click node_custom "https://github.com/gabehowell11/roster-manager/blob/main/src/rostermanager/data/custom_import.py"
click node_nfl "https://github.com/gabehowell11/roster-manager/blob/main/src/rostermanager/data/nflverse.py"
click node_service "https://github.com/gabehowell11/roster-manager/blob/main/src/rostermanager/services/roster_service.py"
click node_editing "https://github.com/gabehowell11/roster-manager/blob/main/src/rostermanager/services/depth_editing.py"
click node_formations "https://github.com/gabehowell11/roster-manager/blob/main/src/rostermanager/services/formations.py"
click node_fieldlayout "https://github.com/gabehowell11/roster-manager/blob/main/src/rostermanager/services/field_layout.py"
click node_listlogic "https://github.com/gabehowell11/roster-manager/blob/main/src/rostermanager/services/roster_list.py"
click node_models "https://github.com/gabehowell11/roster-manager/blob/main/src/rostermanager/models/depth_chart.py"
click node_player "https://github.com/gabehowell11/roster-manager/blob/main/src/rostermanager/models/player.py"
click node_team "https://github.com/gabehowell11/roster-manager/blob/main/src/rostermanager/models/team.py"
click node_repository "https://github.com/gabehowell11/roster-manager/blob/main/src/rostermanager/data/repository.py"

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_user toneBlue
class node_custom,node_nfl,node_models,node_player,node_team,node_repository,node_database toneAmber
class node_service,node_editing,node_formations,node_fieldlayout,node_listlogic toneMint
class node_home,node_teamview,node_field,node_cards,node_editor,node_rosterpanel toneRose
class node_nflsource,node_customfile toneIndigo
```

## Components

### Application

- [App startup](https://github.com/gabehowell11/roster-manager/blob/main/src/rostermanager/__main__.py): `src/rostermanager/__main__.py`

### Roster data

- [Custom roster import](https://github.com/gabehowell11/roster-manager/blob/main/src/rostermanager/data/custom_import.py): `src/rostermanager/data/custom_import.py`
- [NFL roster download](https://github.com/gabehowell11/roster-manager/blob/main/src/rostermanager/data/nflverse.py): `src/rostermanager/data/nflverse.py`
- [Roster models](https://github.com/gabehowell11/roster-manager/blob/main/src/rostermanager/models/depth_chart.py): `src/rostermanager/models/depth_chart.py`
- [Player model](https://github.com/gabehowell11/roster-manager/blob/main/src/rostermanager/models/player.py): `src/rostermanager/models/player.py`
- [Team model](https://github.com/gabehowell11/roster-manager/blob/main/src/rostermanager/models/team.py): `src/rostermanager/models/team.py`
- [Roster repository](https://github.com/gabehowell11/roster-manager/blob/main/src/rostermanager/data/repository.py): `src/rostermanager/data/repository.py`
- **Local SQLite store**

### Roster logic

- [Roster service](https://github.com/gabehowell11/roster-manager/blob/main/src/rostermanager/services/roster_service.py): `src/rostermanager/services/roster_service.py`
- [Depth editing](https://github.com/gabehowell11/roster-manager/blob/main/src/rostermanager/services/depth_editing.py): `src/rostermanager/services/depth_editing.py`
- [Formation layouts](https://github.com/gabehowell11/roster-manager/blob/main/src/rostermanager/services/formations.py): `src/rostermanager/services/formations.py`
- [Depth chart layout](https://github.com/gabehowell11/roster-manager/blob/main/src/rostermanager/services/field_layout.py): `src/rostermanager/services/field_layout.py`
- [Roster list logic](https://github.com/gabehowell11/roster-manager/blob/main/src/rostermanager/services/roster_list.py): `src/rostermanager/services/roster_list.py`

### Desktop interface

- [Team home](https://github.com/gabehowell11/roster-manager/blob/main/src/rostermanager/ui/home_screen.py): `src/rostermanager/ui/home_screen.py`
- [Team view](https://github.com/gabehowell11/roster-manager/blob/main/src/rostermanager/ui/team_view.py): `src/rostermanager/ui/team_view.py`
- [Field renderer](https://github.com/gabehowell11/roster-manager/blob/main/src/rostermanager/ui/field_view.py): `src/rostermanager/ui/field_view.py`
- [Player cards](https://github.com/gabehowell11/roster-manager/blob/main/src/rostermanager/ui/player_card.py): `src/rostermanager/ui/player_card.py`
- [Player editor](https://github.com/gabehowell11/roster-manager/blob/main/src/rostermanager/ui/player_dialog.py): `src/rostermanager/ui/player_dialog.py`
- [Roster list](https://github.com/gabehowell11/roster-manager/blob/main/src/rostermanager/ui/roster_panel.py): `src/rostermanager/ui/roster_panel.py`

### Other components

- **User**
- **NFL roster source**
- **Roster file**

## Connections

- User → Team home: chooses team (evidence: `README.md`)
- App startup → Team home: opens (evidence: `src/rostermanager/__main__.py`)
- App startup → Team view: starts (evidence: `src/rostermanager/__main__.py`)
- Team home → Roster service: requests roster actions (evidence: `src/rostermanager/ui/home_screen.py`)
- Team home → Team view: selects team (evidence: `src/rostermanager/ui/main_window.py`)
- User → Roster file: provides roster (evidence: `README.md`)
- Roster file → Custom roster import: reads CSV or JSON (evidence: `README.md`)
- Roster service → Custom roster import: imports roster (evidence: `src/rostermanager/services/roster_service.py`)
- User → NFL roster source: requests team (evidence: `README.md`)
- NFL roster source → NFL roster download: provides depth chart (evidence: `README.md`)
- Roster service → NFL roster download: downloads or refreshes (evidence: `src/rostermanager/services/roster_service.py`)
- Roster service → Roster repository: loads and saves (evidence: `src/rostermanager/services/roster_service.py`)
- Roster repository → Local SQLite store: reads and writes (evidence: `src/rostermanager/data/repository.py`)
- Custom roster import → Roster models: creates roster (evidence: `src/rostermanager/data/custom_import.py`)
- NFL roster download → Roster models: creates roster (evidence: `src/rostermanager/data/nflverse.py`)
- Roster repository → Roster models: loads and saves (evidence: `src/rostermanager/data/repository.py`)
- Team view → Roster service: loads and edits (evidence: `src/rostermanager/ui/team_view.py`)
- Team view → Field renderer: renders team (evidence: `src/rostermanager/ui/team_view.py`)
- Team view → Player editor: opens editor (evidence: `src/rostermanager/ui/team_view.py`)
- Team view → Roster list: shows roster list (evidence: `src/rostermanager/ui/team_view.py`)
- Field renderer → Player cards: renders players (evidence: `src/rostermanager/ui/field_view.py`)
- Field renderer → Depth chart layout: positions slots (evidence: `src/rostermanager/ui/field_view.py`)
- Field renderer → Formation layouts: selects formation (evidence: `src/rostermanager/ui/field_view.py`)
- Player editor → Roster service: saves player changes (evidence: `src/rostermanager/ui/player_dialog.py`)
- Roster service → Depth editing: applies depth edits (evidence: `src/rostermanager/services/roster_service.py`)
- Formation layouts → Depth chart layout: uses field spots (evidence: `src/rostermanager/services/formations.py`)
- Roster list → Roster list logic: groups players (evidence: `src/rostermanager/ui/roster_panel.py`)
- Depth editing → Roster models: rebuilds roster (evidence: `src/rostermanager/services/depth_editing.py`)
- Formation layouts → Roster models: selects roster players (evidence: `src/rostermanager/services/formations.py`)
- Depth chart layout → Roster models: lays out depth chart (evidence: `src/rostermanager/services/field_layout.py`)
