Add GET /people browse/discover endpoint

Extends the browse/discover pattern already built for movies/series
to the fourth major entity type. No genre/year/status equivalent for
people -- known_for_department is the one categorical filter that
actually means something for a cast/crew list, and sort_by is just
popularity (default) or name. No invalid-filter case either: unlike
genre/status, known_for_department is a plain string compared
directly, nothing to parse or validate.

build_person_summary refactored to share row-to-summary logic with
the new list path, same pattern used for movies/series/companies.

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

app/services/person_service.py

@@ -10,6 +10,7 @@ from sqlalchemy.ext.asyncio import AsyncSession
 from app.core.ids import aurora_id, parse_aurora_id
 from app.models.credit import Credit
 from app.models.enums import ArtworkType
+from app.models.person import Person
 from app.models.tv import Series
 from app.repositories import movie_repository, person_repository, polymorphic, tv_repository
 from app.schemas.person import (
@@ -17,6 +18,7 @@ from app.schemas.person import (
     GuestEpisodeOut,
     PersonCreditsOut,
     PersonDetailOut,
+    PersonListOut,
     PersonSummaryOut,
 )
 from app.services.common import primary_artwork_path, to_artwork_out
@@ -189,13 +191,8 @@ async def get_person_credits(session: AsyncSession, person_aurora_id: str) -> Pe
     return PersonCreditsOut(id=aurora_id("person", str(person.id)), cast=cast, crew=crew)
 
 
-async def build_person_summary(
-    session: AsyncSession, person_id: uuid.UUID
-) -> PersonSummaryOut | None:
-    person = await person_repository.get_person_by_id(session, person_id)
-    if person is None:
-        return None
-    profiles = await polymorphic.get_artwork(session, "person", person_id, ArtworkType.PROFILE)
+async def _person_summary_from_row(session: AsyncSession, person: Person) -> PersonSummaryOut:
+    profiles = await polymorphic.get_artwork(session, "person", person.id, ArtworkType.PROFILE)
     return PersonSummaryOut(
         id=aurora_id("person", str(person.id)),
         name=person.name,
@@ -205,6 +202,15 @@ async def build_person_summary(
     )
 
 
+async def build_person_summary(
+    session: AsyncSession, person_id: uuid.UUID
+) -> PersonSummaryOut | None:
+    person = await person_repository.get_person_by_id(session, person_id)
+    if person is None:
+        return None
+    return await _person_summary_from_row(session, person)
+
+
 async def build_person_summaries(
     session: AsyncSession, person_ids: list[uuid.UUID]
 ) -> list[PersonSummaryOut]:
@@ -214,3 +220,28 @@ async def build_person_summaries(
         if summary is not None:
             out.append(summary)
     return out
+
+
+async def list_people(
+    session: AsyncSession,
+    *,
+    known_for_department: str | None,
+    sort_by: str,
+    sort_dir: str,
+    page: int,
+    page_size: int,
+) -> PersonListOut:
+    people, total = await person_repository.list_people(
+        session,
+        known_for_department=known_for_department,
+        sort_by=sort_by,
+        sort_dir=sort_dir,
+        limit=page_size,
+        offset=(page - 1) * page_size,
+    )
+    results = [await _person_summary_from_row(session, p) for p in people]
+    total_pages = (total + page_size - 1) // page_size if total else 0
+
+    return PersonListOut(
+        page=page, page_size=page_size, total_results=total, total_pages=total_pages, results=results
+    )