Key ADRs Needed

Key ADRs Needed — Lobby

Hva er en ADR?

En Architecture Decision Record (ADR) dokumenterer en viktig arkitekturavgjørelse: kontekst, alternativer vurdert, beslutning tatt og konsekvenser. Gir fremtidige utviklere forståelse for hvorfor, ikke bare hva.

Format: ~/ALAI/products/Lobby/docs/architecture/adr-NNN-tittel.md

---

Ventende ADRs — Krever CEO/Arkitekt-beslutning

ADR-001 — Backend Framework

Status: OPEN — blokkerer Phase 1 byggestart

Spørsmål: Node.js/TypeScript (Hono/Express) ELLER Java/Spring Boot?

Kriterium	Node.js/TS	Java/Spring Boot
Utviklingshastighet	Raskere (samme språk)	Tregere oppstart
Type safety	God (TS)	Utmerket (Java)
Skalerbarhet	God nok for Phase 1-3	Bedre for Phase 4+
ALAI-erfaring	Høy (Bilko, Drop, etc.)	Medium (LumisCare)
Compliance-egnethet	Akseptabel	Sterk
Deployment-enkelthet	Enkel (Vercel/Railway)	Middels (Docker/Azure)

Anbefalt beslutningsdato: Før Phase 1 kickoff Beslutningstaker: Alem (CEO) + John (Arkitekt)

---

ADR-002 — Infrastruktur og Hosting

Status: OPEN — påvirker GDPR-posisjonering og kostnad

Spørsmål: Vercel + Supabase ELLER Azure Norway East?

Kriterium	Vercel + Supabase	Azure Norway East
Time to market	Dager	Uker
GDPR-posisjonering	Akseptabel (US-hosting, SCCs)	Sterk (norsk datacenter)
Ops-overhead	Minimal	Medium
Kostnad Phase 1	Lav (~500 NOK/mnd)	Medium (~2K NOK/mnd)
Skalering	God	Utmerket
ALAI-erfaring	Høy	Lav

Kompromiss-alternativ: Start Vercel+Supabase → migrer til Azure Norway East ved 50 kunder (da kan vi selge "norsk hosting" som feature).

Anbefalt beslutningsdato: Før Phase 1 kickoff Beslutningstaker: Alem (CEO)

---

ADR-003 — Autentisering og BankID

Status: OPEN — påvirker MVP-scope og trustnivå

Spørsmål: Email/passord + magic link (MVP) ELLER BankID fra dag 1?

Alternativ	Fordel	Ulempe	Kostnad
Email/passord + magic link	Rask MVP	Lavere tillit	~0
NextAuth.js / Clerk	God DX, sosial login	US-tjeneste, ingen BankID	~300 NOK/mnd
BankID via Nets	Høy norsk tillit	6–12 uker integrering, kostbart	~5K NOK setup + per-auth
BankID via Signicat	Enklere enn Nets	Fortsatt kompleks	~3K NOK/mnd

Anbefaling: Email + magic link for MVP (Clerk), BankID i Phase 2 (etter first revenue).

Norsk kontekst: Norske SMBer forventer BankID for sensitive plattformer. Manglende BankID kan være salgsbarriere mot større kunder.

Anbefalt beslutningsdato: Uke 1 Phase 1 Beslutningstaker: Alem (CEO)

---

ADR-004 — Monorepo vs Polyrepo

Status: OPEN (men sterkt anbefalt: Monorepo)

Spørsmål: Turborepo monorepo (Bilko-mønster) ELLER separate repos?

Anbefaling: Turborepo monorepo.

Begrunnelse:

• Delt kode mellom web + API + mobile (packages/)
• Bilko-erfaring direkte overførbar
• Enklere dependency management
• En PR for cross-cutting changes

---

ADR-005 — Dataresidens og GDPR

Status: OPEN — juridisk viktig

Spørsmål: Kan vi bruke US-hostede tjenester (Vercel, Supabase) for norske HR-data?

Juridisk kontekst:

• GDPR tillater overføring til USA via Standard Contractual Clauses (SCCs)
• Schrems II gjør dette komplisert (men ikke umulig)
• Norske SMBer er ikke alltid klar over dette
• Konkurrenter (Simployer) er norsk-hostet — kan bli salgsargument mot oss

Alternativer:

1. US-hosting med SCCs (akseptabel juridisk, svakere salgsstory)
2. Norsk hosting fra dag 1 (Azure Norway East, Hetzner Falkenstein)
3. Hybrid — kode på Vercel, data på norsk server

Anbefalt beslutningsdato: Uke 2 Phase 1 (etter juridisk vurdering) Beslutningstaker: Alem (CEO) — vurder juridisk rådgivning

---

Allerede vedtatte beslutninger

ADR	Beslutning	Dato
Frontend	Next.js 15 + React 19 + TypeScript + Tailwind + shadcn/ui	2026-02-24
Database	PostgreSQL + Prisma + RLS multi-tenancy	2026-02-24
AI	Claude API (Haiku + Sonnet)	2026-02-24
Mobile (Phase 2)	React Native + Expo	2026-02-24
Monorepo-verktøy	Turborepo (følger Bilko)	2026-02-24
Referansekode	LumisCare (~/projects/client/lumiscare/)	2026-02-24