UEBERARBEITUNG: Pre-Scan Metadaten-Lookup VOR Ripping, 100% Jellyfin-Kompatibilität (NFO, Ordnerstruktur, Poster/Backdrop), Metadaten-Preview im UI

KONZEPT.md

@@ -17,7 +17,7 @@ Rippy ist ein **komplett neues System** von Grund auf: modulare Multi-Container-
 
 ## 3. Kern-Idee
 
-Ein modular aufgebautes System, das bei Disc-Einwurf automatisch den Typ erkennt, das Medium rippt, Metadaten anreichert und das Ergebnis strukturiert ablegt. Alles über eine REST-API, asynchrone Celery-Jobs, ein React-WebUI und Echtzeit-Status über SSE.
+Ein modular aufgebautes System, das bei Disc-Einwurf automatisch den Typ erkennt, **vorbereitend Metadaten lookup und Preview bereitstellt**, das Medium rippt, Metadaten anreichert und das Ergebnis **Jellyfin-konform strukturiert ablegt**. Alles über eine REST-API, asynchrone Celery-Jobs, ein React-WebUI und Echtzeit-Status über SSE.
 
 ## 4. Features
 
@@ -27,6 +27,10 @@ Ein modular aufgebautes System, das bei Disc-Einwurf automatisch den Typ erkennt
 | Dynamischer Device-Resolver (UUID/Serial) | ✔ M | | |
 | MakeMKV-Ripping (lossless) | ✔ M | | |
 | Audio-Rip mit abcde + MusicBrainz | ✔ M | | |
+| **Metadaten-Lookup VOR dem Ripping (Preview)** | **✔ M** | | |
+| **Jellyfin-Ordnerstruktur & NFO-Generierung** | **✔ M** | | |
+| **Jellyfin-Poster/Backdrop/Fanart Download** | **✔ M** | | |
+| **Jellyfin-kompatible Dateibenennung** | **✔ M** | | |
 | Video-Metadaten via TMDB API | ✔ M | | |
 | AcoustID-Fingerprinting (chromaprint) | ✔ M | | |
 | Multi-Disc-Set-Handling (Release-Group-Resolver) | ✔ M | | |
@@ -56,12 +60,27 @@ Ein modular aufgebautes System, das bei Disc-Einwurf automatisch den Typ erkennt
 2. **Device-Resolver** (udev-basiert) ermittelt UUID/Serial-Nummer des Laufwerks, erzeugt Symlink `/dev/disc/<uuid>`.
 3. **Job-Erstellung** → Dämon erstellt Celery-Task, übergibt Device-Pfad und Disc-Typ.
 4. **Typ-Erkennung** (CD/DVD/Blu-ray) → Auswahl des Ripping-Pfads.
-5. **Ripping**:
+5. **⚡ METADATEN-Lookup im VORFELD** *(neu / geändert)*:
+   - DVD/Blu-ray: `makejungles` (oder equivalent) liest nur die TOC (Table of Contents), **ohne das Medium zu rippen**.
+   - Title, Laufzeit, Scene-Labels werden ausgelesen.
+   - Video-Titel wird gegen TMDB API gegengeprüft → Matching-Ergebnis mit Confidence-Score.
+   - Audio-Titel wird gegen MusicBrainz gegengeprüft (bei CD).
+   - **Rippy zeigt eine Preview im WebUI**: Titel, Jahr, Cover, Scene-Trackliste.
+   - Der Commander kann bestätigen oder manuell korrigieren (z.B. falsches TMDB-Match).
+   - Bestätigte Metadaten werden im SQLite-Cache persistiert.
+6. **Ripping** (nach Bestätigung):
    - CD: `abcde` → FLAC, Metadaten via AcoustID-Fingerprinting + MusicBrainz.
-   - DVD/Blu-ray: `makemkvcon --all --progress` → MKV.
-6. **Metadaten-Anreicherung**: Video-Infos von TMDB, Audio-Fallback von Discogs. SQLite-Cache für Rate-Limits.
-7. **Multi-Disc-Erkennung**: Release-Group-Resolver prüft, ob weitere Discs des gleichen Sets folgen.
-8. **Speichern**: Strukturierte Ablage nach `<media-type>/<Jahr>/<Titel>/`.
+   - DVD/Blu-ray: `makemkvcon --all --progress` → MKV, unter Verwendung der vorab gelookupeten Metadaten.
+7. **Post-Processing & Jellyfin-Formatierung** *(neu / geändert)*:
+   - Dateien werden in Jellyfin-konformer Ordnerstruktur abgelegt:
+     - Filme: `<Filmname> (<Jahr>)/<Filmname>-<title>.mkv` + `poster.jpg` + `fanart.jpg` + `movie.nfo`
+     - Serien: `<Serienname>/<Staffel N>/<Serienname> - S{Season}E{Episode} - <Episode>.mkv` + `poster.jpg` + `fanart.jpg` + `series.nfo` / `episode.nfo`
+     - Musik: `<Künstler>/<Album> (<Jahr>)/<Track-Nr>. <Titel>.flac` + `album.jpg` + `album.nfo`
+   - NFO-Dateien werden automatisch generiert im Jellyfin-Mediainfo-Format (Kodi/NFO-Schema).
+   - Poster/Backdrop/Fanart werden von TMDB heruntergeladen und nebengelegt.
+   - Bei Serien: Episode-Names werden von TheTVDB oder TMDB Movies/Fallback geholt.
+   - Bei Multi-Disc: Disc-Labels werden als `Disc 1.mkv`, `Disc 2.mkv` etc. benannt.
+8. **Multi-Disc-Erkennung**: Release-Group-Resolver prüft, ob weitere Discs des gleichen Sets folgen.
 9. **Status-Push**: Worker sendet Fortschritt über SSE an React-UI.
 10. **Abschluss**: Job-Ergebnis wird protokolliert, API gibt Token zurück, PBS-Backup-Hook kann ausgelöst werden.
 
