Receive In-App Notification When Coordinator Changes My Status
Coordinators can pause or reactivate peer mentors directly from the coordinator pause roster screen, for example when a mentor becomes unreachable or when administrative actions are needed. When this happens, the affected peer mentor must be notified immediately. The notification must clearly state who made the change (coordinator name), what the change was (paused or reactivated), and provide a deep link back into the app to view the current status. The notification card should offer a quick way to open the chat or contact the coordinator.
User Story
Acceptance Criteria
- Given a coordinator pauses a peer mentor from the coordinator roster screen, when the action is saved, then a push notification is dispatched to the peer mentor via 500-pause-notification-orchestrator and 504-fcm-notification-dispatcher
- Given the peer mentor receives the push notification, when they tap it, then they are navigated to their status screen within the app
- Given the notification has been received, when the peer mentor opens the notification centre, then a pause notification card (498-pause-notification-card) is visible with the coordinator's name, the change made, and the timestamp
- Given a coordinator reactivates a peer mentor, when the change is saved, then the peer mentor receives a reactivation notification with the same level of detail as a pause notification
- Given the peer mentor views the notification, when they tap the confirmation banner (499-peer-mentor-confirmation-banner), then they can acknowledge the status change
- Given the notification is delivered, when the peer mentor's app is in the foreground, then an in-app notification banner appears without requiring the user to leave the current screen
Business Value
Transparency in status management prevents peer mentors from feeling blindsided by administrative actions. If a coordinator pauses a mentor without notification, the mentor may continue to accept contacts or feel their volunteer relationship has been terminated without explanation. Immediate notifications maintain trust, give mentors the opportunity to follow up with their coordinator, and ensure no mentor is accidentally left in an incorrect state without awareness.
Components
- Pause Status Notification Card ui
- Peer Mentor Confirmation Banner ui
- Pause Notification Orchestrator service
- Pause Notification Payload Builder service
- Pause Status Webhook Handler infrastructure
- FCM Notification Dispatcher infrastructure
- Coordinator Notification Service service
- Pause Notification Service service
- Mentor Status BLoC infrastructure
- Mentor Status Repository data