Receive Push Notification Before Certification Expires
HLF peer mentors hold a physical certification card that must be renewed periodically. When a certificate is approaching its expiry date, the system should proactively push notifications to the mentor's device at 90, 60, and 30-day intervals. Each notification must be actionable — tapping it should deep-link directly into the certification status screen or the course enrollment prompt. FCM (Firebase Cloud Messaging) is used for delivery. The notification payload must include the expiry date, the mentor's name, and a deep-link URL. If the mentor has already enrolled in a renewal course, escalation notifications should be suppressed.
User Story
Acceptance Criteria
- Given a peer mentor whose certification expires in 90 days, When the nightly scheduler runs, Then a push notification is dispatched via FCM with the expiry date and a deep-link to the certification status screen
- Given a peer mentor who receives a 90-day notification, When 30 more days pass without renewal enrollment, Then a 60-day reminder notification is dispatched
- Given a peer mentor who receives a 60-day notification, When 30 more days pass without renewal enrollment, Then a 30-day urgent reminder notification is dispatched with elevated priority
- Given a peer mentor who has already enrolled in a renewal course, When the scheduler evaluates notifications, Then no further expiry reminders are sent until the next cycle
- Given a peer mentor who taps the push notification, When the app opens, Then the user is navigated directly to the certification status screen showing the expiry date and available renewal actions
- Given the device has push notification permissions revoked, When an expiry notification would be sent, Then an in-app banner is displayed the next time the mentor opens the app
Business Value
Certification lapse directly removes a peer mentor from HLF's public website and disables their active status, which reduces the organization's capacity to serve members. Proactive multi-stage notifications prevent accidental lapses caused by oversight, protecting both volunteer engagement and organizational capacity. This is a core HLF requirement confirmed in the workshop.
Components
- Certification Expiry Nightly Cron Job infrastructure
- Push Notification Service infrastructure
- Certificate Expiry Notification Orchestrator service
- Certificate Expiry Check Edge Function infrastructure
- FCM Push Notification Sender infrastructure
- Certification Expiry Repository data
- Notification Record Repository data
- Certification Reminder Service service
- Notification Deep Link Handler service