Use Dictation in Post-Session Report Way-Forward Section
The post-session report for Blindeforbundet includes a structured 'way forward' section covering health status, course interest, assistive device situation, and referral requests. This section is often the most cognitively demanding to complete and the most valuable for coordinators. By enabling dictation specifically in the way-forward fields, peer mentors can speak their observations naturally and have them transcribed into the appropriate sub-fields. The way-forward task service then processes these inputs into actionable items. This story covers the integration of speech-to-text with the way-forward section widget, ensuring the dictation scope guard allows these fields and that transcribed content is mapped correctly.
User Story
Acceptance Criteria
- Given the peer mentor is on the way-forward section of a post-session report, When they tap the microphone on any way-forward sub-field, Then dictation activates for that specific sub-field only
- Given the peer mentor dictates content for the 'next steps' sub-field, When they insert the transcription, Then the content is stored as a way-forward item linked to the correct field key
- Given the peer mentor completes all way-forward fields via dictation, When they submit the report, Then the way-forward task service creates the appropriate follow-up tasks in the database
- Given the transcription contains an ambiguous term (e.g. a medication name), When the preview is shown, Then the peer mentor can manually correct the text before inserting
- Given the org field config specifies the way-forward section as available for dictation, When the screen loads, Then microphone buttons appear on all way-forward sub-fields
Business Value
The way-forward section is the primary handover mechanism between peer mentors and coordinators in Blindeforbundet's workflow. Reducing friction in completing this section increases the quality and completeness of coordinator follow-up, directly improving participant outcomes and satisfying the structured reporting format required by the organisation.
Components
- Way Forward Section Widget ui
- Speech-to-Text Field Overlay ui
- Speech-to-Text Adapter infrastructure
- Way Forward Task Service service
- Report Form Orchestrator service
- Speech Recognition Service service
- Transcription Preview Field ui
- Dictation Scope Guard service
- Organisation Field Config Loader infrastructure