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

Description

This feature provides a structured multi-step wizard for registering activities that require more detail than the quick-log widget supports. The wizard guides the user through a linear flow: contact selection → activity type → date and time → duration → optional notes and attachments → review and submit. Each step is a full screen with clear progress indication, back navigation, and inline validation. The wizard is the primary registration path for first-time users and for complex activities such as group events, home visits with structured report fields, or activities requiring expense linkage.

User Flow

Activity Registration Wizard user flow
Click to expand

Analysis

Business Value

Not all activities fit the quick-log pattern. Home visits (Blindeforbundet), group activities with multiple attendees (NHF), and activities requiring structured report fields all demand a guided registration experience that ensures completeness and accuracy. The wizard format reduces input errors by breaking a complex form into digestible steps, each with focused context and validation. This directly improves the quality of data available for Bufdir reporting and organizational analytics. A well-designed wizard also serves as an onboarding mechanism, teaching new peer mentors the vocabulary and structure of activity reporting through the act of completing their first registration.

Implementation Notes

Built in Flutter as a multi-screen wizard using a shared WizardStateManager BLoC that holds form state across steps and handles navigation. Each step is a separate widget pushed onto a nested navigator, enabling independent back-navigation without losing progress. Step order is configurable per organization via the organization labels/settings system to support custom terminology and required fields. The wizard reuses the same REST API endpoint (POST /api/v1/activities) as quick-log, with a richer payload. Validation is performed per-step on 'Next' tap, with error messages displayed inline. The final review screen renders a summary of all entered data before submission. Accessibility: back navigation via button (not swipe), vertical scroll within each step, focus management on step transition.

Components (114)

User Interface (2)

Service Layer (4)

Data Layer (1)

Infrastructure (1)

Shared Components

These components are reused across multiple features

Service Layer (34)

Data Layer (22)

Infrastructure (38)

infrastructure Keychain/Keystore Adapter low Shared infrastructure JWT Claims Extractor low Shared infrastructure Organization Labels Adapter low Shared infrastructure Keychain/Keystore Adapter low Shared infrastructure Auth API Client medium Shared infrastructure REST API Client medium Shared infrastructure WCAG Accessibility Adapter low Shared infrastructure Registration API Client low Shared infrastructure Accounting API Client high Shared infrastructure PDF Renderer Adapter medium Shared infrastructure File Share Adapter low Shared infrastructure FCM/APNs Adapter high Shared infrastructure Share Sheet Adapter low Shared infrastructure Share Plus Adapter low Shared infrastructure Platform Accessibility Bridge medium Shared infrastructure Semantics Override Adapter high Shared infrastructure URL Launcher Adapter low Shared infrastructure Markdown Content Renderer low Shared infrastructure Network Connectivity Monitor low Shared infrastructure Expense Receipt Storage Adapter low Shared infrastructure Audit Log Writer low Shared infrastructure Feature Flag Checker low Shared infrastructure Logo Upload Adapter low Shared infrastructure Terminology Constants Registry low Shared infrastructure Feature Flag Cache Adapter low Shared infrastructure Org Scope JWT Resolver medium Shared infrastructure Association Audit Logger low Shared infrastructure Token Blocklist medium Shared infrastructure Analytics Tracker low Shared infrastructure SEO Metadata Config low Shared infrastructure Analytics Tracker low Shared infrastructure Analytics Tracker low Shared infrastructure Sales Analytics Tracker low Shared infrastructure Email Provider Adapter low Shared infrastructure Terms of Service Content Provider low Shared infrastructure Legal PDF Asset Provider low Shared infrastructure Consent-Gated Script Loader low Shared infrastructure Legal Page Layout low Shared

User Stories

No user stories have been generated for this feature yet.