Receive Real-time Assignment Reminder Notifications
The reminder system evaluates each peer mentor's contact assignments against their last registered activity date. When the elapsed time since last contact exceeds the reminder threshold (configurable per organisation), an in-app notification is created in the database and pushed via FCM. Inside the Notification Centre, overdue assignment reminders are rendered using the reminder-notification-card component, which shows the contact name, days since last activity, and a direct action button to log a new activity. The reminder card is visually distinct from other notification types with a warning-level colour accent.
User Story
Acceptance Criteria
- Given a peer mentor has a contact whose last activity date exceeds the organisation-configured reminder threshold, when the reminder evaluation job runs, then a reminder notification record is created in the notifications table.
- Given a reminder notification exists, when the peer mentor opens the Notification Centre, then the notification appears as a reminder-notification-card showing the contact name and days overdue.
- Given the reminder card is visible, when the peer mentor taps the 'Log Activity' action button, then the activity registration wizard opens pre-filled with the overdue contact.
- Given the peer mentor logs an activity for the overdue contact, when the activity is saved, then the reminder notification is automatically marked as resolved and removed from the unread feed.
- Given a screen reader user encounters a reminder notification card, when VoiceOver reads the card, then it announces the contact name, days overdue, and the available action in a meaningful sequence.
Business Value
HLF workshop data shows 40% of peer mentors were not satisfied with follow-up quality. Proactive reminder notifications address the root cause — forgetting — without requiring coordinators to manually chase up each mentor. Automated reminders scale follow-up quality across hundreds of assignments without adding administrative overhead, directly improving service delivery to vulnerable contacts.
Components
- Reminder Notification Card ui
- Reminder Scheduler Service service
- Reminder Evaluation Service service
- Reminder Dispatch Service service
- Assignment Contact Tracking Repository data
- Reminder Configuration Repository data
- In-App Notification Repository data
- Assignment Reminder Cron Trigger infrastructure
- Notification Centre Screen ui
- Notification BLoC service
- Notification Accessibility Announcer infrastructure
Dependencies
- View Consolidated Notification Feed critical