Activity Wizard Screen
Component Detail
Description
Multi-step wizard screen that guides users through a structured activity registration flow. Each step is a separate widget rendered within a nested navigator, providing independent back-navigation without losing progress. Displays a progress indicator, step-specific content, inline validation errors, and navigation controls (Back/Next/Submit).
activity-wizard-screen
Responsibilities
- Render sequential wizard steps (contact, activity type, date/time, duration, notes/attachments, review)
- Display progress indicator showing current step and total steps
- Handle step-level navigation with back button support (no swipe)
- Show inline validation errors per step on Next tap
- Render final review summary screen before submission
Interfaces
buildWizardStep(stepIndex)
navigateToStep(stepIndex)
navigateBack()
submitActivity()
showValidationErrors(errors)
renderProgressIndicator(currentStep, totalSteps)
renderReviewSummary(wizardState)
onStepCompleted(stepIndex, stepData)
resetWizard()
showSubmissionConfirmation()
Relationships
Sub-Components (4)
First wizard step allowing the user to search and select a contact for the activity. Integrates with the existing contact list and supports filtering by name.
- Display searchable contact list
- Allow selection of one or more contacts
- Validate that at least one contact is selected
Wizard step for selecting the activity type (home visit, phone call, group event, etc.). Renders organization-specific activity types using configurable labels from the organization settings system.
- Display available activity types with organization-specific labels
- Allow single activity type selection
- Validate selection before proceeding
Wizard step for entering date, start time, and duration of the activity. Pre-fills with sensible defaults (today's date, 30-minute duration) that the user can override, minimizing input effort.
- Provide date picker with today as default
- Provide time picker with current time as default
- Provide duration selector with 30-minute default
- +1 more
Optional wizard step for adding free-text notes and file attachments to the activity. Supports structured report fields for specific activity types (e.g., home visits for Blindeforbundet) and document attachments for Bufdir verification.
- Provide free-text notes input field
- Allow file/photo attachment upload
- Render structured report fields when required by activity type
- +1 more