init

docs/FLOWER_IMPORT.md

@@ -0,0 +1,28 @@
+# Vorhandene Flower-Taskdaten übernehmen
+
+Optional kann der Agent die noch über Flowers API verfügbaren Tasks als Snapshots
+in seine lokale Outbox übernehmen. Keine direkte Deserialisierung fremder Flower-
+Datenbankdateien. Nicht mehr in Flower vorhandene Tasks können nicht rekonstruiert werden.
+
+```bash
+cd /opt/dilib-dashboard
+sudo systemctl stop dilib-agent
+sudo -u dilib-agent .venv-agent/bin/python -m agent.import_flower --env /etc/dilib-agent/agent.env --limit 100000
+sudo systemctl start dilib-agent
+```
+
+Der Agent überträgt anschließend die Outbox. Argumente, Ergebnisse und Tracebacks
+werden nicht importiert. Pro Task wird der verfügbare Zustand übernommen, keine
+vollständige historische Zustandsfolge. Wiederholung desselben Snapshots verwendet
+dieselbe Ereignis-ID. Flower muss erreichbar sein und gültige Zeitstempel liefern.
+Daten älter als die konfigurierte Retention werden bei der Bereinigung wieder entfernt.
+
+Bei einem blockierten Upload kann eine gezielt geprüfte ungültige Event-ID in eine
+lokale Quarantänetabelle verschoben werden. Vorher Agent stoppen und Spool sichern:
+
+```bash
+sudo -u dilib-agent .venv-agent/bin/python -m agent.spool /var/lib/dilib-agent/outbox.sqlite3
+sudo -u dilib-agent .venv-agent/bin/python -m agent.spool /var/lib/dilib-agent/outbox.sqlite3 --quarantine-id EVENT-UUID --reason 'Validierungsfehler geprüft'
+```
+
+Die Quarantäne bleibt lokal erhalten; sie wird nicht an die API übertragen.