Activity Registration Wizard

Description

The Activity Registration Wizard provides a guided multi-step flow for complex activities requiring more context than quick logging allows. The wizard walks users through five steps - contact selection, date, time, duration, and summary confirmation - ensuring all required data is captured. This structured approach reduces data entry errors while accommodating users with lower digital literacy, meeting the cognitive accessibility requirements highlighted by all four partner organizations.

Sources & reasoning

Line 296 defines the wizard's multi-step flow in the Mobile App Architecture section. Line 316 places activity registration in Fase 1 MVP. Blueprint assigns [MVP] confirming launch-critical status. The wizard complements quick logging for activities requiring full context and is a dependency for downstream features including document attachments and formalized home-visit reports.

docs/source/likeperson.md · line 296

Activity wizard (multi-step: contact → date → time → duration → summary)
docs/source/likeperson.md · line 316

Aktivitetsregistrering med lavest mulig antall klikk og standardverdier

Analysis

Business Value

The wizard addresses complex activity types that cannot be captured through quick logging, such as home visits or sessions requiring specific type selection for Bufdir compliance. A guided sequential flow reduces data entry errors that compromise reporting accuracy. The step-by-step structure with back navigation supports users with cognitive challenges, including stroke survivors explicitly noted by NHF. This feature is also a dependency for document attachments and formalized home-visit reports, ensuring the complete, high-quality data administrators rely on for oversight and Bufdir report generation.

Implementation Notes

Implemented in Flutter with Bloc state management. Each wizard step (contact, date/time, duration, summary) is a separate widget on a navigator stack allowing back navigation without data loss. ActivityWizardService accumulates state across steps and delegates persistence to ActivityRepository via Drift with offline-first support. Swipe navigation is disabled in favor of explicit back buttons per accessibility requirements. The summary screen enables review before committing. All inputs require semantic labels and visible focus indicators for WCAG 2.2 AA compliance throughout the wizard flow.