Receive Automated Expiry Reminder Notifications at Configurable Lead Times
The Expiry Alert Widget and Certificate Service work together to trigger push notifications via the Push Notification Service at configurable lead times before each certificate's expiry date. The Certificate Service runs expiry checks and schedules notifications at the configured intervals (default: 60, 30, and 7 days before expiry). Each notification deep-links directly to the relevant certificate's renewal pathway within the app. In-app expiry alert banners are also rendered by the Expiry Alert Widget on the Certificate Screen and individual certificate cards when a certificate is within the active lead-time window. Alerts are dismissible but re-surface on next app launch until the certificate is renewed or has expired.
User Story
Acceptance Criteria
- Given a certificate is 60 days from expiry, when the scheduled expiry check runs, then a push notification is sent to the peer mentor's device with the certificate name and expiry date
- Given a certificate is 30 days from expiry, when the scheduled check runs, then a second push notification is sent with an increased urgency level
- Given a certificate is 7 days from expiry, when the scheduled check runs, then a critical push notification is sent with a deep link to the certificate renewal screen
- Given a peer mentor taps the expiry notification, when the app opens, then they are navigated directly to the relevant certificate card with the renewal action prominently displayed
- Given a certificate is within the lead-time window, when the Certificate Screen is opened, then the Expiry Alert Widget renders a dismissible banner at the top of the screen
- Given a peer mentor dismisses the in-app expiry alert, when they close and reopen the app before renewing, then the alert banner re-surfaces on the Certificate Screen
- Given push notifications are disabled for the app, when expiry lead times are reached, then in-app banners are shown as a fallback mechanism on next app launch
Business Value
Certificate expiry is HLF's primary operational risk for the peer mentor programme — expired certificates trigger automatic removal from public listings, disrupting active peer support relationships. Automated multi-stage reminders eliminate the manual coordinator tracking burden (currently done via spreadsheets) and give peer mentors ample time to renew, directly reducing programme disruption and mentor attrition.
Components
- Certificate Screen ui
- Certificate Card Widget ui
- Expiry Alert Widget ui
- Certificate Service service
- Certificate Repository data
- Push Notification Service service
- Push Notification Gateway infrastructure