Record Certification Renewal After Completing Course
After a peer mentor completes a renewal course in HLF's Dynamics portal, the certification record should be updated in the app via the hlf-dynamics-sync-service which polls or is triggered by a webhook from Dynamics. Alternatively, if automatic sync is unavailable, the peer mentor or coordinator can manually record the renewal via the record renewal screen, uploading the new certificate details (issue date, expiry date). Once the renewal is recorded, the certification management service updates the mentor's active status, triggers the visibility suppressor to re-enable public visibility, and sends a confirmation notification. All pending expiry notifications are cancelled by the expiry notification orchestrator.
User Story
Acceptance Criteria
- Given HLF's Dynamics system sends a certification update webhook, When the hlf-dynamics-sync-service processes it, Then the peer mentor's certification record is updated with the new expiry date within 5 minutes
- Given the certification record is updated with a new valid expiry date, When the certification management service processes the update, Then the mentor's active status is re-enabled and visibility suppressor restores their public listing
- Given the renewal is confirmed, When the expiry notification orchestrator checks pending notifications, Then all scheduled expiry reminders for that certification are cancelled
- Given automatic sync is not available, When a coordinator opens the record renewal screen for a mentor, Then they can manually input the new certificate issue date and expiry date with supporting document upload
- Given a manual renewal is submitted, When it is saved, Then the certification repository is updated and the mentor receives a confirmation notification: 'Your certification has been renewed. You are now visible as an active peer mentor.'
- Given the renewal screen is used by a screen reader user, When navigating the date input fields, Then all fields have descriptive labels and validation errors are announced via live regions
Business Value
The renewal workflow closes the full certification lifecycle loop. Without it, the system can suppress a mentor but has no automated path to restore them, requiring manual database intervention. Integrating with HLF's Dynamics portal for automatic sync eliminates coordinator overhead for renewal tracking, while the manual fallback ensures the process works even during integration downtime.
Components
- Record Renewal Screen ui
- HLF Dynamics Sync Service service
- Certification Management Service service
- Certification Repository data
- Certificate Expiry Notification Orchestrator service
- Peer Mentor Visibility Suppressor service
- Certification Status Derivation Service service
- Certification BLoC service
- Certification Status Screen ui