Receive Push Notification Before Certification Expires
The system must proactively notify peer mentors via push notification at defined thresholds (e.g., 90, 60, and 30 days before expiry, and again on the expiry date). Notifications must deep-link directly into the certification status screen so the peer mentor can take immediate action. Notification content must be plain-language, non-technical, and accessible, including a clear call to action. Peer mentors must be able to manage their notification preferences, but the default should be opted-in for certification alerts.
User Story
Acceptance Criteria
- Given my certification expires in exactly 90 days, when the nightly scheduler runs, then I receive a push notification titled 'Your certification expires in 90 days' with a body explaining what will happen if I do not renew and a deep link to the certification screen
- Given I have already received the 90-day notification, when my certification reaches 60 days from expiry, then I receive a second escalating notification with stronger urgency language
- Given my certification expires today, when the expiry check edge function runs, then I receive a notification informing me that my certification has expired and I am no longer visible in the organization directory, with a prompt to enroll in a renewal course
- Given I tap on a certification expiry push notification, when the app opens, then I am taken directly to the certification status screen for the relevant certification
- Given I have opted out of certification notifications in notification settings, when my certification approaches expiry, then I do not receive push notifications but the in-app banner on the certification screen still appears
Business Value
HLF requires that peer mentors maintain valid certifications to ensure the quality and safety of peer support interactions. Late or missed renewals result in peer mentors being silently removed from the public directory, creating gaps in service coverage that are difficult for coordinators to detect. Automated, timely notifications significantly reduce the administrative burden of tracking renewal deadlines manually and ensure continuous, high-quality service to end users.
Components
- Certification Reminder Service service
- Certification Expiry Nightly Cron Job infrastructure
- Push Notification Service infrastructure
- Certificate Expiry Notification Orchestrator service
- Certification Expiry Repository data
- Certificate Expiry Check Edge Function infrastructure
- FCM Push Notification Sender infrastructure
- Certification Expiry Warning Banner ui
- Certificate Expiry Notification Banner ui
- Certificate Expiry Status Indicator ui
- Notification Deep Link Handler service