🏠 Overview › 👥 User Roles ›📖 Create a New Mentor-Mentee Pairing Using Matching...

Create a New Mentor-Mentee Pairing Using Matching Criteria Filters

Coordinators use the Mentor Match Widget to initiate new pairings. The widget surfaces available peer mentors and eligible mentees drawn from the Peer Mentor Profiles and Contact features. Filter controls allow narrowing candidates by geographic proximity, current availability status, and specialist area. After selecting a mentor and mentee, the coordinator confirms the pairing; the MentorProgramService validates the selection, sets the initial programme status, and persists the record to the mentor_pairings table via the Mentor Program Repository. Role-level Supabase policies and the Permission Guard ensure that only users with the coordinator role can access or interact with the Mentor Match Widget.

CRITICAL story-mentor-program-coordinator-003 5 pts
5
Story Points
Critical
Priority
Mentor Program Management
Feature

User Story

As a Coordinator
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

Acceptance Criteria

  • 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
  • Given I apply a specialisation filter, when the candidate list updates, then only candidates matching the selected specialisation area are shown
  • Given I select a mentor and a mentee, when I confirm the pairing, then the system creates a new pairing record with status 'active' and an initial milestone set populated from the programme template
  • Given a pairing is successfully created, when the coordinator returns to the programme overview screen, then the new pairing appears in the active pairings list with an 'active' status indicator
  • Given I am authenticated as a peer mentor, when I attempt to access the Mentor Match Widget, then access is denied by the permission guard and no pairing creation UI is shown

Business Value

Directly enables the formalised mentorship scheme identified as a distinct organisational need by Norges Blindeforbund. Replacing spreadsheet-based matching with criteria-filtered digital tooling improves pairing quality and reduces the time coordinators spend on manual coordination. High-quality initial pairings are the strongest predictor of programme completion and long-term volunteer retention in peer support organisations.

Components

Mentor Program Management
Related Feature
Coordinator
User Role