Add approval-bound Sonarr episode search

2026-08-21 10:57:33 +02:00
parent f0d552ef58
commit 4089bb46e6
3 changed files with 165 additions and 13 deletions
@@ -72,3 +72,21 @@ mehrere Bereiche verbindet.
 Schreibende Aktionen bleiben hinter der jeweiligen serverseitigen Policy und
 einem Vorschau-/Bestätigungsablauf. Ein Client-Schalter allein darf niemals
 eine read-only Policy aufheben.
+
+## Sonarr: sichere Episodensuche
+
+Der lokale Sonarr-Patch stellt bewusst keine freie Sonarr-Command-API bereit.
+Der erlaubte Schreibablauf ist eng auf fehlende Episoden begrenzt:
+
+1. `preview_episode_search` bekommt Serien-ID, Staffel und die exakten
+   Episodennummern. Es liest Sonarr-Metadaten, entfernt bereits vorhandene
+   Episoden und erzeugt eine konkrete Vorschau samt kurzlebigem Ticket.
+2. Der Client zeigt diese Vorschau unverändert an. Ohne ausdrückliche
+   Benutzerfreigabe endet der Ablauf hier.
+3. `start_episode_search` akzeptiert nur denselben Umfang, `confirm=true` und
+   das passende Ticket. Erst dann startet Sonarr eine `EpisodeSearch` über die
+   dort konfigurierten Indexer.
+
+Der Ablauf ändert weder Serien- noch Staffel-Monitoring und erlaubt weder
+beliebige Commands noch direkte URL-/Release-Downloads. Tickets gelten zehn
+Minuten, sind einmalig und an genau die angezeigte Auswahl gebunden.