🏠 Overview › 🧩 Components ›🧩 Structured Report Form Screen

Structured Report Form Screen

Component Detail

User Interface medium complexity mobile
2
Dependencies
0
Dependents
0
Entities
0
Integrations

Description

A conditional wizard step injected by WizardStateManager when the selected activity type is a home visit category. Renders the structured post-visit report form with fields for health status, course interest, assistive device situation, and a 'way forward' field. All form controls use design system widgets (AppTextField, radio groups, checkboxes) with WCAG 2.2 AA compliance and screen-reader-compatible Semantics widgets for field-level error announcements.

Feature: Formalized Home Visit Report Structure

structured-report-form-screen

Responsibilities

  • Render structured home visit report fields within the activity registration wizard flow
  • Validate and surface field-level errors via accessible Semantics widgets
  • Enable speech-to-text input on all free-text fields via SpeechInputWidget integration
  • Submit completed form data to ReportTemplateService for backend persistence
  • Support offline form completion by consuming cached templates from ReportTemplateRepository

Interfaces

buildReportForm(template: ReportTemplate)
onFieldChanged(fieldId, value)
onSubmit(reportData: HomeVisitReport)
validateForm()
showFieldError(fieldId, message)
resetForm()
loadTemplate(templateId)
toggleSpeechInput(fieldId)
onWayForwardChanged(value)

Relationships

Dependencies (2)

Components this component depends on

data Report Template Repository service Report Template Service

Sub-Components (2)

Way Forward Coordinator Task Widget
component low

A specialized form section for the 'way forward' field that captures structured coordinator follow-up instructions. On submit, the value is sent to the backend to create a queryable coordinator task record linked to the home visit activity. Provides rich-text-like input with speech-to-text support.

  • Capture structured 'way forward' input from peer mentor
  • Create coordinator task record via API on form submission
  • Display confirmation that coordinator follow-up has been registered
Health Status Section Widget
component low

A reusable form section widget rendering health status fields using radio groups and checkboxes from the design system. Configurable via template to show or hide specific fields based on organization settings.

  • Render configurable health status form fields
  • Emit field-change events to parent form state
  • Apply organization-specific field visibility from template