0.12.0-17 Misc fixes

2026-03-30 19:15:23 +00:00
parent 5284dd2a43
commit c67ac593de
29 changed files with 1596 additions and 117 deletions
@@ -1,6 +1,42 @@
 # Backend-Services

-Das Backend ist in Services aufgeteilt, die von Express-Routen orchestriert werden.
+Das Backend ist in Services aufgeteilt, die von Express-Routen orchestriert werden. Seit v0.12.0 erfolgt die Medienverarbeitung über ein **Plugin-System**.
+
+---
+
+## Plugin-System (`src/plugins/`)
+
+Ab v0.12.0 ist die Pipeline modular aufgebaut. Jeder Medientyp wird von einem eigenen Plugin verwaltet.
+
+### Basisklassen
+
+- **`PluginBase.js`** — Abstrakte Basisklasse `SourcePlugin` mit Lifecycle-Methoden
+- **`PluginRegistry.js`** — Dynamische Plugin-Erkennung, prioritätsbasierte Auswahl, Settings-Schema-Aggregation
+- **`PluginContext.js`** — Ausführungskontext (Logger, Callbacks, Signals) für Plugin-Aufrufe
+
+### Plugin-Lifecycle
+
+Jedes Plugin implementiert die folgenden Methoden:
+
+| Methode | Beschreibung |
+|---|---|
+| `detect(discInfo)` | Medientyp-Erkennung |
+| `analyze(devicePath, job, ctx)` | Analyse / Metadaten-Extraktion |
+| `rip(job, ctx)` | Rohdaten-Extraktion |
+| `review(job, ctx)` | Optionale Vorschau-Vorbereitung |
+| `encode(job, ctx)` | Finales Encoding/Konvertierung |
+| `finalize(job, ctx)` | Nachbearbeitung |
+| `onCancel(job, ctx)` | Bereinigung bei Abbruch |
+| `onRetry(job, ctx)` | Zustand-Reset vor Retry |
+
+### Implementierte Plugins
+
+- **`BluRayPlugin.js`** — Blu-ray via MakeMKV (Backup-Modus)
+- **`DVDPlugin.js`** — DVD via MakeMKV (MKV-Modus)
+- **`CdPlugin.js`** — Audio-CD via cdparanoia + FFmpeg (experimentell)
+- **`AudiobookPlugin.js`** — AAX/M4B via FFmpeg mit Kapitel-Splitting
+- **`ConverterPlugin.js`** — Generische Audio/Video-Konvertierung via FFmpeg
+- **`VideoDiscPlugin.js`** — Gemeinsame Basis für Blu-ray/DVD (MediaInfo-Parsing)

 ---

@@ -11,10 +47,11 @@ Zentrale Workflow-Orchestrierung.
 Aufgaben:

 - Pipeline-State-Machine + Persistenz (`pipeline_state`)
- Disc-Analyse/Rip/Review/Encode
+- Disc-Analyse/Rip/Review/Encode via Plugin-Delegation
 - Queue-Management (Jobs + `script|chain|wait` Einträge)
 - Retry/Re-Encode/Restart-Flows
 - WebSocket-Broadcasts für State/Progress/Queue
+- Converter-Job-Verwaltung (`createConverterJobFromEntry`, `uploadConverterFiles`, `startConverterJob`)

 Wichtige Methoden:

@@ -29,6 +66,8 @@ Wichtige Methoden:
 - `restartEncodeWithLastSettings()`
 - `resumeReadyToEncodeJob()`
 - `enqueueNonJobEntry()`, `reorderQueue()`, `removeQueueEntry()`
+- `createConverterJobFromEntry()`, `createConverterJobsFromSelection()`
+- `uploadConverterFiles()`, `startConverterJob()`

 ---

@@ -57,9 +96,10 @@ Features:
 - `getCategorizedSettings()` für UI-Form
 - `setSettingValue()` / `setSettingsBulk()`
 - profilspezifische Auflösung (`resolveEffectiveToolSettings`)
- CLI-Config-Building für MakeMKV/HandBrake/MediaInfo
+- CLI-Config-Building für MakeMKV/HandBrake/MediaInfo/FFmpeg
 - HandBrake-Preset-Liste via `HandBrakeCLI -z`
 - MakeMKV-Registration-Command aus `makemkv_registration_key`
+- Pfadauflösung für alle Medienprofile inkl. Audiobook und Converter

 ---

@@ -77,6 +117,59 @@ Features:

 ---

