Extend the public API: news excerpts/detail, game team logos, sponsor logo dimensions, player licenses

- news: NewsItemOut gains `excerpt` (truncated body); GET /news/{slug}/
  fetches a single item. slug already auto-populates on save, but a
  data migration backfills any pre-existing blank ones.
- games: home_team/away_team change from plain strings to {id, name,
  logo_url} objects -- home links to the actual Team (logo from the
  club's own logo, since teams have none of their own), away links
  to the actual Opponent (which already had a logo field). Breaking
  change for any existing consumer of the old string shape.
- sponsors: SponsorOut gains logo_width/logo_height, computed in
  Sponsor.save() -- Pillow for raster, a bounded regex read of the
  SVG root tag for vector logos (not a full XML parse, since that's
  exposed to entity-expansion attacks on untrusted uploads). A data
  migration backfills dimensions for existing sponsor logos.
- teams: PlayerOut gains `license`, sourced from ClubMembership (not
  Member -- it's per-club, per-season), batched in one query.

news/api.py

@@ -11,7 +11,9 @@ import uuid
 from datetime import datetime
 
 from django.utils import timezone
+from django.utils.text import Truncator
 from ninja import Router, Schema
+from ninja.errors import HttpError
 
 from api.errors import require_club
 
@@ -22,6 +24,11 @@ router = Router(tags=["news"])
 DEFAULT_LIMIT = 20
 MAX_LIMIT = 100
 
+#: Words, not characters -- reads more naturally cut off mid-list than a hard
+#: character count, and body is plain text so there's no markup to worry about
+#: truncating mid-tag.
+EXCERPT_WORDS = 40
+
 
 class NewsPhotoOut(Schema):
     url: str
@@ -33,6 +40,7 @@ class NewsItemOut(Schema):
     id: uuid.UUID
     title: str
     slug: str
+    excerpt: str
     body: str
     published_at: datetime
     teams: list[str]
@@ -46,11 +54,21 @@ class NewsListOut(Schema):
     results: list[NewsItemOut]
 
 
+def _visible_news(club):
+    return News.objects.filter(
+        club=club,
+        status=News.Status.PUBLISHED,
+        published_at__lte=timezone.now(),
+        visibility__in=[News.Visibility.EXTERNAL, News.Visibility.BOTH],
+    )
+
+
 def _to_news_item_out(item, request) -> NewsItemOut:
     return NewsItemOut(
         id=item.pk,
         title=item.title,
         slug=item.slug,
+        excerpt=Truncator(item.body).words(EXCERPT_WORDS, truncate=" …"),
         body=item.body,
         published_at=item.published_at,
         teams=[team.name for team in item.teams.all()],
@@ -66,18 +84,19 @@ def list_news(request, limit: int = DEFAULT_LIMIT, offset: int = 0):
     limit = max(1, min(limit, MAX_LIMIT))
     offset = max(0, offset)
 
-    queryset = (
-        News.objects.filter(
-            club=club,
-            status=News.Status.PUBLISHED,
-            published_at__lte=timezone.now(),
-            visibility__in=[News.Visibility.EXTERNAL, News.Visibility.BOTH],
-        )
-        .prefetch_related("photos", "teams")
-        .order_by("-published_at")
-    )
+    queryset = _visible_news(club).prefetch_related("photos", "teams").order_by("-published_at")
 
     count = queryset.count()
     page = queryset[offset : offset + limit]
 
     return NewsListOut(count=count, limit=limit, offset=offset, results=[_to_news_item_out(item, request) for item in page])
+
+
+@router.get("/{slug}/", response=NewsItemOut, summary="Single published news item")
+def get_news_item(request, slug: str):
+    club = require_club(request)
+    item = _visible_news(club).filter(slug=slug).prefetch_related("photos", "teams").first()
+    if item is None:
+        raise HttpError(404, "No such news item.")
+
+    return _to_news_item_out(item, request)

news/migrations/0002_backfill_slugs.py

@@ -0,0 +1,23 @@
+from django.db import migrations
+
+from rosterchief.base import unique_slugify
+
+
+def backfill_slugs(apps, schema_editor):
+    """News.save() already auto-populates a blank slug (rosterchief.base.
+    ClubScopedModel.save), but that only fires on save() -- rows created
+    before the slug field existed, or via bulk_create, never got one."""
+    News = apps.get_model("news", "News")
+    for item in News.objects.filter(slug=""):
+        item.slug = unique_slugify(item, item.title, scope={"club_id": item.club_id})
+        item.save(update_fields=["slug"])
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("news", "0001_initial"),
+    ]
+
+    operations = [
+        migrations.RunPython(backfill_slugs, migrations.RunPython.noop),
+    ]