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.