Filter Peer Mentors on Map by Specialty and Availability
Having all peer mentors on the map is useful, but coordinators need to find the right mentor for a specific contact need, not just the nearest one. The map-filter-panel provides controls for filtering by: active/paused status, certification validity, areas of lived experience or specialization, and chapter affiliation for multi-chapter contexts. Filters are applied client-side after initial data load for responsiveness, with mentor-filter-service handling the logic. The filter panel slides up from the bottom of the screen as a bottom sheet, keeping the map visible for spatial context. Applied filters persist during the session and are shown as active filter chips above the map. The view-toggle-button allows switching to the list fallback view with the same filters applied.
User Story
Acceptance Criteria
- Given the coordinator opens the filter panel, when they apply a 'certification valid' filter, then only peer mentors with a non-expired certification are shown as markers on the map
- Given filters are applied, when the coordinator toggles to list view via the view-toggle-button, then the same filtered mentor set is shown in the mentor-list-fallback with identical results
- Given the coordinator applies a 'paused' status filter, when the map refreshes, then paused peer mentors are visually distinguished (greyed-out markers) rather than completely hidden, so the coordinator is aware of the full roster
- Given multiple filters are applied, when the coordinator views the map, then active filter chips are displayed above the map with individual remove buttons for each
- Given no mentors match the current filter combination, when filters are applied, then an empty state message explains what filters are active and suggests clearing or adjusting them
- Given the coordinator clears all filters, when the reset action is triggered, then all peer mentors with location consent are shown again and filter chips are removed
Business Value
Geographic proximity alone is insufficient for quality peer mentor matching. Coordinators must ensure the selected mentor is certified, active, and has relevant lived experience for the contact's situation. Filtering directly on the map eliminates the current two-step workflow where coordinators cross-reference a paper roster against a map. This reduces matching errors and speeds up assignment, which is critical when a contact needs urgent support.
Components
- Map View Screen ui
- Map Filter Panel ui
- Map / List View Toggle Button ui
- Mentor List Fallback View ui
- Mentor Filter Service service
- Location Privacy Configuration infrastructure