Wer etwas sieht, kann es jetzt auch sagen

Wer einen Server für andere betreibt, erfährt von Fehlern zuletzt: dass
die deutsche Tonspur nach einer halben Stunde aussetzt, merkt der, der den
Film sieht, und nicht der, der ihn eingeräumt hat. Bisher gab es dafür
keinen Weg ausser dem Zuruf im Wohnzimmer.

Gemeldet wird an einem Film, einer Serie, einer einzelnen Staffel und
einer einzelnen Folge: Art (Bild, Ton, Untertitel, Angaben, Sonstiges),
eine freiwillige Stelle wie 0:34:12 und der Kommentar. Pflicht ist nur der
Kommentar — die beiden anderen machen aus einer Liste von Sätzen etwas,
das man sortieren und nachstellen kann.

**Eine Staffel gibt es als Zeile nicht**, und das prägt den Entwurf. Sie
ist Serie plus Nummer, so wie überall sonst in diesem Server; die Meldung
trägt deshalb drei Fremdschlüssel und daneben eine Staffelnummer. Dass die
Nummer auf eine Staffel zeigt, die es gibt, prüft der Endpunkt beim
Schreiben — die Datenbank kann es nicht, es gibt nichts, worauf sie zeigen
könnte.

**Die Rechteprüfung steht nirgends.** Wer einen Titel nicht sehen darf,
findet ihn beim Melden nicht — das erledigt der Freigabefilter, ohne ein
einziges `Where`. Elegant und genau deshalb leicht zu zerstören, darum
steht dafür ein Test da.

**Die eigene Liste überlebt fremde Entscheidungen.** Titel werden
nachgeschlagen, nicht verbunden: zieht ein Administrator einen Titel
zurück, nachdem jemand ihn gemeldet hat, bleibt die Meldung beim Melder
stehen — nur ohne Namen. Ein Join hätte sie verschwinden lassen, und das
wäre jemandes eigene Eingabe, weggenommen wegen einer fremden Entscheidung.
`IgnoreQueryFilters` wäre die bequeme Abkürzung und gäbe den Namen eines
unveröffentlichten Titels über einen Weg heraus, an den beim nächsten Mal
niemand denkt.

**Erledigt heisst abgehakt, nicht gelöscht**, als Zeitpunkt und nicht als
Haken — wie `PublishAt` und `ChangedSince`. Daneben steht „Wieder öffnen";
ein Fehlgriff wäre sonst endgültig. Das Archiv wird erst auf Zuruf geholt:
es wächst nur, und für den seltenen Blick dauernd zu zahlen lohnt nicht.

**Der Abschnitt steht neben der Prüfliste, nicht darin.** Die versteckt
sich, sobald nichts auf Freigabe wartet — das ist der Normalfall, und die
Meldungen verschwänden mit ihr. Umgekehrt bleibt der Meldungsabschnitt
stehen, auch wenn nichts drinsteht: ein Kanal, der sich versteckt, solange
ihn niemand benutzt hat, bringt niemandem bei, dass es ihn gibt.

Die Zahl an der Leiste holt sich nur, wer sie nicht ohnehin hat: steht „Zu
prüfen" offen, meldet der Abschnitt sie selbst und nach jedem Abhaken.

Nebenbei zwei Dinge am Dialog, die hier auffielen. Es gab **kein
mehrzeiliges Feld** — und das Einsammeln der Werte hätte ein `<textarea>`
still verschluckt: es ist kein `HTMLInputElement` und wäre ins Auffangnetz
für Auswahlfelder gelaufen, also als `undefined` hinausgegangen. Der
Server hätte „ohne Beschreibung" geantwortet, auf einem Dialog, in dem
sichtbar etwas steht. Und `dialog()` meldete sich als einziger nicht beim
Seitenwechsel an: ein Dialog von der Detailseite überlebte den
Zurück-Knopf und stand danach über der Mediathek.

