En maritim plattform med klare systemgrenser
Utformet arkitekturen for en lagdelt maritim plattform som skiller en Next.js PWA‑frontend, et Go‑API (Huma/Fiber) og et funksjonslag i PostgreSQL, med all forretningslogikk i databasen.
Arbeidet utført: 2025
Slik når forespørselen databasen
Oversikt over forespørselens vei gjennom implementeringen; resultater og målegrunnlag står i selve casen.
Forespørsel fra brukerflaten
Den maritime brukerflaten ber om strukturerte data og viser returnert JSON.
Go-API
Go-API-et håndterer ruting, validering av forespørsler, sikkerhet og databasekallet.
JSON fra PostgreSQL
Databasefunksjoner lager komplett JSON, som API-et returnerer uendret.
én maritim plattform, i tre rene lag
Situasjon. NextMariner er en maritim plattform for profesjonelle nettverk, selskapsomtaler og utdanningssponsing. Grunnleggerens arkitekturbidrag er registrert under NextMariner‑oppdraget fra november 2025; beskrivelsen skiller ikke ut en senere ansettelsesperiode eller fastslår at hele produktet ble levert av Engineer ApS.
Oppgave. I arkitektrollen var beslutningen som måtte tas i forkant, hvor hver type logikk skulle ligge, med grenser som var tydelige nok til å holde under press i stedet for å viskes ut første gang noen hadde dårlig tid.
Handling. Det endte med tre lag, med én jobb hver. Next.js‑frontenden tar seg av presentasjon og interaktivitet og ingenting annet. Go‑API‑et — Huma over Fiber — er bevisst tynt: det ruter, validerer forespørselen, anvender sikkerhetsfiltreringen og orkestrerer, men det inneholder ingen forretningslogikk i det hele tatt. All forretningslogikken ligger i PostgreSQL‑funksjoner, som setter sammen hele resultatet og gir det tilbake slik at API‑et kan videresende det. Når en regel endres, endres den derfor i ett lag, i SQL, og de to andre trenger ikke å vite om det. Grensene ble skrevet ned og deretter håndhevet i kodegjennomgangen, fordi en konvensjon som ingen passer på, slutter å være en.
Resultat. Den implementerte arkitekturen gir presentasjon, forespørselshåndtering og forretningsregler hvert sitt ansvar. Kilden dokumenterer oppdelingen og begrunnelsen, ikke en målt forbedring i leveringstid, stabilitet eller forretningsresultater.

Foto: mherfurt / Pixabay 
Foto: atti69 / Pixabay
Bruk erfaringen i prosjektet deres
Bruk «En maritim plattform med klare systemgrenser» som utgangspunkt for en lignende utfordring i organisasjonen deres. Tjenestene bak arbeidet er tilgjengelige for prosjektet deres. En struktur som samsvarer med hvordan virksomheten faktisk fungerer, slik at spørsmålene du trenger svar på senere, fortsatt er mulige å stille.
Se bak resultatet
Les om situasjonen, beslutningene og resultatet i eksemplet. Vi kan drøfte hva som passer deres rammer, og hva som krever en annen tilnærming. En maritim plattform med klare systemgrenser — én maritim plattform, i tre rene lag
Les videre: Designet JSON rett fra Postgres til API‑et. Eller ta en titt på hele porteføljen.
Overfor kunder kaller vi denne En maritim plattform med klare systemgrenser — se den sammen med de andre sakene.
Ett stykke av en lengre oversikt — og den ligger i sin helhet her.
Hver oppføring er skrevet på samme måte: situasjonen, oppgaven, hva vi gjorde, og hva som endret seg.

