0.14.0-4 Docs

docs/getting-started/configuration.md

@@ -1,71 +1,102 @@
 # Ersteinrichtung
 
-Nach der Installation erfolgt die tägliche Konfiguration fast vollständig in der GUI unter `Settings`.
+Diese Seite ist die Betriebs-Checkliste vor dem ersten produktiven Lauf.
 
-## Ziel
+## Ziel der Ersteinrichtung
 
-Vor dem ersten echten Job müssen Pfade, Tools und Metadatenzugriff sauber gesetzt sein.
+Vor dem ersten Job müssen drei Dinge stabil sein:
 
-## Reihenfolge (empfohlen)
+1. Pfade stimmen (RAW, Output, Logs)
+2. Tools sind aufrufbar (MakeMKV, HandBrake, MediaInfo)
+3. Metadatenzugänge funktionieren (OMDb, optional TMDb/MusicBrainz)
 
-### 1. `Settings` -> Tab `Konfiguration`
+## Empfohlene Reihenfolge
 
-Setze zuerst diese Pflichtwerte:
+### 1) Basis in `Settings -> Konfiguration`
 
-| Bereich | Wichtige Felder |
+Setze zuerst:
+
+- `Raw-Ordner` und `Film-/Serien-Ordner`
+- `Log Ordner`
+- `MakeMKV Kommando`, `HandBrake Kommando`, `Mediainfo Kommando`
+- `OMDb API Key`
+
+Dann speichern.
+
+### 2) Profile pro Medium festziehen
+
+Ripster löst viele Werte profilspezifisch auf (`bluray`, `dvd`, `cd`, `audiobook`).
+
+Pflichtprüfung:
+
+- RAW-Pfade je Profil
+- Output-Pfade je Profil
+- HandBrake-Preset je Profil
+- Output-Templates je Profil
+
+Für Serien zusätzlich:
+
+- `RAW-Ordner (Blu-ray/DVD Serie)`
+- `Serien-Ordner (Blu-ray/DVD)`
+- Serien-Templates (Episode/Multi-Episode)
+
+### 3) Queue-Verhalten definieren
+
+Stelle ein:
+
+- `Max. parallele Film/Video Encodes`
+- `Max. parallele Audio CD Jobs`
+- `Max. Encodes gesamt`
+- optional `Audio CDs: Queue-Reihenfolge überspringen`
+
+Damit steuerst du Durchsatz, Priorität und Lastverteilung.
+
+### 4) Metadatenquellen absichern
+
+Film:
+
+- OMDb-Key prüfen
+
+Serien:
+
+- TMDb Read Access Token setzen
+- Sprache/Fallback-Sprachen festlegen
+
+CD/Audiodaten:
+
+- `MusicBrainz aktiviert` nach Bedarf
+
+### 5) Optional: Benachrichtigungen
+
+- PushOver-Zugangsdaten setzen
+- `PushOver Test` ausführen
+- Event-Toggles pro Phase prüfen
+
+### 6) Optional: Automatisierung
+
+1. Skripte testen
+2. Skriptketten bauen/testen
+3. Cronjobs erst danach aktivieren
+
+## Funktionsprüfung (Kurztest)
+
+1. Disc in `Ripper` erkennen lassen.
+2. `Analyse starten`.
+3. Metadaten übernehmen.
+4. Bis `Bereit zum Encodieren` laufen.
+5. Encode starten und Abschluss in `Historie` prüfen.
+
+## Typische Konfigurationsfehler
+
+| Symptom | Häufige Ursache |
 |---|---|
-| Pfade | `Raw Ausgabeordner`, `Film Ausgabeordner`, `Log Ordner` |
-| Tools | `MakeMKV Kommando`, `HandBrake Kommando`, `Mediainfo Kommando` |
-| Metadaten | `OMDb API Key`, optional `OMDb Typ` |
-
-Danach `Änderungen speichern`.
-
-### 2. Medienprofile prüfen
-
-Wenn du Blu-ray und DVD unterschiedlich behandeln willst, pflege die profilbezogenen Felder:
-
-- `*_bluray`
-- `*_dvd`
-- optional `*_other`
-
-Typische Beispiele:
-
-- `HandBrake Preset` (Blu-ray und DVD)
-- `Raw Ausgabeordner` (Blu-ray und DVD)
-- `Dateiname Template` (Blu-ray und DVD)
-
-### 3. Queue und Monitoring festlegen
-
-- `Parallele Jobs` für den gleichzeitigen Durchsatz
-- `Hardware Monitoring aktiviert` + `Hardware Monitoring Intervall (ms)` für Live-Metriken im Ripper
-
-### 4. Optional: Push-Benachrichtigungen
-
-In den Benachrichtigungsfeldern setzen:
-
-- `PushOver aktiviert`
-- `PushOver Token`
-- `PushOver User`
-
-Dann über `PushOver Test` direkt prüfen.
-
-## 2-Minuten-Funktionstest
-
-1. `Ripper` öffnen
-2. Disc einlegen
-3. `Analyse starten`
-4. Metadaten übernehmen
-5. Bis `Bereit zum Encodieren` laufen lassen
-
-Wenn diese Schritte funktionieren, ist die Grundkonfiguration korrekt.
-
-## Wenn Werte nicht gespeichert werden
-
-- Feld mit Fehler markieren lassen (rote Validierung im Formular)
-- Pfadangaben und numerische Werte prüfen
-- bei Tool-Pfaden direkt CLI-Aufruf im Terminal testen
+| Job bleibt früh auf Fehler | Toolkommando falsch oder nicht im PATH |
+| RAW/Output landet am falschen Ort | Profilpfade nicht gesetzt, Fallback greift |
+| Serienausgabe landet bei Filmen | Serienpfade/Serientemplates fehlen |
+| Queue verhält sich unerwartet | Gesamtlimit und Lane-Limits widersprechen sich |
 
 ## Weiter
 
 - [Erster Lauf](quickstart.md)
