0.14.0-4 Merger

2026-04-21 14:27:07 +00:00
parent caf6a638f7
commit c27a81cdb1
127 changed files with 10643 additions and 335 deletions
@@ -95,6 +95,18 @@ Erzwingt erneute Laufwerksprüfung.

 ---

+## POST /api/pipeline/rescan-drive
+
+Erzwingt Rescan für ein konkretes Laufwerk.
+
+**Request:**
+
+```json
+{ "devicePath": "/dev/sr0" }
+```
+
+---
+
 ## GET /api/pipeline/omdb/search?q=<query>

 OMDb-Titelsuche.
@@ -117,6 +129,78 @@ OMDb-Titelsuche.

 ---

+## GET /api/pipeline/tmdb/series/search?q=<query>&season=<n>
+
+TMDb-Seriensuche (für Serien-Workflow bei DVD/Blu-ray).
+
+---
+
+## GET /api/pipeline/cd/drives
+
+Liefert Snapshot der aktuell bekannten CD-Laufwerke.
+
+---
+
+## GET /api/pipeline/cd/musicbrainz/search?q=<query>
+
+MusicBrainz-Suche für CD-Metadaten.
+
+## GET /api/pipeline/cd/musicbrainz/release/:mbId
+
+Lädt Release-Details zu einer MusicBrainz-ID.
+
+## POST /api/pipeline/cd/select-metadata
+
+Übernimmt CD-Metadaten für einen Job.
+
+**Request (Beispiel):**
+
+```json
+{
+  "jobId": 91,
+  "title": "Album",
+  "artist": "Artist",
+  "year": 2020,
+  "mbId": "f5093c06-23e3-404f-aeaa-40f72885ee3a",
+  "coverUrl": "https://...",
+  "tracks": []
+}
+```
+
+## POST /api/pipeline/cd/start/:jobId
+
+Startet/queued CD-Rip mit Format-/Script-/Chain-Konfiguration.
+
+---
+
+## POST /api/pipeline/audiobook/upload
+
+Upload von AAX-Datei (Multipart/FormData).
+
+**FormData-Felder:**
+
+- `file` (Pflicht)
+- `format` (optional)
+- `startImmediately` (optional)
+
+## GET /api/pipeline/audiobook/pending-activation
+
+Zeigt AAX-Jobs mit fehlenden Activation-Bytes.
+
+## POST /api/pipeline/audiobook/start/:jobId
+
+Startet Audiobook-Job mit optionaler Konfiguration.
+
+## GET /api/pipeline/audiobook/jobs
+
+Liefert Audiobook-Jobliste.
+
+## GET /api/pipeline/audiobook/output-tree
+
+Read-only Baumansicht des Audiobook-Ausgabeordners.
+
+---
+
 ## POST /api/pipeline/select-metadata

 Setzt Metadaten (und optional Playlist) für einen Job.
