scope-mvp

Dette dokumentet er auto-synket fra kildefilene i boligassistent-repoet. Endringer her vil overskrives ved neste sync. Rediger kildefilen direkte.

I MVP

Autentisering og brukere

Pålogging med e-post + passord (Auth.js)
To brukere knyttet til ett hus, felles arbeidsrom
Hus-basert tilgangskontroll (ingen kryssing mellom hus)
Ikke i MVP: attribusjon i UI, aktivitetsfeed, assignee, partner-varsler eller andre koordineringsmekanismer mellom de to brukerne. Paret koordinerer ved samtale. Se docs/product/non-goals.md.
Teknisk lagres created_by i databasen for sporbarhet på backend, men eksponeres ikke i UI.

Brukerprofil og preferanser (UserPreferences)

Hver bruker har en egen preferanseprofil som styrer AI-tonen mot dem individuelt
MVP-felt: budsjettstrategi, arbeidsstrategi (DIY vs fagperson), tidshorisont
Valgfritt livssituasjon-felt (fritekst-tagger)
Standardverdier settes ved opprettelse — brukeren trenger ikke fylle ut noe
Profilen injiseres i AI-systemprompten ved alle forespørsler for den innloggede brukeren
Kan oppdateres fra innstillinger
Profilene er interne for AI-kontekst, ikke eksponert som “partnerens preferanser”-visning

Spatial Model (Spec 001)

Registrere eiendom med metadata (adresse, byggeår, areal)
Registrere etasjer med nivå og areal
Registrere rom med type, funksjon, tilstand og tilknytning til etasje
Registrere uteområder (hage, terrasse, garasje, passasjer)
Registrere støtterom (krypkjeller, vedskjul, avfallsstasjon)

Tekniske systemer (Spec 002)

Registrere bygningssystemer med kategori, beskrivelse og status
Koble systemer til rom og eiendom
Støttede kategorier: varme, ventilasjon, vann/avløp, elektro, drenering, fasade, pipe

Avvik og sikkerhet (Spec 003)

Registrere Issues med kategori, alvorlighetsgrad og TG-kode
Knytte Issues til rom, uteområder og bygningssystemer
Registrere SafetyItems med risiko og prioritet, særlig barnesikkerhet
Grunnleggende Measurements (radon, fukt, temperatur)
Kildebevissthet på alle avvik (takstrapport, egen observasjon, fagperson)

Observasjoner (Spec 004)

Registrere observasjoner knyttet til rom, uteområder og systemer
Kategorier: daglig bruk, sesong, barnesikkerhet, inneklima, hage
Sesong og dato
Mobilvennlig registreringsgrensesnitt

Forbedringsidéer og oppgaver (Spec 005)

Registrere ImprovementIdeas med prioritet, estimat og backlog-status
Kostnadsintervall (min/maks) på ImprovementIdeas og Tasks for bedre beslutningsstøtte
Opprette Tasks knyttet til Issues og ImprovementIdeas
DIY-klassifisering på Tasks: gjør selv / gjør selv med veiledning / fagperson
Grunnleggende MaintenancePlan-struktur
Koble oppgaver til rom og systemer

Designretning og interiørobjekter (Spec 006)

Registrere DesignDirection per domene (interiør, eksteriør, hage)
Stilord, prinsipper, farger og hva som skal unngås
Registrere InteriorAssets (møbler, lamper, dekor) med rom og stiltagger
LayoutIntent per rom

Kunnskapslag

Laste opp bilder (MinIO) knyttet til rom, avvik, utstyr
Laste opp dokumenter (manualer, takstrapport, kvitteringer)
Produktlenker som referanse

Prioriteringsdashboard (Spec 008)

Samlet “Hva bør jeg gjøre nå?”-visning ved innlogging
Tre kategorier: Haster nå / Planlegg snart / Backlog
Aggregerer Issues, SafetyItems, Tasks og ImprovementIdeas på tvers
Kobling til AI-oppsummering (J1-journey)
Mobilvennlig

Dokumentinntak og AI-bootstrap (Spec 007)

Last opp salgsoppgave og/eller takstrapport (PDF)
AI-ekstraksjon av Property, SpatialModel og BuildingSystems med confidence-score
Brukergjennomgang: godkjenn / endre / forkast hvert uttrukket faktum
Kildehenvisning per faktum (sidenummer i originaldokument)
Bootstrap av modellen etter godkjenning: romstruktur, systemer, avvik, vedlikeholdsoppgaver
Støtte for nye dokumenter med forslag til oppdatering av eksisterende data

