Cloudflare-safe persistent jobs for Paperless worker

[Feberdin]

Ergebnis

Potentiell lange Worker-Endpunkte nehmen Arbeit nun per HTTP 202 an und liefern job_id, request_id und status_url. SQLite hält Jobs über Reloads und Worker-Restarts persistent; schreibende Jobs sind serialisiert und werden nach Unterbrechung nicht automatisch wiederholt.

Endpunkte

• POST /api/run, /api/resume, /api/restart
• POST /api/review/entities/jobs
• POST /api/review/merge
• GET /api/jobs/<job_id>
• Legacy GET /api/review/entities liefert jetzt 405

Sicherheit und Betrieb

• Idempotency-Key und atomare Ressourcenbelegung
• exakter Fortschritt ohne erfundene ETA
• sichere terminale Fehler mit Request-ID
• Log-Redaction, no-store, Session- statt Local-Storage für Bearer-Token
• Read-only-Scan darf nach Restart einmal fortgesetzt werden; Mutationen werden interrupted
• Basisimage ist per Digest, Python-Abhängigkeiten sind exakt versioniert
• Broker baut das Produktionsimage aus dem unveränderlichen GitOps-Checkout; die Laufzeit meldet den getesteten App-Commit
• Migration und Rollback sind in docs/cloudflare-long-running-jobs.md beschrieben

Qualitätssicherung

• 98 Pytest-Tests lokal grün, inklusive Happy Path, Parallelität, Restart und Negativfällen
• Parallelitätslauf fünfmal mit je acht Konkurrenten
• Ruff, PyCompile, Compose-Validierung und Gitleaks lokal grün
• finaler Push-CI-Run: https://github.com/Feberdin/Paperless-KIplus/actions/runs/31573089368
• finaler PR-CI-Run: https://github.com/Feberdin/Paperless-KIplus/actions/runs/31573092128
• HACS/Hassfest: https://github.com/Feberdin/Paperless-KIplus/actions/runs/31573092163
• Version Guard: https://github.com/Feberdin/Paperless-KIplus/actions/runs/31573092129

Deployment

• GitOps-Commit: a15d18646e6a1e17f682593fd7fb183cfa9caed0
• getesteter App-Commit im Image: e15532882f58a02e2a033d0f79e6b965eaad39a7
• Broker-Plan: plan_2a1fa82035aa41548368815a9020d1c5
• Security-Gate: allow, Commit stimmt überein, 0 Blocker
• Deployment: deploy_41850636966248e8ad741b415a86ce7d
• Laufzeit: paperless-kiplus-worker:1.4.21-e155328, Port 8788, healthy
• Start-Reconciliation: 0 fortgesetzte Read-only-Jobs, 0 unterbrochene Mutationen
• Heimdall/Broker-Probe: HTTP 200

Rollback bleibt über einen neuen Broker-Plan auf den vorherigen bekannten Commit möglich; die persistente /data-Ablage wurde beibehalten.