Contact Detail & Edit

Accurate and current contact records are foundational to every peer mentoring workflow; stale or incomplete data leads to missed follow-up, duplicate entries, and inaccurate Bufdir reporting. The edit capability allows peer mentors to capture first-hand field knowledge in real time, reducing the lag between reality and the system record. Coordinators rely on up-to-date contact detail to assign peer mentors correctly and resolve disputes. The optimistic mutation model with offline rollback is especially critical for rural deployments common in large-county organisations like Blindeforbundet, where network access is intermittent during home visits.

Built in Flutter with the ContactBloc managing view, edit, and saving state transitions. The edit form uses AppTextField and custom field widgets with server-side-sourced validation schemas. Optimistic mutations apply changes locally and queue an API PATCH via the mutation outbox; on conflict or failure, the outbox triggers automatic rollback and surfaces a user-facing error banner. The feature integrates with the Drift contacts table (organisation-scoped), the organisation labels system for field display names, and emits deep-link events consumed by the activity registration wizard to pre-populate the correct contact. ContactDetailScreen and EditContactScreen are separate routes managed by the ContactBloc.