# 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;
```