# georgetatakis/sharpline architecture

> Architecture diagram of the GitHub repository georgetatakis/sharpline, 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/georgetatakis/sharpline
- Repository: https://github.com/georgetatakis/sharpline

## Overview

Sharpline is an early-stage NFL predictive analytics platform: the documented goal is to produce game, player-prop, and anytime-TD probabilities and compare them with betting markets. The visible workflow is data import into PostgreSQL, readiness checking, and—through the game-model module—feature-driven prediction. The sampled UI exposes the checklist and system-status views, not prediction results. Several model capabilities are documented but their implementation was not sampled; unverified ingestion links are marked dashed.

Main entry points: [`backend/app/importer.py`](https://github.com/georgetatakis/sharpline/blob/main/backend/app/importer.py) (CSV import), [`backend/app/models.py`](https://github.com/georgetatakis/sharpline/blob/main/backend/app/models.py) (Domain records), [`backend/app/db.py`](https://github.com/georgetatakis/sharpline/blob/main/backend/app/db.py) (DB sessions), [`backend/app/game_model.py`](https://github.com/georgetatakis/sharpline/blob/main/backend/app/game_model.py) (Game predictions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Web interface"]
  node_app_ui["Sharpline tabs<br/>[App.jsx]"]
  node_checklist_ui["Data checklist<br/>[DataChecklist.jsx]"]
  node_status_ui["System status<br/>[SystemStatus.jsx]"]
  node_api_client["API client<br/>[api.js]"]
end

subgraph group_ingest["Data ingestion"]
  node_screenshot_import["CSV import<br/>[importer.py]"]
  node_game_import["Schedule and results<br/>[game_importer.py]"]
  node_nfl_loader["nflverse loader<br/>[nflverse_loader.py]"]
  node_nfl_build["nflverse stat builder<br/>[nflverse_build.py]"]
  node_team_lookup["Team name matching<br/>[team_lookup.py]"]
end

subgraph group_model["Prediction and analysis"]
  node_features["Model features<br/>[features.py]"]
  node_game_model["Game predictions<br/>[game_model.py]"]
  node_simulator["Outcome simulation<br/>[simulator.py]"]
  node_overlap["Feature overlap analysis<br/>[overlap.py]"]
end

subgraph group_platform["API and persistence"]
  node_api["FastAPI routes<br/>[main.py]"]
  node_checklist["Readiness checklist<br/>[checklist.py]"]
  node_teams_api["Team endpoints<br/>[teams.py]"]
  node_db_sessions["DB sessions<br/>[db.py]"]
  node_settings["Runtime settings<br/>[config.py]"]
  node_schema["Domain records<br/>[models.py]"]
  node_run_log["Run logging<br/>[run_log.py]"]
  node_postgres[("PostgreSQL")]
end

node_user(("Engineer / analyst"))

node_user -->|"uses"| node_app_ui
node_app_ui -->|"renders"| node_checklist_ui
node_app_ui -->|"renders"| node_status_ui
node_checklist_ui -->|"fetches checklist"| node_api
node_api -->|"routes to"| node_checklist
node_api -->|"routes to"| node_teams_api
node_api -->|"gets settings"| node_db_sessions
node_api -->|"configures CORS"| node_settings
node_checklist -->|"uses dependency"| node_db_sessions
node_checklist -->|"reads sources"| node_features
node_checklist -->|"uses table catalog"| node_screenshot_import
node_checklist -->|"queries records"| node_schema
node_db_sessions -->|"configures engine"| node_settings
node_db_sessions -->|"connects"| node_postgres
node_teams_api -->|"queries records"| node_schema
node_screenshot_import -->|"dispatches game tables"| node_game_import
node_screenshot_import -->|"writes imported data"| node_schema
node_screenshot_import -->|"uses sessions"| node_db_sessions
node_screenshot_import -->|"resolves teams"| node_team_lookup
node_screenshot_import -->|"records runs"| node_run_log
node_game_import -->|"writes games"| node_schema
node_game_import -->|"resolves teams"| node_team_lookup
node_nfl_loader -.->|"loads records"| node_schema
node_nfl_loader -.->|"shares import handling"| node_screenshot_import
node_nfl_build -->|"writes statistics"| node_schema
node_nfl_build -.->|"resolves teams"| node_team_lookup
node_nfl_build -.->|"shares import helpers"| node_screenshot_import
node_features -->|"reads records"| node_schema
node_features -->|"uses analysis"| node_overlap
node_game_model -->|"uses features"| node_features
node_game_model -->|"simulates outcomes"| node_simulator
node_game_model -->|"uses records"| node_schema
node_game_model -->|"uses sessions"| node_db_sessions
node_game_model -->|"resolves teams"| node_team_lookup
node_game_model -->|"records runs"| node_run_log
node_overlap -->|"queries records"| node_schema
node_overlap -->|"uses sessions"| node_db_sessions
node_overlap -.->|"records runs"| node_run_log

click node_app_ui "https://github.com/georgetatakis/sharpline/blob/main/frontend/src/App.jsx"
click node_checklist_ui "https://github.com/georgetatakis/sharpline/blob/main/frontend/src/DataChecklist.jsx"
click node_status_ui "https://github.com/georgetatakis/sharpline/blob/main/frontend/src/SystemStatus.jsx"
click node_api_client "https://github.com/georgetatakis/sharpline/blob/main/frontend/src/api.js"
click node_api "https://github.com/georgetatakis/sharpline/blob/main/backend/app/main.py"
click node_checklist "https://github.com/georgetatakis/sharpline/blob/main/backend/app/checklist.py"
click node_teams_api "https://github.com/georgetatakis/sharpline/blob/main/backend/app/teams.py"
click node_db_sessions "https://github.com/georgetatakis/sharpline/blob/main/backend/app/db.py"
click node_settings "https://github.com/georgetatakis/sharpline/blob/main/backend/app/config.py"
click node_schema "https://github.com/georgetatakis/sharpline/blob/main/backend/app/models.py"
click node_screenshot_import "https://github.com/georgetatakis/sharpline/blob/main/backend/app/importer.py"
click node_game_import "https://github.com/georgetatakis/sharpline/blob/main/backend/app/game_importer.py"
click node_nfl_loader "https://github.com/georgetatakis/sharpline/blob/main/backend/app/nflverse_loader.py"
click node_nfl_build "https://github.com/georgetatakis/sharpline/blob/main/backend/app/nflverse_build.py"
click node_team_lookup "https://github.com/georgetatakis/sharpline/blob/main/backend/app/team_lookup.py"
click node_features "https://github.com/georgetatakis/sharpline/blob/main/backend/app/features.py"
click node_game_model "https://github.com/georgetatakis/sharpline/blob/main/backend/app/game_model.py"
click node_simulator "https://github.com/georgetatakis/sharpline/blob/main/backend/app/simulator.py"
click node_overlap "https://github.com/georgetatakis/sharpline/blob/main/backend/app/overlap.py"
click node_run_log "https://github.com/georgetatakis/sharpline/blob/main/backend/app/run_log.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_app_ui,node_checklist_ui,node_status_ui,node_api_client toneBlue
class node_screenshot_import,node_game_import,node_nfl_loader,node_nfl_build,node_team_lookup toneAmber
class node_features,node_game_model,node_simulator,node_overlap toneMint
class node_api,node_checklist,node_teams_api,node_db_sessions,node_settings,node_schema,node_run_log,node_postgres toneRose
class node_user toneIndigo
```

## Components

### Web interface

- [Sharpline tabs](https://github.com/georgetatakis/sharpline/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Data checklist](https://github.com/georgetatakis/sharpline/blob/main/frontend/src/DataChecklist.jsx): `frontend/src/DataChecklist.jsx`
- [System status](https://github.com/georgetatakis/sharpline/blob/main/frontend/src/SystemStatus.jsx): `frontend/src/SystemStatus.jsx`
- [API client](https://github.com/georgetatakis/sharpline/blob/main/frontend/src/api.js): `frontend/src/api.js`

### Data ingestion

- [CSV import](https://github.com/georgetatakis/sharpline/blob/main/backend/app/importer.py): `backend/app/importer.py`
- [Schedule and results](https://github.com/georgetatakis/sharpline/blob/main/backend/app/game_importer.py): `backend/app/game_importer.py`
- [nflverse loader](https://github.com/georgetatakis/sharpline/blob/main/backend/app/nflverse_loader.py): `backend/app/nflverse_loader.py`
- [nflverse stat builder](https://github.com/georgetatakis/sharpline/blob/main/backend/app/nflverse_build.py): `backend/app/nflverse_build.py`
- [Team name matching](https://github.com/georgetatakis/sharpline/blob/main/backend/app/team_lookup.py): `backend/app/team_lookup.py`

### Prediction and analysis

- [Model features](https://github.com/georgetatakis/sharpline/blob/main/backend/app/features.py): `backend/app/features.py`
- [Game predictions](https://github.com/georgetatakis/sharpline/blob/main/backend/app/game_model.py): `backend/app/game_model.py`
- [Outcome simulation](https://github.com/georgetatakis/sharpline/blob/main/backend/app/simulator.py): `backend/app/simulator.py`
- [Feature overlap analysis](https://github.com/georgetatakis/sharpline/blob/main/backend/app/overlap.py): `backend/app/overlap.py`

### API and persistence

- [FastAPI routes](https://github.com/georgetatakis/sharpline/blob/main/backend/app/main.py): `backend/app/main.py`
- [Readiness checklist](https://github.com/georgetatakis/sharpline/blob/main/backend/app/checklist.py): `backend/app/checklist.py`
- [Team endpoints](https://github.com/georgetatakis/sharpline/blob/main/backend/app/teams.py): `backend/app/teams.py`
- [DB sessions](https://github.com/georgetatakis/sharpline/blob/main/backend/app/db.py): `backend/app/db.py`
- [Runtime settings](https://github.com/georgetatakis/sharpline/blob/main/backend/app/config.py): `backend/app/config.py`
- [Domain records](https://github.com/georgetatakis/sharpline/blob/main/backend/app/models.py): `backend/app/models.py`
- [Run logging](https://github.com/georgetatakis/sharpline/blob/main/backend/app/run_log.py): `backend/app/run_log.py`
- **PostgreSQL**

### Other components

- **Engineer / analyst**

## Connections

- Engineer / analyst → Sharpline tabs: uses (evidence: `frontend/src/App.jsx`)
- Sharpline tabs → Data checklist: renders (evidence: `frontend/src/App.jsx`)
- Sharpline tabs → System status: renders (evidence: `frontend/src/App.jsx`)
- Data checklist → FastAPI routes: fetches checklist (evidence: `frontend/src/DataChecklist.jsx`)
- FastAPI routes → Readiness checklist: routes to (evidence: `backend/app/main.py`)
- FastAPI routes → Team endpoints: routes to (evidence: `backend/app/main.py`)
- FastAPI routes → DB sessions: gets settings (evidence: `backend/app/main.py`)
- FastAPI routes → Runtime settings: configures CORS (evidence: `backend/app/main.py`)
- Readiness checklist → DB sessions: uses dependency (evidence: `backend/app/checklist.py`)
- Readiness checklist → Model features: reads sources (evidence: `backend/app/checklist.py`)
- Readiness checklist → CSV import: uses table catalog (evidence: `backend/app/checklist.py`)
- Readiness checklist → Domain records: queries records (evidence: `backend/app/checklist.py`)
- DB sessions → Runtime settings: configures engine (evidence: `backend/app/db.py`)
- DB sessions → PostgreSQL: connects (evidence: `backend/app/db.py`)
- Team endpoints → Domain records: queries records (evidence: `backend/app/teams.py`)
- CSV import → Schedule and results: dispatches game tables (evidence: `backend/app/importer.py`)
- CSV import → Domain records: writes imported data (evidence: `backend/app/importer.py`)
- CSV import → DB sessions: uses sessions (evidence: `backend/app/importer.py`)
- CSV import → Team name matching: resolves teams (evidence: `backend/app/importer.py`)
- CSV import → Run logging: records runs (evidence: `backend/app/importer.py`)
- Schedule and results → Domain records: writes games (evidence: `backend/app/game_importer.py`)
- Schedule and results → Team name matching: resolves teams (evidence: `backend/app/game_importer.py`)
- nflverse loader → Domain records: loads records (evidence: `backend/app/nflverse_loader.py`)
- nflverse loader → CSV import: shares import handling (evidence: `backend/app/nflverse_loader.py`)
- nflverse stat builder → Domain records: writes statistics (evidence: `backend/app/nflverse_build.py`)
- nflverse stat builder → Team name matching: resolves teams (evidence: `backend/app/nflverse_build.py`)
- nflverse stat builder → CSV import: shares import helpers (evidence: `backend/app/nflverse_build.py`)
- Model features → Domain records: reads records (evidence: `backend/app/features.py`)
- Model features → Feature overlap analysis: uses analysis (evidence: `backend/app/features.py`)
- Game predictions → Model features: uses features (evidence: `backend/app/game_model.py`)
- Game predictions → Outcome simulation: simulates outcomes (evidence: `backend/app/game_model.py`)
- Game predictions → Domain records: uses records (evidence: `backend/app/game_model.py`)
- Game predictions → DB sessions: uses sessions (evidence: `backend/app/game_model.py`)
- Game predictions → Team name matching: resolves teams (evidence: `backend/app/game_model.py`)
- Game predictions → Run logging: records runs (evidence: `backend/app/game_model.py`)
- Feature overlap analysis → Domain records: queries records (evidence: `backend/app/overlap.py`)
- Feature overlap analysis → DB sessions: uses sessions (evidence: `backend/app/overlap.py`)
- Feature overlap analysis → Run logging: records runs (evidence: `backend/app/overlap.py`)
