Backend-Services¶

Das Backend ist in Node.js/Express geschrieben und in Services aufgeteilt, die jeweils eine klar abgegrenzte Verantwortlichkeit haben.

pipelineService.js¶

Der Kern von Ripster – orchestriert den gesamten Ripping-Workflow.

Zuständigkeiten¶

• Verwaltung des Pipeline-Zustands als State Machine
• Koordination zwischen allen externen Tools
• Generierung von Encode-Plänen
• Fehlerbehandlung und Recovery

Haupt-Methoden¶

Zustandsübergänge¶

flowchart LR
    START(( )) --> IDLE
    IDLE -->|analyzeDisc()| META[METADATA\nSELECTION]
    META -->|selectMetadata()| RTS[READY_TO\nSTART]
    RTS -->|Auto-Start/Queue| RIP[RIPPING]
    RTS -->|Auto-Start mit RAW| MIC[MEDIAINFO\nCHECK]
    RIP -->|MKV erstellt| MIC[MEDIAINFO\nCHECK]
    MIC -->|Playlist offen| WUD[WAITING_FOR\nUSER_DECISION]
    WUD -->|selectMetadata(selectedPlaylist)| MIC
    MIC -->|Tracks analysiert| RTE[READY_TO\nENCODE]
    RTE -->|confirmEncodeReview() + startPreparedJob()| ENC[ENCODING]
    ENC -->|HandBrake + Post-Skripte fertig| FIN([FINISHED])
    ENC -->|Abbruch| CAN([CANCELLED])
    ENC -->|Fehler| ERR([ERROR])
    RIP -->|Fehler| ERR
    RIP -->|Abbruch| CAN
    ERR -->|retry() / cancel()| IDLE
    CAN -->|retry() / analyzeDisc()| IDLE
    FIN -->|cancel / neue Disc| IDLE

    style FIN fill:#e8f5e9,stroke:#66bb6a,color:#2e7d32
    style CAN fill:#fff3e0,stroke:#fb8c00,color:#e65100
    style ERR fill:#ffebee,stroke:#ef5350,color:#c62828
    style ENC fill:#f3e5f5,stroke:#ab47bc,color:#6a1b9a
    style RIP fill:#e3f2fd,stroke:#42a5f5,color:#1565c0
    style MIC fill:#e3f2fd,stroke:#42a5f5,color:#1565c0

diskDetectionService.js¶

Überwacht das Disc-Laufwerk auf Disc-Einleger- und Auswurf-Ereignisse.

Modi¶

Polling¶

Der Service pollt das Laufwerk im konfigurierten Intervall (disc_poll_interval_ms, Standard: 4000ms) und emittiert Events:

// Ereignisse
emit('discInserted', { path: '/dev/sr0' })
emit('discRemoved', { path: '/dev/sr0' })

processRunner.js¶

Verwaltet externe CLI-Prozesse.

Features¶

• Streaming: stdout/stderr werden zeilenweise gelesen
• Progress-Callbacks: Ermöglicht Echtzeit-Fortschrittsanzeige
• Graceful Shutdown: SIGINT → Warte-Timeout → SIGKILL
• Prozess-Registry: Verfolgt aktive Prozesse für sauberes Beenden

Nutzung¶

const result = await runProcess(
  'HandBrakeCLI',
  ['--input', rawFile, '--output', outputFile, '--preset', preset],
  {
    onStderr: (line) => parseHandBrakeProgress(line),
    onStdout: (line) => logger.debug(line)
  }
);

websocketService.js¶

WebSocket-Server für Echtzeit-Client-Kommunikation.

Betrieb¶

• Läuft auf Pfad /ws des Express-Servers
• Hält eine Registry aller verbundenen Clients
• Ermöglicht Broadcast an alle Clients oder gezieltes Senden

API¶

broadcast('PIPELINE_STATE_CHANGED', { state, activeJobId });
broadcast('PIPELINE_PROGRESS', { state, progress, eta, statusText });
broadcast('PIPELINE_QUEUE_CHANGED', queueSnapshot);

omdbService.js¶

Integration mit der OMDb API.

Methoden¶

Zurückgegebene Daten¶

{
  "imdbId": "tt1375666",
  "title": "Inception",
  "year": "2010",
  "type": "movie",
  "poster": "https://...",
  "plot": "...",
  "director": "Christopher Nolan"
}

settingsService.js¶

Verwaltet alle Anwendungseinstellungen.

Features¶

• Schema-getriebene Validierung: Jede Einstellung hat Typ, Grenzen und Pflichtfeld-Flag
• Kategorisierung: Einstellungen sind in Kategorien gruppiert (Paths, Tools, Encoding, ...)
• Persistenz: Werte in SQLite, Schema ebenfalls in SQLite
• Defaults: defaultSettings.js definiert Standardwerte

Einstellungs-Kategorien¶

historyService.js¶

Datenbankoperationen für Job-Historie.

Hauptoperationen¶

notificationService.js¶

PushOver-Push-Benachrichtigungen.

await notify({
  title: 'Ripster: Job abgeschlossen',
  message: 'Inception (2010) wurde erfolgreich encodiert'
});

logger.js¶

Strukturiertes Logging mit täglicher Log-Rotation.

Log-Level¶

Log-Dateien¶

logs/
├── ripster-2024-01-15.log    ← Tages-Log
└── jobs/
    └── job-42-handbrake.log  ← Prozess-spezifische Logs