ERP-System für einen Kunden

Das ERP-System bildet die Kernprozesse des Kunden ab: Verträge, Touren, Abrechnungsläufe und Angebote. Es läuft als Laravel-Anwendung mit Vue-3-Oberfläche (Inertia), MySQL als Datenbank und Redis für Queues und Cache, in Docker-Containern.

Dokumente wie Rechnungen, Angebote und Tourenpläne entstehen nicht im ERP, sondern in einem Workflow-System. Das ERP stößt die Workflows per API an und bekommt das Ergebnis zurück. Ich bin Hauptentwickler dieser Anbindung und außerdem von Abrechnung, Touren, Frontend und Deployment.

Der Webhook-Endpunkt nimmt die Anfrage nur noch entgegen und übergibt die Arbeit an einen Queue-Job (Horizon). Der Request antwortet sofort und hängt nicht mehr, auch wenn die Verarbeitung länger dauert.

Das Workflow-System signiert jeden Aufruf mit HMAC-SHA256 über Zeitstempel und Inhalt. Das ERP prüft Signatur und Zeitstempel (30 Minuten Toleranz) und lehnt alles andere ab.

Statt große Dateien im Webhook zu verschicken, liefert das Workflow-System für den Sammeldruck jetzt eine URL, sobald alle Dokumente erzeugt sind. Der Base64-Weg ist nur noch für ältere Lieferungen im Code, dort liegt das PDF höchstens 15 Minuten im Cache.

Das Token liegt zentral im Cache und wird früher verworfen, als es abläuft. Ein Lock sorgt dafür, dass sich nur ein Prozess neu anmeldet. Wird eine Anfrage trotzdem abgelehnt, holt der Client ein frisches Token und wiederholt sie einmal.

private function authenticateWithLock(): void{    // Nur ein Prozess meldet sich an, die anderen warten    Cache::lock('workflow_token_lock', 15)->block(10, function (): void {        if (! $this->loadTokenFromCache()) {            $this->requestNewToken();        }    });}

Statt Updates von Hand auf dem Server einzuspielen, baut die Pipeline bei jeder Änderung ein Docker-Image und löst per Webhook das Deployment aus. Die Container haben getrennte Rollen für Web, Scheduler und Queue-Worker. Als Nächstes zieht das Deployment auf Coolify um.