Pause Function

Peer mentor burnout and unmanaged exits represent a significant operational risk for organizations managing volunteer networks. Without a structured pause mechanism, mentors who need a temporary break may permanently disengage, causing loss of trained volunteers who are difficult to replace. This feature reduces attrition by providing a dignified, low-friction way to step back without severing the relationship. Coordinators gain real-time visibility into availability changes, enabling accurate assignment planning. Three of the four client organizations explicitly requested this feature, confirming broad strategic value across the multi-tenant platform.

PeerMentorStatusService handles the status transition and calls the PushNotificationService to notify the coordinator immediately. Status is persisted in the peer_mentor_statuses table (one-to-one with users) via PATCH /api/v1/peer-mentors/{id}/status. The backend enforces that only the peer mentor themselves or their assigned coordinator can initiate a pause. Riverpod state invalidation refreshes home dashboard widgets and contact pool queries that depend on active status. The feature is gated under the peer-mentor-status area ID in the module registry; disabling the area hides the PauseStatusScreen entirely without a client release.