How gabehowell11/roster-manager works
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: roster_service.py Roster service · team_view.py Team view · depth_chart.py Roster models · field_view.py Field renderer
Components 22
Application
- App startup
src/rostermanager/__main__.py
Roster data
- Custom roster import
src/rostermanager/data/custom_import.py - NFL roster download
src/rostermanager/data/nflverse.py - Roster models
src/rostermanager/models/depth_chart.py - Player model
src/rostermanager/models/player.py - Team model
src/rostermanager/models/team.py - Roster repository
src/rostermanager/data/repository.py - Local SQLite store
Roster logic
- Roster service
src/rostermanager/services/roster_service.py - Depth editing
src/rostermanager/services/depth_editing.py - Formation layouts
src/rostermanager/services/formations.py - Depth chart layout
src/rostermanager/services/field_layout.py - Roster list logic
src/rostermanager/services/roster_list.py
Desktop interface
- Team home
src/rostermanager/ui/home_screen.py - Team view
src/rostermanager/ui/team_view.py - Field renderer
src/rostermanager/ui/field_view.py - Player cards
src/rostermanager/ui/player_card.py - Player editor
src/rostermanager/ui/player_dialog.py - Roster list
src/rostermanager/ui/roster_panel.py
Other components
- User
- NFL roster source
- Roster file
Connections 30
- User → Team home: chooses team
README.md - App startup → Team home: opens
src/rostermanager/__main__.py - App startup → Team view: starts
src/rostermanager/__main__.py - Team home → Roster service: requests roster actions
src/rostermanager/ui/home_screen.py - Team home → Team view: selects team
src/rostermanager/ui/main_window.py - User → Roster file: provides roster
README.md - Roster file → Custom roster import: reads CSV or JSON
README.md - Roster service → Custom roster import: imports roster
src/rostermanager/services/roster_service.py - User → NFL roster source: requests team
README.md - NFL roster source → NFL roster download: provides depth chart
README.md - Roster service → NFL roster download: downloads or refreshes
src/rostermanager/services/roster_service.py - Roster service → Roster repository: loads and saves
src/rostermanager/services/roster_service.py - Roster repository → Local SQLite store: reads and writes
src/rostermanager/data/repository.py - Custom roster import → Roster models: creates roster
src/rostermanager/data/custom_import.py - NFL roster download → Roster models: creates roster
src/rostermanager/data/nflverse.py - Roster repository → Roster models: loads and saves
src/rostermanager/data/repository.py - Team view → Roster service: loads and edits
src/rostermanager/ui/team_view.py - Team view → Field renderer: renders team
src/rostermanager/ui/team_view.py - Team view → Player editor: opens editor
src/rostermanager/ui/team_view.py - Team view → Roster list: shows roster list
src/rostermanager/ui/team_view.py - Field renderer → Player cards: renders players
src/rostermanager/ui/field_view.py - Field renderer → Depth chart layout: positions slots
src/rostermanager/ui/field_view.py - Field renderer → Formation layouts: selects formation
src/rostermanager/ui/field_view.py - Player editor → Roster service: saves player changes
src/rostermanager/ui/player_dialog.py - Roster service → Depth editing: applies depth edits
src/rostermanager/services/roster_service.py - Formation layouts → Depth chart layout: uses field spots
src/rostermanager/services/formations.py - Roster list → Roster list logic: groups players
src/rostermanager/ui/roster_panel.py - Depth editing → Roster models: rebuilds roster
src/rostermanager/services/depth_editing.py - Formation layouts → Roster models: selects roster players
src/rostermanager/services/formations.py - Depth chart layout → Roster models: lays out depth chart
src/rostermanager/services/field_layout.py