Pause Own Peer Mentor Status
The pause feature (SHOULD HAVE, Phase 2) allows peer mentors to temporarily deactivate themselves without leaving the organization. This is critical for volunteer retention — forcing mentors to fully resign when they need a short break leads to permanent dropout. When a peer mentor initiates a pause, they are shown a confirmation dialog where they can optionally set an expected return date. After confirmation, the coordinator is automatically notified, the mentor's status changes to 'Paused', and they appear with a visual pause badge on all coordinator views. The pause status banner is shown at the top of the mentor's own profile to remind them they are paused.
User Story
Audience Summaries
Volunteer retention is a critical cost driver for peer mentor programs. This story delivers a structured pause mechanism that prevents experienced peer mentors from permanently resigning when they need a temporary break. Workshop data from NHF and HLF confirms that without this option, mentors who need short-term relief exit the program entirely — taking accumulated relationship knowledge and training investment with them. By enabling a reversible pause with automatic coordinator notification, the organization protects continuity of care for existing contacts, reduces coordinator recruitment and onboarding overhead, and sustains mentor supply without expanding budget.
This is a high-priority Phase 2 feature directly tied to volunteer satisfaction, operational resilience, and long-term program sustainability.
This high-priority Phase 2 story requires coordination across UI, notification, and status management concerns. Effort includes building the pause-confirmation-dialog with optional return date input, updating mentor status transitions (Active → Paused → Active), surfacing the pause-status-banner on the mentor's own profile, and integrating with the coordinator-notification-service for both pause and reactivation events. Dependency on story-peer-mentor-profile-status-peer-mentor-001 means the profile status system must be complete first. Acceptance criteria are well-defined with six scenarios covering the full pause/reactivate cycle.
Testing should include coordinator notification delivery, edge cases around return date entry, and coordinator-side behavior preventing new contact assignments while a mentor is paused. UAT should involve both peer mentor and coordinator roles.
Implementation requires extending the mentor profile screen with a stateful pause-reactivate-toggle component that conditionally renders either a pause or reactivate action based on current status. The pause-confirmation-dialog must support an optional date picker for expected return date. On confirmation, the backend must atomically update the mentor's status field to 'Paused' and trigger the coordinator-notification-service with mentor name and return date payload. The pause-status-banner should be injected at the top of the mentor profile view when status equals 'Paused'.
The coordinator view must reflect the paused badge and enforce a guard preventing new contact assignments to paused mentors — this likely requires a status check on the assignment flow. Reactivation reverses status and sends a second coordinator notification. Ensure status transitions are idempotent and that the toggle state is derived from server-side status, not local UI state.
Acceptance Criteria
- Given I am an active peer mentor on my profile screen, When I tap the pause-reactivate-toggle, Then a pause-confirmation-dialog appears asking me to confirm and optionally enter an expected return date
- Given the pause confirmation dialog is open, When I confirm the pause, Then my status changes to 'Paused' and the pause-status-banner appears at the top of my profile
- Given I have just paused, When the action completes, Then the coordinator-notification-service sends a notification to my assigned coordinator with my name and expected return date
- Given I am paused, When I view my profile, Then the pause-reactivate-toggle shows 'Reactivate' state and the pause-status-banner is visible
- Given I am paused and tap 'Reactivate', When I confirm reactivation, Then my status returns to 'Active' and the coordinator is notified of my return
- Given I am paused, When a coordinator views my profile, Then they see a clear paused indicator and cannot assign me new contacts without reactivating me first
Business Value
The pause feature directly addresses volunteer burnout and dropout. Workshop data across NHF and HLF shows that peer mentors who cannot temporarily step back often resign permanently. Providing a structured pause mechanism retains experienced mentors, reduces coordinator recruitment burden, and ensures existing contact assignments are not abandoned without warning. Automatic coordinator notification is critical for contact continuity.
Components
- Pause / Reactivate Toggle ui
- Pause Confirmation Dialog ui
- Pause Status Banner ui
- Mentor Status Service service
- Coordinator Notification Service service
- Mentor Status Repository data
- Mentor Status BLoC infrastructure
- Peer Mentor Detail Screen ui
- Peer Mentor Detail BLoC service