Operatività e troubleshooting
Deployment, backup, log e gli errori più comuni.
VeloStack è un'applicazione FastAPI singola con PostgreSQL. Gli aggiornamenti vengono distribuiti con migrazione, health check e smoke test; senza backup nessun aggiornamento.
Deployment
- Crea backup di database e secret.
- Distribuisci la nuova versione.
- Esegui
alembic upgrade head. - Controlla
GET /healtheGET /health/timers. - Smoke test: login, ricerca marketplace, un ordine in dry-run.
Backup
Esegui il backup di PostgreSQL con pg_dump, conserva .env e chiavi separatamente. Testa regolarmente un restore, non solo documentarlo. Copia i file SQLite solo a servizio fermo.
Log
- Log app per errori e query lente.
/health/timersper stato sync e timer.- Audit dispatch per gli ordini.
- Log esecuzione n8n per inoltri.
Troubleshooting
| Sintomo | Causa | Soluzione |
|---|---|---|
| 401/411 su VeloConnect | Credenziali o tenant errati | Controlla connessione e tenant |
| 415 su VeloConnect | SellersID sconosciuto | Controlla il seller ID |
| Sync senza nuovi articoli | Filtro, intervallo o timeout | Controlla esecuzione e profilo, avvia manualmente |
| PDF come BOZZA | Dati destinatario mancanti | Completa i dati del tenant |
| Dispatch fallito | Canale, credenziali o destinazione non raggiungibili | Controlla dry-run e config canale |