Den API‑Vertrag aus der Datenbank generiert
Den API‑Vertrag von der Datenbank aus nach außen generiert —
OpenAPI, einen typisierten TypeScript‑Client mit 44.076 Zeilen, 61
Mock‑Handler und die von der UI durchgesetzten Grenzen — mit einer
Prüfung an jedem Übergang, die Abweichungen zurückweist.
2025

Situation. Frontend und Backend entwickeln sich in ihrem eigenen
Tempo; ihre Annahmen über Anfragedaten können unbemerkt
auseinanderlaufen. Meist zeigt sich das erst als 422 im Browser,
nachdem die Unstimmigkeit bereits veröffentlicht wurde — also zum
teuersten Zeitpunkt. Beide Seiten von Hand nach demselben Dokument
zu schreiben löst das Problem nicht, sondern verlagert es auf die
Person, die das erneute Lesen vergessen hat.

Aufgabe. Beide Seiten sollten aus einer Quelle erzeugt werden, statt
zwischen zwei Quellen abgestimmt zu sein. Jeder Erzeugungsschritt
musste geprüft werden, statt ihm einfach zu vertrauen.

Massnahmen. Die Kette beginnt in der Datenbank und führt nach außen.
Schema und Funktionen legen die Strukturen fest, Go‑Typen definieren
die API, Huma erzeugt daraus OpenAPI, und daraus wird ein
typisierter TypeScript‑Client mit 44.076 Zeilen generiert. Parallel
entstehen 61 Mock‑Handler, damit Frontendtests gegen den echten
Vertrag laufen statt gegen handgeschriebene Testdaten. Auch die
Formulargrenzen der UI stammen aus derselben Quelle, statt erneut in
einen Validator eingetippt zu werden. Jeder Übergang ist
abgesichert. Eine CI‑Vertragsprüfung vergleicht Frontendanfragen mit
den Erwartungen der API und lässt den Build bei Abweichungen
scheitern. Darunter prüft eine Schemasonde die tatsächlichen
Strukturen statt ihrer Beschreibung. Bewusst erfasst werden typische
Verstecke für Abweichungen: optionale Body‑Felder, bei denen
"fehlend" und "null" verwechselt werden, sowie Enums in
Abfrageparametern mit möglicherweise unterschiedlichen erlaubten
Werten.

Ergebnis. Ein Feld kann sich nicht nur auf einer Seite ändern: Der
erste bemerkende Übergang lässt den Build wenige Minuten nach der
Änderung scheitern. Damit entfiel eine wiederkehrende, lästige
Fehlerklasse, die im Code‑Review unsichtbar blieb und erst zur
Laufzeit auffiel. Der Preis ist ein Generierungsschritt mitten im
Arbeitsablauf. Neuerzeugung kostet Aufwand, und die Kette ist nur so
vertrauenswürdig wie ihr am wenigsten abgesichertes Glied — weshalb
jeder Übergang eine eigene Prüfung erhielt.

Kategorien:
1Backend‑Entwicklung	/de/categories/backend/	engineer.company	70
1APIs und Integration	/de/categories/api/	engineer.company	70
1DevOps	/de/categories/devops/	engineer.company	70
1Automatisierung und CI/CD	/de/categories/automation/	engineer.company	70
1Zuverlässigkeit und Sicherungen	/de/categories/reliability/	engineer.company	70
1Tests und Qualitätssicherung	/de/categories/testing/	engineer.company	70

Leistungen:
1Backend- und API‑Entwicklung	/de/services/backend-development/	engineer.company	70
1Werkzeuge für KI‑Agenten und MCP‑Server	/de/services/ai-tools/	engineer.company	70
1DevOps- und CI/CD‑Automatisierung	/de/services/devops-cicd/	engineer.company	70

hDiese Seite im Web	URL:https://engineer.company/de/portfolio/generated-the-api-contract-from-the-database-out/	engineer.company	70
