1.0.0 release snapshot

2026-06-12 11:17:44 +02:00
parent 6115090da1
commit c9ad6b2f06
274 changed files with 138472 additions and 1 deletions
@@ -0,0 +1,290 @@
+# Converter API
+
+Endpunkte für den Datei-Converter: Datei-Explorer, Upload, Job-Verwaltung.
+
+Basis-Pfad: `/api/converter`
+
+---
+
+## Scan & Explorer
+
+### `GET /api/converter/tree`
+
+Vollständiger Verzeichnisbaum des `converter_raw_dir` (FS-basiert, keine DB).
+
+**Response:**
+
+```json
+{
+  "tree": [
+    {
+      "name": "filme",
+      "relPath": "filme",
+      "isDir": true,
+      "children": [
+        {
+          "name": "film.mkv",
+          "relPath": "filme/film.mkv",
+          "isDir": false,
+          "size": 10485760
+        }
+      ]
+    }
+  ]
+}
+```
+
+---
+
+### `GET /api/converter/browse?parent=relPath`
+
+DB-basierter Datei-Explorer. Gibt Einträge für einen Unterordner zurück.
+
+**Query-Parameter:**
+
+| Parameter | Typ | Beschreibung |
+|---|---|---|
+| `parent` | string | Relativer Pfad zum Unterordner (leer = Root) |
+
+**Response:**
+
+```json
+{
+  "entries": [
+    {
+      "id": 1,
+      "rel_path": "filme/film.mkv",
+      "is_dir": false,
+      "size": 10485760,
+      "job_id": null
+    }
+  ],
+  "rawDir": "/data/output/converter-raw"
+}
+```
+
+---
+
+### `POST /api/converter/scan`
+
+Manuellen Scan des `converter_raw_dir` auslösen. Aktualisiert `converter_scan_entries` in der DB.
+
+**Response:**
+
+```json
+{ "result": { "added": 3, "removed": 1 } }
+```
+
+---
+
+## Jobs erstellen
+
+### `POST /api/converter/jobs/from-selection`
+
+Jobs aus im Datei-Explorer ausgewählten Dateien erstellen.
+
+**Body:**
+
+```json
+{
+  "relPaths": ["filme/film.mkv", "musik/track.flac"],
+  "audioMode": "individual"
+}
+```
+
+| Feld | Typ | Beschreibung |
+|---|---|---|
+| `relPaths` | string[] | Relative Pfade der ausgewählten Dateien |
+| `audioMode` | string | `individual` (ein Job pro Datei) oder `shared` (ein gemeinsamer Job) |
+
+**Response:**
+
+```json
+{ "jobs": [{ "id": 42, "status": "READY_TO_START" }] }
+```
+
+---
+
+### `POST /api/converter/create-jobs`
+
+Jobs aus DB-Scan-Einträgen erstellen.
+
+**Body:**
+
+```json
+{
+  "entries": [
+    { "relPath": "filme/film.mkv", "converterMediaType": "video" }
+  ]
+}
+```
+
+---
+
+### `POST /api/converter/upload`
+
+Dateien hochladen (Multipart, max. 50 Dateien).
+
+**Form-Felder:**
+
+| Feld | Typ | Beschreibung |
+|---|---|---|
+| `files` | File[] | Hochzuladende Dateien |
+| `folderName` | string | (Optional) Ziel-Unterordner |
+
+**Response:**
+
+```json
+{
+  "folders": [{ "folderRelPath": "upload-2026-03-30", "fileCount": 2 }]
+}
+```
+
+---
+
+## Job-Verwaltung
+
+### `GET /api/converter/jobs`
+
+Alle Converter-Jobs zurückgeben.
+
+**Response:**
+
+```json
+{ "jobs": [{ "id": 42, "status": "READY_TO_START", "title": "film.mkv" }] }
+```
+
+---
+
+### `GET /api/converter/jobs/:jobId`
+
+Einzelnen Converter-Job abrufen.
+
+---
+
+### `POST /api/converter/jobs/:jobId/config`
+
+Konfigurationsentwurf für einen Job speichern (persistiert in `encode_plan_json`).
+
+**Body:** Partielles Konfig-Objekt (Ausgabeformat, Presets, Metadaten, Track-Auswahl).
+
+---
+
+### `POST /api/converter/jobs/:jobId/assign-files`
+
+Dateien einem bestehenden (noch nicht gestarteten) Job hinzufügen.
+
+**Body:**
+
+```json
+{ "relPaths": ["musik/track2.flac"] }
+```
+
+---
+
+### `POST /api/converter/jobs/:jobId/remove-file`
+
+Datei aus einem Job entfernen (per relativer Pfad).
+
+**Body:**
+
+```json
+{ "relPath": "musik/track2.flac" }
+```
+
+---
+
+### `POST /api/converter/jobs/:jobId/remove-input`
+
+Datei aus einem Job entfernen (per absolutem Eingabepfad).
+
+**Body:**
+
+```json
+{ "inputPath": "/data/output/converter-raw/musik/track2.flac" }
+```
+
+---
+
+### `POST /api/converter/jobs/:jobId/start`
+
+Job mit finaler Konfiguration starten.
+
+**Body:**
+
+```json
+{
+  "converterMediaType": "video",
+  "outputFormat": "mkv",
+  "userPreset": "H.264 MKV 1080p30",
+  "trackSelection": {},
+  "handBrakeTitleId": 1,
+  "audioFormatOptions": {}
+}
+```
+
+---
+
+### `POST /api/converter/jobs/:jobId/cancel`
+
+Laufenden Job abbrechen.
+
+---
+
+### `DELETE /api/converter/jobs/:jobId`
+
+Job aus der DB löschen.
+
+---
+
+## Datei-Operationen
+
+Alle Datei-Operationen arbeiten direkt auf dem Dateisystem (ohne DB-Aktualisierung). Ein anschließender Scan-Aufruf synchronisiert die DB.
+
+### `DELETE /api/converter/files`
+
+Datei oder Ordner löschen.
+
+**Body:**
+
+```json
+{ "relPath": "filme/film.mkv" }
+```
+
+---
+
+### `POST /api/converter/files/rename`
+
+Datei oder Ordner umbenennen.
+
+**Body:**
+
+```json
+{ "relPath": "filme/film.mkv", "newName": "film-neu.mkv" }
+```
+
+---
+
+### `POST /api/converter/files/move`
+
+Datei oder Ordner verschieben.
+
+**Body:**
+
+```json
+{ "relPath": "filme/film.mkv", "targetParentRelPath": "archiv" }
+```
+
+`targetParentRelPath = ""` verschiebt in das Root-Verzeichnis.
+
+---
+
+### `POST /api/converter/files/folder`
+
+Neuen Ordner anlegen.
+
+**Body:**
+
+```json
+{ "parentRelPath": "filme", "name": "neu" }
+```