{"canonical_url":"https://engineer.company/de/portfolio/generated-the-api-contract-from-the-database-out/","content_markdown":"# Den API‑Vertrag aus der Datenbank generiert\n\nDen 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.\n\n2025\n\n**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.\n\n**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.\n\n**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.\n\n**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.\n\n---\n\n- Rolle: Backend‑Ingenieurin\n- Kategorien: [Backend‑Entwicklung](https://engineer.company/de/categories/backend/), [APIs und Integration](https://engineer.company/de/categories/api/), [DevOps](https://engineer.company/de/categories/devops/), [Automatisierung und CI/CD](https://engineer.company/de/categories/automation/), [Zuverlässigkeit und Sicherungen](https://engineer.company/de/categories/reliability/), [Tests und Qualitätssicherung](https://engineer.company/de/categories/testing/)\n- Leistungen: [Backend- und API‑Entwicklung](https://engineer.company/de/services/backend-development/), [Werkzeuge für KI‑Agenten und MCP‑Server](https://engineer.company/de/services/ai-tools/), [DevOps- und CI/CD‑Automatisierung](https://engineer.company/de/services/devops-cicd/)\n\n\u003chttps://engineer.company/de/portfolio/generated-the-api-contract-from-the-database-out/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"API-Vertrag aus der Datenbank generiert: OpenAPI, typisierter TypeScript-Client, Mock-Handler und UI-Grenzen mit Prüfung an jedem Übergang.","formats":{"gemtext":"https://engineer.company/de/portfolio/generated-the-api-contract-from-the-database-out/index.gmi","gopher":"https://engineer.company/de/portfolio/generated-the-api-contract-from-the-database-out/gophermap","html":"https://engineer.company/de/portfolio/generated-the-api-contract-from-the-database-out/","json":"https://engineer.company/de/portfolio/generated-the-api-contract-from-the-database-out/index.json","markdown":"https://engineer.company/de/portfolio/generated-the-api-contract-from-the-database-out/index.md","pdf":"https://engineer.company/de/portfolio/generated-the-api-contract-from-the-database-out/index.pdf"},"kind":"page","language":"de","title":"Den API-Vertrag aus der Datenbank generiert","url":"https://engineer.company/de/portfolio/generated-the-api-contract-from-the-database-out/","version":1}