Ingest and self-host company/network logos

CompanyBriefOut.logo_path and CompanyDetailOut.logo_path have existed
in the API schemas since Core 0.1's first pass, but nothing ever
actually populated them -- TMDb's production_companies/networks
entries carry a logo_path field that the normalizer simply never read,
so every response has silently returned null there.

- NormalizedCompanyRef now captures logo_path from both movie
  production_companies and series networks/production_companies.
- normalizer.company_logo_artwork() builds the single-image artwork
  entry for it (a company has exactly one logo ingested, so it's
  always is_primary) -- centralized there rather than duplicated in
  both ingestion modules, matching how movie/series artwork URLs are
  already built in one place.
- movie_ingestion.py and series_ingestion.py sync it via the same
  sync_artwork() the rest of section 10's self-hosting already uses,
  so it gets the same re-ingestion-safe upsert behavior for free.
- tasks.py cascades a download_artwork_task per referenced company
  after movie/series ingestion, same fan-out pattern as
  movie/series/season/person artwork.

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

tests/integration/test_movie_ingestion.py

@@ -11,6 +11,8 @@ import pytest
 from sqlalchemy import select
 from sqlalchemy.ext.asyncio import AsyncSession
 
+from app.models.artwork import Artwork
+from app.models.company import Company
 from app.models.credit import Credit
 from app.models.genre import Genre
 from app.models.movie import Movie
@@ -103,3 +105,26 @@ async def test_ingest_movie_is_idempotent(db_session: AsyncSession):
     )
     # Credits are replaced wholesale on re-sync, not duplicated.
     assert len(credits_) == 2  # 1 cast + 1 crew from FAKE_MOVIE
+
+
+@pytest.mark.asyncio
+async def test_ingest_movie_ingests_company_logo(db_session: AsyncSession):
+    provider = FakeTMDbProvider(FAKE_MOVIE)
+
+    await ingest_movie(db_session, provider, "603")
+    await db_session.commit()
+
+    company = (
+        await db_session.execute(
+            select(Company).where(Company.name == "Village Roadshow Pictures")
+        )
+    ).scalar_one()
+
+    logo = (
+        await db_session.execute(
+            select(Artwork).where(Artwork.entity_type == "company", Artwork.entity_id == company.id)
+        )
+    ).scalar_one()
+    assert logo.artwork_type.value == "logo"
+    assert logo.is_primary is True
+    assert logo.original_url.endswith("/village-roadshow-logo.png")

tests/unit/test_normalizer.py

@@ -32,7 +32,12 @@ FAKE_MOVIE = {
     "imdb_id": "tt0133093",
     "genres": [{"id": 28, "name": "Action"}, {"id": 878, "name": "Science Fiction"}],
     "production_companies": [
-        {"id": 79, "name": "Village Roadshow Pictures", "origin_country": "US"}
+        {
+            "id": 79,
+            "name": "Village Roadshow Pictures",
+            "origin_country": "US",
+            "logo_path": "/village-roadshow-logo.png",
+        }
     ],
     "poster_path": "/poster.jpg",
     "backdrop_path": "/backdrop.jpg",
@@ -160,6 +165,17 @@ def test_normalize_movie_marks_exactly_one_primary_poster_and_backdrop():
     assert primary_backdrops[0].provider_asset_id == "/backdrop.jpg"
 
 
+def test_normalize_movie_maps_company_logo_path():
+    movie = normalize_movie(FAKE_MOVIE)
+    assert movie.companies[0].logo_path == "/village-roadshow-logo.png"
+
+
+def test_normalize_movie_company_without_logo_is_none():
+    minimal = {**FAKE_MOVIE, "production_companies": [{"id": 1, "name": "No Logo Studio"}]}
+    movie = normalize_movie(minimal)
+    assert movie.companies[0].logo_path is None
+
+
 def test_normalize_movie_external_ids_never_include_tmdb_itself():
     # TMDb's own id is handled separately by the ingestion pipeline via
     # `normalized.external_id`, not folded into `external_ids` (section 3:
@@ -224,9 +240,9 @@ FAKE_SERIES = {
     "vote_count": 15000,
     "genres": [{"id": 18, "name": "Drama"}, {"id": 80, "name": "Crime"}],
     "created_by": [{"id": 66633, "name": "Vince Gilligan", "gender": 2}],
-    "networks": [{"id": 174, "name": "AMC", "origin_country": "US"}],
+    "networks": [{"id": 174, "name": "AMC", "origin_country": "US", "logo_path": "/amc-logo.png"}],
     "production_companies": [
-        {"id": 2605, "name": "Gran Via Productions", "origin_country": "US"}
+        {"id": 2605, "name": "Gran Via Productions", "origin_country": "US", "logo_path": None}
     ],
     "poster_path": "/poster.jpg",
     "backdrop_path": "/backdrop.jpg",
@@ -323,6 +339,14 @@ def test_normalize_series_maps_networks_vs_production_companies():
     assert [c.name for c in series.companies] == ["Gran Via Productions"]
 
 
+def test_normalize_series_maps_network_logo_path():
+    series = normalize_series(FAKE_SERIES)
+    assert series.networks[0].logo_path == "/amc-logo.png"
+    # Gran Via's fixture entry has no logo_path at all -- must come through
+    # as None, not KeyError.
+    assert series.companies[0].logo_path is None
+
+
 def test_normalize_series_maps_creators_separately_from_crew():
     series = normalize_series(FAKE_SERIES)
     assert len(series.creators) == 1