Assignment Matching by Geography

Description

Assignment Matching by Geography overlays encrypted assignment dispatch data onto the peer mentor map, enabling coordinators to identify the closest available and eligible peer mentor for a new assignment. The feature provides a map overlay showing open assignment locations alongside peer mentor positions, with proximity filtering and eligibility checks (certification status, active status, capacity). It supports the coordinator workflow of selecting the best-fit peer mentor without leaving the map context, then initiating dispatch directly from the map overlay.

Sources & reasoning

The phrase "matching og oppdragstildeling" (matching and assignment dispatch) at line 99 directly motivates a dedicated assignment-matching capability layered on top of the base map. Fase 3 placement at line 359 maps to v1.1 by ordinal. Depends on peer-mentor-map and encrypted-assignment-dispatch both being enabled.

docs/source/likeperson.md · line 99

Geografisk kartvisning av likepersoner for matching og oppdragstildeling (særlig store fylker).
docs/source/likeperson.md · line 359

Geografisk kartvisning (Blindeforbundet)

Analysis

Business Value

Geographic assignment matching directly addresses the operational pain Blindeforbundet described for large-county coordination: finding the right peer mentor for a sensitive assignment is time-consuming when done manually from address lists. By surfacing assignment locations and peer mentor positions together on a map, coordinators can make proximity-based decisions in seconds rather than minutes. Faster matching reduces the time contacts wait for support, improving service quality. The eligibility overlay (paused, expired certification) prevents dispatch errors that would cause assignment failures and coordinator follow-up overhead. This feature meaningfully differentiates the platform for geographically dispersed organizations.

Implementation Notes

Builds directly on PeerMentorMapScreen and MapService from the peer-mentor-map feature. Adds AssignmentMapOverlayWidget as a composable layer on the existing map. GeographicMatchingService queries assignment locations and peer mentor eligibility in a single API call to avoid waterfall requests on slow connections. Eligibility logic (certification expiry, pause status) is evaluated server-side to prevent stale client-side data from causing invalid dispatches. The overlay must be toggled independently of the base map so coordinators can declutter the view. Deep integration with encrypted-assignments area means this feature requires encrypted-assignments module toggle to also be enabled. Drift local DB should not cache assignment location data due to sensitivity requirements.