0.14.0-4 Docs

docs/gui/history.md

@@ -1,88 +1,89 @@
 # Historie
 
-Die Seite `Historie` ist für Suche, Prüfung und Nachbearbeitung bestehender Jobs.
+`Historie` ist die Kontroll- und Nachbearbeitungsoberfläche für alle bereits angelegten Jobs.
 
 ## Hauptansicht
 
-Filter und Werkzeuge:
+Filter und Arbeitsmittel:
 
-- Suche (Titel/IMDb)
-- Status-Filter
-- Medium-Filter (`Blu-ray`, `DVD`, `Sonstiges`)
+- Suche (Titel, IMDb, Kontextbegriffe)
+- Statusfilter
+- Mediumfilter
 - Sortierung
 - Listen-/Grid-Layout
 
-Jeder Eintrag zeigt:
+Jeder Eintrag zeigt auf einen Blick:
 
-- Poster, Titel, Jahr, IMDb
-- Medium-Indikator
-- Status
-- Start/Ende
-- Verfügbarkeit von RAW/Movie
-- Ratings (wenn OMDb-Daten vorhanden)
+- Titel, Jahr, Poster
+- Status und Zeitstempel
+- RAW-/Output-Verfügbarkeit
+- Medien- und ggf. Containerhinweise
 
-Klick auf einen Eintrag öffnet die Detailansicht.
+## Detaildialog: Was dort zusammenläuft
 
----
+Der Detaildialog bündelt:
 
-## Job-Detaildialog
+- Metadaten (Film oder Serie)
+- Jobstatus und Fehlertexte
+- RAW-/Output-Pfade
+- Encode-Plan und Trackauswahl
+- ausgeführte Kommandodetails
+- Prozesslog (`Tail` oder vollständig)
 
-Bereiche:
+Bei Seriencontainern wird disk-/child-orientiert dargestellt, nicht nur als Einzeljob.
 
-- Film-Infos + OMDb-Details
-- Job-Infos (Status, Pfade, Erfolgsflags, Fehler)
-- hinterlegte Encode-Auswahl
-- ausgeführter HandBrake-Befehl
-- strukturierte JSON-Blöcke (OMDb/MakeMKV/MediaInfo/EncodePlan/HandBrake)
-- Log-Ladefunktionen (`Tail`, `Vollständig`)
+## Nachbearbeitungsaktionen und Wirkung
 
-Bei Serien-Containern zeigt der Dialog statt eines globalen Log-Blocks einen `Disks`-Bereich mit einzelnen Disk-Akkordeons.
-Jede Disk kann dort separat geprüft und bearbeitet werden.
+| Aktion | Typischer Einsatz | Technische Wirkung |
+|---|---|---|
+| `OMDb neu zuordnen` | falsches Match, Titel/Jahr korrigieren | Metadatenfelder werden neu geschrieben; Folder-Rename wird best effort angestoßen |
+| `Review neu starten` | neue Track-/Titelbewertung nötig | Mediainfo/Review wird aus RAW neu aufgebaut |
+| `RAW neu encodieren` | neuer Encode aus vorhandenem RAW | startet Encode ohne neuen Laufwerks-Rip |
+| `Encode neu starten` | gleiche bestätigte Auswahl erneut fahren | letzter bestätigter Plan wird geladen, optional mit Bereinigung unvollständiger Ausgabe |
+| `Retry Rippen` | Rip/Analyse neu anstoßen | neuer Rip-Lauf, inkl. erneuter RAW-Phase |
 
-## Typische Aktionen im Detaildialog
+Löschaktionen im Dialog:
 
-- `OMDb neu zuordnen`
-- `Encode neu starten`
-- `Review neu starten`
-- `RAW neu encodieren`
-- `RAW löschen`, `Movie löschen`, `Beides löschen`
+- `RAW löschen`
+- `Movie löschen`
+- `Beides löschen`
 - `Historieneintrag löschen`
-- bei Queue-Lock: `Aus Queue löschen`
 
-Zusätzlich bei Serien-Container-Disks:
+## Löschvorschau und selektives Löschen
 
-- `Im Ripper öffnen` (für `READY_TO_ENCODE`-Kinder)
-- diskbezogene Löschaktionen (`RAW`, `Folgen`, `Beides`) mit Child-/Subjob-Scope
-- diskbezogenes Löschen des Historieneintrags (inkl. Subjobs)
+Vor endgültigem Löschen zeigt Ripster eine Vorschau mit:
 
-## Wann welche Aktion?
+- `RAW`-Kandidaten
+- `Movie`-/Episoden-Kandidaten
+- Related-Scope (Container/Kinder/verbundene Jobs)
 
-| Ziel | Aktion |
-|---|---|
-| Metadaten korrigieren | `OMDb neu zuordnen` |
-| mit gleicher bestätigter Auswahl neu encodieren | `Encode neu starten` |
-| Titel-/Spurprüfung komplett neu berechnen | `Review neu starten` |
-| aus vorhandenem RAW erneut encodieren | `RAW neu encodieren` |
-| Speicher freigeben | Dateilöschaktionen |
+Wichtige Punkte:
 
----
+- Pfade sind selektierbar.
+- Für RAW-Löschung muss bei Mehrfachkandidaten mindestens ein RAW-Pfad gewählt werden.
+- Schutzlogik verhindert Löschungen außerhalb erlaubter Root-Verzeichnisse.
 
-## Löschen mit Vorschau
+## Serien- und Multipart-Sicht in der Historie
 
-Beim Löschen eines Historieneintrags (`Eintrag löschen`) gibt es eine Pfadvorschau:
+### Serien
 
-- getrennt nach `RAW` und Ausgabe (`Movie`/`Folgen`)
-- für Serien-/Multipart-Fälle mit Scope auf verknüpfte Jobs
-- selektierbare Pfade vor dem finalen Löschen
+- Container zeigt aggregierten Zustand aus Child-Jobs.
+- Disk-/Episode-Aktionen können child-spezifisch ausgeführt werden.
+- `Im Ripper öffnen` hilft bei `Bereit zum Encodieren`-Kindern.
 
-Neu im RAW-Bereich:
+### Multipart
 
-- bei mehreren RAW-Kandidaten kann pro Pfad gewählt werden, was entfernt wird
-- mindestens ein RAW-Pfad muss gewählt sein, wenn RAW-Löschung Teil der Aktion ist
+- gemeinsamer Container mit Disc-Childs
+- Disc-Nummern bleiben pro Child nachvollziehbar
+- Delete-Preview kann Related-Pfade gemeinsam auflösen
 
-Die Buttons (`Eintrag + nur RAW`, `Eintrag + nur ...`, `Eintrag + RAW + ...`) berücksichtigen die aktuelle Pfadauswahl und deaktivieren sich bei unvollständiger Auswahl.
+## Logs sinnvoll nutzen
 
-## Logs
+- `Tail laden (800)` für schnellen Fehlerkontext
+- `Vollständiges Log laden` für forensische Analyse
 
-- `Tail laden (800)` für schnelle Fehleranalyse
-- `Vollständiges Log laden` für vollständige Nachverfolgung
+Empfehlung:
+
+1. Erst Tail prüfen.
+2. Bei Pfad-/Toolproblemen vollständiges Log laden.
+3. Danach passende Wiederanlauf-Aktion wählen.