Add keyword browsing/filtering and expose alternate titles

Keywords were ingested and shown read-only on detail pages, but had no directory (GET /keywords) or filter param -- the same gap genres had before today. Mirrors the genre browse pattern exactly: repository, service, route, plus a `keyword` filter on GET /movies and GET /series. Alternate/translated titles ("Also Known As") were normalized down to bare title strings and never written to MovieAlternateTitle/ SeriesAlternateTitle at all. Normalizer now captures country_code + type per TMDb's actual shape; ingestion writes them; movie/series detail now expose an alternate_titles list. Co-Authored-By: Claude Sonnet 5 <[email protected]>
2026-09-06 04:40:32 -05:00
parent e1a36ce227
commit 567b4ef068
23 changed files with 548 additions and 17 deletions
@@ -0,0 +1,24 @@
+"""Keyword endpoints (section 17: additive) -- a directory for the
+`keyword` filter GET /movies and GET /series accept, with no prior way to
+discover what those ids are. Mirrors app/api/v1/genres.py exactly."""
+
+from __future__ import annotations
+
+from fastapi import APIRouter, Depends, Query
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from app.core.database import get_db
+from app.core.security import enforce_rate_limit
+from app.schemas.common import KeywordListOut
+from app.services import keyword_service
+
+router = APIRouter(prefix="/keywords", tags=["keywords"], dependencies=[Depends(enforce_rate_limit)])
+
+
+@router.get("", response_model=KeywordListOut)
+async def list_keywords(
+    page: int = Query(1, ge=1),
+    page_size: int = Query(50, ge=1, le=200),
+    session: AsyncSession = Depends(get_db),
+) -> KeywordListOut:
+    return await keyword_service.list_keywords(session, page=page, page_size=page_size)