Architektur

VeloConnect Simulator ist eine FastAPI-basierte Middleware mit vier externen Schnittstellen.

Schnittstellen

VeloConnect XML (/veloconnect)

XML-POST/GET-Protokoll für Warenwirtschaftssysteme. VC 1.1 Core + 1.5 BIDEX Catalog. Auth: BuyersID + Credential + SellersID.

REST-API (/api/v1)

Moderne JSON-Schnittstelle mit OpenAPI/Swagger, JWT-Auth, automatischem Tenant-Scoping. 17 Endpoint-Module.

MCP-Server (/mcp)

Model Context Protocol für AI-Clients (Claude). OAuth 2.1 Auth, HTTP/SSE Transport. 34 Tools für Katalog-Verwaltung.

Web-UI (/admin/)

Admin-Dashboard mit Jinja2 + Bootstrap 5. Supplier-Management, Artikel-Import, Gruppierung, Quality-Checks.

Service-Schicht

ArticleService, SupplierService, ImportService, GroupingService, BidexService, CategoryMappingService, DispatcherService, ConnectorRunner, InventoryService, DocumentRenderer, AuditService.

Multi-Tenant-Design

Jeder Hersteller und Händler ist ein eigener Tenant mit getrennten Daten. Tenant-ID in allen relevanten Tabellen, SQLAlchemy-Event-Hook als Application-Level-Row-Filter. Rollen: Admin, Hersteller, Händler. Pro-Tenant: admin/editor/viewer.

Authentifizierung

Pro-Tenant-IdP (Keycloak OIDC), Single Logout (Back-Channel), lokale User als Fallback. MCP: OAuth 2.1 mit eigenem Authorization-Server.

Datenbank

PostgreSQL 15 (Prod), SQLite (Dev). Schema-Migrationen via Alembic. 30+ ORM-Modelle.

Federation

Mehrere Simulator-Instanzen können untereinander per VeloConnect 1.6 kommunizieren. Hersteller-Instanzen liefern Kataloge an Händler-Instanzen.