🏠 Overview â€ș 🎯 Features â€ș🎯 Activity Registration Wizard

Activity Registration Wizard

Feature Detail

medium complexity extracted Activity Registration Confidence: 100%
3
Components
18
Shared
0
User Stories
Yes
Analyzed

Description

The Activity Registration Wizard provides a multi-step guided flow for logging more complex activities that require additional context beyond a quick log. The wizard walks the peer mentor through sequential steps - contact selection, date, time, duration, activity type, and summary - with progress indication and the ability to save drafts between steps. This complements the simple quick-log by handling structured activity types such as home visits, group sessions, and events that require richer documentation for Bufdir compliance and coordinator oversight.

Sources & reasoning

The mobile architecture section (line 296-298) explicitly lists the wizard as a named screen in the app. The WCAG dragging-movements rule (line 36) directly constrains its navigation pattern. Fase 1 / MVP in the roadmap section (line 405).

Analysis

Business Value

While simple logging handles the majority of activity types, Bufdir reporting requirements and coordinator oversight demand structured data for certain interaction categories. Without a wizard, peer mentors would skip required fields or enter inconsistent data that fails validation at report-generation time. The wizard's draft-save capability is especially important for users with cognitive challenges (NHF's stated priority) who may need to complete a registration across multiple sessions. Consistent structured data also enables the statistics and team reports features that coordinators depend on for quality oversight.

Implementation Notes

Implement using a WizardStepController service that manages step state as an immutable stack in Riverpod. ActivityDraftStore persists incomplete wizard state to Drift so drafts survive app restarts. Each wizard step is a separate Flutter widget with its own validation logic. Navigation uses a custom PageView with animated transitions; back navigation must use explicit back buttons rather than swipe gestures per the WCAG 2.2 dragging movements requirement. The final submission step calls ActivityService which posts to the shared ActivityRepository. Draft IDs are mapped to server IDs after sync to prevent duplicate submissions.

Quality Assurance

Peer Mentor (primary) · Coordinator (same flow)
1
Scenarios
7
UAT Steps
24
A11y Annotations
3
Role Boundaries
Peer Mentor

Peer Mentor

Quick UAT

  1. Åpne appen som Peer Mentor. Trykk pĂ„ Legg til-knappen (senter i bunnavigasjonen) og velg Aktivitet.
  2. Trinn 1 — Kontaktvalg: velg en eksisterende kontakt fra listen. Bekreft at kontaktens navn vises i fremdriftsindikatoren þverst.
  3. Trinn 2 — Dato: bekreft at dagens dato er forhĂ„ndsvalgt. Endre til gĂ„rsdagens dato og trykk Neste.
  4. Trinn 3 — Tid og varighet: bekreft at starttid er forhĂ„ndsvalgt. Endre varighet til 45 minutter og trykk Neste.
  5. Trinn 4 — Aktivitetstype: velg «HjemmebesĂžk» fra listen. Bekreft at obligatoriske felt for denne typen vises og trykk Neste.
  6. Trinn 5 — Sammendrag: skriv en kort tekst i oppsummeringsfeltet og trykk Lagre utkast. Lukk appen, Ă„pne den pĂ„ nytt og gjenoppta utkastet — bekreft at all tidligere data er bevart.
  7. Trykk FullfĂžr registrering. Bekreft at aktiviteten vises under Mine aktiviteter med riktig dato, type og kontakt.

