Panoramica e architettura
Componenti, flusso dati e modello operativo di VeloStack.
VeloStack è un PIM e middleware open source per anagrafiche articoli e ordini nel commercio di biciclette. La produzione usa PostgreSQL 15, lo sviluppo SQLite.
Componenti
| Componente | Compito |
|---|---|
| App FastAPI | VeloConnect, REST, MCP, web UI |
| Importer | Proxy VeloConnect, CSV/Excel, BIDEX |
| Grouping | Crea modelli e varianti |
| Mapping | Fornitore → BIDEX → gruppo merceologico |
| Dispatcher | Invia ordini con audit trail |
| MCP/REST | Accesso AI e API |
Flusso dati
- Il fornitore fornisce articoli via VeloConnect, CSV o Excel.
- L'importer normalizza e valida i dati.
- Il grouping crea modelli e varianti taglia/colore.
- Il mapping imposta codici BIDEX e il proprio gruppo.
- ERP e marketplace leggono il catalogo.
- Gli ordini passano dal dispatcher e vengono auditati.
Tenant
Ogni produttore e rivenditore è un tenant separato. L'isolamento usa un tenant ID in tutte le tabelle rilevanti e un event hook SQLAlchemy come row filter. Ruoli: admin, produttore, rivenditore; per tenant anche admin/editor/viewer.
Federation
Più istanze VeloStack possono comunicare via VeloConnect 1.6. Le istanze produttore forniscono cataloghi alle istanze rivenditore senza condividere lo stesso database.