Receive and View Certification Expiry Alert Banner
HLF requires that when a peer mentor's certification expires, they are automatically removed from the chapter's public website listing and become ineligible for new contact assignments. The peer mentor must be proactively informed before this happens. The certification-alert-banner should appear on the profile screen when the expiry is within 60 days (warning) or has already passed (critical). The banner must clearly state the expiry date, the consequence of not renewing (removal from directory, no new assignments), and provide a direct action button to begin the renewal process. The banner should be dismissible for the 'expiring soon' state but not dismissible for the 'expired' state.
User Story
Audience Summaries
This story directly protects HLF's volunteer network integrity and peer mentor retention. When certifications expire without warning, mentors are silently removed from chapter directories and lose assignment eligibility — a jarring experience that damages trust and increases volunteer churn. By surfacing a proactive, action-oriented alert banner 60 days before expiry, the platform converts a compliance enforcement event into a guided renewal journey. This reduces coordinator intervention, preserves the mentor relationship, and ensures chapters maintain adequate staffing.
The business impact extends to contact assignment continuity: fewer gaps in mentor availability mean better outcomes for families seeking support, directly supporting HLF's core mission metrics and chapter satisfaction scores.
This is a high-priority story with moderate delivery complexity, requiring coordination between the mobile frontend team and the backend certification data service. The dual-state banner (warning vs. expired) introduces distinct UX behaviors — dismissibility logic, session-level persistence for the warning state, and non-dismissible enforcement for the expired state — each requiring explicit acceptance testing. Dependencies include story-peer-mentor-profile-status-peer-mentor-002, so sequencing must be validated before sprint planning.
Rollout risk is low if the certification expiry date is reliably surfaced from the data layer. UAT should cover timezone edge cases for expiry boundaries and verify the renewal navigation pathway is functional end-to-end across both iOS and Android platforms.
Implementation requires a certification-alert-banner component with two rendering modes driven by a computed expiry state derived from the mentor's certification record. The warning state (≤60 days) renders with amber styling and a dismiss action stored in session state (not persisted across app launches). The expired state renders with red styling and no dismiss affordance. Both states include a 'Renew Now' CTA that triggers navigation to the course enrollment pathway — this route must be confirmed with the navigation/routing layer.
The component should query the certification expiry date from the profile data model and derive state client-side. Edge cases include exactly-60-day boundaries, null expiry dates, and multiple certifications. Session dismiss state should use ephemeral storage, not persistent storage, to ensure reappearance on next launch.
Acceptance Criteria
- Given my certification expires in 60 days or less, When I open my profile screen, Then the certification-alert-banner is displayed with amber styling and the exact expiry date
- Given my certification has expired, When I open my profile screen, Then the certification-alert-banner is displayed with red styling, cannot be dismissed, and states I am no longer visible in the chapter directory
- Given the expiry warning banner is displayed, When I tap 'Renew Now', Then I am navigated to the appropriate course enrollment pathway
- Given the expiry warning banner (not expired) is displayed, When I tap the dismiss button, Then the banner collapses for the current session but reappears on the next app launch
- Given my certification is valid with more than 60 days remaining, When I view my profile, Then no certification-alert-banner is displayed
Business Value
Automatic removal from chapter directories upon certification expiry is a hard requirement from HLF. Without proactive in-app notification, peer mentors will be surprised to find themselves removed from the directory and unable to receive new contact assignments. The alert banner converts a disruptive automated event into a manageable, guided process that preserves the volunteer relationship and maintains compliance.
Components
- Certification Alert Banner ui
- Certification Status Derivation Service service
- Certification Record Repository data
- Peer Mentor Detail BLoC service
- Certification Expiry Auto-Pause Job infrastructure
- Mentor Status BLoC infrastructure