Datenbank¶

Ripster verwendet SQLite (backend/data/ripster.db).

Tabellen¶

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¶

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;