Vorspann und Abspann — erkannt, abgelegt, überspringbar

Beides mit derselben Rechnung, nur in einem anderen Fenster: vorn die
ersten fünfzehn Minuten, hinten die letzten zehn. Was `Tonabgleich`
findet, hängt allein daran, welchen Ausschnitt man ihm gibt — eine
zweite Erkennung für den Abspann wäre dieselbe Suche ein zweites Mal.

Je Staffel verglichen, nicht je Serie: Serien wechseln ihren Vorspann
zwischen Staffeln, und über alle hinweg fände man nichts oder das
Falsche. Gefundenes über fünf Minuten wird verworfen — zwei Folgen, die
dieselbe Datei tragen, teilen vierzig, und darüber stünde sonst ein
Überspringen-Knopf.

Der Lauf geht auf Zuruf, nicht bei jedem Scan: er liest von jeder Folge
ein Stück Ton und dauert Minuten. Der Knopf dafür steht auf der
Serienseite, bei den Verwalterknöpfen.

Die Marken gehen im Folgenvertrag mit — als „intro" und „credits", die
Wörter, die die Apps von Jellyfin her ohnehin kennen. In der App zeichnet
sie der vorhandene Überspringen-Knopf, der bisher nie etwas zu tun
hatte; im Web ist er neu, rechtsbündig über der Zeitleiste.

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

server/src/Flaro.Api/Endpoints/LibraryContentEndpoints.cs

@@ -118,6 +118,7 @@ public static class LibraryContentEndpoints
             .ToListAsync();
         var spuren = await SpurenZu(db, dateien.Select(d => d.Id).ToList());
         var stände = await ZuständeZu(db, wer, folgen: [nachbar.Id]);
+        var marken = await MarkenZu(db, [nachbar.Id]);
 
         // **Ohne eigenes Bild das der Serie.** Eine graue Fläche sagt
         // nichts; das Plakat der Serie sagt wenigstens, worum es geht.
@@ -133,7 +134,31 @@ public static class LibraryContentEndpoints
             dateien.Select(d => Datei(d.Id, d.Path, d.SizeBytes, d.Container, d.Duration, spuren, d.VersionLabel)).ToList(),
             stände.GetValueOrDefault(nachbar.Id),
             nachbar.PublishAt,
-            SeriesId: diese.SeriesId));
+            SeriesId: diese.SeriesId,
+            Markers: marken[nachbar.Id].ToList()));
+    }
+
+    /// <summary>Die Marken zu einer Reihe von Folgen.</summary>
+    ///
+    /// <remarks>
+    /// Als Nachschlagewerk und nicht je Folge einzeln: eine Staffel mit
+    /// zwanzig Folgen wären sonst zwanzig Abfragen für zwanzig kurze Zeilen.
+    /// </remarks>
+    private static async Task<ILookup<Guid, MarkerResponse>> MarkenZu(
+        FlaroContext db, IReadOnlyCollection<Guid> folgen)
+    {
+        if (folgen.Count == 0)
+            return Array.Empty<(Guid, MarkerResponse)>().ToLookup(x => x.Item1, x => x.Item2);
+
+        var roh = await db.Marken.AsNoTracking()
+            .Where(m => folgen.Contains(m.EpisodeId))
+            .Select(m => new { m.EpisodeId, m.Art, m.VonSekunden, m.BisSekunden })
+            .ToListAsync();
+
+        return roh.ToLookup(
+            m => m.EpisodeId,
+            m => new MarkerResponse(
+                m.Art == Markenart.Intro ? "intro" : "credits", m.VonSekunden, m.BisSekunden));
     }
 
     private static async Task<ILookup<Guid, MediaStreamResponse>> SpurenZu(FlaroContext db, List<Guid> dateien)
@@ -792,6 +817,7 @@ public static class LibraryContentEndpoints
                 .ToListAsync();
             var spuren = await SpurenZu(db, dateien.Select(d => d.Id).ToList());
             var stände = await ZuständeZu(db, wer, folgen: [id]);
+            var marken = await MarkenZu(db, [id]);
 
             var wurzel = await MediathekspfadFuer(db, wer,
                 await db.Series.AsNoTracking().Where(x => x.Id == folge.SeriesId)
@@ -803,7 +829,8 @@ public static class LibraryContentEndpoints
                 dateien.Select(d => Datei(d.Id, d.Path, d.SizeBytes, d.Container, d.Duration, spuren, d.VersionLabel, wurzel)).ToList(),
                 stände.GetValueOrDefault(id),
                 folge.PublishAt,
-                SeriesId: folge.SeriesId));
+                SeriesId: folge.SeriesId,
+                Markers: marken[id].ToList()));
         }).RequireAuthorization();
 
         // **Die Nachbarfolge — vorwärts wie rückwärts.** Reihenfolge ist
@@ -813,6 +840,21 @@ public static class LibraryContentEndpoints
         // **Beide Richtungen, seit es im Spieler Knöpfe dafür gibt.** Wer
         // eine Folge zu weit gesprungen ist, soll zurück können, ohne über
         // die Serienseite zu gehen.
+        // **Vorspann und Abspann suchen — auf Zuruf.**
+        //
+        // Der Lauf dauert Minuten: er liest von jeder Folge einer Staffel
+        // ein Stück Ton und vergleicht die Abdrücke. Deshalb 202 und ein
+        // Hintergrundlauf statt einer Antwort, auf die jemand wartet.
+        app.MapPost("/api/v1/series/{id:guid}/marken", async (
+            Guid id, FlaroContext db, Markenerkennung erkennung, bool erneut = false) =>
+        {
+            if (!await db.Series.AsNoTracking().AnyAsync(x => x.Id == id)) return Results.NotFound();
+
+            return erkennung.Starten(id, erneut)
+                ? Results.Accepted()
+                : Einwand.Belegt("Für diese Serie werden gerade Marken gesucht.");
+        }).RequireAuthorization(FlaroPolicies.Administrator);
+
         app.MapGet("/api/v1/episodes/{id:guid}/next", (Guid id, ClaimsPrincipal wer, FlaroContext db) =>
             Nachbarfolge(id, wer, db, vorwaerts: true)).RequireAuthorization();
 
@@ -901,6 +943,7 @@ public static class LibraryContentEndpoints
                 .ToListAsync();
             var spuren = await SpurenZu(db, dateien.Select(d => d.Id).ToList());
             var stände = await ZuständeZu(db, wer, folgen: ids);
+            var marken = await MarkenZu(db, ids);
 
             var serienBild = await db.Series.AsNoTracking()
                 .Where(x => x.Id == id)
@@ -913,7 +956,8 @@ public static class LibraryContentEndpoints
                     .Select(d => Datei(d.Id, d.Path, d.SizeBytes, d.Container, d.Duration, spuren, d.VersionLabel, wurzel)).ToList(),
                 stände.GetValueOrDefault(f.Id),
                 f.PublishAt,
-                SeriesId: id)).ToList();
+                SeriesId: id,
+                Markers: marken[f.Id].ToList())).ToList();
 
             return Results.Ok(new Page<EpisodeResponse>(items, items.Count));
         }).RequireAuthorization();