How georgetatakis/sharpline works
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: importer.py CSV import · models.py Domain records · db.py DB sessions · game_model.py Game predictions
Components 22
Web interface
- Sharpline tabs
frontend/src/App.jsx - Data checklist
frontend/src/DataChecklist.jsx - System status
frontend/src/SystemStatus.jsx - API client
frontend/src/api.js
Data ingestion
- CSV import
backend/app/importer.py - Schedule and results
backend/app/game_importer.py - nflverse loader
backend/app/nflverse_loader.py - nflverse stat builder
backend/app/nflverse_build.py - Team name matching
backend/app/team_lookup.py
Prediction and analysis
- Model features
backend/app/features.py - Game predictions
backend/app/game_model.py - Outcome simulation
backend/app/simulator.py - Feature overlap analysis
backend/app/overlap.py
API and persistence
- FastAPI routes
backend/app/main.py - Readiness checklist
backend/app/checklist.py - Team endpoints
backend/app/teams.py - DB sessions
backend/app/db.py - Runtime settings
backend/app/config.py - Domain records
backend/app/models.py - Run logging
backend/app/run_log.py - PostgreSQL
Other components
- Engineer / analyst
Connections 38
- Engineer / analyst → Sharpline tabs: uses
frontend/src/App.jsx - Sharpline tabs → Data checklist: renders
frontend/src/App.jsx - Sharpline tabs → System status: renders
frontend/src/App.jsx - Data checklist → FastAPI routes: fetches checklist
frontend/src/DataChecklist.jsx - FastAPI routes → Readiness checklist: routes to
backend/app/main.py - FastAPI routes → Team endpoints: routes to
backend/app/main.py - FastAPI routes → DB sessions: gets settings
backend/app/main.py - FastAPI routes → Runtime settings: configures CORS
backend/app/main.py - Readiness checklist → DB sessions: uses dependency
backend/app/checklist.py - Readiness checklist → Model features: reads sources
backend/app/checklist.py - Readiness checklist → CSV import: uses table catalog
backend/app/checklist.py - Readiness checklist → Domain records: queries records
backend/app/checklist.py - DB sessions → Runtime settings: configures engine
backend/app/db.py - DB sessions → PostgreSQL: connects
backend/app/db.py - Team endpoints → Domain records: queries records
backend/app/teams.py - CSV import → Schedule and results: dispatches game tables
backend/app/importer.py - CSV import → Domain records: writes imported data
backend/app/importer.py - CSV import → DB sessions: uses sessions
backend/app/importer.py - CSV import → Team name matching: resolves teams
backend/app/importer.py - CSV import → Run logging: records runs
backend/app/importer.py - Schedule and results → Domain records: writes games
backend/app/game_importer.py - Schedule and results → Team name matching: resolves teams
backend/app/game_importer.py - nflverse loader → Domain records: loads records
backend/app/nflverse_loader.py - nflverse loader → CSV import: shares import handling
backend/app/nflverse_loader.py - nflverse stat builder → Domain records: writes statistics
backend/app/nflverse_build.py - nflverse stat builder → Team name matching: resolves teams
backend/app/nflverse_build.py - nflverse stat builder → CSV import: shares import helpers
backend/app/nflverse_build.py - Model features → Domain records: reads records
backend/app/features.py - Model features → Feature overlap analysis: uses analysis
backend/app/features.py - Game predictions → Model features: uses features
backend/app/game_model.py - Game predictions → Outcome simulation: simulates outcomes
backend/app/game_model.py - Game predictions → Domain records: uses records
backend/app/game_model.py - Game predictions → DB sessions: uses sessions
backend/app/game_model.py - Game predictions → Team name matching: resolves teams
backend/app/game_model.py - Game predictions → Run logging: records runs
backend/app/game_model.py - Feature overlap analysis → Domain records: queries records
backend/app/overlap.py - Feature overlap analysis → DB sessions: uses sessions
backend/app/overlap.py - Feature overlap analysis → Run logging: records runs
backend/app/overlap.py