Eine Reihe, die nur zu ihrer Zeit dasteht

Zu Halloween, zur Weihnachtszeit, zum Jahreswechsel, im Sommer — und zu allem, was sonst jemand feiert. **Nach Stichwörtern, nicht nach Genres.** „Stirb langsam" ist kein Familienfilm und trägt trotzdem „christmas". Eine Weihnachtsreihe nach Genres enthielte jeden Zeichentrickfilm und diesen Film nicht. TMDB führt die Stichwörter ohnehin; sie kommen jetzt über `append_to_response` mit und landen in einer eigenen Tabelle, nach demselben Muster wie Genres. Kleingeschrieben abgelegt — TMDB liefert „Christmas" und „christmas" je nach Eintrag, und zwei Schreibweisen wären zwei Stichwörter. **Einstellbar und nicht eingebaut.** Halloween und Weihnachten kennt jeder; der 1. August ist Schweizer Nationalfeiertag, der 4. Juli amerikanischer, und der Geburtstag des Betreibers steht in keiner Bibliothek. Eine feste Liste im Quelltext hiesse: für jeden Anlass eine neue Fassung. Vier sind vorangelegt — als Beispiel, nicht als Meinung darüber, was jemand feiert. **Über den Jahreswechsel hinweg.** „28.12. bis 02.01." ist kein Fehler, sondern der Normalfall für Silvester; ein Vergleich, der nur „von ≤ heute ≤ bis" kennt, fände diesen Zeitraum nie — und die Reihe stünde genau in den Tagen nicht da, für die sie gedacht ist. Geprüft, Tag für Tag, samt der Zusicherung, dass sich die vorangelegten Anlässe an keinem Tag im Jahr überschneiden. **Leer heisst leer.** Gilt heute kein Anlass oder findet er nichts, kommt eine Reihe ohne Namen zurück und der Client zeigt gar keine — statt einer mit Überschrift und nichts darunter. Scheitert der Abruf ganz, fehlt eine Reihe und nicht die Startseite. Bedient wird sie als Text, eine Zeile je Anlass: Name, von, bis, Stichwörter, Genres. Ein Listeneditor mit Zeilen zum Hinzufügen, Verschieben und Löschen wäre viel Oberfläche für etwas, das man dreimal im Jahr anfasst — und es ist dieselbe Form, in der es gespeichert wird. Ein Anlass ohne Stichwort und ohne Genre wird abgewiesen statt stillschweigend geschluckt: er fände nie etwas, und wer ihn eingetragen hat, suchte den Fehler woanders. **Die Stichwörter kommen erst beim nächsten Auffrischen der Metadaten.** Vorhandene Titel tragen noch keine — bis dahin bleibt die Reihe leer. 764 Tests grün, davon 22 neue. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-10-08 21:45:09 +02:00
parent c13d1e78d2
commit e066f5fe87
19 changed files with 2121 additions and 7 deletions
@@ -0,0 +1,62 @@
+using System.Text.Json;
+using Flaro.Core.Library;
+using Flaro.Data;
+using Microsoft.EntityFrameworkCore;
+
+namespace Flaro.Api;
+
+/// <summary>Die saisonalen Anlässe, aus den Einstellungen.</summary>
+///
+/// <remarks>
+/// <b>Als JSON in einer Zeile und nicht als Tabelle.</b> Das hier ist
+/// Konfiguration, kein Bestand: eine Handvoll Einträge, die zusammen
+/// gelesen und zusammen geschrieben werden. Eine Tabelle dafür hiesse eine
+/// Migration für etwas, das niemand einzeln abfragt.
+/// </remarks>
+public sealed class Saisoneinstellungen(FlaroContext db)
+{
+    public const string Schluessel = "startseite.saisonal.anlaesse";
+
+    private IReadOnlyList<Saisonanlass>? _gemerkt;
+
+    public async Task<IReadOnlyList<Saisonanlass>> AnlaesseAsync(CancellationToken ct = default)
+    {
+        if (_gemerkt is { } fertig) return fertig;
+
+        var zeile = await db.Settings.AsNoTracking()
+            .FirstOrDefaultAsync(s => s.Key == Schluessel, ct);
+
+        return _gemerkt = Lesen(zeile?.Value);
+    }
+
+    /// <summary>Liest die gespeicherte Liste — oder gibt die Vorgabe zurück.</summary>
+    ///
+    /// <remarks>
+    /// <b>Unlesbares ist kein Grund, die Startseite zu verlieren.</b> Steht
+    /// dort Unsinn, gilt die Vorgabe; eine Ausnahme hier nähme dem Server
+    /// die ganze Reihe und nicht nur den falschen Eintrag.
+    /// </remarks>
+    public static IReadOnlyList<Saisonanlass> Lesen(string? roh)
+    {
+        if (string.IsNullOrWhiteSpace(roh)) return Saisonanlass.Vorgabe;
+
+        try
+        {
+            var gelesen = JsonSerializer.Deserialize<List<Saisonanlass>>(
+                roh, new JsonSerializerOptions(JsonSerializerDefaults.Web));
+
+            // Eine leere Liste ist eine Entscheidung — „keine saisonalen
+            // Reihen" — und nicht dasselbe wie „nichts eingestellt".
+            return gelesen is null ? Saisonanlass.Vorgabe : gelesen.Where(a => a.Brauchbar).ToList();
+        }
+        catch (JsonException)
+        {
+            return Saisonanlass.Vorgabe;
+        }
+    }
+
+    public static string Schreiben(IEnumerable<Saisonanlass> anlaesse) =>
+        JsonSerializer.Serialize(
+            anlaesse.Where(a => a.Brauchbar).ToList(),
+            new JsonSerializerOptions(JsonSerializerDefaults.Web));
+}