0.16.1-1 release snapshot

2026-04-29 08:35:24 +00:00
parent 6115090da1
commit 901a3b1ad7
269 changed files with 127336 additions and 1 deletions
@@ -0,0 +1,203 @@
+# Datenbank
+
+Ripster verwendet SQLite (`backend/data/ripster.db`).
+
+---
+
+## Tabellen
+
+```text
+settings_schema
+settings_values
+jobs
+job_lineage_artifacts
+job_output_folders
+pipeline_state
+scripts
+script_chains
+script_chain_steps
+user_presets
+cron_jobs
+cron_run_logs
+aax_activation_bytes
+user_prefs
+converter_scan_entries
+```
+
+---
+
+## `jobs`
+
+Speichert Pipeline-Lifecycle und Artefakte pro Job.
+
+Zentrale Felder:
+
+- Metadaten: `title`, `year`, `imdb_id`, `poster_url`, `omdb_json`, `selected_from_omdb`
+- Laufzeit: `start_time`, `end_time`, `status`, `last_state`
+- 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`)
+- Job-Typ/Beziehung: `job_kind`, `parent_job_id`
+- Multipart-/Disc-Merkmale: `is_multipart_movie`, `disc_number`, `metadata_fingerprint`
+- Prüfsumme: `aax_checksum` (für AAX-Dateien)
+- Audit: `created_at`, `updated_at`
+
+Typische `job_kind`-Werte:
+
+- Standard: `bluray`, `dvd`, `cd`, `audiobook`, `converter_audio`, `converter_video`, `converter_iso`
+- Serien: `dvd_series_container`, `dvd_series_child`
+- Multipart Film: `multipart_movie_container`, `multipart_movie_child`
+
+Wichtige Indizes:
+
+- `idx_jobs_status`
+- `idx_jobs_parent_job_id`
+- `idx_jobs_job_kind`
+- `idx_jobs_disc_number`
+- `idx_jobs_metadata_fingerprint`
+
+---
+
+## `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:
+
+- `state`
+- `active_job_id`
+- `progress`
+- `eta`
+- `status_text`
+- `context_json`
+- `updated_at`
+
+---
+
+## `settings_schema` + `settings_values`
+
+- `settings_schema`: Definition (Typ, Default, Validation, Reihenfolge)
+- `settings_values`: aktueller Wert pro Key
+
+---
+
+## `scripts`, `script_chains`, `script_chain_steps`
+
+- `scripts`: Shell-Skripte (`name`, `script_body`, `order_index`)
+- `script_chains`: Ketten (`name`, `order_index`)
+- `script_chain_steps`: Schritte je Kette
+  - `step_type`: `script` oder `wait`
+  - `script_id` oder `wait_seconds`
+
+---
+
+## `user_presets`
+
+Benannte HandBrake-Preset-Sets:
+
+- `name`
+- `media_type` (`bluray|dvd|other|all`)
+- `handbrake_preset`
+- `extra_args`
+- `description`
+
+---
+
+## `cron_jobs` + `cron_run_logs`
+
+- `cron_jobs`: Zeitplan + Status
+- `cron_run_logs`: einzelne Läufe
+  - `status`: `running|success|error`
+  - `output`
+  - `error_message`
+
+---
+
+## `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.
+
+Bei korruptem SQLite-File:
+
+1. Datei wird nach `backend/data/corrupt-backups/` verschoben
+2. neue DB wird initialisiert
+3. Schema wird neu aufgebaut
+
+---
+
+## Direkte Inspektion
+
+```bash
+sqlite3 backend/data/ripster.db
+
+.mode table
+SELECT id, status, title, media_type, created_at FROM jobs ORDER BY created_at DESC;
+SELECT id, parent_job_id, job_kind, is_multipart_movie, disc_number 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;
+```