🏠 Overview â€ș 🎯 Features â€ș🎯 Assignment Matching by Geography

Assignment Matching by Geography

Feature Detail

high complexity extracted Geographic Map View Confidence: 100%
5
Components
2
Shared
0
User Stories
Yes
Analyzed

Description

Geographic matching engine that pairs incoming assignments with the most suitable peer mentor based on proximity to the contact's location. The system computes distance metrics between assignment locations and available mentors, presenting coordinators with ranked candidates to optimize dispatch decisions. Beyond simple distance calculations, the matching service considers mentor availability, current assignment load, and certification status. Coordinators retain final authority over dispatch decisions but receive data-driven recommendations that significantly reduce manual decision overhead in regions with many active mentors.

Sources & reasoning

Listed in §8 area taxonomy under geographic-map-view. §3.1 ties geographic visualization explicitly to 'matching og oppdragstildeling' (matching and assignment dispatch). Phase derived from §5 Fase 3 which places the area in Growth & Engagement; no earlier phase mentions it.

  • Geografisk kartvisning av likepersoner for matching og oppdragstildeling (sĂŠrlig store fylker).
  • geographic-map-view | Geographic Map View | Peer Mentor Map, Assignment Matching by Geography

Analysis

Business Value

Manual mentor selection for assignment dispatch is time-consuming and error-prone, especially in large geographic regions where coordinators lack visibility into mentor proximity. This directly affects response time to contacts and travel costs, both critical operational metrics for Blindeforbundet. Automated geographic matching reduces coordinator workload, accelerates assignment dispatch, and minimizes total travel costs across the organization. Better proximity matching also improves contact experience through faster response times and more frequent in-person visits, strengthening the peer mentor program's core value proposition.

Implementation Notes

Geo Matching Service computes distances using standard geospatial libraries (haversine for direct distance, optional integration with routing APIs for travel time). Candidates are ranked by composite score combining distance, availability status, and current workload from assignment-threshold tracking. Integration with encrypted-assignment-dispatch ensures matched assignments respect privacy boundaries. The matching UI surfaces top candidates with rationale (distance, current load) and allows manual override. Performance considerations include indexed spatial queries on the geo_locations table and pre-computed availability snapshots refreshed periodically.

Quality Assurance

Coordinator (primary) · Peer Mentor (subject)
2
Scenarios
9
UAT Steps
23
A11y Annotations
4
Role Boundaries
Coordinator (Koordinator)

Coordinator (Koordinator)

Quick UAT

  1. Logg inn i Meander-mobilappen som Koordinator og Ă„pne Oppdrag-fanen.
  2. Trykk 'Nytt oppdrag' og velg en kontakt med registrert adresse i et stort fylke.
  3. NĂ„r geomatch-skjermen Ă„pnes, bekreft at likepersoner vises sortert etter avstand med estimert kilometer, tilgjengelighetsstatus og antall aktive oppdrag.
  4. Filtrer bort likepersoner som er pÄ pause og kontroller at listen oppdateres.
  5. Velg den Ăžverste tilgjengelige likepersonen og trykk 'Tildel oppdrag'.
  6. Bekreft at oppdraget er sendt kryptert til valgt likeperson og at geomatch-skjermen lukkes med kvittering 'Oppdrag tildelt'.

