Use the Post-Session Report Form With Full Screen Reader Access
The post-session report is a structured document unique to Blindeforbundet, covering health status, course interest, assistive equipment needs, and a 'way forward' section that functions as a referral to the coordinator. The form uses dynamic field rendering where fields are loaded based on organisation configuration. Each rendered field must have proper semantic labels and input hints. The way-forward section involves task creation with date pickers and free text. Any dynamically inserted fields must also announce their appearance via live regions. The report-form-orchestrator must manage focus positioning when new sections load, and the report-field-validator must announce validation errors as live region messages, not just visual highlights.
User Story
Acceptance Criteria
- Given a peer mentor opens the post-session report with VoiceOver active, when the form loads, then all fields are announced with their label and input type (e.g., 'Health status, text field, required')
- Given a dynamic field is injected by the org-field-config-loader, when it appears, then a live region announces 'New field added: [field name]' and focus moves to it
- Given the way-forward section is expanded, when the peer mentor navigates into it, then task input fields and the date picker are all reachable and labelled
- Given a field fails validation on form submission, when the error state is set, then an assertive live region announces the specific validation error for that field
- Given the form is submitted successfully, when the confirmation screen loads, then a polite announcement reads 'Report submitted successfully' and the report summary is traversable
- Given the peer mentor is using speech-to-text in the notes field, when dictation is active, then the recording state indicator announces 'Recording active' and 'Recording stopped' via live regions
Business Value
The post-session report is Blindeforbundet's most critical data collection mechanism. It feeds into coordinator workflows, triggers referrals, and contributes to Bufdir reporting. A peer mentor who cannot fill in this form independently is unable to fulfil their core professional responsibility. For an organisation whose peer mentors may themselves be visually impaired (the peer-to-peer model), this is not an edge case — it is the primary use case.
Components
- Post-Session Report Screen ui
- Dynamic Field Renderer ui
- Way Forward Section Widget ui
- Speech-to-Text Field Overlay ui
- Report Form Orchestrator service
- Report Field Validator service
- Organisation Field Config Loader infrastructure
- Semantics Wrapper Widget ui
- Live Region Announcer ui
- Focus Management Service service
- Semantics Service Facade infrastructure
- Plain Language Error Display ui
- Accessibility Live Region Announcer infrastructure