Scores aren't updating during games
▼
1. Go to GitHub → Actions → auto-scoring → check the latest run for errors.
2. Most common cause: Tank01 API rate limit. Check your monthly usage at rapidapi.com — if near 1,000 on Basic plan, upgrade to Pro immediately.
3. Manual trigger: Actions → auto-scoring → Run workflow → enter the week number.
4. If Tank01 is down (rare): scores will resume automatically when it recovers. Final scores can be manually entered in the commissioner panel after the games.
A player's score looks wrong
▼
Before Tuesday 9am: Go to Commissioner Panel → Import Week Scores → use manual score entry to override the individual team's score.
After Tuesday 9am (locked): Scores are locked by GitHub Actions. To override, go to Commissioner Panel → the week entry → unlock the score manually, edit, re-lock.
Root cause check: Compare Tank01's box score for the player's game against the expected fantasy total. Common issues: DEF points-allowed calculation or 100-yard bonuses not triggering.
A player wasn't locked when their game started
▼
Check: GitHub → Actions → kickoff-locks → latest run. If it errored, trigger it manually.
Manual lock: The lock data lives in Firebase at /leagues/fr_refresh26/locks/2026/week{N}/{TEAM}. You can add the team abbreviation manually in the Firebase console.
Policy: If a player slipped in after kickoff due to a lock failure, commissioner discretion. Generally: if the game had started and they picked someone in the active game, the lineup should be voided for that slot and scored 0 for that player.
A player submitted no lineup
▼
Policy: No lineup = 0 points for the week. This is by design — the deadline is first kickoff.
Exception rule (optional): Some commissioners allow one "emergency" late submission per season for documented technical issues. If you allow this, set the policy before the season and document it.
What not to do: Don't submit a lineup on a player's behalf — it creates disputes about who chose what.
Salary generation returned flat/zero salaries
▼
Cause: Tank01 projections not yet available for the week (common early in the week or during bye weeks).
Fix: Try regenerating Thursday morning — projections are usually updated by then. If still flat on Thursday, the flat salary fallback (QB $8,500, etc.) is fair to use and announce to players.
Tank01 check: Test the projections endpoint directly: fantasy-refresh-news.mtriedel.workers.dev/projections?week=N&season=2026
GitHub Actions isn't running
▼
Check 1: GitHub → Settings → Actions → General → make sure Actions are enabled for the repo.
Check 2: GitHub free plan gives 2,000 Action minutes/month. At 5-min intervals, the season uses ~1,200 minutes. Should be fine on free plan.
Check 3: Verify both secrets are still set: FIREBASE_DB_URL and TANK01_KEY. Go to Settings → Secrets → Actions.
Manual trigger: Any workflow can be manually triggered from the Actions tab → Run workflow button.