Quick UAT — Accessibility

  1. Åpne appen som Peer Mentor. Trykk pĂ„ Legg til-knappen (senter i bunnavigasjonen) og velg Aktivitet.
    • Screen reader Bunnavigasjon annonseres som 'navigasjonsmeny, 5 elementer'; Legg til-knappen annonseres som 'Legg til, knapp'.
    • Keyboard / focus Tab-rekkefĂžlge: hjem → kontakter → Legg til → arbeid → varslinger. Enter Ă„pner modalvelger.
    • Touch target Legg til-knappen er minst 48×48 CSS-piksler.
  2. Trinn 1 — Kontaktvalg: velg en eksisterende kontakt fra listen. Bekreft at kontaktens navn vises i fremdriftsindikatoren þverst.
    • Screen reader Skjermleser annonserer 'Trinn 1 av 5, Velg kontakt'; hvert listeelement annonseres med navn og rolle.
    • Keyboard / focus Piltaster navigerer i kontaktlisten; Enter velger kontakt.
    • Focus visibility Synlig fokusring pĂ„ valgt kontakt; fremdriftsindikator har aria-label 'Trinn 1 av 5'.
    • Zoom Listen er brukbar ved 200 % zoom — ingen horisontal scrolling pĂ„krevd.
  3. Trinn 2 — Dato: bekreft at dagens dato er forhĂ„ndsvalgt. Endre til gĂ„rsdagens dato og trykk Neste.
    • Screen reader Datovelger annonseres med gjeldende verdi og instruksjoner for endring.
    • Keyboard / focus Piltaster endrer dag/mĂ„ned/Ă„r i datovelgeren; Tab flytter til Neste-knapp.
    • Focus visibility Neste-knapp har synlig fokusring og label 'Neste'.
    • Contrast Valgt dato skiller seg fra ikke-valgt dato med annet enn farge alene (f.eks. fet skrift eller ramme).
  4. Trinn 3 — Tid og varighet: bekreft at starttid er forhĂ„ndsvalgt. Endre varighet til 45 minutter og trykk Neste.
    • Screen reader Varighetsvelger annonserer gjeldende verdi i minutter; endringer leses opp ved hvert trinn.
    • Keyboard / focus Piltaster justerer varighet; Tab til Neste-knapp.
    • Touch target Øk/minsk-knapper for varighet er minst 24×24 CSS-piksler.
  5. Trinn 4 — Aktivitetstype: velg «HjemmebesĂžk» fra listen. Bekreft at obligatoriske felt for denne typen vises og trykk Neste.
    • Screen reader Hvert alternativ annonseres med navn; valgt alternativ annonseres som 'valgt'.
    • Focus visibility Fokus flyttes automatisk til fĂžrste nye obligatoriske felt etter typevalg.
    • Live region Polite live region annonserer 'Nye obligatoriske felt er tilgjengelige' nĂ„r HjemmebesĂžk velges og ekstra felt lastes.
  6. Trinn 5 — Sammendrag: skriv en kort tekst i oppsummeringsfeltet og trykk Lagre utkast. Lukk appen, Ă„pne den pĂ„ nytt og gjenoppta utkastet — bekreft at all tidligere data er bevart.
    • Screen reader Tekstfelt annonseres med label 'Sammendrag, obligatorisk'; tegnantall leses opp ved endringer.
    • Focus visibility Lagre utkast-knapp har synlig fokusring og aria-label 'Lagre utkast og fortsett senere'.
    • Live region Polite live region annonserer 'Utkast lagret' etter vellykket lagring.
    • Zoom Tekstfeltet er brukbart ved 200 % zoom uten at tekst klippes.
  7. Trykk FullfĂžr registrering. Bekreft at aktiviteten vises under Mine aktiviteter med riktig dato, type og kontakt.
    • Screen reader Bekreftelsesmelding annonseres av skjermleser; navigasjon tilbake til aktivitetslisten annonserer ny rad.
    • Focus visibility Fokus flyttes til bekreftelsesbanneret eller fĂžrste element i oppdatert aktivitetsliste.
    • Live region Polite live region annonserer 'Aktivitet registrert. Vises nĂ„ under Mine aktiviteter.'

Role Boundaries

3 role(s) must NOT access this feature
  • Organization Administrator

    Veiviseren finnes ikke i Admin Web Portal-navigasjonen; org-admin bruker koordinatorrollen i mobilappen (samme tilgang som koordinator) — admin-portalens aktivitetsoversikt tilbyr kun godkjenning og korrigering, ikke wizard-registrering.

  • Global Administrator

    Global Admin har ingen tilgang til mobilappen og ser Aktivitet-veiviseren hverken i navigasjon eller via deep-link; forsĂžk returnerer 403.

  • Prospective Organization Representative

    Rollen eksisterer kun pÄ salgsnettstedet; har ingen brukerkonto i den operative plattformen og kan ikke nÄ veiviseren.

Expected End State

Aktiviteten er lagret med status FullfĂžrt, knyttet til valgt kontakt og synlig under Mine aktiviteter for Peer Mentor og i aktivitetsoversikten for Coordinator. Aktivitetsdata er strukturert og klar for Bufdir-rapportering.

Components (21)

User Interface (1)

ui ActivityWizardScreen medium

Service Layer (1)

service WizardStepController medium

Data Layer (1)

data ActivityDraftStore medium

Shared Components

These components are reused across multiple features

User Stories

No user stories have been generated for this feature yet.