Initial Aurora Core 0.1 implementation

Production-grade media metadata backend per docs/aurora-core-spec.md: Aurora-owned UUIDv7 identity system, normalized movie/TV/people/credits schema, provider abstraction with a TMDb adapter, an idempotent async ingestion pipeline (normalize -> match -> upsert -> provenance), a Postgres FTS/trigram search layer, a stateless FastAPI v1 API with Redis caching/rate-limiting, arq workers, dev/prod Docker Compose topologies, unit + integration + load tests, CI, and architecture/ database/API/ERD documentation. Co-Authored-By: Claude Sonnet 5 <[email protected]>
2026-09-04 17:34:03 -05:00
commit c20df1c503
111 changed files with 10041 additions and 0 deletions
@@ -0,0 +1,119 @@
+"""Shared response building blocks used across entity schemas.
+
+These are hand-written Pydantic models, never SQLAlchemy models serialized
+directly — see section 18 of the build spec.
+"""
+
+from __future__ import annotations
+
+from datetime import date
+
+from pydantic import BaseModel, ConfigDict
+
+
+class ORMModel(BaseModel):
+    """Base for schemas built from ORM rows via `model_validate(obj)`."""
+
+    model_config = ConfigDict(from_attributes=True)
+
+
+class GenreOut(ORMModel):
+    id: str
+    name: str
+
+
+class KeywordOut(ORMModel):
+    id: str
+    name: str
+
+
+class ArtworkOut(BaseModel):
+    id: str
+    type: str
+    language: str | None = None
+    width: int | None = None
+    height: int | None = None
+    aspect_ratio: float | None = None
+    url: str
+    provider: str | None = None
+    is_primary: bool = False
+    vote_average: float | None = None
+
+
+class ImagesOut(BaseModel):
+    posters: list[ArtworkOut] = []
+    backdrops: list[ArtworkOut] = []
+    logos: list[ArtworkOut] = []
+
+
+class VideoOut(BaseModel):
+    id: str
+    type: str
+    site: str | None = None
+    url: str
+    language: str | None = None
+    country: str | None = None
+    is_official: bool = False
+    published_at: date | None = None
+    provider: str | None = None
+
+
+class ExternalIDsOut(BaseModel):
+    """Provider slug -> native ID, e.g. {"tmdb": "550", "imdb": "tt0137523"}."""
+
+    model_config = ConfigDict(extra="allow")
+
+
+class PersonBriefOut(BaseModel):
+    id: str
+    name: str
+    profile_path: str | None = None
+
+
+class CastCreditOut(BaseModel):
+    id: str
+    person: PersonBriefOut
+    character: str | None = None
+    billing_order: int | None = None
+    episode_count: int | None = None
+
+
+class CrewCreditOut(BaseModel):
+    id: str
+    person: PersonBriefOut
+    department: str
+    job: str | None = None
+    episode_count: int | None = None
+
+
+class CreditsOut(BaseModel):
+    cast: list[CastCreditOut] = []
+    crew: list[CrewCreditOut] = []
+
+
+class CompanyBriefOut(BaseModel):
+    id: str
+    name: str
+    company_type: str
+    logo_path: str | None = None
+
+
+class CollectionBriefOut(BaseModel):
+    id: str
+    name: str
+
+
+class PageMeta(BaseModel):
+    page: int
+    page_size: int
+    total: int
+    total_pages: int
+
+
+class ErrorDetail(BaseModel):
+    code: str
+    message: str
+
+
+class ErrorResponse(BaseModel):
+    error: ErrorDetail