+## `audiobookService.js`
+
+Audiobook-Verarbeitung (AAX/M4B).
+
+Features:
+
+- FFprobe-basierte Analyse (Kapitel, Metadaten)
+- FFmpeg-basiertes Encoding mit Kapitel-Splitting
+- Ausgabeformate: M4B, MP3, FLAC
+- Template-basierte Pfade (`{author}`, `{title}`, `{year}`, `{narrator}`, `{series}`, `{part}`)
+
+---
+
+## `activationBytesService.js`
+
+Verwaltung von Audible-Activation-Bytes für AAX-DRM-Handling.
+
+Features:
+
+- SHA-1-Prüfsumme der AAX-Datei berechnen
+- Activation Bytes in `aax_activation_bytes`-Tabelle cachen
+- Lookup via `audnexService` (wenn konfiguriert)
+
+---
+
+## `converterScanService.js`
+
+Dateisystem-Überwachung des Converter-Eingangsordners.
+
+Features:
+
+- Vollständiger FS-Baum (`getTree()`)
+- DB-basierter Datei-Explorer (`getEntries()`)
+- Manueller und automatischer Scan (Polling)
+- Pfad-Normalisierung mit Traversal-Schutz
+- WebSocket-Broadcast: `CONVERTER_SCAN_UPDATE`
+
+---
+
+## `downloadService.js`
+
+Download-Queue für Ausgabedateien aus der Historie.
+
+Features:
+
+- Job in Download-Queue einreihen (`enqueueHistoryJob`)
+- ZIP-Archiv aus Ausgabedateien erstellen (`archiver`)
+- Datei-Streaming via `res.download()`
+- WebSocket-Broadcast: `DOWNLOADS_UPDATED` bei Status-Änderungen
+- Download-Item löschen
+
+---
+
 ## `cronService.js`

 Integriertes Cron-System ohne externe Parser-Library.
