Überblick & Architektur
Komponenten, Datenfluss und Betriebsmodell von VeloStack.
VeloStack ist ein quelloffenes PIM und Middleware für Artikelstammdaten und Bestellungen im Fahrrad-Fachhandel. Produktion läuft auf PostgreSQL 15, Entwicklung auf SQLite.
Komponenten
| Komponente | Aufgabe |
|---|---|
| FastAPI-App | VeloConnect, REST, MCP, Web-UI |
| Importer | VeloConnect-Proxy, CSV/Excel, BIDEX |
| Grouping | Modelle und Varianten bilden |
| Mapping | Lieferant → BIDEX → Warengruppe |
| Dispatcher | Bestellungen mit Audit-Trail senden |
| MCP/REST | AI- und API-Zugriff |
Datenfluss
- Lieferant liefert Artikel per VeloConnect, CSV oder Excel.
- Importer normalisiert und prüft die Daten.
- Grouping bildet Modelle und Größen-/Farbvarianten.
- Mapping setzt BIDEX-Codes und die eigene Warengruppe.
- ERP und Marktplatz lesen den Katalog.
- Bestellungen laufen über den Dispatcher und werden auditiert.
Mandanten
Jeder Hersteller und Händler ist ein eigener Tenant. Die Isolation läuft über eine Tenant-ID in allen relevanten Tabellen und einen SQLAlchemy-Event-Hook als Row-Filter. Rollen: Admin, Hersteller, Händler; pro Tenant zusätzlich admin/editor/viewer.
Federation
Mehrere VeloStack-Instanzen können per VeloConnect 1.6 miteinander kommunizieren. Hersteller-Instanzen liefern Kataloge an Händler-Instanzen, ohne dass beide dieselbe Datenbank teilen.