View Current Pause Status and History
The app should make the peer mentor's current status immediately visible on their home screen and profile page. A persistent banner should be shown when the mentor is paused, indicating the pause is active and displaying the expected return date if set. If a certification is expiring while the mentor is paused, an additional warning banner should appear prompting the mentor to renew before reactivating. The mentor should also be able to access a notification card summarising the most recent pause or reactivation event.
User Story
Audience Summaries
Status transparency is foundational to trust in any volunteer or peer-support platform. This story ensures that peer mentors always have an accurate, real-time understanding of their active or paused state, directly reducing the risk of missed contact follow-ups that erode program effectiveness and contact satisfaction. The persistent pause banner prevents the costly scenario where a mentor believes they are active but is not, which can lead to uncontacted individuals falling through the system — a reputational and outcome risk for the program. The proactive certification expiry warning during pause periods is strategically important: it prevents a common re-entry failure point where a mentor returns only to discover an expired certification, creating delay and frustration.
By surfacing historical pause timelines, the platform also enables performance reviews and quality assurance conversations grounded in factual engagement data, supporting program governance and mentor accountability.
This story has a dependency on the core pause/reactivation story and should be sequenced after that foundation is stable. Delivery involves coordinating between mobile UI (banner components, profile status indicator, notification centre card), backend (pause history endpoint, certification expiry logic), and potentially the certification management subsystem if expiry data is not already accessible at the mentor profile level. Six acceptance criteria must be validated, including conditional banner display, distinct visual status states, and historical timeline rendering. QA effort is moderate — testers must set up paused, active, and mixed certification-state scenarios.
A key delivery risk is the certification expiry integration: if the certification service is owned by another team, a dependency handshake and shared data contract are needed early. The notification centre card for coordinator actions requires alignment with whatever coordinator-side actions exist in the parallel coordinator story track. Recommend planning this in the same sprint window as the coordinator notification story.
This story requires changes across the home screen, profile screen, and notification centre. The home screen needs a conditionally rendered pause status banner component that reads mentor status from the app state or a dedicated status endpoint; it must display `pause_start_date` and the nullable `expected_return_date`. A second conditional banner must render when a certification expiry date is within the warning threshold while the mentor is paused — this requires access to certification expiry data, either already in the mentor profile response or via a separate fetch. The profile screen needs a distinct visual state for 'Paused' vs 'Active' (separate CSS class or icon set, not just a text label).
The pause history section requires a chronological timeline data structure — the backend must expose a `pause_history` array on the mentor profile endpoint, with start and end timestamps per pause period. The notification centre card for coordinator actions is a read-only display component consuming existing notification payloads — ensure the data contract includes pause-related event types. All banner and status UI must be driven purely by server state to prevent stale local state mismatches.
Acceptance Criteria
- Given I am paused, when I open the app home screen, then a pause status banner is displayed prominently with my pause start date and expected return date if set
- Given I am paused, when I navigate to my profile, then my status is shown as 'Paused' with a visual indicator distinct from 'Active'
- Given my certification expires while I am paused, when I open the app, then a certification expiry warning banner appears above or alongside the pause status banner
- Given a coordinator has taken action related to my pause (e.g., acknowledged my absence), when I open the notification centre, then I can see a pause notification card with the relevant details
- Given I am active (not paused), when I view my profile, then no pause banner is displayed and my status shows as 'Active'
- Given I have a history of past pauses, when I view my profile or activity history, then previous pause periods are recorded and visible as timeline entries
Business Value
Transparent status visibility prevents confusion for peer mentors about their current state. Without clear feedback, mentors may believe they are active when they are not, leading to missed follow-ups with contacts. Proactive certification warnings during pause periods prevent mentors from reactivating only to discover their certification is expired, which would delay their return to full activity.
Components
- Pause Status Banner ui
- Mentor Status BLoC infrastructure
- Certification Expiry Warning Banner ui
- Pause Status Indicator ui
- Certification Expiry Checker Service service
- Peer Mentor Status Repository data
- Certification Status Repository data
- Pause Management Service service
- Certificate Expiry Notification Banner ui
- Certificate Expiry Status Indicator ui
- Pause Status Notification Card ui
- Peer Mentor Confirmation Banner ui
- Pause Status Record Repository data
- Notification Centre Screen ui
- Notification List Item ui
- Notification BLoC service