Receive Certification Expiry Warning During Pause
HLF uses certification expiry as a trigger for automatic removal of peer mentors from the chapter's public website. When a peer mentor is on pause, their certification expiry date continues to advance. The system must proactively warn the mentor via push notification and in-app banner when their certification will expire within 30 days, and again when it has expired. This allows the mentor to enrol in renewal courses before they attempt to reactivate. The nightly scheduler should evaluate certification status for all paused mentors and dispatch notifications accordingly.
User Story
Audience Summaries
This high-priority story directly protects HLF's public reputation and regulatory compliance by ensuring only certified peer mentors remain visible on chapter websites. Expired certifications on public-facing pages expose the organisation to trust erosion and potential liability — proactive 30-day warnings give mentors time to renew before automatic removal occurs, reducing disruption and support overhead. By integrating nightly certification checks with push and in-app notifications, the platform transforms a passive compliance risk into an actively managed workflow. This strengthens mentor retention, reduces coordinator intervention load, and reinforces the platform's value as a compliance-aware operations tool — a key differentiator for regulated volunteer organisations.
This story carries high delivery priority due to its compliance and automation scope. It spans the nightly scheduler, push notification service, in-app banner system, deep-linking infrastructure, and the HLF website sync service — requiring coordination across backend scheduling, mobile frontend, and third-party integration teams. Acceptance criteria define five distinct notification and gating scenarios, each requiring separate QA test cases. Dependencies on the pause/reactivation story (story-peer-mentor-pause-reactivation-peer-mentor-001) mean scheduling must account for that story completing first.
Rollout risk includes scheduler reliability and notification delivery guarantees on both iOS and Android platforms. UAT should involve HLF stakeholders to validate website sync behaviour.
Implementation requires extending the nightly scheduler to evaluate certification expiry dates for all mentors with a 'paused' status, computing 30-day and zero-day thresholds. Push notifications require integration with the mobile push service (FCM/APNs) with deep-link payloads routing to the certification management screen. In-app banners must be rendered persistently alongside the existing pause status banner — the UI layer needs to support stacked, coexisting banner states. A blocking dialog must intercept the reactivation confirmation flow when certification is expired, with a conditional path for coordinator-handled exceptions.
The HLF website sync service must be triggered from the scheduler for expired-while-paused cases. Edge cases: mentors who renew mid-cycle (banner should clear), duplicate notification prevention across scheduler runs, and timezone-safe date comparison logic.
Acceptance Criteria
- Given I am paused and my certification expires in 30 days, when the nightly scheduler runs, then I receive a push notification and an in-app notification warning me of the upcoming expiry
- Given I am paused and my certification has expired today, when the nightly scheduler runs, then I receive a push notification stating my certification has expired and that I need to renew before reactivating
- Given I receive a certification expiry push notification, when I tap it, then I am deep-linked to the certification management screen showing my current certification status and renewal options
- Given my certification has expired while I am paused, when I open the app, then a certification expiry warning banner is persistently shown alongside my pause status banner
- Given my certification has expired and I attempt to reactivate, when I confirm reactivation, then a blocking warning dialog explains that my certification is expired and I must renew first (or the coordinator is informed to handle the exception)
- Given the HLF organisation is configured with website sync, when my certification expires while paused, then the nightly scheduler triggers removal from the HLF website via the sync service
Business Value
HLF explicitly requires that peer mentors with expired certifications are automatically removed from public-facing chapter pages. Proactive notifications during a pause period prevent a peer mentor from being surprised by this removal and enable them to plan renewal in advance. This protects organisational quality standards and ensures that only certified mentors appear available to the public, which is critical for maintaining trust and regulatory compliance.
Components
- Certification Expiry Auto-Pause Job infrastructure
- Certification Expiry Warning Banner ui
- Certification Expiry Checker Service service
- Pause Notification Service service
- HLF Website Sync Service service
- Peer Mentor Status Repository data
- Certification Status Repository data
- Nightly Job Scheduler infrastructure
- Certification Status Screen ui
- Certifications Expiring This Month Widget ui
- Certification Expiry Badge ui
- Certification Management Service service
- Certification Reminder Service service
- Certification BLoC service
- HLF Dynamics Sync Service service
- Certification Repository data
- Certification Expiry Nightly Cron Job infrastructure
- Push Notification Service infrastructure
- Pause Management Service service
- Certificate Expiry Notification Banner ui
- Certificate Expiry Notification Orchestrator service
- Certification Expiry Repository data
- Certificate Expiry Check Edge Function infrastructure
- FCM Push Notification Sender infrastructure