# Season history

Season records and stats for past seasons come from the same collectors,
replayed per season:

```bash
uv run python manage.py football_sync --seasons 2010-2025
uv run python manage.py football_sync --seasons 2015-2025 standings team_stats
```

`--seasons` replays `schedule`, `standings`, `player_stats` and `team_stats`
for every season in the range, in that order, and prints one summary line per
job per season. Sources and coverage:

| Data | Source | Seasons |
|------|--------|---------|
| Schedules and results | nflverse `games.csv` (one all-seasons file, cached between calls) | 1999– |
| Standings — W-L-T, points, division and conference rank, playoff seed | ESPN standings `?season=` | ~2002– |
| Player season stats with NFL ranks | nflverse `stats_player_reg_<season>.csv` | 1999– |
| Team season stats with 1–32 ranks | nflverse `stats_team_reg_<season>.csv` | 1999– |

A team's **season record** is its `Standing` row for that season (wins, losses,
ties, win percentage, points for/against, streak, `division_rank`,
`conference_rank`, `playoff_seed`, home/road/division/conference splits). A
**conference's** season is the standings filtered by conference and ordered by
`conference_rank` — `/api/football/standings/?season=2023&conference=7`.

Players on a tracked team's past rosters are created as non-roster `Player`
rows the first time their season stats are collected, so the Stats pages can
show them.