Quick UAT — Accessibility

  1. Logg inn i Meander-mobilappen som Koordinator og Ă„pne Oppdrag-fanen.
    • Screen reader Skjermleser annonserer 'Oppdrag, fane 4 av 5, valgt'.
    • Focus visibility Synlig fokusring pĂ„ aktiv fane.
    • Touch target Fane-knapper ≄ 24×24 CSS px.
  2. Trykk 'Nytt oppdrag' og velg en kontakt med registrert adresse i et stort fylke.
    • Screen reader 'Nytt oppdrag, knapp' annonseres; kontaktliste leses som 'Kontakt, 1 av N'.
    • Keyboard / focus Tab nĂ„r 'Nytt oppdrag'; piltaster navigerer kontaktliste; Enter velger.
    • Touch target Knapp og listeelementer ≄ 24×24 CSS px.
  3. NĂ„r geomatch-skjermen Ă„pnes, bekreft at likepersoner vises sortert etter avstand med estimert kilometer, tilgjengelighetsstatus og antall aktive oppdrag.
    • Screen reader Hver rad annonseres som 'Likeperson [navn], [N] km, status [tilgjengelig/pause], [M] aktive oppdrag'.
    • Zoom Liste er brukbar ved 200% zoom uten horisontal scrolling.
    • Contrast Status formidles med bĂ„de ikon og tekst, ikke kun farge; tekst 4.5:1 kontrast.
  4. Filtrer bort likepersoner som er pÄ pause og kontroller at listen oppdateres.
    • Keyboard / focus Filterbryter nĂ„s med Tab; Space veksler av/pĂ„.
    • Focus visibility Synlig fokusring pĂ„ filterbryter; etikett 'Skjul likepersoner pĂ„ pause' lest av skjermleser.
    • Live region 'Liste oppdatert. [N] likepersoner vises.'
  5. Velg den Ăžverste tilgjengelige likepersonen og trykk 'Tildel oppdrag'.
    • Screen reader Valgt rad annonseres som 'valgt'; 'Tildel oppdrag, knapp' leses.
    • Keyboard / focus Enter pĂ„ rad markerer; Tab til 'Tildel oppdrag'; Enter aktiverer.
    • Touch target 'Tildel oppdrag'-knapp ≄ 24×24 CSS px.
  6. Bekreft at oppdraget er sendt kryptert til valgt likeperson og at geomatch-skjermen lukkes med kvittering 'Oppdrag tildelt'.
    • Focus visibility Fokus flyttes tilbake til Oppdrag-listen pĂ„ toppen av nytt oppdrag.
    • Live region 'Oppdrag tildelt [navn pĂ„ likeperson]. Kryptert sending bekreftet.'
Peer Mentor (Likeperson) subject view

Peer Mentor (Likeperson)

Quick UAT

  1. Logg inn i Meander-mobilappen som Likeperson umiddelbart etter at Koordinator har tildelt et geomatchet oppdrag.
  2. Åpne Varsler-fanen og bekreft at det ligger et nytt varsel om kryptert oppdrag.
  3. Åpne oppdraget og bekreft at det er adressert til deg basert pĂ„ geografisk nĂŠrhet, med kontaktens adresse synlig.

Quick UAT — Accessibility

  1. Logg inn i Meander-mobilappen som Likeperson umiddelbart etter at Koordinator har tildelt et geomatchet oppdrag.
    • Screen reader PĂ„loggingsskjerm annonseres; biometrisk prompt leses som 'Bruk Face ID for Ă„ logge inn'.
    • Focus visibility Fokus starter pĂ„ e-postfeltet ved fĂžrste pĂ„logging.
  2. Åpne Varsler-fanen og bekreft at det ligger et nytt varsel om kryptert oppdrag.
    • Touch target Varsel-element ≄ 24×24 CSS px.
    • Live region '1 nytt varsel: Kryptert oppdrag mottatt.'
  3. Åpne oppdraget og bekreft at det er adressert til deg basert pĂ„ geografisk nĂŠrhet, med kontaktens adresse synlig.
    • Screen reader Skjermleser advarer fĂžr opplesning av sensitive felter (navn, adresse) iht. sensitive-field readout warning.
    • Contrast Sensitive felter merket bĂ„de med ikon og tekst, ikke kun farge.

Role Boundaries

4 role(s) must NOT access this feature
  • Peer Mentor (Likeperson)

    Geomatch-skjermen er ikke tilgjengelig i likeperson-navigasjonen; deep-link til geomatch-ruten returnerer 403 / 'Ingen tilgang'.

  • Organization Administrator

    Organisasjonsadministrator logger ikke inn i mobilappen i admin-modus; geomatch er ikke eksponert i admin-portalen - kun via mobil som Koordinator.

  • Global Administrator

    Global Admin har ikke standard tilgang til operasjonell tenant-data; geomatch-API returnerer 403 uten tidsbegrenset support-tilgang aktivert av organisasjonen.

  • Prospective Buyer

    Salgsnettstedet har ingen pÄlogging og ingen tilgang til mobilappens geomatch-funksjon.

Expected End State

Oppdraget er kryptert tildelt den geografisk nÊrmeste, tilgjengelige likepersonen valgt av Koordinator. Likepersonen mottar varsel om kryptert oppdrag i mobilappen, og geomatch-skjermen lukkes med bekreftelse pÄ vellykket tildeling.

Components (7)

User Interface (2)

ui Map Screen medium ui Geo Match Screen medium

Service Layer (2)

service Geo Service medium service Geo Matching Service medium

Infrastructure (1)

infrastructure Map Tiles Provider medium

Shared Components

These components are reused across multiple features

User Stories

No user stories have been generated for this feature yet.