# Schedule & scoreboard

## Schedule

**Job:** `NFL: season schedule and results` — 0:00 and 7:00 ET daily.
**Command:** `football_sync schedule [--season YYYY]`

Reads the all-seasons `games.csv` from nflverse and keeps the rows for the
current season (ESPN per-team schedules as the fallback when nflverse has no
rows yet). Each row carries the ESPN game id, so both sources write the same
`Game`. nflverse also supplies the spread, total, coaches, starting QBs,
referee, roof and surface.

A game with a final score is marked `post` / completed. A game without one is
left alone if the scoreboard already marked it live — a schedule re-run never
regresses an in-progress game or clears scores the scoreboard set.

## Scoreboard

**Job:** `NFL: live scoreboard` — every 30 minutes.
**Command:** `football_sync scoreboard`

One ESPN `/scoreboard` call: scores, quarter linescores, clock, period, status
detail, game leaders, attendance and the teams' records, written onto games
already in the database. When no game is within a day of today the job
returns without calling ESPN, so the off-season costs nothing. The manual
command always calls.

