HIGH story-contact-detail-management-peer-mentor-009 2 pts
2
Story Points
High
Priority
Contact Detail & Management
Feature

User Story

As a user
I want form fields to validate my input in real time as I type or move between fields, showing clear inline error messages before I attempt to submit
So that So that I can correct mistakes immediately while the context is fresh, rather than discovering validation errors after submitting an entire form

Acceptance Criteria

  • Given a user enters a value in a required field and then clears it, when the field loses focus, then an inline 'Required' error message appears below the field
  • Given a user enters a malformed phone number, when the field loses focus, then an inline format error is displayed with an example of the expected format
  • Given a user attempts to advance to the next step with validation errors present, when they tap the next button, then advancement is blocked and all errors on the current step are highlighted
  • Given all fields on a step are valid, when the user advances, then no error messages are shown and the next step loads
  • Given a user corrects a previously invalid field, when the field value becomes valid, then the error message disappears immediately without requiring blur
  • Given a screen reader is active, when a validation error appears, then the error message is announced to the user immediately

Business Value

Real-time field validation prevents invalid data from entering the contact database, which directly protects the integrity of Bufdir reports that draw on contact and activity data. For peer mentors with lower digital literacy or cognitive accessibility needs, immediate feedback on errors is far less frustrating and less cognitively demanding than discovering all errors at submission time. This also reduces coordinator correction overhead by ensuring data quality at the point of entry.