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:
- US-hosting med SCCs (akseptabel juridisk, svakere salgsstory)
- Norsk hosting fra dag 1 (Azure Norway East, Hetzner Falkenstein)
- 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 |