Contact Detail & Edit
Feature Detail
Description
This feature displays the full profile of a contact, including personal details, caregiver relationships, assigned peer mentor, activity history, and notes. Users can edit contact information inline, with field-level validation and save confirmation. The detail screen is the central hub linking to all related records — activities, notes, assignments, and expenses — giving peer mentors and coordinators a complete picture of each contact's situation and history.
User Flow
Analysis
A complete, editable contact record is essential for the quality of peer mentor work. Without accurate contact details, peer mentors cannot reach contacts, coordinators cannot manage assignments, and Bufdir reporting lacks the data quality required for compliance. The ability to update records in the field — during or immediately after a visit — reduces data loss from delayed entry and ensures the central record reflects current reality. For coordinators, the edit capability supports operational continuity when contacts change phone numbers, addresses, or caregiver arrangements, which is frequent in vulnerable populations.
Built as a Flutter screen with a read/edit toggle pattern to reduce accidental edits while keeping the edit flow accessible. Form fields use the shared AppTextField widget with appropriate input types (phone, email, date pickers). All edits are sent via PATCH to the REST API with optimistic UI updates and rollback on error. Sensitive fields (e.g., health notes, address) must trigger a readout warning when a screen reader is active, as required by NHF. Field labels must be fully internationalised using the organisation's custom terminology system so that field names reflect each org's vocabulary.
Components (113)
Shared Components
These components are reused across multiple features
User Interface (12)
Service Layer (34)
Data Layer (22)
Infrastructure (38)
User Stories
No user stories have been generated for this feature yet.