-- [GUI-Seiten im Detail](../gui/index.md)
+- [GUI-Seiten](../gui/index.md)
+- [Workflows aus Nutzersicht](../workflows/index.md)

docs/getting-started/quickstart.md

@@ -1,19 +1,21 @@
 # Erster Lauf
 
-Dieser Ablauf zeigt einen vollständigen Job aus Anwendersicht: von Disc-Erkennung bis fertiger Datei.
+Dieser Ablauf führt einen vollständigen Disc-Job von Erkennung bis fertiger Datei durch.
 
-## 1. Ripper öffnen und Disc einlegen
+## 1) Disc erkennen
 
-Erwartung:
+1. `Ripper` öffnen.
+2. Disc einlegen.
+3. Auf `Medium erkannt` warten.
 
-- Status wechselt auf `Medium erkannt`
-- im Bereich `Disk-Information` sind Laufwerksdaten sichtbar
+Prüfen:
 
-Wenn nichts passiert: `Laufwerk neu lesen`.
+- `Disk-Information` zeigt Device/Label.
+- Falls nicht: `Laufwerk neu lesen`.
 
-## 2. Analyse starten
+## 2) Analyse starten
 
-Aktion im Ripper:
+Aktion:
 
 - `Analyse starten`
 
@@ -22,49 +24,67 @@ Erwartung:
 - Status `Analyse`
 - danach Metadaten-Dialog
 
-## 3. Metadaten auswählen
+## 3) Metadaten bestätigen
 
-Im Dialog `Metadaten auswählen`:
+Im Dialog:
 
-1. OMDb-Suche nutzen oder manuell eintragen
-2. passenden Treffer markieren
-3. `Auswahl übernehmen`
+1. Treffer suchen/auswählen.
+2. Bei Serie zusätzlich Disc-Nummer setzen.
+3. `Auswahl übernehmen`.
 
-## 4. Auf den nächsten Zustand reagieren
+Mögliche Abzweigungen:
 
-- Normalfall ohne vorhandenes RAW: `Rippen` -> `Mediainfo-Pruefung` -> `Bereit zum Encodieren`
-- bei vorhandenem RAW: direkt `Mediainfo-Pruefung` -> `Bereit zum Encodieren`
-- bei unklarer Blu-ray-Playlist: `Warte auf Auswahl` (Playlist auswählen und übernehmen)
+- Duplikatfilm -> `Übernahme erzwingen` oder `Multipart movie`
+- vorhandenes RAW -> Entscheidungsdialog (weiterverwenden oder neu rippen)
 
-## 5. Review in `Bereit zum Encodieren`
+## 4) Rip/Review-Phase
 
-Im aufgeklappten Job (`Pipeline-Status`):
+Normalfall:
 
-- Encode-Titel wählen
+- `Startbereit` -> `Rippen` -> `Mediainfo-Pruefung`
+
+Mögliche Alternativen:
+
+- vorhandenes RAW: direkter Sprung in Prüfung
+- Blu-ray/DVD-Entscheidung nötig: `Warte auf Auswahl` für Playlist/Titel
+
+## 5) Encode-Review abschließen
+
+Bei `Bereit zum Encodieren`:
+
+- Titel festlegen
 - Audio-/Subtitle-Spuren prüfen
-- optional User-Preset auswählen
-- optional Pre-/Post-Skripte bzw. Ketten hinzufügen
+- optional Preset auswählen
+- optional Pre-/Post-Skripte wählen
 
-Dann `Encoding starten`.
+Dann:
 
-## 6. Encoding überwachen
+- `Encoding starten`
+
+## 6) Encoding überwachen
 
 Während `Encodieren`:
 
-- Fortschritt + ETA im Ripper
-- Live-Log im `Pipeline-Status`
-- Queue- und Skript/Cron-Status parallel beobachtbar
+- Fortschritt/ETA im Ripper
+- Queue- und Runtime-Status beobachten
+- optional Logkontrolle in Historie
 
-## 7. Ergebnis prüfen
+## 7) Ergebnis verifizieren
 
-Bei `Fertig`:
+Nach `Fertig`:
 
-1. Seite `Historie` öffnen
-2. Job in Details öffnen
-3. Output-Pfad, Status und Log prüfen
+1. `Historie` öffnen.
+2. Jobdetail prüfen.
+3. Output-Pfad und Log plausibilisieren.
 
-## Typische Folgeaktionen
+Kontrollpunkte:
 
-- Falsches OMDb-Match: in `Historie` -> `OMDb neu zuordnen`
-- Neue Encodierung aus RAW: `RAW neu encodieren`
-- Prüfung komplett neu aufbauen: `Review neu starten`
+- finale Datei am erwarteten Template-Pfad
+- RAW-Ordnerzustand finalisiert (kein `Incomplete_`)
+
+## 8) Typische Folgeaktionen
+
+- falsche Metadaten: `OMDb neu zuordnen`
+- andere Trackauswahl: `Review neu starten`
+- erneuter Encode aus RAW: `RAW neu encodieren`
+- gleicher Plan erneut: `Encode neu starten`