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. Formen på et system tegnet opp på papiret først, slik at delene passer sammen og kostnaden er kjent før noen skriver kode.
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.

