Activity Registration Wizard
Feature Detail
Description
Multi-step guided flow (contact → date → time → duration → summary) for activities that need more context than a quick log - e.g. home visits, structured follow-ups, or registrations that may feed into expense claims. The wizard reduces cognitive load by presenting one decision per screen with a visible progress indicator and a back button rather than sideways swipe. Used when the registration carries enough structure that field-by-field guidance pays off, and as the path users with cognitive accessibility needs (e.g. NHF's stroke-survivor mentors) take by default.
Sources & reasoning
The mobile-app architecture section explicitly lists the multi-step Activity wizard, and §1.2 motivates the step-by-step layout for cognitive accessibility. Both belong to MVP per the Fase 1 mobile scope in §5.
-
docs/source/likeperson.md · line 221-222Activity wizard (multi-step: contact → date → time → duration → summary)
-
docs/source/likeperson.md · line 19-23Kognitiv tilgjengelighet: NHF nevner spesifikt slagrammede. Enkel navigasjon, logisk flyt, ikke for mange valg ... Tilbakeknapp fremfor sidelengs-sveip.
Analysis
The wizard makes activity registration usable for the long tail of mentors who find a single dense form overwhelming - a group NHF explicitly highlights (stroke survivors, cognitive impairments). Without this path the MVP would either alienate that audience or force the simple form to bloat into something neither audience uses well. It also creates the structured entry point that downstream features (formalised home-visit report, expense linking, document attachments) hook into without contaminating the quick-log path.
Flutter PageView-style wizard with per-step validation and persistent draft state in Drift, so a half-filled wizard survives app kill. Each step renders a single decision plus optional skip; back button is hardware/visible, no sideways swipe (workshop principle). Final summary screen is reviewable and edits route back to the relevant step. Shares the same activity write path as Simple Activity Logging - the wizard is a UI on top of the same domain service, not a parallel pipeline. Speech-to-text and attachments mount as additional steps only when their parent modules are enabled for the tenant.
Quality Assurance
Peer Mentor (primary)Peer Mentor (Likeperson)
Quick UAT
- Logg inn i Meander-appen som Likeperson. Trykk paa Legg til-knappen i bunnmenyen og velg Aktivitet (veiviser).
- Velg en eksisterende kontakt fra listen i steg 1 (Kontakt) og trykk Neste.
- I steg 2 (Dato) skal dagens dato vaere forvalgt. Endre datoen til i gaar og trykk Neste.
- I steg 3 (Tid) bekreft forvalgt klokkeslett og trykk Neste. Trykk deretter Tilbake og bekreft at tidligere verdier er bevart.
- I steg 4 (Varighet) endre standardverdien fra 30 min til 45 min og trykk Neste.
- I steg 5 (Oppsummering) gjennomgaa feltene og trykk Lagre aktivitet.
- Bekreft at aktiviteten vises oeverst i Mine aktiviteter med riktig kontakt, dato og varighet.
Quick UAT — Accessibility
-
Logg inn i Meander-appen som Likeperson. Trykk paa Legg til-knappen i bunnmenyen og velg Aktivitet (veiviser).
- Screen reader TalkBack/VoiceOver leser 'Legg til, knapp'. Modal-meny annonseres med rolle 'meny' og fokus flyttes til foerste valg.
- Focus visibility Synlig fokusring paa menyvalg ved tastaturnavigasjon.
- Touch target Legg til-knapp og menyvalg minst 24x24 CSS-piksler.
-
Velg en eksisterende kontakt fra listen i steg 1 (Kontakt) og trykk Neste.
- Screen reader Stegindikator annonseres som 'Steg 1 av 5, Kontakt'. Hver kontaktrad leser navn og rolle.
- Keyboard / focus Tab gaar stegindikator -> soek -> kontaktliste -> Neste. Piltaster navigerer kontaktrader.
- Focus visibility Neste-knapp er deaktivert (aria-disabled=true) til kontakt er valgt; tilstandsendring annonseres.
-
I steg 2 (Dato) skal dagens dato vaere forvalgt. Endre datoen til i gaar og trykk Neste.
- Screen reader Datofelt leses som 'Dato, i dag, [dato], rediger'. Endret verdi annonseres etter valg.
- Keyboard / focus Datovelger fullt tastaturstyrbar; piltaster flytter dag, Shift+Pil flytter uke.
- Live region 'Dato endret til [i gaars dato]' annonseres hoeflig.
-
I steg 3 (Tid) bekreft forvalgt klokkeslett og trykk Neste. Trykk deretter Tilbake og bekreft at tidligere verdier er bevart.
- Screen reader Tilbake-knapp leses som 'Tilbake til Dato, knapp'. Ved retur annonseres bevart verdi i steg 3.
- Keyboard / focus Tilbake og Neste naas via Tab; Enter aktiverer.
- Focus visibility Ved navigering Tilbake/Neste flyttes fokus til steg-overskrift, ikke til toppen av siden.
-
I steg 4 (Varighet) endre standardverdien fra 30 min til 45 min og trykk Neste.
- Screen reader Inntastingsfelt leses som 'Varighet i minutter, 30, juster'. Ny verdi annonseres ved endring.
- Touch target Plus/minus-knapper minst 24x24 CSS-piksler.
- Zoom Veiviseren forblir brukbar ved 200% zoom; ingen avkutting av Neste-knapp.
-
I steg 5 (Oppsummering) gjennomgaa feltene og trykk Lagre aktivitet.
- Screen reader Oppsummeringen leses som definisjonsliste: 'Kontakt: [navn]; Dato: [dato]; Tid: [tid]; Varighet: 45 minutter.'
- Focus visibility Lagre aktivitet-knapp har synlig fokusring og er primaerknapp.
- Contrast Lagre-knapp oppfyller 4.5:1 mot bakgrunn; status formidles ikke av farge alene.
-
Bekreft at aktiviteten vises oeverst i Mine aktiviteter med riktig kontakt, dato og varighet.
- Screen reader Ny rad i Mine aktiviteter leses med kontakt, dato og varighet i logisk rekkefoelge.
- Live region 'Aktivitet lagret' annonseres hoeflig.
Role Boundaries
3 role(s) must NOT access this feature-
Organization Administrator
Org Admin har ikke paalogging i mobilappen; veiviseren er ikke tilgjengelig. Admin-portalen har ingen aktivitetsveiviser og deep-link til mobilrute returnerer 404/forbudt.
-
Global Administrator
Ingen tilgang til mobilappen; veiviseren er ikke synlig i admin-portalen og deep-link returnerer 403.
-
Prospective Buyer
Salgsnettstedet har ingen innlogging eller veiviser; ruten eksisterer ikke.
Expected End State
En ny aktivitet er lagret i activities-tabellen knyttet til valgt kontakt med korrekt dato, klokkeslett og varighet (45 min), og vises oeverst i Mine aktiviteter. Veiviser-utkastet er ryddet bort fra lokal draft-lagring.
Components (4)
Shared Components
These components are reused across multiple features
User Stories
No user stories have been generated for this feature yet.