Automotive Vertriebsplattform

ADG Sales vertreibt Fahrzeuge der Marken Dongfeng, Voyah und Venucia über ein Netz von Handelspartnern. Zum Tagesgeschäft gehören neben dem Verkauf auch Einkauf, Fahrzeuglogistik und Aftersales mit Garantie- und Supportfällen.

Fahrzeuge, Kaufverträge und Rechnungen werden in einer bestehenden Warenwirtschaft auf MySQL geführt, aufgeteilt auf mehrere Firmendatenbanken, unter anderem für Vertrieb und Aftersales. Dieses System bleibt für Bestand und Buchhaltung maßgeblich, die neue Plattform musste sich also daran anbinden, statt es zu ersetzen.

Drei Gruppen arbeiten mit der Plattform: Interessenten und mögliche Partner auf der öffentlichen Website, Händler und ihre Mitarbeitenden in der Dealer Box sowie die Abteilungen von ADG in der Distribution Box. Speditionen erhalten für einzelne Aufträge einen gesicherten Link und brauchen kein eigenes Konto.

Ein Fahrzeugkauf berührt mehrere Systeme zugleich. Das Fahrzeug muss noch verfügbar sein, der Händler braucht ein geprüftes Vertriebsrecht für die Marke und eine Kundennummer in der richtigen Firmendatenbank, und Kaufvertrag und Bestellposition müssen dort konsistent entstehen. Ein Warenkorb kann dabei Fahrzeuge enthalten, die unterschiedlichen Firmen zugeordnet sind.

Dazu kommt die Breite der Abläufe: Händlerbewerbungen mit Prüfung und Freigabe, befristete Vertriebsrechte, Zahlungsprüfung, Transporte und Abholungen mit externen Speditionen, Fahrzeugeingang, Einkaufspreislisten und Garantiefälle, die beim Hersteller eingereicht werden. Jede Abteilung braucht andere Rechte, und Händler sollen ihre eigenen Mitarbeitenden selbst verwalten.

Die öffentliche Website muss in zehn Sprachen funktionieren, Modellinformationen und Preislisten für jeden Markt bereitstellen und Interessenten zum passenden Händler führen.

Die öffentliche Website präsentiert Marken und Modelle in zehn Sprachen. Zu jedem Modell gibt es eine Preisliste als PDF in jeder dieser Sprachen, eine Händlersuche zeigt Vertriebs- und Servicepartner auf einer Karte, und der Partnerbereich führt interessierte Betriebe zur Bewerbung.

In der Dealer Box filtern Händler Lager-, Vorlauf- und Bestellfahrzeuge, legen sie in den Warenkorb und bestätigen den Kauf mit ihrer PIN. Das System erzeugt Bestellauftrag und Bestellannahme als PDF, offene Zahlungen und Abholungen bleiben im Blick. Im Aftersales-Bereich erfassen Händler Garantiefälle mit Fotos sowie Teile- und Arbeitszeitcodes, stellen Support-Tickets und greifen auf freigegebene Dokumente zu.

Die Distribution Box bündelt die Arbeit der ADG-Abteilungen:

Das Frontend ist eine React-Anwendung mit TypeScript, Vite, TanStack Query und Tailwind CSS. Das Backend basiert auf Fastify, jeder Endpunkt ist mit TypeBox-Schemas für Anfrage und Antwort beschrieben. Daraus entsteht eine OpenAPI-Beschreibung, aus der das Frontend seinen typisierten API-Client generiert, sodass Änderungen an der Schnittstelle schon beim Kompilieren auffallen.

Eigene Daten wie Händler, Bestellungen, Logistikaufträge und Garantiefälle liegen in MongoDB. Die Warenwirtschaft ist über einen eigenen Verbindungspool je Firmendatenbank angebunden. Beim Kauf gruppiert das Backend die Fahrzeuge nach Firma und legt Kaufverträge und Bestellpositionen je Firma in einer Transaktion an; schlägt ein Schritt fehl, wird alles zurückgerollt. Abgleiche von Stammdaten, etwa für Händler und Speditionen, sind so gebaut, dass ein Fehler auf der MySQL-Seite die Arbeit im Portal nicht blockiert.

Berechtigungen folgen einer Matrix aus Bereichen, Gruppen und Einzelrechten, die Positionen in Abteilungen zugewiesen werden. Jede ändernde Anfrage wird automatisch mit Vorher-Nachher-Vergleich protokolliert. Verträge, Transportaufträge und die Modell-Preislisten rendert Puppeteer auf dem Server als PDF, Dokumente liegen auf einem SFTP-Speicher. Zeitgesteuerte Jobs prüfen ablaufende Vertriebsrechte, erstellen Proforma- und Schlussrechnungen und versenden Erinnerungen.

Die Plattform läuft in Docker-Containern hinter Caddy mit automatischem TLS, getrennt in Entwicklungs- und Produktionsumgebung. GitHub Actions prüft jeden Push mit Linting, Typprüfung und einem Sicherheitsaudit der Abhängigkeiten, bevor automatisch deployt wird. Parallel läuft die Vitest-Suite, darunter ein PDF-Render-Test mit echtem Chromium. Die Plattformdatenbank wird täglich gesichert.

Händler kaufen Fahrzeuge selbstständig im Portal, und jeder Kauf landet als Kaufvertrag in der Warenwirtschaft. Das ADG-Team bearbeitet Bewerbungen, Zahlungen, Transporte und Garantiefälle im selben System, mit nachvollziehbarer Historie für jede Änderung.

Die Plattform ist im produktiven Betrieb und wird laufend erweitert, zuletzt um eine Händlerkarte auf der öffentlichen Website, einen mobilen Zugang zum technischen Support und eine Lieferantenverwaltung im Einkauf.