Formalized Home-Visit Report
Feature Detail
Description
The Formalized Home-Visit Report provides a structured after-visit reporting template specifically designed for home visit interactions. The report captures standardized fields including health status observations, course interest, assistive equipment situation, and a "next steps" section that functions as a task handoff to the coordinator. The form uses checkboxes and short free-text fields to minimize writing burden while ensuring completeness. Completed reports are linked to the associated activity record and are accessible to the coordinator for follow-up planning.
Sources & reasoning
Lines 96-98 define the exact field structure and coordinator-handoff purpose. Line 354-355 places this in Fase 3 (v1.1) in the roadmap, and the needs matrix marks it NICE (Blind. + Barnekreft) / Fase 3. Two organizations, not universal, and Fase 3 maps to v1.1 by ordinal.
-
docs/source/likeperson.md · line 96-98Formalisert rapportstruktur etter hjemmebesøk: Helsetilstand, kursinteresse, hjelpemiddelsituasjon, «veien videre» - fungerer som bestilling til koordinatoren.
-
docs/source/likeperson.md · line 354-355Formalisert rapportstruktur (Blindeforbundet + Barnekreftforeningen)
Analysis
Both Blindeforbundet and Barnekreftforeningen identified a formalized post-visit report structure as important for coordinator follow-up. Blindeforbundet's home visits involve sensitive health and equipment assessments that need structured capture so coordinators can act on the information without a separate verbal debrief. Barnekreftforeningen works with families in difficult situations where consistent structured reporting ensures no follow-up action falls through the gaps. The standardized structure also enables aggregate analysis of common themes across visits, supporting continuous program improvement and providing richer data for Bufdir quality reporting.
Implement HomeVisitReportScreen as a Flutter form with section-grouped fields matching the documented structure (health status, course interest, equipment, next steps). HomeVisitReportService handles submission and links the report to the parent activity via the activity_id foreign key. HomeVisitReportRepository persists to the home_visit_reports table. The form is triggered as an optional post-completion step after an activity wizard submission when the activity type is "home visit." Organization-specific field sets can be configured via the Organization Labels system to accommodate Blindeforbundet vs Barnekreftforeningen terminology differences without separate code paths. WCAG 2.2 AA compliance required throughout.
Quality Assurance
Peer Mentor (primary) · Coordinator (subject — receives report for follow-up)Peer Mentor
Quick UAT
- Logg inn i appen som Peer Mentor. Gå til Aktiviteter og åpne en aktivitet av typen hjemmebesøk.
- Trykk på 'Hjemmebesøksrapport' eller tilsvarende knapp nederst på aktivitetsdetaljskjermen for å åpne rapportskjemaet.
- Fyll ut avkrysningsfeltene for helsetilstand — velg minst ett alternativ og bekreft at valgene lagres visuelt.
- Fyll ut feltet for kursinteresse og hjelpemiddelsituasjon ved hjelp av de tilgjengelige avkrysningsboksene.
- Skriv inn en kort fritekst i 'Veien videre'-feltet som beskriver neste steg for koordinatoren.
- Trykk 'Lagre' eller 'Send inn rapport'. Bekreft at appen returnerer til aktivitetsdetaljskjermen og viser et sammendrag eller bekreftelsesmerke som indikerer at rapporten er koblet til aktiviteten.
Quick UAT — Accessibility
-
Logg inn i appen som Peer Mentor. Gå til Aktiviteter og åpne en aktivitet av typen hjemmebesøk.
- Screen reader Sideoverskrift 'Aktiviteter' annonseres ved navigasjon; aktivitetslisten leses rad for rad med tittel og dato.
- Keyboard / focus Tab-rekkefølge: bunnavigasjon → aktivitetsliste → aktivitetsrad; Enter åpner aktiviteten.
- Focus visibility Synlig fokusring på valgt aktivitetsrad.
-
Trykk på 'Hjemmebesøksrapport' eller tilsvarende knapp nederst på aktivitetsdetaljskjermen for å åpne rapportskjemaet.
- Screen reader 'Hjemmebesøksrapport, knapp' annonseres av skjermleser.
- Keyboard / focus Knappen nås med Tab; aktiveres med Enter eller Space.
- Focus visibility Fokus flyttes automatisk til første felt i rapportskjemaet ved åpning.
- Touch target ≥ 24×24 CSS px
-
Fyll ut avkrysningsfeltene for helsetilstand — velg minst ett alternativ og bekreft at valgene lagres visuelt.
- Screen reader Hvert avkrysningsfelt annonseres som 'avkrysningsboks, [etikett], ikke avkrysset / avkrysset' ved fokus og ved endring.
- Keyboard / focus Space veksler avkrysset-tilstand; Tab beveger mellom boksene i logisk rekkefølge.
- Focus visibility Synlig fokusring rundt aktiv avkrysningsboks.
- Touch target ≥ 24×24 CSS px per avkrysningsboks
- Contrast 4.5:1 for etiketttekst; avkrysset-tilstand indikeres ikke av farge alene — hake-ikon brukes.
-
Fyll ut feltet for kursinteresse og hjelpemiddelsituasjon ved hjelp av de tilgjengelige avkrysningsboksene.
- Screen reader Seksjonstittel 'Kursinteresse' og 'Hjelpemiddelsituasjon' annonseres som overskrifter; avkrysningsbokser leses med etiketter.
- Keyboard / focus Tab navigerer mellom seksjoner og bokser; Space veksler tilstand.
- Focus visibility Synlig fokusring; seksjonsoverskrifter er semantisk merket som h2 eller h3.
- Contrast Etiketter og seksjonstekst har minimum 4.5:1 kontrast mot bakgrunn.
-
Skriv inn en kort fritekst i 'Veien videre'-feltet som beskriver neste steg for koordinatoren.
- Screen reader Tekstfeltet annonseres med etikett 'Veien videre' og rolle 'tekstfelt, flerlinje' ved fokus.
- Keyboard / focus Tab når tekstfeltet; standard tekstinntasting fungerer uten snarveikonflikter.
- Focus visibility Synlig fokusring rundt tekstfeltet.
- Zoom Feltet forblir lesbart og redigerbart ved 200 % zoom uten horisontal scrolling.
-
Trykk 'Lagre' eller 'Send inn rapport'. Bekreft at appen returnerer til aktivitetsdetaljskjermen og viser et sammendrag eller bekreftelsesmerke som indikerer at rapporten er koblet til aktiviteten.
- Screen reader Suksessmelding eller bekreftelsesmerke annonseres via polite live-region: 'Hjemmebesøksrapport lagret og koblet til aktiviteten.'
- Keyboard / focus Lagre-knappen nås med Tab; Enter sender inn.
- Focus visibility Fokus returnerer til aktivitetsdetaljskjermen etter innsending.
- Live region 'Hjemmebesøksrapport lagret og koblet til aktiviteten.'
Coordinator
Quick UAT
- Logg inn i appen som Koordinator. Gå til Aktiviteter og åpne en aktivitet som er registrert av en av dine Peer Mentors etter et hjemmebesøk.
- Bekreft at aktivitetsdetaljskjermen viser en 'Hjemmebesøksrapport'-seksjon med feltene helsetilstand, kursinteresse, hjelpemiddelsituasjon og 'Veien videre' utfylt av Peer Mentoren.
- Bekreft at 'Veien videre'-innholdet er lesbart og kan brukes som grunnlag for koordinatorens oppfølging uten behov for separat muntlig debrief.
Quick UAT — Accessibility
-
Logg inn i appen som Koordinator. Gå til Aktiviteter og åpne en aktivitet som er registrert av en av dine Peer Mentors etter et hjemmebesøk.
- Screen reader Aktivitetslisten leses med Peer Mentor-navn og dato; aktivitetstype annonseres i detaljer.
- Keyboard / focus Tab-navigasjon og Enter åpner aktiviteten.
- Focus visibility Fokusring synlig på valgt aktivitetsrad.
-
Bekreft at aktivitetsdetaljskjermen viser en 'Hjemmebesøksrapport'-seksjon med feltene helsetilstand, kursinteresse, hjelpemiddelsituasjon og 'Veien videre' utfylt av Peer Mentoren.
- Screen reader Seksjon 'Hjemmebesøksrapport' annonseres som overskrift; hvert felt leses med etikett og verdi.
- Focus visibility Skjermlesernavigasjon via overskrifter fungerer — H-tast navigerer rett til rapportseksjonen.
- Zoom Rapporten er lesbar ved 200 % zoom uten tap av innhold.
- Contrast Avkryssede verdier og fritekst har minimum 4.5:1 kontrast.
-
Bekreft at 'Veien videre'-innholdet er lesbart og kan brukes som grunnlag for koordinatorens oppfølging uten behov for separat muntlig debrief.
- Screen reader 'Veien videre, [innhold]' leses som et merket tekstfelt i skrivebeskyttet modus.
- Zoom Fritekstinnholdet skalerer riktig ved 200 % og forblir lesbart.
Role Boundaries
3 role(s) must NOT access this feature-
Organization Administrator
Skjermen finnes ikke i admin-portalen; rapporten er kun tilgjengelig som del av aktivitetsdetaljvisning i mobilappen via koordinatorvisning.
-
Global Administrator
Global Administrator har ingen tilgang til mobilappen; skjermen er utilgjengelig fra admin-portalen.
-
Prospective Organization Representative
Prospective Organization Representative har ingen brukerkonto i mobilappen; deep-link returnerer 401.
Expected End State
Hjemmebesøksrapporten er lagret og koblet til aktivitetsposten. Koordinatoren kan lese rapporten direkte fra aktivitetsdetaljvisningen og bruke 'Veien videre'-innholdet som oppfølgingsgrunnlag uten separat debrief.
Components (21)
Shared Components
These components are reused across multiple features
User Stories
No user stories have been generated for this feature yet.