FPL Weekly — Admin

When to use — Functions

Off-season (Jun–Jul): click Apply off-season mode — disables live scrapers and raw bootstrap archives.
Pre-season: re-enable scrapers individually (or turn off off-season mode), then use Run now on scrapeBootstrapStatic and scrapeFixtures once new-season data is live.
In-season: leave bootstrap (5am/5pm), fixtures (6am/6pm), and active-window (30 min) on. Use ingestion runs table to spot failures.
Run now — manual scrape; ignores the disable toggle but respects ingestion options (e.g. raw archives off).

Ingestion options

Apply when bootstrap scrapers run (scheduled or manual). SQL player/team upserts still run; only raw Storage archives and snapshot metadata are skipped when disabled.

Ingestion runs

Time	Function	Outcome	Detail

When to use — SQL data

Sanity-check row counts after scrapes (~20 teams, ~700 players, ~380 fixtures).
After historic ingest, confirm playerPriorSeason has rows per season.
After template generation, use Firestore tab or Pre-season section — templates live in Firestore, not SQL.
Load rows — debug JSON samples only; not for production edits.

When to use — Firestore

Inspect mirrors: fpl_global/event_status_cloud_fn, user paths under users/{uid}/.
Template squads: collection preSeasonTemplates (doc id {seasonId}_{strategyId}).
Ingest progress: system_config/prior_season_ingest/current.

When to use — Storage

Debug raw bootstrap JSON under fpl-api-raw/bootstrap-static/ (when archives enabled).
Off-season: archives are usually off — expect few or no new files.
Danger zone can delete mirror archives before a new season.

New season checklist (manual)

Danger zone: SQL truncate → clear mirrors/Storage → reset user season data (watchlist, assistant, stock exchange).
Functions: Run bootstrap + fixtures manually; re-enable scrapers.
Step 1 — Historic data (below): Probe API → Run ingest (after new-season bootstrap if you need the just-finished season in history_past).
Step 2 — Templates: Generate template squads (needs SQL players + prior seasons).

1. Historic player seasons

Bulk-ingest FPL element-summary history_past[] into SQL PlayerPriorSeason. ~700 API calls, ~3–10 min. Not on daily crons.

Import	Season	Rows in SQL	API (sample)	Last ingested

Import scope All seasons from API Selected seasons only (checked above)

2. Strategy template squads

Rule-based 15-man squads (9 strategies) saved to Firestore preSeasonTemplates. Fast — SQL only. Re-run after rule tweaks or bootstrap refresh.

Optional campaign label (blank = auto from current gameweek)

Output

When to use — Danger zone

New season start (order matters): (1) SQL truncate → (2) clear mirrors + Storage → (3) reset user season data.
SQL truncate — wipes all app tables including playerPriorSeason; re-scrape bootstrap after.
Clear mirrors + Storage — event status, live mirrors, bootstrap JSON archives.
Reset user season data — watchlist, team assistant, stock exchange; keeps linked FPL entries.
Type confirmation phrase exactly before any destructive action.

Destructive actions. Type confirmation phrase exactly:

Confirmation

User season data (Firestore)

Clears watchlist, team assistant GW state, and stock exchange holdings — not fplEntries or auth.

Loading counts…

Targets Watchlist Team assistant Stock exchange

Optional user UID (blank = all users)