Receive Push Notifications for New Assignments
When a coordinator assigns a new contact or task to a peer mentor, the system must deliver a push notification to the mentor's device via FCM. The notification should include the contact's first name (not sensitive details), the assignment type, and a deep link that opens directly to the relevant assignment detail screen inside the app. The notification must be delivered even when the app is in the background or closed.
User Story
Acceptance Criteria
- Given a coordinator assigns a new contact to a peer mentor, when the assignment is saved in the database, then an FCM push notification is dispatched to the mentor's registered device within 30 seconds
- Given the peer mentor taps the notification, when the app opens, then the user is navigated directly to the assignment or contact detail screen via the deep link
- Given the app is in the foreground when the notification arrives, when the notification is received, then an in-app banner is displayed without interrupting the current workflow
- Given the peer mentor has not yet opened the notification, when they open the notification centre, then the unread notification is listed with a bold indicator and a badge count on the nav tab
- Given the notification is tapped and the screen is opened, when the user returns to the notification centre, then the notification is marked as read and the badge count decreases
Business Value
Timely notifications are the primary mechanism ensuring peer mentors respond quickly to new assignments. Without push delivery, response delays increase and contacts may feel neglected, directly reducing service quality. For HLF and NHF, prompt follow-up is a key satisfaction metric cited in the workshop findings, where 40% of peer mentors were rated as providing insufficient follow-up.
Components
- Push Notification Service infrastructure
- Push Notification Service infrastructure
- Notification Trigger Service service
- Notification Deep Link Handler service
- Notification Permission Manager service
- FCM Token Manager infrastructure
- FCM Push Notification Sender infrastructure
- FCM Notification Dispatcher infrastructure
- Push Notification Dispatcher infrastructure
- Notification Centre Screen ui
- Notification List Item ui
- Notification Tab Badge ui
- Notification BLoC service
- Notification Deep Link Handler service
- Notification Read State Service service
- Notification Repository data
- Notification Domain Model data
- Supabase Realtime Subscription Service infrastructure
- In-App Notification Banner ui