Receive Immediate Notification When a Peer Mentor Initiates a Pause
When a peer mentor taps the pause toggle on their profile and confirms through the pause confirmation dialog, the system must dispatch a real-time push notification to all coordinators responsible for that mentor. The notification must include the mentor's name, the effective pause date, and the expected return date if provided. The coordinator should also see a persistent pause status banner in their coordinator view and on the mentor's detail card. This story covers the full notification pipeline from the mentor-side action through to the coordinator-side delivery and acknowledgement, including in-app notification centre display and FCM push delivery.
User Story
Acceptance Criteria
- Given a peer mentor confirms a pause via the pause-confirmation-dialog, when the mentor-status-service processes the status change, then a push notification is dispatched to the coordinator's device within 5 seconds via the fcm-notification-dispatcher
- Given the push notification is received, when the coordinator opens the notification, then the notification-deep-link-handler navigates directly to the mentor's detail screen showing the pause-status-banner
- Given the coordinator opens the notification centre, when they view the pause notification card, then the pause-notification-card displays the mentor name, pause start date, expected return date (if set), and a direct link to the coordinator-pause-roster-screen
- Given the mentor has set an expected return date, when the notification is rendered, then the expected return date is prominently shown in both the push payload and the in-app notification card
- Given the coordinator acknowledges the notification, when they tap the acknowledge action, then the pause-status-record-repository marks the notification as read and removes the unread badge from the notification-tab-badge
- Given the notification is delivered while the app is in the foreground, when the pause event fires, then an in-app-notification-banner slides in at the top of the screen with the mentor name and pause reason summary
Business Value
Coordinators manage dozens of peer mentors and depend on accurate availability information to ensure every person seeking support is matched with an active mentor. Without timely notifications, a paused mentor may continue to appear available, resulting in failed contact attempts, frustrated service recipients, and reputational risk for the organisation. Immediate automated notification eliminates the need for manual status checks and phone calls, saving coordinators an estimated 30–60 minutes per pause event and ensuring zero-gap handover of open assignments.
Components
- Pause / Reactivate Toggle ui
- Pause Confirmation Dialog ui
- Pause Status Banner ui
- Mentor Status Service service
- Coordinator Notification Service service
- Mentor Status BLoC infrastructure
- Pause Notification Service service
- Peer Mentor Status Repository data
- Pause Status Notification Card ui
- Peer Mentor Confirmation Banner ui
- Pause Notification Orchestrator service
- Pause Notification Payload Builder service
- Pause Status Record Repository data
- Pause Status Webhook Handler infrastructure
- FCM Notification Dispatcher infrastructure
- Notification Centre Screen ui
- Notification List Item ui
- Notification Tab Badge ui
- Notification BLoC service
- Notification Deep Link Handler service
- Supabase Realtime Subscription Service infrastructure
- In-App Notification Banner ui