Genererte API‑kontrakten med databasen som kilde
Genererte API‑kontrakten fra databasen og utover — OpenAPI, en typet
TypeScript‑klient på 44 076 linjer, 61 mock‑handlere og grensene
brukergrensesnittet håndhever — med en kontroll i hvert ledd som
feiler ved avvik.
2025

Situasjon. Frontend og backend utvikler seg i hvert sitt tempo, og
antakelsene deres om innholdet i en forespørsel kan gli fra
hverandre uten at noen merker det. Som regel oppdager man det
gjennom en 422 i nettleseren — etter at avviket allerede er levert,
som er det dyreste tidspunktet å få vite om det på. Å skrive begge
sidene for hånd ut fra samme dokument løser det ikke; det flytter
bare avviket over til den som glemte å lese dokumentet på nytt.

Oppgave. De to sidene måtte genereres fra én kilde i stedet for å
avtales mellom to, og hvert trinn i genereringen måtte kontrolleres
i stedet for å tas på tro.

Handling. Kjeden starter i databasen og går utover. Skjemaet og
funksjonene i det definerer datastrukturene; Go‑typene definerer
API‑et; Huma lager OpenAPI‑beskrivelsen ut fra dem; en typet
TypeScript‑klient — 44 076 linjer i alt — genereres fra den
beskrivelsen; 61 mock‑handlere genereres ved siden av, slik at
frontendens egne tester kjører mot den virkelige kontrakten og ikke
mot håndskrevne testdata; og grensene brukergrensesnittet håndhever
i et webskjema, kommer fra samme sted i stedet for å bli skrevet inn
på nytt i en validator. Hvert ledd har en vakt. En kontraktskontroll
i CI sammenligner det frontenden sender, med det API‑et forventer,
og får bygget til å feile ved avvik, med en skjemaprobe under som
kontrollerer de faktiske datastrukturene i stedet for en beskrivelse
av dem. Den dekker med vilje stedene der avvik gjerne gjemmer seg:
valgfrie felt i forespørselskroppen, der «mangler» og «null» blandes
sammen, og enumer i spørringsparametere, der de to sidene i det
stille kan være uenige om de tillatte verdiene.

Resultat. Et felt kan ikke endres på bare én side — det feiler i det
første leddet som merker det, i et bygg, minutter etter endringen.
Det fjernet en tilbakevendende og virkelig irriterende klasse feil,
den typen som er usynlig i kodegjennomgang og bare viser seg under
kjøring. Prisen er et genereringstrinn midt i alt sammen: å generere
på nytt er et ork, og kjeden er bare så pålitelig som sitt dårligst
bevoktede ledd, og derfor fikk hvert ledd sin vakt.

Kategorier:
1Backend‑utvikling	/nb/categories/backend/	engineer.company	70
1API‑er og integrasjon	/nb/categories/api/	engineer.company	70
1DevOps	/nb/categories/devops/	engineer.company	70
1Automatisering og CI/CD	/nb/categories/automation/	engineer.company	70
1Pålitelighet og sikkerhetskopier	/nb/categories/reliability/	engineer.company	70
1Testing og kvalitetssikring	/nb/categories/testing/	engineer.company	70

Tjenester:
1Backend- og API‑utvikling	/nb/services/backend-development/	engineer.company	70
1Verktøy for AI‑agenter og MCP‑servere	/nb/services/ai-tools/	engineer.company	70
1DevOps og CI/CD‑automatisering	/nb/services/devops-cicd/	engineer.company	70

hDenne siden på nettet	URL:https://engineer.company/nb/portfolio/generated-the-api-contract-from-the-database-out/	engineer.company	70
