Identify Closest Available Mentor to an Assignment Location
The Geographic Matching Service computes proximity rankings for peer mentor home-area centroids relative to a specified assignment location (input as a municipality or postal code). The Map View Screen can highlight the closest mentors with a proximity ranking overlay or distance indicator on the pin bottom sheet. Proximity is calculated using municipality/postal-code-level centroids, not real-time GPS, in compliance with GDPR. Results are filtered to coordinators' organisational scope via RLS policies.
User Story
Acceptance Criteria
- Given I enter or select an assignment target location on the map, when the proximity calculation completes, then mentor pins are annotated or ranked to indicate relative distance from the target location
- Given proximity ranking is displayed, when I tap a ranked mentor pin, then the bottom sheet shows the estimated distance from the assignment location
- Given proximity is calculated using centroids, when I review results, then the distance shown is labelled as approximate (municipality/postal code level) to set accurate expectations
- Given I apply an availability filter alongside proximity, when results are shown, then only available mentors are ranked by proximity and paused mentors are excluded from ranking
Business Value
Directly addresses the core operational pain point for Blindeforbundet coordinators in large counties: without proximity guidance, coordinators must mentally estimate travel times from postal codes, which is slow and error-prone. Automated proximity ranking reduces matching time and produces better outcomes — shorter mentor travel, higher assignment acceptance rates, and more equitable geographic distribution of assignments.
Components
- Geographic Matching Service service
- Map View Screen ui
- Location Pin Widget ui
- Location Repository data
- Maps API Integration infrastructure