How aakarsh-88/f1-analytics works
F1 Analytics is a historical Formula 1 dashboard: users explore overview statistics, driver and constructor careers, race details, championship standings, and cross-season analytics. The documented runtime path is Next.js pages and visualizations consuming a versioned FastAPI API backed by PostgreSQL. Backend routes delegate to domain services and repositories; repositories query the relational data. The README also documents search and Clerk authentication. Some frontend and backend feature files were not sampled, so their internal calls are represented only where the README or source index supports them.
Main entry points: (dashboard) Dashboard pages · v1 Feature routes · repositories Feature repositories · api API clients
Components 18
Web experience
- Dashboard pages
frontend/src/app/(dashboard) - Feature visualizations
frontend/src/components - API clients
frontend/src/lib/api - Clerk authentication
frontend/src/lib/auth
REST API
- Application entry
backend/app/main.py - Versioned router
backend/app/api/v1/router.py - Feature routes
backend/app/api/v1 - Request dependencies
backend/app/api/deps.py - Cross-domain search
backend/app/api/v1
Domain and queries
- Feature services
backend/app/services - Feature repositories
backend/app/repositories - F1 data models
backend/app/models - API schemas
backend/app/schemas - Pagination utilities
backend/app/utils/pagination.py
Persistence
- Database sessions
backend/app/core/database.py - PostgreSQL
Other components
- Dashboard user
- CSV provisioning
scripts
Connections 16
- Dashboard user → Dashboard pages: explores
- Dashboard pages → Feature visualizations: renders
- Dashboard pages → API clients: requests data
- Dashboard pages → Clerk authentication: authenticates
- API clients → Application entry: calls REST API
- Application entry → Versioned router: mounts routes
backend/app/main.py - Versioned router → Feature routes: registers
backend/app/api/v1/router.py - Feature routes → Feature services: delegates
backend/app/api/v1/analytics.py - Feature services → Feature repositories: queries through
backend/app/services/standings_service.py - Feature repositories → F1 data models: queries
backend/app/repositories/standings_repository.py - Feature repositories → Database sessions: uses sessions
- Database sessions → PostgreSQL: connects
- Feature routes → API schemas: validates responses
backend/app/api/v1/analytics.py - Feature routes → Pagination utilities: uses pagination
backend/app/api/v1/constructors.py - Dashboard user → Cross-domain search: searches
- CSV provisioning → PostgreSQL: provisions data