Mentor Program Management
Feature Detail
Description
Mentor Program Management supports the structured mentorship schemes run by organisations such as Norges Blindeforbund, where experienced peer mentors guide newer members through a defined programme. The feature enables coordinators to create mentor-mentee pairings, track programme progress, and manage the matching workflow. Peer mentors can view their assigned mentees and programme milestones directly in the app, while coordinators maintain oversight of active pairings and can intervene when a pairing is not progressing. The feature is designed for relatively small cohorts with high-touch coordination.
Analysis
Norges Blindeforbund identified a formal mentorship scheme as a distinct organisational need for onboarding new peer mentors and providing career development pathways. Without dedicated tooling, coordinators manage pairings through spreadsheets and manual follow-up, leading to inconsistent programme delivery and dropout. An in-app mentor programme module reduces coordinator administrative load, ensures consistent pairing quality, and provides visibility into programme health. For peer mentors, it creates a sense of structured progression and belonging, which research consistently links to higher volunteer retention rates in peer support organisations.
The MentorProgramService manages pairing logic and status transitions; the Mentor Program Repository persists pairings and milestone data to Supabase. The Mentor Program Screen presents active pairings in a list with status indicators; the Mentor Match Widget provides a coordinator-facing UI for creating new pairings by selecting from available peer mentors and eligible mentees. Matching criteria (geography, availability, specialisation) are surfaced as filters using data from the Geographic Matching and Peer Mentor Profiles features. The data model extends peer_mentors with a mentor_programme_role field and introduces a separate mentor_pairings join table. Role-level Supabase policies ensure only coordinators can create or dissolve pairings.
Dependencies
Definition of Done
Components (5)
User Stories (7)
As a As a Coordinator
I want I want to mark specific programme milestones as completed for an active mentor-mentee pairing
So that So that I can track programme progress accurately and ensure the mentor programme advances through its defined stages in a consistent and documentable manner
- Given I am a coordinator viewing a pairing detail with pending milestones, when I tap the mark complete action on a milestone, then the milestone status updates to completed with the current timestamp
- Given a milestone is marked complete, when I view the pairing detail, then the milestone displays a completed visual indicator and the completion date
- Given all milestones for a pairing are marked complete, when the final milestone is saved, then the pairing status automatically transitions to 'programme complete'
- +2 more
As a As a Coordinator
I want I want to dissolve a mentor-mentee pairing that is not progressing or is no longer appropriate
So that So that I can free both the mentor and mentee to be re-matched with more compatible partners and maintain a clean programme roster free of stalled pairings that distort programme health metrics
- Given I am a coordinator on the pairing detail screen, when I select the dissolve pairing action, then a confirmation dialog appears requiring selection of a dissolution reason before proceeding
- Given I confirm dissolution with a reason, when the action is submitted, then the pairing status transitions to 'dissolved' and the record is archived with the reason and timestamp
- Given a pairing is dissolved, when I view the active programme overview, then the dissolved pairing no longer appears in the active list
- +2 more
As a As a Peer Mentor (Likeperson)
I want I want to view my assigned mentees and the programme milestones associated with each pairing
So that So that I can track my mentorship responsibilities and understand which programme stages I need to guide my mentees through
- Given I am authenticated as a peer mentor, when I navigate to the mentor programme section, then I see only my own active mentee pairings
- Given I have active pairings, when the list loads, then each pairing shows the mentee name, current programme status indicator, and any pending milestones
- Given I have no active pairings, when I open the mentor programme screen, then a clear empty-state message is displayed explaining that I have no current mentees assigned
- +2 more
As a As a user
I want I want to view the full details of a specific mentor-mentee pairing including pairing history and milestone completion status
So that So that I can understand the current state of the pairing, review what has been accomplished, and identify what programme stages still need to be completed
- Given I am a peer mentor viewing my own pairing, when I tap a pairing entry, then the detail screen opens showing pairing history and milestone statuses in read-only mode with no intervention controls visible
- Given I am a coordinator viewing any pairing, when I open the detail screen, then I see the full pairing history plus the coordinator intervention controls (dissolve, mark milestone complete)
- Given there are multiple milestones in the programme, when the detail screen loads, then each milestone is listed with its completion status (completed, in-progress, pending) and completion timestamp where applicable
- +2 more
As a As a Coordinator
I want I want to view all active mentor-mentee pairings within my organisational scope with visual status indicators for each pairing
So that So that I can quickly assess overall programme health, identify stalled pairings requiring intervention, and ensure consistent programme delivery across all active cohorts
- Given I am authenticated as a coordinator, when I open the mentor programme screen, then I see all active pairings within my organisational scope
- Given pairings are loaded, when I view the list, then each entry shows mentor name, mentee name, current programme stage, and a colour-coded status indicator
- Given a pairing has had no recorded activity or milestone progress in the last 14 days, when I view the status indicator, then it is visually distinguished (e.g., amber or red) to flag the need for intervention
- +2 more
As a As a user
I want I want to view the full details of a specific mentor-mentee pairing including pairing history and milestone completion status
So that So that I can understand the current state of the pairing, review what has been accomplished, and identify what programme stages still need to be completed
- Given I am a peer mentor viewing my own pairing, when I tap a pairing entry, then the detail screen opens showing pairing history and milestone statuses in read-only mode with no intervention controls visible
- Given I am a coordinator viewing any pairing, when I open the detail screen, then I see the full pairing history plus the coordinator intervention controls (dissolve, mark milestone complete)
- Given there are multiple milestones in the programme, when the detail screen loads, then each milestone is listed with its completion status (completed, in-progress, pending) and completion timestamp where applicable
- +2 more
As a As a Coordinator
I want I want to create new mentor-mentee pairings by selecting compatible candidates using filters for geography, availability, and specialisation
So that So that I can establish high-quality pairings that maximise compatibility and programme success, replacing the current manual spreadsheet-based matching process
- Given I am authenticated as a coordinator, when I open the Mentor Match Widget, then I see a list of available peer mentors and eligible mentees
- Given I apply a geography filter, when the candidate list updates, then only mentors and mentees within the specified geographic area are shown
- Given I apply an availability filter, when the candidate list updates, then only peer mentors with an active availability status are displayed
- +4 more