HIGH story-driver-administration-and-confidentiality-declarations-coordinator-005 5 pts

User Story

As a Coordinator
I want to be notified when a driver has acknowledged the confidentiality declaration and to confirm this acknowledgement in the system so that the assignment can proceed with full compliance documentation in place
So that the workflow moves forward automatically when compliance is satisfied and I do not need to manually poll for status changes

Acceptance Criteria

  • Given a driver has acknowledged the declaration, when the system receives the acknowledgement event, then the coordinator receives a push notification stating the driver's name and which assignment they acknowledged
  • Given the coordinator taps the notification, when the declaration acknowledgement screen opens, then it shows the driver's name, acknowledgement timestamp, the assignment details, and the declaration content summary
  • Given the acknowledgement has been received, when the coordinator views the assignment, then the declaration status badge updates to 'Acknowledged' and the honorarium registration button becomes active
  • Given the acknowledgement is stored, when the audit log is queried, then a record exists with the coordinator's org ID, the assignment ID, the driver ID, the declaration version, and the acknowledgement timestamp
  • Given the coordinator has notifications disabled, when a declaration is acknowledged, then the status badge on the assignment list screen updates within 60 seconds via real-time subscription without requiring a manual refresh

Business Value

Without real-time acknowledgement notifications, coordinators must manually check the status of each declaration before proceeding — a time-consuming task when managing several active assignments. Automated notification closes the compliance loop immediately, reduces assignment delays, and provides the organization with a timestamped digital record that eliminates disputes about whether a driver was informed of their confidentiality obligations.