@@ -124,6 +217,12 @@ Vollständige API-Dokumentation: [Runtime Activities API](../api/runtime-activit
 - `hardwareMonitorService.js` (CPU/RAM/GPU/Storage)
 - `websocketService.js` (Client-Registry + Broadcast)
 - `notificationService.js` (PushOver)
+- `cdRipService.js` (CD-Ripping mit cdparanoia)
+- `musicBrainzService.js` (MusicBrainz-Metadaten-Lookup)
+- `audnexService.js` (Audnex-API für Audiobook-Metadaten)
+- `coverArtRecoveryService.js` (Cover-Art-Wiederherstellung)
+- `thumbnailService.js` (Vorschaubild-Generierung)
+- `omdbService.js` (OMDb-Metadaten-Suche)
 - `logger.js` (rotierende Datei-Logs)

 ---
@@ -133,9 +232,10 @@ Vollständige API-Dokumentation: [Runtime Activities API](../api/runtime-activit
 Beim Start:

 1. DB init/migrate
-2. Pipeline-Init
+2. Pipeline-Init (inkl. Plugin-Registry)
 3. Cron-Init
 4. Express-Routes + Error-Handler
 5. WebSocket-Server auf `/ws`
 6. Hardware-Monitoring-Init
 7. Disk-Detection-Start
+8. Converter-Scan-Service-Init (Polling falls aktiviert)
@@ -10,6 +10,8 @@ Ripster verwendet SQLite (`backend/data/ripster.db`).
 settings_schema
 settings_values
 jobs
+job_lineage_artifacts
+job_output_folders
 pipeline_state
 scripts
 script_chains
@@ -17,6 +19,9 @@ script_chain_steps
 user_presets
 cron_jobs
 cron_run_logs
+aax_activation_bytes
+user_prefs
+converter_scan_entries
 ```

 ---
@@ -32,10 +37,38 @@ Zentrale Felder:
 - Pfade: `raw_path`, `output_path`, `encode_input_path`
 - Tool-Ausgaben: `makemkv_info_json`, `handbrake_info_json`, `mediainfo_info_json`, `encode_plan_json`
 - Kontrolle: `encode_review_confirmed`, `rip_successful`, `error_message`
+- Medientyp: `media_type` (`bluray|dvd|cd|audiobook|converter`)
+- Prüfsumme: `aax_checksum` (für AAX-Dateien)
 - Audit: `created_at`, `updated_at`

 ---

+## `job_lineage_artifacts`
+
+Verknüpft Jobs mit ihren Quell-Jobs (z. B. Re-Encode aus einem vorherigen Rip).
+
+Felder:
+
+- `job_id` — der abgeleitete Job
+- `source_job_id` — der Quell-Job
+- `artifact_type` — Art der Verknüpfung (z. B. `reencode`, `restart_review`)
+- `created_at`
+
+---
+
+## `job_output_folders`
+
+Verfolgt Ausgabepfade pro Job (mehrere Ausgaben möglich, z. B. bei Kapitel-Splitting).
+
+Felder:
+
+- `job_id`
+- `folder_path`
+- `label` — optionaler Bezeichner
+- `created_at`
+
+---
+
 ## `pipeline_state`

 Singleton-Tabelle (`id = 1`) für aktiven Snapshot:
@@ -89,6 +122,45 @@ Benannte HandBrake-Preset-Sets:

 ---

+## `aax_activation_bytes`
+
+Cache für Audible-Activation-Bytes (AAX-DRM).
+
+Felder:
+
+- `checksum` — SHA-1-Prüfsumme der AAX-Datei (Primärschlüssel)
+- `activation_bytes` — Hex-String der Activation Bytes
+- `created_at`
+
+---
+
+## `user_prefs`
+
+Benutzer-spezifische Einstellungen (Key-Value).
+
+Felder:
+
+- `key`
+- `value`
+- `updated_at`
+
+---
+
+## `converter_scan_entries`
+
+DB-seitige Erfassung gescannter Dateien im Converter-Eingangsordner.
+
+Felder:
+
+- `rel_path` — relativer Pfad zum `converter_raw_dir`
+- `is_dir` — Verzeichnis-Flag
+- `size` — Dateigröße in Bytes
+- `modified_at` — Datei-Änderungsdatum
+- `job_id` — zugewiesener Converter-Job (falls vorhanden)
+- `scanned_at`
+
+---
+
 ## Migration/Recovery

 Beim Start werden Schema und Settings-Metadaten automatisch abgeglichen.
@@ -107,6 +179,8 @@ Bei korruptem SQLite-File:
 sqlite3 backend/data/ripster.db

 .mode table
-SELECT id, status, title, created_at FROM jobs ORDER BY created_at DESC;
+SELECT id, status, title, media_type, created_at FROM jobs ORDER BY created_at DESC;
 SELECT key, value FROM settings_values ORDER BY key;
+SELECT checksum, activation_bytes FROM aax_activation_bytes;
+SELECT rel_path, job_id FROM converter_scan_entries;
 ```
@@ -13,10 +13,11 @@ Pipeline-Steuerung:
 - Status/Progress/ETA
 - Metadaten-Dialog
 - Playlist-Entscheidung
- Review-Panel
+- Review-Panel (Track-Auswahl)
 - Queue-Interaktion (reorder/add/remove)
 - Job-Aktionen (Start/Cancel/Retry/Re-Encode)
 - Hardware-Monitoring-Anzeige
+- Aktivitäts-Tracking (Skripte, Ketten, Cron)

 ### `SettingsPage.jsx`

@@ -36,15 +37,46 @@ Historie:
 - OMDb-Nachzuweisung
 - Re-Encode/Restart-Workflows

+### `ConverterPage.jsx`
+
+Datei-Converter:
+
+- Datei-Explorer des Converter-Eingangsordners (Baum-Ansicht)
+- Upload von Audio/Video-Dateien (bis zu 50 Dateien gleichzeitig)
+- Dateiverwaltung: Umbenennen, Verschieben, Löschen, Ordner erstellen
+- Jobs aus Dateiauswahl erstellen
+- Converter-Job-Konfiguration (Ausgabeformat, Preset, Tracks)
+- Job-Start, Abbruch, Löschung
+- Automatischer Scan-Status
+
+### `DownloadsPage.jsx`
+
+Download-Queue:
+
+- Ausgabedateien aus der Job-Historie in die Queue einreihen
+- Download-Status verfolgen (ausstehend, wird verarbeitet, bereit, fehlgeschlagen)
+- Dateien als ZIP herunterladen
+- Download-Einträge löschen
+
+### `DatabasePage.jsx`
+
+Expert-Modus:
+
+- Tabellarische Rohsicht der Job-Datenbank
+- Orphan-RAW-Import
+
 ---

 ## Wichtige Komponenten

- `PipelineStatusCard.jsx`
- `MetadataSelectionDialog.jsx`
- `MediaInfoReviewPanel.jsx`
- `JobDetailDialog.jsx`
- `CronJobsTab.jsx`
+- `PipelineStatusCard.jsx` — Pipeline-Status-Anzeige mit Progress
+- `MetadataSelectionDialog.jsx` — OMDb-Metadaten-Auswahl
+- `MediaInfoReviewPanel.jsx` — Track-Auswahl-Interface (Video/Audio/Untertitel)
+- `JobDetailDialog.jsx` — Job-Detailansicht mit Logs
+- `CronJobsTab.jsx` — Cron-Job-Verwaltung
+- `DynamicSettingsForm.jsx` — Schema-gesteuertes Einstellungsformular
+- `ConverterJobCard.jsx` — Converter-Job-Darstellung
+- `CdRipConfigPanel.jsx` — Konfiguration für Audio-CD-Ripping

 ---

@@ -68,6 +100,9 @@ In `App.jsx` werden u. a. verarbeitet:
 - `PIPELINE_QUEUE_CHANGED`
 - Disk erkannt / Disk entfernt
 - `HARDWARE_MONITOR_UPDATE`
+- `DOWNLOADS_UPDATED`
+- `CONVERTER_SCAN_UPDATE`
+- `RUNTIME_ACTIVITY_CHANGED`

 ---