Add opt-in season cascade to series ingestion

Ingesting a series only ever produced season stubs -- getting actual
episodes meant calling POST /admin/ingest/season once per season by
hand, which is exactly what manual end-to-end testing kept requiring
for every multi-season show.

POST /api/v1/admin/ingest/series now takes include_seasons (default
false, since a show can have dozens of seasons and that's dozens of
TMDb calls fired from one request). When true, ingest_series_task
fans out one ingest_season job per season once the series succeeds,
using arq's own ctx['redis'] connection for the job (the same pattern
arq's docs recommend for job chaining) rather than a second unrelated
connection. Each fanned-out season job still goes through
get_or_create_ingestion_job, so re-running a cascaded series ingestion
reuses the same season job rows instead of creating duplicates.

Co-Authored-By: Claude Sonnet 5 <[email protected]>

docs/api.md

@@ -120,7 +120,7 @@ you want network-level isolation too.
 |---|---|---|---|
 | POST | `/api/v1/admin/ingest/movie` | `{"tmdb_id": "603"}` | Enqueues an arq job; returns `{"job_id": "...", "status": "enqueued"}` immediately (section 15: ingestion never runs inline in a request). |
 | POST | `/api/v1/admin/ingest/person` | `{"tmdb_id": "6384"}` | Same, for a person profile. |
-| POST | `/api/v1/admin/ingest/series` | `{"tmdb_id": "1396"}` | Ingests the series and season *stubs* (number, title, air date, poster) — no episodes yet. |
+| POST | `/api/v1/admin/ingest/series` | `{"tmdb_id": "1396", "include_seasons": false}` | Ingests the series and season *stubs* (number, title, air date, poster) — no episodes yet. With `include_seasons: true`, also enqueues an `ingest/season` job for every season once the series finishes (opt-in: some shows have dozens of seasons, each a separate TMDb call). |
 | POST | `/api/v1/admin/ingest/season` | `{"tmdb_id": "1396", "season_number": 1}` | Ingests one season's full episode list. Requires the series to already be ingested (`ingest/series` first) — fails with a clear error otherwise. |
 | GET | `/api/v1/admin/ingest/jobs/{job_id}` | — | Poll job status: `pending` → `running` → `succeeded`/`failed`/`retrying`. |
 

docs/database.md

@@ -171,6 +171,9 @@ indexes on the alternate-title tables. See
 - `ingest_series` only upserts season *stubs* (number, title, air date,
   poster) — episodes require a separate `ingest_season` call per season
   (TMDb has no single endpoint returning a whole series' episodes), and
-  that call requires the series to already exist. There's no orchestration
-  yet that walks all of a series' seasons automatically after
-  `ingest_series` succeeds.
+  that call requires the series to already exist. `POST
+  /api/v1/admin/ingest/series` can cascade this automatically
+  (`include_seasons: true` fans out one `ingest_season` job per season from
+  `ingest_series_task` once the series succeeds, via arq's own `ctx['redis']`
+  — see `app/workers/tasks.py`), but it's opt-in: some shows have dozens of
+  seasons, each a separate TMDb call, so cascading isn't the default.