Automatically Flag Peer Mentor as Unavailable When Certificate Expires
The Certificate Service integrates with the peer mentor pause management flow. When a certificate expiry check detects that a certificate has passed its expiry date, the service automatically sets the peer mentor's availability status to 'Unavailable — certificate expired' by calling the Pause Management Service. This prevents the mentor from appearing as available for new assignments. A coordinator notification is sent via the Coordinator Notification Service informing them of the automatic status change and prompting renewal follow-up. The peer mentor also receives a notification explaining why they have been flagged as unavailable. When the coordinator issues a renewed certificate, the pause status is automatically lifted and the mentor returns to active status.
User Story
Acceptance Criteria
- Given a peer mentor's certificate reaches its expiry date, when the Certificate Service runs the daily expiry check, then the mentor's availability status is automatically set to unavailable with the reason 'Certificate expired'
- Given the automatic unavailability flag is triggered, when the coordinator next opens the app, then they receive a notification listing all peer mentors newly flagged as unavailable due to certificate expiry
- Given a peer mentor is automatically flagged as unavailable, when they open the app, then they see a notification explaining the reason (certificate expired) with a direct link to the relevant certificate card and renewal pathway
- Given a coordinator issues a renewed certificate for a previously flagged mentor, when the new certificate record is saved with a valid future expiry date, then the peer mentor's availability status is automatically restored to available
- Given a peer mentor has multiple certificates and only one has expired, when the expiry check runs, then the system evaluates whether the expired certificate is a required credential before flagging unavailability — if it is required, the flag is applied; if not, a warning is issued without auto-flagging
- Given the automatic unavailability flag has been applied, when the coordinator views the peer mentor's profile, then the certificate expiry reason is clearly displayed alongside the unavailability status
Business Value
HLF policy automatically removes peer mentors with expired certifications from the organization's public listings. Automating this enforcement within the app ensures that expired mentors are not assigned new contacts, protecting the organization's credibility and the quality of peer support delivery. Coordinator notifications and automatic status restoration upon renewal create a seamless operational loop that minimizes manual intervention while maintaining programme integrity.
Components
- Certificate Service service
- Certificate Repository data
- Push Notification Service service
- Pause Management Service service
- Coordinator Notification Service service
- Availability Repository data