# 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 |