Der Server weiss jetzt mehr als Titel und Plakat

Bisher standen zu einem Film vier Angaben in der Datenbank: Titel, Jahr,
Beschreibung, zwei Bilder. Damit lässt sich eine Kachel zeichnen und sonst
nichts — keine Detailseite, die mehr sagt als der Dateiname, keine
Vorschläge, kein Filter nach Genre. Alles drei hing daran.

Jetzt kommen dazu: **Laufzeit, Bewertung, Werbezeile, Altersfreigabe,
Genres, Besetzung, Stab — und der Schriftzug des Titels.** Letzterer ist
das, was eine Startseite teuer aussehen lässt: „Blade Runner 2049" in seiner
eigenen Schrift über dem Hintergrundbild statt in der Systemschrift.

**Alles in einer Anfrage.** `append_to_response` hängt Besetzung,
Fremdkennungen, Freigaben und Bilder an den Einzelabruf. Vier getrennte
Anfragen je Titel wären bei vierhundert Filmen sechzehnhundert, und TMDB
begrenzt, wie oft man fragen darf. Der eigene Abruf der IMDb-Kennung ist
dabei entfallen — sie hängt jetzt mit dran.

Freigaben sind national: die FSK gilt in Deutschland, die MPAA in den USA,
und TMDB führt beide nebeneinander. Genommen wird die des eingestellten
Landes. Beim Schriftzug entscheidet zuerst die Sprache und erst danach die
Bildbewertung — ein deutscher Titel in deutscher Schrift schlägt den besser
bewerteten englischen.

Vom Stab nur Regie und Drehbuch. TMDB führt dort auch Beleuchter und
Caterer; eine Detailseite, die alle nennt, nennt nichts.

**Genres und Personen als eigene Tabellen**, nicht als Text im Film. Sonst:
filtern über `LIKE`, Tippfehler als eigenes Genre, und bei einer Umbenennung
vierhundert Zeilen anfassen. Personen über die Kennung der Quelle geführt,
nicht über den Namen — es gibt zwei Schauspieler namens „Chris Evans".

Darauf sitzen zwei neue Endpunkte: ein Filter nach Genre (nur die, die in
der Mediathek auch vorkommen — ein Knopf zu einer leeren Liste ist schlimmer
als kein Knopf) und **Vorschläge** über die Genres des zuletzt Gesehenen.
Keine Empfehlungsmaschine: ein Haushaltsserver hat keine Millionen
Sehverläufe, aus denen sich etwas lernen liesse. Eine schlichte Regel ist
nachvollziehbar, was eine undurchschaubare Empfehlung nie ist.

---

**Zwei Fehler, beide fand erst der echte Lauf.**

`UNIQUE constraint failed: Genres.Name`, und damit scheiterte der ganze
Scan — in der Mediathek erschien kein einziger Titel. Vier Bibliotheken
scannen gleichzeitig, jede mit eigenem Datenbankkontext; zwei stossen auf
„Drama", keine sieht die ungespeicherte Zeile der anderen. Statt die Läufe
zu serialisieren — das kostete bei zehn Bibliotheken das Zehnfache an Zeit —
wird der Fehlschlag hingenommen und die Zeile des anderen benutzt. Sie steht
ja genau dafür da.

Und: **eine geänderte Sprache erreichte vorhandene Titel nie.** Ein zweiter
Scan fragt nichts erneut, das ist Absicht. Wer aber von Englisch auf Deutsch
stellt, bekam deutsche Titel erst beim nächsten neuen Film. Dafür gibt es
jetzt „Metadaten auffrischen" je Bibliothek — geholt über die bekannte
Kennung, nicht über eine neue Suche, damit eine Zuordnung von Hand
stehenbleibt.

368 Tests grün, zehn davon neu. Am Container nachgewiesen: „Der Untergang",
156 Minuten, FSK 12, Bewertung 7,9, Genres Drama/Historie/Kriegsfilm,
22 Mitwirkende mit Rollennamen, Schriftzug und Hintergrund da — und nach dem
Umstellen auf de-DE heisst er nicht mehr „Downfall".

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

server/src/Flaro.Core/Library/CatalogEntities.cs