Neun Testfälle auf dem Server, zwölf Läufe. Für den Web-Client gibt es in
diesem Projekt keine Tests; dort ist von Hand geprüft.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Scarriffle
2026-10-06 22:18:14 +02:00
co-authored by Claude Opus 5
parent 02978e482c
commit 7cd48f5528
18 changed files with 2588 additions and 20 deletions
+86
View File
@@ -0,0 +1,86 @@
namespace Flaro.Core.Library;
/// <summary>Worum es bei einer Meldung geht.</summary>
///
/// <remarks>
/// <b>Fünf Fächer, nicht fünfzig.</b> Sie sind nicht dazu da, das Problem zu
/// beschreiben — das tut der Kommentar —, sondern dazu, eine Liste sortierbar
/// zu machen. „Dreimal Ton an derselben Serie" ist eine Auskunft, die man
/// sieht, ohne zu lesen.
/// </remarks>
public enum Meldungsart
{
Bild,
Ton,
Untertitel,
/// <summary>Titel, Jahr, Plakat, Zuordnung — alles, was nicht im Bild ist.</summary>
Daten,
Sonstiges,
}
/// <summary>Was jemandem an einem Titel aufgefallen ist.</summary>
///
/// <remarks>
/// <para>
/// <b>Vier Ziele, drei Spalten.</b> Film, Serie, Staffel, Folge — und eine
/// Staffel gibt es als Zeile nicht. Sie ist <c>SeriesId</c> plus
/// <c>SeasonNumber</c>, so wie sie überall sonst in diesem Server adressiert
/// wird. Eine Tabelle dafür anzulegen, nur damit eine Meldung irgendwohin
/// zeigen kann, wäre ein Modellumbau für einen Fremdschlüssel.
/// </para>
/// <para>
/// <b>Keine Zeile je Benutzer und Titel.</b> Anders als bei
/// <see cref="Playback.UserItemState"/> und <see cref="Playback.Sehtag"/> steht
/// hier kein eindeutiger Index: zwei Meldungen zu demselben Film sind zwei
/// Meldungen. „Der Ton setzt bei 0:30 aus" und „das Plakat gehört zu einem
/// anderen Film" haben miteinander nichts zu tun.
/// </para>
/// <para>
/// <b>Ein Zeitpunkt statt eines Hakens.</b> Wie bei <c>PublishAt</c> und
/// <c>ChangedSince</c>: ein <c>bool Erledigt</c> sagt, dass es vorbei ist,
/// aber nicht wann — und „seit wann liegt das hier" ist die erste Frage an
/// eine Liste von Aufgaben.
/// </para>
/// </remarks>
public sealed class Meldung
{
public Guid Id { get; init; } = Guid.CreateVersion7();
/// <summary>Wer gemeldet hat — aus dem Token, nie aus dem Rumpf.</summary>
public required Guid UserId { get; init; }
/// <summary>Entweder ein Film …</summary>
public Guid? MovieId { get; init; }
/// <summary>… oder eine Serie, ganz oder mit <see cref="SeasonNumber"/> …</summary>
public Guid? SeriesId { get; init; }
/// <summary>… oder eine einzelne Folge. Genau eines von dreien.</summary>
///
/// <remarks>
/// <b>Ohne die Serie daneben.</b> Welche Serie das ist, weiss die Folge
/// selbst; es hier ein zweites Mal abzulegen hiesse, zwei Wahrheiten zu
/// pflegen, von denen eine irgendwann die ältere ist.
/// </remarks>
public Guid? EpisodeId { get; init; }
/// <summary>Eine einzelne Staffel — nur zusammen mit <see cref="SeriesId"/>.</summary>
public int? SeasonNumber { get; init; }
public required Meldungsart Art { get; init; }
/// <summary>Wo im Titel. <c>null</c> heisst: nicht an einer Stelle.</summary>
public TimeSpan? Stelle { get; init; }
public required string Kommentar { get; init; }
public required DateTimeOffset GemeldetAm { get; init; }
/// <summary>Wann abgehakt — <c>null</c> heisst: offen.</summary>
public DateTimeOffset? ErledigtAm { get; set; }
/// <summary>Wer abgehakt hat.</summary>
public Guid? ErledigtVon { get; set; }
}