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,58 @@
+# 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.