0.12.0-17 Misc fixes

docs/architecture/backend.md

@@ -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)