Receive Automatic Notification When a Mentor's Certification Expires Triggering Auto-Pause
HLF requires that a peer mentor with an expired certification is automatically hidden from the local chapter's public website and marked as paused in the system. The nightly-scheduler triggers the certification-expiry-checker which evaluates all active mentor certifications. When an expiry is detected, the mentor-status-service transitions the mentor to paused state and the pause-notification-orchestrator dispatches a coordinator notification that clearly distinguishes this as a system-initiated pause (due to certification expiry) rather than a mentor-initiated pause. The certification-expiry-warning-banner must appear on the mentor's detail card in the coordinator's view. The hlf-website-sync-service must be triggered to suppress the mentor from public listings. The coordinator notification must include a direct call-to-action deep link to the certification management workflow.
User Story
Acceptance Criteria
- Given the nightly-scheduler runs and the certification-expiry-checker finds a mentor with an expired certification, when the check completes, then the mentor-status-service sets the mentor's status to 'paused' with pause_reason='certification_expired' within the same nightly job execution
- Given a mentor is auto-paused due to certification expiry, when the pause-notification-orchestrator processes the event, then the coordinator receives a push notification with the subject 'Certification Expired – [Mentor Name] auto-paused' and a body that distinguishes it from a voluntary pause
- Given the auto-pause notification is received, when the coordinator taps the notification, then the deep link navigates to the mentor detail screen which shows the certification-expiry-warning-banner prominently at the top of the screen
- Given the mentor is auto-paused, when the hlf-website-sync-service runs, then the mentor is removed from the public chapter website listing within 15 minutes of the status change
- Given a coordinator receives the certification-expiry notification, when they tap the 'Renew Certification' call-to-action in the notification, then the app navigates to the certification renewal workflow pre-populated with the mentor's details
- Given multiple mentors have expired certifications in the same nightly run, when notifications are dispatched, then each mentor generates a separate notification card in the coordinator's notification centre rather than being batched into an unreadable aggregate
- Given the mentor subsequently renews their certification, when the certification-status-repository is updated with a valid certificate, then the pause-management-service automatically reactivates the mentor and the coordinator receives a 'Mentor Reactivated' notification
Business Value
HLF's certification programme is a cornerstone of quality assurance for their peer mentor service. An expired certificate represents a compliance risk: if an uncertified mentor continues to appear available and is assigned contacts, HLF faces reputational and potentially legal exposure. Automating the pause-on-expiry flow and instantly notifying coordinators removes human error from the compliance loop, ensures the public-facing website always reflects accurate mentor availability, and creates an auditable trail that demonstrates due diligence to certification standards. This is a MUST requirement for HLF's go-live decision.
Components
- Certification Expiry Warning Banner ui
- Pause Status Indicator ui
- Pause Management Service service
- 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
- Dynamics 365 Portal API Client infrastructure
- Certification Status Screen ui
- Certifications Expiring This Month Widget ui
- Certification Management Service service
- Certification Reminder Service service
- Certification Expiry Nightly Cron Job infrastructure
- Pause Management Service service
- Certificate Expiry Notification Orchestrator service
- Certificate Expiry Check Edge Function infrastructure
- FCM Push Notification Sender infrastructure
- Pause Notification Orchestrator service
- FCM Notification Dispatcher infrastructure