Files
ripster/docs/gui/downloads.md
T
2026-06-12 11:17:44 +02:00

1.4 KiB

Downloads

Auf Downloads werden ZIP-Archive für Historie-Artefakte erstellt und bereitgestellt.

Was heruntergeladen werden kann

Ein Download-Eintrag referenziert immer einen Historie-Job und genau ein Ziel:

  • RAW
  • Output

Erzeugt wird ein ZIP-Archiv im Download-Verzeichnis des Backends.

Statusmodell

Status Bedeutung
queued Eintrag erstellt, wartet auf Verarbeitung
processing ZIP wird gerade gebaut
ready Archiv fertig, Download-Link aktiv
failed Erzeugung oder Zugriff fehlgeschlagen

Eintrag anlegen

Startpunkt ist die Historie:

  1. Job öffnen.
  2. Download einreihen.
  3. Ziel (RAW oder Output) wählen.
  4. Status in Downloads verfolgen.

Wichtige Laufzeitdetails

  • Wenn bereits ein passendes, aktuelles Archiv existiert, kann der Eintrag wiederverwendet werden.
  • Nach Backend-Neustart werden unterbrochene queued/processing-Einträge geprüft und fortgesetzt.
  • Fehlt eine erwartete ZIP-Datei bei ready, wird der Eintrag auf failed gesetzt.

Download auslösen

Bei Status ready:

  • Download-Button lädt die ZIP direkt aus /api/downloads/:id/file.

Einträge entfernen

Löschen entfernt:

  • Queue-Metadaten
  • zugehörige Archivdatei

Nicht erlaubt:

  • Löschen während queued/processing

Echtzeitaktualisierung

Die Seite reagiert auf DOWNLOADS_UPDATED per WebSocket. Dadurch sind Statuswechsel ohne Reload sichtbar.