Betrieb & Troubleshooting

Deployment, Backup, Logs und die häufigsten Fehler.

VeloStack läuft als einzelne FastAPI-Anwendung mit PostgreSQL. Updates werden mit Migration, Health-Check und Smoke-Test ausgerollt; ohne Backup kein Update.

Deployment

Backup von Datenbank und Secrets erstellen.
Neue Version deployen.
alembic upgrade head ausführen.
GET /health und GET /health/timers prüfen.
Smoke-Test: Login, Marktplatz-Suche, eine Bestellung im Dry-Run.

Backup

PostgreSQL per pg_dump sichern, .env und Keys getrennt ablegen. Ein Restore wird regelmäßig getestet, nicht nur dokumentiert. SQLite-Dateien nur im Stillstand kopieren.

Logs

App-Log für Fehler und Slow Queries.
/health/timers für Sync- und Timer-Status.
Dispatch-Audit für Bestellungen.
n8n-Execution-Log für Weiterleitungen.

Troubleshooting

Symptom	Ursache	Lösung
401/411 bei VeloConnect	Credentials oder Tenant falsch	Anbindung und Tenant prüfen
415 bei VeloConnect	SellersID unbekannt	Seller-ID der Anbindung prüfen
Sync ohne neue Artikel	Filter, Intervall oder Timeout	Lauf und Profil prüfen, manuell starten
PDF als ENTWURF	Empfängerdaten fehlen	Tenant-Stammdaten ergänzen
Dispatch fehlgeschlagen	Kanal, Credentials oder Ziel nicht erreichbar	Dry-Run und Kanal-Config prüfen

Stand: Oktober 2026