@@ -0,0 +1,66 @@
+namespace Flaro.Core.Library;
+
+/// <summary>Ein Genre, einmal je Name.</summary>
+///
+/// <remarks>
+/// <b>Eine eigene Tabelle und keine Liste im Film.</b> „Science Fiction" als
+/// Text in jedem Film stehen zu haben hiesse: filtern über <c>LIKE</c>,
+/// Tippfehler als eigenes Genre, und bei einer Umbenennung vierhundert
+/// Zeilen anfassen. So ist es eine Zeile und ein Verweis.
+/// </remarks>
+public sealed class Genre
+{
+    public Guid Id { get; init; } = Guid.CreateVersion7();
+    public required string Name { get; set; }
+}
+
+/// <summary>Verbindet ein Genre mit einem Film oder einer Serie.</summary>
+public sealed class GenreLink
+{
+    public Guid Id { get; init; } = Guid.CreateVersion7();
+    public required Guid GenreId { get; init; }
+    public Guid? MovieId { get; init; }
+    public Guid? SeriesId { get; init; }
+}
+
+/// <summary>Jemand, der mitgewirkt hat.</summary>
+///
+/// <remarks>
+/// Über die Kennung der Quelle geführt, nicht über den Namen: es gibt zwei
+/// Schauspieler namens „Chris Evans", und sie über einen Kamm zu scheren
+/// hiesse, dem einen die Filmografie des anderen anzuhängen.
+/// </remarks>
+public sealed class Person
+{
+    public Guid Id { get; init; } = Guid.CreateVersion7();
+    public required string Name { get; set; }
+
+    /// <summary>Die Kennung bei TMDB — der eindeutige Schlüssel.</summary>
+    public required int TmdbId { get; init; }
+
+    /// <summary>Das Porträt in der Bildablage.</summary>
+    public string? Image { get; set; }
+}
+
+public enum CreditRole { Actor, Director, Writer }
+
+/// <summary>Wer in welcher Rolle woran beteiligt war.</summary>
+public sealed class Credit
+{
+    public Guid Id { get; init; } = Guid.CreateVersion7();
+    public required Guid PersonId { get; init; }
+    public Guid? MovieId { get; init; }
+    public Guid? SeriesId { get; init; }
+    public required CreditRole Role { get; init; }
+
+    /// <summary>Die gespielte Rolle — nur bei Darstellern.</summary>
+    public string? Character { get; set; }
+
+    /// <summary>Die Reihenfolge, wie die Quelle sie nennt.</summary>
+    ///
+    /// <remarks>
+    /// Die Besetzungsliste ist nicht alphabetisch: oben stehen die
+    /// Hauptrollen. Nach Namen zu sortieren hiesse, diese Aussage wegzuwerfen.
+    /// </remarks>
+    public int Order { get; set; }
+}

server/src/Flaro.Core/Library/MediaEntities.cs

@@ -121,6 +121,33 @@ public sealed class Movie
 
     public string? BackdropImage { get; set; }
 
+    /// <summary>Die Laufzeit laut Quelle, in Minuten.</summary>
+    ///
+    /// <remarks>
+    /// Nicht die der Datei — die steht in <see cref="MediaFile.Duration"/>
+    /// und misst, was wirklich vorliegt. Beide sind nützlich und beide
+    /// verschieden: eine Fassung mit Werbepausen ist länger als der Film.
+    /// </remarks>
+    public int? RuntimeMinutes { get; set; }
+
+    /// <summary>Die Bewertung der Quelle, 0–10.</summary>
+    public double? Rating { get; set; }
+
+    /// <summary>Die Werbezeile, etwa „Die Wirklichkeit ist eine Lüge".</summary>
+    public string? Tagline { get; set; }
+
+    /// <summary>Die Altersfreigabe des eingestellten Landes, etwa „16".</summary>
+    public string? ContentRating { get; set; }
+
+    /// <summary>Der Schriftzug des Titels in der Bildablage.</summary>
+    ///
+    /// <remarks>
+    /// Freigestellt auf durchsichtigem Grund. Über dem Hintergrundbild sagt
+    /// er mehr als derselbe Titel in der Systemschrift — und nicht jeder
+    /// Titel hat einen.
+    /// </remarks>
+    public string? LogoImage { get; set; }
+
     public DateTimeOffset AddedAt { get; init; } = DateTimeOffset.UtcNow;
 }
 
@@ -184,6 +211,33 @@ public sealed class Series
 
     public string? BackdropImage { get; set; }
 
+    /// <summary>Die Laufzeit laut Quelle, in Minuten.</summary>
+    ///
+    /// <remarks>
+    /// Nicht die der Datei — die steht in <see cref="MediaFile.Duration"/>
+    /// und misst, was wirklich vorliegt. Beide sind nützlich und beide
+    /// verschieden: eine Fassung mit Werbepausen ist länger als der Film.
+    /// </remarks>
+    public int? RuntimeMinutes { get; set; }
+
+    /// <summary>Die Bewertung der Quelle, 0–10.</summary>
+    public double? Rating { get; set; }
+
+    /// <summary>Die Werbezeile, etwa „Die Wirklichkeit ist eine Lüge".</summary>
+    public string? Tagline { get; set; }
+
+    /// <summary>Die Altersfreigabe des eingestellten Landes, etwa „16".</summary>
+    public string? ContentRating { get; set; }
+
+    /// <summary>Der Schriftzug des Titels in der Bildablage.</summary>
+    ///
+    /// <remarks>
+    /// Freigestellt auf durchsichtigem Grund. Über dem Hintergrundbild sagt
+    /// er mehr als derselbe Titel in der Systemschrift — und nicht jeder
+    /// Titel hat einen.
+    /// </remarks>
+    public string? LogoImage { get; set; }
+
     public DateTimeOffset AddedAt { get; init; } = DateTimeOffset.UtcNow;
 }
 

