project-summary

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

Hva brukeren ønsker å oppnå

1. Bli kjent med huset over 1–2 sesonger før store beslutninger tas
2. Håndtere nødvendig vedlikehold, sikkerhet og risikoreduksjon systematisk
3. Skape trygge omgivelser for et lite barn
4. Bygge en langsiktig backlog av forbedringsidéer uten å beslutte for tidlig
5. Utvikle en helhetlig stil på tvers av interiør, eksteriør og hage
6. Bruke en AI-assistent som faktisk kjenner boligen

---

Hva som er viktig i prosjektet

• Separasjon av begreper: Problem ≠ Ønske. Observasjon ≠ Oppgave. Møbel ≠ Teknisk utstyr.
• Kildebevissthet: All data skal ha kilde (takstrapport, egne observasjoner, fagperson)
• Gradvis modning: Systemet skal tåle at forståelse og ønsker endres over tid
• Praktisk brukbarhet: Modellen skal hjelpe beslutninger, ikke komplisere dem
• AI-kontekst: Datastrukturen designes for at AI kan hente riktig kontekst

---

Hoveddatamodell

HouseModel
├── Property              — Eiendommen som helhet (adresse, areal, byggeår)
├── SpatialModel          — Etasjer, rom, uteområder, støtterom
├── BuildingSystems       — Tekniske systemer (varme, elektro, VVS, drenering)
├── Assets                — Teknisk utstyr (varmepumpe, varmtvannsbereder, lader)
├── ConditionLayer        — Avvik (Issue), sikkerhet (SafetyItem), målinger
├── PlanningLayer         — Forbedringsidéer, oppgaver, vedlikeholdsplan
├── ExperienceLayer       — Observasjoner, sesongnotater, beslutningsnotater
├── DesignLayer           — Designretning (interiør / eksteriør / hage)
├── InteriorLayer         — Møbler, lamper, dekor og romintensjon
└── KnowledgeLayer        — Dokumenter, bilder, produktlenker, manualer

Relasjoner er dokumentert i docs/domain/relations.md.

---

Brukere

• Preben — primærbruker, PC-primær, mobilbruk sekundært
• Partner — sekundærbruker, PC-primær, mobilbruk sekundært
• Begge knyttet til samme hus, sporing av hvem som registrerte hva

---

Teknisk stack

Komponent	Valg
Monorepo	Turborepo + pnpm
Frontend	React + Vite + shadcn/ui + Tailwind
Backend	Express.js
Database	PostgreSQL 16 + Drizzle ORM + pgvector
Auth	Auth.js
Filer	MinIO (S3-kompatibel)
AI	Claude API + DALL-E 3 + Brave Search
Drift	Docker Compose, lokalt med nettilgang

---

Hvorfor systemet er spesielt

De fleste løsninger dekker bare ett av disse domenene:

• Vedlikehold og teknisk tilstand
• Estetikk og design
• Daglig liv og observasjoner

Dette systemet kobler alle tre i én modell — og gir dermed en AI-assistent reell kontekstuell forståelse av boligen, ikke bare generiske råd.

---

Neste steg

Se docs/project-state/current-state.md for nåværende status og docs/project-state/roadmap.md for utviklingsplan.