Way Forward Section Widget
Component Detail
Description
A dedicated UI section within the report form for entering one or more 'way forward' entries that function as task handoffs to the coordinator. Each entry can be added, edited, or removed before submission, and the speech-to-text trigger is available per entry.
way-forward-section-widget
Summaries
The Way Forward Section Widget formalizes task handoffs between field workers and coordinators directly within the submission workflow, replacing informal verbal or ad-hoc communication that frequently leads to missed follow-up actions. By capturing structured, reviewable action items at the point of report submission, organizations gain a traceable record of commitments made in the field, reducing operational risk and improving accountability. The per-entry speech-to-text capability lowers the friction of data entry during or immediately after demanding fieldwork, which directly improves the completeness and timeliness of handoff records. This supports coordinators in prioritizing work and provides management with visibility into outstanding actions.
The Way Forward Section Widget is rated medium complexity and has a single upstream dependency on the Speech-To-Text Field Overlay, making its schedule risk relatively contained. The core delivery work involves implementing a dynamic list management UI — add, edit, and remove entries — within the broader report form. Integration with the parent form's state management must be agreed upon early: `onEntriesChanged(entries)` must align with the form's submission payload structure and the `way-forward-item` data model. Testing scope includes multi-entry CRUD interactions, speech-to-text integration per entry, and accessibility labelling for the list layout.
Coordinate timing with the report submission feature to avoid blocking end-to-end form testing. No database writes are made by this widget directly; it feeds data to the parent form on change.
Way Forward Section Widget executes in the mobile (Flutter) context as a self-contained sub-section of the report form. It manages an internal ordered list of `way-forward-item` entries, exposing `addEntry()`, `removeEntry(index)`, `updateEntry(index, text)`, and `getEntries()` for external read access. State changes bubble up via `onEntriesChanged(entries)`, which the parent form uses to include entries in its submission payload. Each entry row integrates the `speech-to-text-field-overlay` dependency to provide voice input without duplicating the overlay implementation.
The widget is responsible for rendering each entry in a clearly labelled, accessible list layout — screen reader ordering and focus management for add/remove actions must be explicitly handled. There are no direct Supabase calls from this component; persistence is handled by the parent form at submission time. Evolution consideration: if entries gain additional fields (e.g., assignee, due date), the `way-forward-item` data model and this widget's entry row layout will both need updating in lockstep.
Responsibilities
- Allow adding multiple way-forward action entries
- Support editing and removing individual entries
- Provide speech-to-text input per entry
- Display entry list in accessible, labelled layout
Interfaces
addEntry()
removeEntry(index)
updateEntry(index, text)
getEntries()
onEntriesChanged(entries)