Certification Expiry Auto-Pause

Description

The Certification Expiry Auto-Pause feature automatically transitions a peer mentor to paused status when their certification lapses, without requiring manual coordinator intervention. This prevents uncertified mentors from appearing as active in assignment pools or public-facing organization listings. HLF explicitly requires that mentors with expired certificates disappear from local chapter websites automatically. The feature runs as a scheduled backend job, notifies both the peer mentor and coordinator when a pause is triggered, and provides a clear path to recertification and reactivation via the Resume Function.

Sources & reasoning

Line 80 explicitly ties certification expiry to automatic removal for HLF. The priority matrix places sertifisering at Fase 3 (line 155), which maps to v1.1 per roadmap ordinal. The blueprint also assigns [v1.1]. The feature depends on certification-training shipping first, making v1.1 the correct target phase.

docs/source/likeperson.md · line 80

HLF kobler dette til sertifisering: ved utgått sertifikat forsvinner likepersonen fra lokallagets nettsider automatisk.
docs/source/likeperson.md · line 155

| Kursadministrasjon / sertifisering | ✓ | - | - | ✓ | ✓ | SHOULD (HLF + Barnekreft) | 3 |

Analysis

Business Value

For HLF, certification compliance is a formal organizational requirement: an uncertified mentor appearing as active on public listings creates reputational and potentially legal exposure. Automating the pause removes the risk of human oversight failure, where a coordinator might miss a lapsed certificate in a large volunteer roster. For other organizations using the certification-training module, the feature enforces quality standards without manual monitoring overhead. The automation directly reduces coordinator workload, ensures consistent enforcement of certification policies across the volunteer network, and makes the platform more trustworthy for organizational stakeholders and the funding bodies they report to.

Implementation Notes

CertificationExpiryChecker is a backend-scheduled service (daily cron) that queries peer_mentor_certificates for records where expiry_date is past and the linked user's status is active. For each match it calls the same status transition endpoint used by the Pause Function with source set to "system-auto-pause", ensuring a consistent audit trail. AutoPauseNotificationWidget surfaces the expiry reason in the mentor's notification inbox. If the ExternalPortalSyncService is enabled (HLF config), the status change is propagated to the external portal. The checker is conditionally active only when the certification-training module is toggled on for the organization, preventing unintended side effects for organizations without certification workflows.