server/src/Flaro.Core/Metadata/IMetadataProvider.cs

@@ -3,13 +3,78 @@ namespace Flaro.Core.Metadata;
 /// <summary>Ein Bild bei der Quelle — noch nicht heruntergeladen.</summary>
 public sealed record RemoteImage(string Url);
 
+/// <summary>Jemand, der mitgewirkt hat.</summary>
+///
+/// <remarks>
+/// <c>Character</c> ist nur bei Darstellern gefüllt. Regie und Drehbuch
+/// haben keine Rolle, und ein leeres Feld dafür wäre ehrlicher als „—".
+/// </remarks>
+public sealed record CreditMetadata(
+    int ProviderId, string Name, CreditKind Kind, string? Character, RemoteImage? Portrait, int Order);
+
+public enum CreditKind { Actor, Director, Writer }
+
+/// <summary>Was eine Quelle über einen Film weiss.</summary>
+///
+/// <remarks>
+/// <b>Gewachsen, und das hat einen Grund.</b> Mit Titel, Jahr, Beschreibung
+/// und zwei Bildern lässt sich eine Kachel zeichnen und sonst nichts: keine
+/// Detailseite, die mehr sagt als der Dateiname, keine Vorschläge, kein
+/// Filter nach Genre. Alles drei hängt daran, dass hier mehr ankommt.
+///
+/// Jedes Feld darf fehlen. Ein Mitschnitt, den keine Quelle kennt, soll
+/// trotzdem in der Mediathek stehen.
+/// </remarks>
 public sealed record MovieMetadata(
     int ProviderId, string Title, int? Year, string? Overview,
-    RemoteImage? Poster, RemoteImage? Backdrop, string? ImdbId = null);
+    RemoteImage? Poster, RemoteImage? Backdrop, string? ImdbId = null,
+    /// <summary>Laufzeit in Minuten, wie die Quelle sie nennt.</summary>
+    ///
+    /// <remarks>
+    /// Nicht die der Datei: die steht in <c>MediaFile.Duration</c> und misst,
+    /// was wirklich vorliegt. Beide sind nützlich und beide verschieden —
+    /// eine Fassung mit Werbepausen ist länger als der Film.
+    /// </remarks>
+    int? RuntimeMinutes = null,
+    /// <summary>Die Bewertung der Quelle, 0–10.</summary>
+    double? Rating = null,
+    string? Tagline = null,
+    /// <summary>Die Altersfreigabe des eingestellten Landes, etwa „16".</summary>
+    string? ContentRating = null,
+    IReadOnlyList<string>? Genres = null,
+    IReadOnlyList<CreditMetadata>? Credits = null,
+    /// <summary>Der Schriftzug des Titels, freigestellt auf durchsichtigem Grund.</summary>
+    ///
+    /// <remarks>
+    /// <b>Das, was eine Startseite teuer aussehen lässt.</b> „Blade Runner
+    /// 2049" in seiner eigenen Schrift über dem Hintergrundbild sagt mehr als
+    /// derselbe Titel in der Systemschrift — und es ist der Unterschied
+    /// zwischen einer Kachelwand und etwas, das wie ein Filmdienst aussieht.
+    ///
+    /// Nicht jeder Titel hat eines. Fehlt es, steht der Titel als Text da.
+    /// </remarks>
+    RemoteImage? Logo = null);
 
 public sealed record SeriesMetadata(
     int ProviderId, string Title, int? Year, string? Overview,
-    RemoteImage? Poster, RemoteImage? Backdrop, string? ImdbId = null);
+    RemoteImage? Poster, RemoteImage? Backdrop, string? ImdbId = null,
+    int? RuntimeMinutes = null,
+    double? Rating = null,
+    string? Tagline = null,
+    string? ContentRating = null,
+    IReadOnlyList<string>? Genres = null,
+    IReadOnlyList<CreditMetadata>? Credits = null,
+    /// <summary>Der Schriftzug des Titels, freigestellt auf durchsichtigem Grund.</summary>
+    ///
+    /// <remarks>
+    /// <b>Das, was eine Startseite teuer aussehen lässt.</b> „Blade Runner
+    /// 2049" in seiner eigenen Schrift über dem Hintergrundbild sagt mehr als
+    /// derselbe Titel in der Systemschrift — und es ist der Unterschied
+    /// zwischen einer Kachelwand und etwas, das wie ein Filmdienst aussieht.
+    ///
+    /// Nicht jeder Titel hat eines. Fehlt es, steht der Titel als Text da.
+    /// </remarks>
+    RemoteImage? Logo = null);
 
 public sealed record EpisodeMetadata(string? Title, string? Overview, RemoteImage? Still);