AI-assistent (grunnleggende)

Chat-grensesnitt for kontekstuell rådgivning
Kontekstbygging basert på valgt rom, relevant utstyr og designretning
Svar basert på faktiske data om boligen

Ikke i MVP

Se docs/product/non-goals.md for full liste. Spesifikt for dette prosjektet:

Funksjonalitet	Begrunnelse
AI-genererte rombilder (DALL-E 3)	Krever mer modning av romdata og stilmodell
Produktsøk via Brave Search	Krever mer testing av søkekvalitet
Sesongbaserte vedlikeholdsplaner (automatisert)	Manuell backlog er tilstrekkelig i MVP
Multi-hus-støtte	Bygges for én husstand i MVP, men arkitektur støtter det
Eksport av dokumentasjon	Lavere prioritet enn innlegging av data
Avansert rapportering / statistikk	Ikke nødvendig i tidlig fase
Offline-støtte	Krever service worker og kompleksitet
Integrasjon mot Matrikkelen / offentlige registre	For tidlig
Prediktivt vedlikeholdsvarsel	Krever historiske data over tid

Faktisk gjennomført utviklingsrekkefølge

Rekkefølgen avviker noe fra opprinnelig plan — særlig ved tillegg av Fase 0, 2.5 og 3.5 underveis. Se docs/project-state/roadmap.md for fullstendig historikk og status.

Fase 0 — Prosjektoppsett ✅ (2026-03-18)
  Turborepo + pnpm, Docker Compose, Auth.js, React/Vite/shadcn, DB-migrasjoner

Fase 1 — Kjernedata ✅ (2026-03-28)
  Spec 001: Spatial Model
  Spec 002: Tekniske systemer
  Spec 007: Salgsoppgave PDF-import (Gemini Files API)

Fase 2 — Tilstand og planlegging ✅ (2026-03-31)
  Spec 003: Avvik og sikkerhet
  Spec 004: Observasjoner
  Spec 005: Forbedringsidéer og oppgaver
  Spec 008: Prioriteringsdashboard
  Spec 009: Slett eiendom
  Spec 010: Avbryt import
  Spec 011: Tilstandsrapport PDF-import

Fase 2.5 — CRUD-fullføring og UX-gaps ✅ (2026-04-08)
  Infrastrukturfikser (localStorage, Error Boundary, nav)
  Spec 012: Innstillinger og UserPreferences
  Spec 013: Observation→Task / Issue→Task quick-create
  Spec 014–016: CRUD-fullføring (edit/delete for alle entiteter)
  Spec 017: Vaktmester-dashboard

Fase 3 — Design, bilder og AI-planlegging ✅ (2026-04-09)
  Spec 019: Dashboard-triage og kortgruppering
  Spec 020: KnowledgeLayer — bilder (mobil-first)
  Spec 021: MaintenancePlan→Task ett-klikk
  Spec 006: DesignDirection og InteriorAssets
  Spec 018: Arkitekt-dashboard
  Spec 022: ImprovementDependency + AI-planlegger

Fase 3.5 — Mobil-optimalisering ✅ (2026-04-09)
  Spec 030: PWA-installasjon
  Spec 031: Mobil navigasjon og layout (bunnmeny, FAB, safe areas)
  Spec 032: Mobil landingsside
  Spec 033: Quick-add (+) flyt
  Spec 034: Kameraintegrasjon og bildeopplasting

Fase 4 — AI-assistent (planlagt)
  Embedding-pipeline + pgvector semantisk søk
  Kontekstbygging + Claude API chat-grensesnitt
  Specs 023–029, 035–038 (se roadmap for detaljer)

Suksesskriterier for MVP

Begge brukere kan logge inn og se samme bolig i felles arbeidsrom
Alle rom, systemer og avvik fra takstrapport er lagt inn
Observasjoner kan registreres fra mobil på under 30 sekunder i enkleste tilfelle
Forbedringsbacklog er i bruk
AI-assistenten kan svare på spørsmål om ett spesifikt rom basert på faktiske data
Hver hovedskjerm består en forenklings-test: kan noe fjernes uten å miste verdi? Se docs/ux/personas.md seksjon 3.3 (beslutningsregel).