0.16.1-1 release snapshot

docs/workflows/index.md

@@ -0,0 +1,207 @@
+# Workflows aus Nutzersicht
+
+Diese Seite beschreibt die produktiven Abläufe als Handbuch: welche Entscheidung an welcher Stelle fällt, welche Objekte dabei entstehen (Job, Container, Child-Job) und welche Dateien in welchen Ordnern landen.
+
+## Gemeinsame Grundlagen
+
+### Statuskette im Normalfall
+
+`Medium erkannt` -> `Analyse` -> `Metadatenauswahl` -> `Startbereit` -> `Rippen` -> `Mediainfo-Pruefung` -> `Bereit zum Encodieren` -> `Encodieren` -> `Fertig`
+
+Abweichungen:
+
+- bei Blu-ray/DVD mit nötiger Playlistwahl: `Mediainfo-Pruefung` -> `Warte auf Auswahl` -> zurück in `Mediainfo-Pruefung`
+- bei vorhandenem RAW: `Startbereit` springt direkt in Review/Prüfung ohne neuen Laufwerks-Rip
+- bei Fehler/Abbruch: `Fehler` oder `Abgebrochen` mit Wiederanlauf-Aktionen
+
+### Job- und Container-Typen
+
+| Typ | Zweck | Was enthält der Typ? |
+|---|---|---|
+| Normaler Disc-Job | Einzel-Film oder einzelne Disc | RAW-Pfad, Output-Pfad, Logs, Review |
+| `dvd_series_container` | logischer Serien-Container (pro Serie/Staffel) | Metadatenanker, aggregierter Status über Kinder |
+| `dvd_series_child` | einzelne Serien-Disc oder Serien-Episode-Job | eigentliche RAW-/Encode-Arbeit |
+| `multipart_movie_container` | logischer Multipart-Film-Container | Zusammenfassung für mehrere Film-Discs |
+| `multipart_movie_child` | einzelne Disc innerhalb Multipart-Film | Disc-spezifische RAW-/Encode-Daten |
+
+Wichtig:
+
+- Container sind primär Ordnungs- und Statusobjekte.
+- Dateien (RAW/Output) hängen an den Child-Jobs.
+
+## Workflow A: Film (Blu-ray/DVD)
+
+### 1) Disc analysieren und Film-Metadaten wählen
+
+1. Im `Ripper` `Analyse starten`.
+2. Im Metadaten-Dialog Film auswählen (OMDb bzw. manuelle Film-Metadaten).
+3. `Auswahl übernehmen`.
+
+Wirkung:
+
+- der Job wird als Film-Workflow geführt
+- Film-Fingerprint für Duplikaterkennung wird gebildet (IMDb oder Titel/Jahr)
+
+### 2) Duplikatfall entscheiden
+
+Wenn Film mit gleichem Fingerprint bereits existiert, gibt es zwei Wege:
+
+1. `Übernahme erzwingen` (`allow_new`): neuer unabhängiger Film-Job
+2. `Multipart movie`: neuer Job wird mit bestehendem Job in einem Multipart-Container verknüpft
+
+Bei Multipart gilt:
+
+- beide Discs brauchen unterschiedliche `Disc-Nummer`
+- gleiche Disc-Nummer blockiert den Vorgang (`MULTIPART_DISC_ALREADY_EXISTS`)
+
+### 3) RAW-Verzeichnis entsteht
+
+Ordnername basiert auf Metadaten plus Job-ID:
+
+- `Incomplete_<Titel> (<Jahr>) - RAW - job-<id>`
+
+Zustandswechsel des RAW-Ordners:
+
+- beim Start: `Incomplete_...`
+- nach erfolgreichem Rip: `Rip_Complete_...`
+- nach erfolgreichem Encode: Prefix wird entfernt (final)
+
+### 4) Review und Encode
+
+In `Bereit zum Encodieren`:
+
+- Titel wählen
+- Audio-/Subtitle-Spuren festlegen
+- optional User-Preset
+- optional Pre-/Post-Encode-Skripte oder Ketten
+
+Beim Start:
+
+- temporäre Ausgabe in `Incomplete_job-<id>/<Datei>.<ext>`
+- nach Erfolg Verschiebung in finalen Zielpfad aus Film-Template
+
+## Workflow B: Serie (Blu-ray/DVD)
+
+### 1) Serienmodus aktivieren
+
+1. Disc analysieren.
+2. Im Metadaten-Dialog Serienmetadaten wählen (TMDb-basiert).
+3. `Disc-Nummer` setzen (Pflicht, ab 1).
+
+Wirkung:
+
+- Workflow-Kind wird `series`
+- Seriencontainer wird gesucht/angelegt
+- aktueller Job wird als `dvd_series_child` darunter geführt
+
+### 2) Seriencontainer und Disc-Konflikte
+
+Beim Speichern wird geprüft:
+
+- existiert für Serie/Staffel bereits ein Container?
+- existiert in diesem Container bereits dieselbe `Disc-Nummer`?
+
+Wenn ja, wird blockiert (`SERIES_DISC_ALREADY_EXISTS`).
+
+### 3) Serien-RAW-Pfad
+
+Für Serien wird ein eigener RAW-Pfad bevorzugt:
+
+- Blu-ray: `raw_dir_bluray_series` (Fallback: `raw_dir_bluray`)
+- DVD: `raw_dir_dvd_series` (Fallback: `raw_dir_dvd`)
+
+RAW-Namensbasis enthält Staffel/Disc (`SxDy`) und wird ebenfalls mit den Prefix-Phasen geführt:
+
+- `Incomplete_...` -> `Rip_Complete_...` -> final
+
+### 4) Serien-Review und Episoden-Ausgabe
+
+Beim Review werden Episoden-/Titelzuordnungen genutzt. Je nach Auswahl:
+
+- Einzel-Episode: Episode-Template
+- Multi-Episode-Titel: Multi-Episode-Template
+
+Ausgabepfad:
+
+- Root: `series_dir_*` (Fallback auf `movie_dir_*`)
+- Dateiname/Unterordner aus Serien-Template
+
+### 5) Multi-Episode-Disc als Batch
+
+Wenn mehrere Episoden-Titel aus einer Disc encodiert werden:
+
+- Ripster erzeugt Episode-Child-Jobs
+- der ursprüngliche Disc-Job dient als Batch-Anker
+- RAW-Finalisierung erfolgt erst, wenn alle Episode-Encodes abgeschlossen sind
+
+## Workflow C: Multipart-Film
+
+### Wann dieser Flow gedacht ist
+
+- gleicher Film auf mehreren Discs (z. B. Disc 1/Disc 2)
+- Zusammengehörigkeit soll in Historie und Detailansichten sichtbar sein
+
+### Ablauf
+
+1. Film-Metadaten wählen.
+2. Duplikatdialog -> `Multipart movie`.
+3. Disc-Nummern für bestehenden und neuen Job festlegen.
+
+Wirkung:
+
+- `multipart_movie_container` wird angelegt oder wiederverwendet
+- beteiligte Jobs werden `multipart_movie_child`
+- Container führt gemeinsame Metadaten, Kinder führen je Disc die eigentlichen Artefakte
+
+## Workflow D: Vorhandenes RAW / RAW-Import
+
+### Fall 1: RAW bereits vorhanden bei Metadatenübernahme
+
+Nach Metadaten-Übernahme erkennt Ripster passende RAW-Ordner und setzt den Job auf Entscheidungsstatus.
+
+Möglichkeiten:
+
+- vorhandenes RAW weiterverwenden (kein neuer Rip)
+- RAW löschen/ignorieren und neu rippen
+
+### Fall 2: Orphan-RAW aus `/database`
+
+1. In `Database` `RAW prüfen`.
+2. Bei orphan RAW `Job anlegen`.
+3. Job wird in Historie erzeugt und wie "Disk analysieren aus RAW" weiterverarbeitet.
+
+## Workflow E: Nachbearbeitung bestehender Jobs
+
+In `Historie` (Detaildialog):
+
+| Aktion | Wirkung |
+|---|---|
+| `OMDb neu zuordnen` | Metadaten neu schreiben, Folder-Rename wird best effort angestoßen |
+| `Review neu starten` | Titel-/Spurprüfung aus aktuellem RAW neu aufbauen |
+| `RAW neu encodieren` | Encode erneut aus vorhandenem RAW starten |
+| `Encode neu starten` | letzte bestätigte Review-Einstellungen wiederverwenden |
+| `Retry Rippen` | Rip/Analyse neu starten; alter Job-RAW kann bereinigt werden |
+
+## Wo landet was? (Artefakt-Matrix)
+
+| Artefakt | Film | Serie | Multipart |
+|---|---|---|---|
+| RAW | `raw_dir_*` | bevorzugt `raw_dir_*_series` | pro Child-Job im normalen Film-RAW-Schema |
+| Finale Ausgabe | `movie_dir_*` + Film-Template | `series_dir_*` (Fallback `movie_dir_*`) + Serien-Templates | pro Child-Job normaler Film-Output |
+| Container-Datensatz | nein | ja (`dvd_series_container`) | ja (`multipart_movie_container`) |
+| Löschvorschau in Historie | einzelner Job oder Related Scope | Container-/Child-bezogen mit Pfadauswahl | Container-/Child-bezogen mit Pfadauswahl |
+
+## Queue-Verhalten im Alltag
+
+Die Startfreigabe hängt an vier Settings:
+
+- `Max. parallele Film/Video Encodes`
+- `Max. parallele Audio CD Jobs`
+- `Max. Encodes gesamt`
+- `Audio CDs: Queue-Reihenfolge überspringen`
+
+Praxis:
+
+- Film/Video- und Audio/CD laufen in getrennten Lanes
+- Gesamtlimit begrenzt beide gemeinsam
+- Queue kann neben Jobs auch `Skript`, `Kette`, `Warten` enthalten