Sprinting Solo

exo1 — Node og React

Til B2B-portaler og forretningsapplikationer: kunde- og partnerportaler, backoffice og workflows.

Status

Brugbar (v0.1.0). Kører i skyen i et testmiljø. Endnu ikke brugt i et kundeprojekt.

Til hvad

Én kunde pr. installation, med organisationer indbygget: kundens egne kunder, partnere eller afdelinger. Brugere hører til organisationer med en rolle, og data er adskilt pr. organisation. Dansk og engelsk fra start.

Stack

  • Backend: NestJS 11 på Node 24, TypeScript
  • Data: PostgreSQL med Prisma 7, baggrundsjob i Postgres (pg-boss), Redis/Valkey som cache
  • Frontend: React 19 med React Router 8 og MUI-komponenter
  • Kontrakt: zod-skemaer delt mellem server og klient; en typet klient genereres automatisk
  • Login: standard OIDC, Keycloak som udgangspunkt, Entra ID eller andet ved konfiguration
  • Test og drift: Vitest og Playwright; DigitalOcean App Platform i EU

Hvad følger med

  • En arkitektur-blueprint med reglerne for hvert lag
  • Et kørende skabelonprojekt med login, organisationer, roller, audit-log, cache og baggrundsjob
  • En eksempel-feature gennem alle lag, så agenterne har et mønster at kopiere
  • Automatiske kontroller: typer, lint, unit-, integrations- og browsertests
  • Et agent-lag: regler for AI-agenterne, en skill for hvert tilbagevendende greb og hooks, der kører kontrollerne
  • CI på GitHub og miljøbeskrivelser til DigitalOcean

Miljøer

Lokalt med én kommando: database, cache og Keycloak kører i Docker. I skyen et tst-miljø, der deployes fra main, og et prd-miljø til produktion, der kun opdateres ved en release. Produktionsmiljøet er beskrevet, men endnu ikke oprettet.

Login og roller

Identiteten kommer fra kundens login-system via OIDC; roller og medlemskaber ligger i applikationen. Tre organisationsroller (administrator, medlem, læser) og en global administrator. Serveren håndhæver rettighederne; brugerfladen skjuler blot det, man ikke må.

Sådan starter et projekt

Et projekt starter med en kopi af exo1 ved en bestemt version. Udvikleren skifter logo og farver, kører opsætningen, bygger den første feature med agent-skill'en add-entity og fjerner eksemplet. Afvigelser fra blueprint'en skrives ned.

Det kan vi vise

  • Bygget op fra en tom mappe med én kommando: 27 automatiske tests og 2 browserforløb grønne (19. november 2026).
  • Kører i skyen i tst-miljøet med login via Keycloak og testdata; CI kører på GitHub ved hvert push.
  • Kan prøves live i det låste område.

Ikke på plads endnu

  • Produktionsmiljø og release-flow er endnu ikke kørt.
  • Overvågning (fejlsporing, logs) og en sikkerheds- og GDPR-baseline.
  • Admin-skærme, filer, e-mail og realtid følger ikke med som standard; de tilføjes pr. projekt.
  • Ingen evaluering fra et rigtigt projekt endnu.

← exo'erne