glossary
Dette dokumentet er auto-synket fra kildefilene i boligassistent-repoet. Endringer her vil overskrives ved neste sync. Rediger kildefilen direkte.
Tekniske systemer og utstyr
Section titled “Tekniske systemer og utstyr”BuildingSystem (Bygningssystem) En kategori av teknisk infrastruktur i boligen (f.eks. varmesystemet, ventilasjonsanlegget, det elektriske anlegget). Et system er en overordnet kategori — ikke én konkret enhet.
Equipment (Utstyr / Teknisk utstyr) En konkret, fysisk installert teknisk enhet. Tilhører et BuildingSystem. Eksempler: varmepumpe, varmtvannsbereder, elbil-lader, avtrekksvifte. Merk: Equipment er ikke det samme som møbler og dekor (InteriorAsset).
Tilstand og avvik
Section titled “Tilstand og avvik”Issue (Avvik / Problem) Et teknisk problem, avvik fra forventet tilstand, eller identifisert risiko. Issues er fakta — de beskriver noe som er galt eller mangelfullt, ikke noe man ønsker å endre. Kan komme fra takstrapport (TG2/TG3), egne observasjoner eller fagrapporter. Merk: Issue er ikke det samme som ImprovementIdea.
TG (Tilstandsgrad) Norsk standard for tilstandsvurdering fra takstrapport:
- TG0 = Ingen avvik
- TG1 = Svake symptomer
- TG2 = Vesentlige symptomer
- TG3 = Store eller alvorlige avvik
- IU = Ikke undersøkt
SafetyItem (Sikkerhetsforhold) Et identifisert sikkerhetsforhold som krever tiltak. Særlig relevant for barnesikkerhet. Skilles fra Issues ved at fokuset er risiko for persons sikkerhet, ikke bygningsteknisk tilstand.
Measurement (Måling) En konkret måling med verdi, enhet og tidspunkt. Eksempler: radon i Bq/m³, luftfuktighet i %, romtemperatur i °C.
Planlegging
Section titled “Planlegging”ImprovementIdea (Forbedringsidé) Et ønsket tiltak som ikke er et teknisk avvik — noe man vil gjøre for å forbedre, oppgradere eller endre boligen. Lever i en backlog og kan modnes over tid. Merk: ImprovementIdea er ikke det samme som Issue.
Task (Oppgave) En konkret, handlingsrettet oppgave som enten løser et Issue eller implementerer en ImprovementIdea. En Task har en ansvarlig, prioritet og status.
MaintenancePlan (Vedlikeholdsplan) En sesongbasert plan med sjekkliste for periodisk vedlikehold av bygningssystemer og rom.
Erfaring
Section titled “Erfaring”Observation (Observasjon) En erfaring registrert fra daglig bruk av boligen. Ikke en oppgave og ikke et avvik — en observasjon beskriver noe man har lagt merke til. Eksempel: «Stuen er kald ved nordveggen om vinteren», «Hagen i vest har sol til kl 15».
SeasonalNote (Sesongnotat) En oppsummering av erfaringer fra én sesong. Brukes til å bygge opp sesongkunnskap over tid.
DecisionNote (Beslutningsnotat) Dokumentasjon av en beslutning som ble tatt — med vurdering, valg og begrunnelse. Viktig for å forstå hvorfor ting ble gjort slik de ble.
Design
Section titled “Design”DesignDirection (Designretning) Et sett av prinsipper, stilord, farger og materialer som definerer den ønskede estetiske retningen for ett domene (interiør, eksteriør eller hage). Er foreløpig og reviderbar. Stilretning er ikke det samme som konkrete objekter (InteriorAsset).
InteriorAsset (Interiørobjekt) Et konkret interiørobjekt — møbel, lampe, dekor, tekstil, kunst eller plante. Tilhører et rom og kan tagges med stil. Merk: InteriorAsset er ikke det samme som Equipment.
LayoutIntent (Romintensjon) Beskrivelse av ønsket bruk og møblering av ett rom: funksjonssoner, trafikkflyt, belysningsbehov og barnesikkerhet. Én LayoutIntent per rom.
Kunnskap
Section titled “Kunnskap”Document (Dokument) Et fil-basert dokument knyttet til eiendom, rom, utstyr eller avvik. Eksempler: takstrapport, salgsoppgave, garanti, kvittering, fagrapport.
Photo (Bilde) Et bilde knyttet til et sted, avvik eller objekt i boligen. Lagres i MinIO.
ProductReference (Produktreferanse) En lenke til et produkt som er relevant for en forbedringsidé, et interiørobjekt eller en oppgave.
Manual (Manual) Brukermanual for konkret utstyr. Kan leses av AI-assistenten via RAG.
Teknisk
Section titled “Teknisk”Source type (Kildetype) Angir hvor en opplysning kommer fra. Viktig for kildebevissthet:
takstrapport— fra profesjonell tilstandsrapportegen_observasjon— registrert av bruker selvfagperson— fra håndverker, ingeniør eller annen fagpersonmåling— fra et instrumentukjent— kilde ikke kjent
Confidence (Sikkerhetsnivå) Angir hvor sikker opplysningen er: høy / medium / lav. Brukes sammen med source_type.
pgvector PostgreSQL-utvidelse som muliggjør lagring og søk i vektorer. Brukes til semantisk søk i AI-kontekst — for å finne de mest relevante entitetene til et bruker-spørsmål.
RAG (Retrieval-Augmented Generation) Teknikk der AI-assistenten henter relevant kontekst fra databasen (f.eks. manualinnhold, romdata) og bruker det som grunnlag for svaret sitt.