@@ -88,16 +107,23 @@ Ein modular aufgebautes System, das bei Disc-Einwurf automatisch den Typ erkennt
 │  │  MakeMKV (isolierter CLI-Aufruf)       │          │
 │  │  HandBrake (optional, CLI)             │          │
 │  │  abcde + chromaprint + MusicBrainz     │          │
+│  │  NFO-Generator (Jellyfin-Mediainfo)    │  ★ NEU   │
+│  │  TMDB/TVDB Image-Downloader            │  ★ NEU   │
 │  └────────────────────────────────────────┘          │
 └─────────────────────────────────────────────────────┘
 ```
 
 **Container-Design:**
 - **API-Service** (FastAPI): JWT-Auth, REST-Endpoints, OpenAPI-Docs, Job-Management, Lizenz-Handling.
-- **Worker-Service** (Celery + Redis mit AOF-Persistence): Isolierte Ripping-Jobs, Cellery Tasks mit Device-Meta-Daten.
+- **Worker-Service** (Celery + Redis mit AOF-Persistence): Isolierte Ripping-Jobs, Celery Tasks mit Device-Meta-Daten.
 - **UI-Service** (React + Vite): Build-Step → statisch, bereitgestellt via Nginx. SSE-Client für Echtzeit-Status.
 - **udev-Daemon**: Separater System-Dienst (unabhängig von API-Container), empfängt Disc-Einwurf-Events.
 
+**Neue Worker-Komponenten:**
+- **NFO-Generator**: Liest die gelookupeten Metadaten und schreibt `.nfo`-Dateien im Jellyfin-erkannten Format (Kodi/NFO-Schema). Unterstützt movie.nfo, series.nfo, episode.nfo, album.nfo.
+- **TMDB Image-Downloader**: Lädt poster.jpg, fanart.jpg, backdrop.jpg in der Jellyfin-konformen Auflösung (poster: 500x750, fanart: 1920x1080+).
+- **Pre-Scan-Modul**: Liest die TOC der Disc (ohne Ripping), extrahiert Titel/Laufzeit/Scene-Labels und queryt TMDB/TVDB/MusicBrainz.
+
 **LXC-Isolation:**
 - Read-only Bind-Mounts für System-Bibliotheken.
 - Device-Node-Read-Only für `/dev/sr*` (optische Medien sind read-only).
@@ -106,17 +132,18 @@ Ein modular aufgebautes System, das bei Disc-Einwurf automatisch den Typ erkennt
 
 **Persistenz:**
 - PostgreSQL für Job-Logs, Metadaten, User-Management.
-- SQLite-Cache für API-Antworten (MusicBrainz, TMDB) — max 10.000 Einträge, LRU-Eviction.
+- SQLite-Cache für API-Antworten (MusicBrainz, TMDB, TheTVDB) — max 10.000 Einträge, LRU-Eviction.
 - NFS/Bind-Mount für Medien-Store (geteilter Volume).
 
 ## 7. UX-Flow
 
 1. **Dashboard** — Echtzeit-Kacheln mit aktuellem Job-Status, Queue-Übersicht, Disc-Einwurf-Hinweis.
 2. **Job-Verlauf** — Tabelle aller Jobs mit Status, Fortschrittsbalken, Ergebnis-Vorschau.
-3. **Job-Detail** — Live-Log-Ausgabe, Fortschritt, Möglichkeit "Abort" (nur vor Job-Start).
-4. **Ergebnis-View** — Liste gerippter Dateien, Metadaten-Anzeige, "Play" (Streaming) / "Download".
-5. **Einstellungen** — API-Keys verwalten (TMDB, Discogs), Transcoding-Optionen, Backup-Pfade, Lizenz-Einstellungen.
-6. **Geräte-Verwaltung** — Liste verfügbarer Laufwerke, Status, Device-Resolver-Konfiguration.
+3. **Metadaten-Preview** *(neu)* — Nach udev-Erkennung zeigt das UI automatisch die gelookupeten Metadaten: Titel, Jahr, Cover, Trackliste, Confidence-Score. Der Commander kann bestätigen oder manuell korrigieren (z.B. falsches TMDB-Match auswählen, Titel bearbeiten).
+4. **Job-Detail** — Live-Log-Ausgabe, Fortschritt, Möglichkeit "Abort" (nur vor Job-Start).
+5. **Ergebnis-View** — Liste gerippter Dateien, Metadaten-Anzeige, Jellyfin-Ordnerstruktur-Preview, "Play" (Streaming) / "Download".
+6. **Einstellungen** — API-Keys verwalten (TMDB, Discogs, TheTVDB), Transcoding-Optionen, Backup-Pfade, Lizenz-Einstellungen, Jellyfin-Config (Ziel-Pfade, NFO-Format).
+7. **Geräte-Verwaltung** — Liste verfügbarer Laufwerke, Status, Device-Resolver-Konfiguration.
 
 ## 8. Risiken & offene Punkte
 
@@ -130,6 +157,10 @@ Ein modular aufgebautes System, das bei Disc-Einwurf automatisch den Typ erkennt
 | Rate-Limits der Metadaten-APIs | Gelöst | SQLite-Cache (LRU, 10k Einträge), exponential backoff Retry (max 5 Versuche) |
 | GPL-v3-Compliance | Gelöst | Checkliste, Source-Release-Endpoint, MakeMKV als isolierte Black-Box, Lizenz-Dokumentation |
 | Redis Single-Instance Bottleneck | Offen | MVP mit Single-Instance; Redis-Cluster als "Später"-Feature |
+| **TMDB-Matching-Fehler bei Nischentiteln** | **Neu** | **Offen** — Pre-Scan zeigt Confidence-Score, manuelle Korrektur durch Commander. Fallback: manueller Titel-Eingabedialog. TheTVDB als Serien-Fallback. |
+| **NFO-Format-Abhängigkeit von Jellyfin-Version** | **Neu** | **Hinweis** — Jellyfin nutzt Kodi/NFO-Schema (gut dokumentiert). Bei Upstream-Änderungen muss NFO-Generator angepasst werden. Keine kritische Abhängigkeit. |
+| **Pre-Scan verzögert Ripping-Start** | **Neu** | **Hinweis** — Pre-Scan dauert 5–15s (TOC lesen + API-Query). Parallelisierbar: udev-Daemon startet Pre-Scan sofort, Ripping wartet nur auf Bestätigung. Akzeptabel für Heim-Use-Case. |
+| **TMDB-Bildrechte für Poster/Fanart** | **Neu** | **Gelöst** — TMDB API-ToS erlaubt Nutzung für private Heimzwecke (Daten Attribution Required). NFO enthält `<details>Source: TMDB</details>`. |
 
 ## 9. Härtetest-Dokumentation
 
@@ -147,3 +178,24 @@ Ein modular aufgebautes System, das bei Disc-Einwurf automatisch den Typ erkennt
 5 HINWEISE (keine BLOCKER): React als Build-Step+Statisch (korrigiert), Redis-AOF-Persistence (integriert), Read-only vs. Write-Konflikt (nicht relevant — optische Medien sind read-only), Redis-Cluster (als "Später" notiert), Cold-Boot-Problematik (udev-Daemon als separater Dienst gelöst).
 
 **Ergebnis:** Keine BLOCKER mehr. Konzept ist wasserdicht für MVP-Phase.
+
+---
+
+**Dritte Iteration — UEBERARBEITUNG (Commander-Feedback):**
+
+Änderungen:
+- **Metadaten-Lookup VOR dem Ripping** eingefügt (Sek. 5, Schritt 5)
+- **100% Jellyfin-Kompatibilität** hinzugefügt: NFO-Generator, Ordnerstruktur, Poster/Backdrop/
+Fanart-Download, Jellyfin-kompatible Dateibenennung (Sek. 4, Sek. 5, Sek. 6)
+- **Metadaten-Preview im UI** als neuer UX-Schritt (Sek. 7, Schritt 3)
+- **Neue Risiken**: TMDB-Matching-Fehler (offen, mit Fallback), NFO-Format-Abhängigkeit (Hinweis), Pre-Scan-Latenz (Hinweis), TMDB-Bildrechte (gelöst)
+
+**Kurzer Härte-Check der Änderungen (Advocatus Diaboli):**
+Keine BLOCKER. Die Änderungen sind konsistent mit dem bestehenden Konzept:
+- Pre-Scan fügt 5–15s hinzu, ist aber akzeptabel und parallelisierbar.
+- Jellyfin-Formatierung ist ein klar definierter Output-Step nach dem Ripping.
+- NFO-Generator nutzt Kodi/NFO-Schema (gut dokumentiert, stabil).
+- TMDB-Matching bei Nischentiteln ist ein echtes Risiko, aber der manuelle Korrektur-Mechanismus (Preview + Confidence-Score) behandelt es angemessen.
+- TMDB-Bildrechte sind für private Nutzung OK (TMDB API-ToS).
+
+**Ergebnis:** Konzept nach Commander-Feedback ist wasserdicht.