@@ -135,12 +219,69 @@ Setzt Metadaten (und optional Playlist) für einen Job.
 }
 ```

+Wichtige optionale Felder:
+
+- `selectedHandBrakeTitleId` / `selectedHandBrakeTitleIds`: Titel-Auswahl für Review/MediaInfo.
+- `metadataProvider`: `omdb` oder `tmdb`.
+- `workflowKind`: bei Disc-Jobs typischerweise `film` oder `series`.
+- `discNumber`: Pflicht für Serien-Disc-Zuordnung (`workflowKind=series`).
+- `duplicateAction`: Duplikatverhalten bei Film-Metadaten (`allow_new` oder `multipart_movie`).
+- `existingJobId`: optionaler Referenzjob für `multipart_movie`.
+- `existingDiscNumber`: Disc-Nummer des bestehenden Jobs für `multipart_movie`.
+
 **Response:**

 ```json
 { "job": { "id": 42, "status": "READY_TO_START" } }
 ```

+**Konflikt-Response (Beispiel, HTTP 409):**
+
+```json
+{
+  "message": "Metadaten bereits in der Historie gefunden. Bitte Auswahl übernehmen oder Multipart movie wählen.",
+  "details": [
+    {
+      "code": "METADATA_DUPLICATE_FOUND",
+      "mediaProfile": "bluray",
+      "existingJob": {
+        "id": 17,
+        "title": "Inception",
+        "year": 2010,
+        "status": "FINISHED",
+        "jobKind": "bluray",
+        "discNumber": 1,
+        "isMultipartMovie": false
+      }
+    }
+  ]
+}
+```
+
+**Relevante Fehlercodes (`POST /api/pipeline/select-metadata`):**
+
+| Code | Bedeutung |
+|---|---|
+| `METADATA_DUPLICATE_FOUND` | Film-Metadaten existieren bereits in der Historie (Konfliktdialog im UI). |
+| `MULTIPART_DISC_REQUIRED` | Für Multipart fehlen Disc-Nummern (`discNumber`/`existingDiscNumber`). |
+| `MULTIPART_DISC_ALREADY_EXISTS` | Disc-Nummer im Multipart-Container bereits vergeben oder doppelt. |
+| `MULTIPART_MEDIA_MISMATCH` | Multipart nur bei gleichem Medientyp (DVD oder Blu-ray). |
+| `MULTIPART_SERIES_NOT_ALLOWED` | Multipart ist nur für Film-Jobs erlaubt, nicht für Serien-Workflow. |
+| `MULTIPART_METADATA_MISMATCH` | Ausgewählter bestehender Job passt nicht zu den Film-Metadaten. |
+| `SERIES_DISC_ALREADY_EXISTS` | Serien-Disc-Nummer innerhalb einer Staffel bereits vorhanden. |
+
+---
+
+## POST /api/pipeline/jobs/:jobId/raw-decision
+
+Trifft Entscheidung bei vorhandenem RAW (`continue` oder `restart` je nach Dialogfluss).
+
+**Request:**
+
+```json
+{ "decision": "continue" }
+```
+
 ---

 ## POST /api/pipeline/start/:jobId
@@ -233,10 +374,28 @@ Berechnet Review aus RAW neu.

 Startet Encoding mit letzter bestätigter Review neu.

+## POST /api/pipeline/restart-cd-review/:jobId
+
+Berechnet CD-Review aus vorhandenem RAW neu.
+
 ## POST /api/pipeline/resume-ready/:jobId

 Lädt `READY_TO_ENCODE`-Job nach Neustart wieder in aktive Session.

+## GET /api/pipeline/output-folders/:jobId
+
+Liefert bekannte Output-Ordner entlang der Job-Lineage.
+
+## POST /api/pipeline/delete-output-folders/:jobId
+
+Löscht ausgewählte Output-Ordner.
+
+**Request:**
+
+```json
+{ "folderPaths": ["/mnt/movies/Inception (2010)"] }
+```
+
 Alle Endpunkte liefern `{ result: ... }` bzw. `{ job: ... }`.

 ---
@@ -358,12 +517,18 @@ Entfernt Queue-Eintrag.
 | `DISC_DETECTED` | Medium erkannt |
 | `ANALYZING` | MakeMKV-Analyse läuft |
 | `METADATA_SELECTION` | Metadaten-Auswahl |
-| `WAITING_FOR_USER_DECISION` | Playlist-Entscheidung erforderlich |
+| `WAITING_FOR_USER_DECISION` | Nutzerentscheidung erforderlich (Playlist-Auswahl oder RAW-Entscheidung) |
 | `READY_TO_START` | Übergang vor Start |
 | `RIPPING` | MakeMKV-Rip läuft |
 | `MEDIAINFO_CHECK` | Titel-/Track-Auswertung |
 | `READY_TO_ENCODE` | Review bereit |
 | `ENCODING` | HandBrake-Encoding läuft |
+| `CD_METADATA_SELECTION` | CD-Metadatenauswahl aktiv |
+| `CD_READY_TO_RIP` | CD-Job ist startbereit |
+| `CD_ANALYZING` | CD-Struktur/Tracks werden vorbereitet |
+| `CD_RIPPING` | CD-Ripping läuft |
+| `CD_ENCODING` | CD-Encode läuft |
 | `FINISHED` | Abgeschlossen |
+| `DONE` | Abgeschlossen (v. a. Audiobook/Converter/CD-Varianten) |
 | `CANCELLED` | Abgebrochen |
 | `ERROR` | Fehler |