🏠 Overview â€ș 🎯 Features â€ș🎯 Recruitment Tracking

Recruitment Tracking

Feature Detail

medium complexity extracted Referral Program Confidence: 100%
5
Components
2
Shared
0
User Stories
Yes
Analyzed

Description

This feature provides peer mentors, coordinators, and organization admins with visibility into the outcomes of invitations sent via the referral program. It surfaces who was invited, which invitations converted into actual sign-ups, and the cumulative recruitment contribution of each sharer and each local association. The tracking dashboard distinguishes pending invitations, accepted invitations, and lapsed ones, and ties recruitment counts back to the inviter's profile so the effort feeds into the broader visibility-of-effort narrative shared with the gamification area.

Sources & reasoning

Named verbatim in the canonical area taxonomy as the second feature of referral-program. Required to make invite-link-qr-sharing measurable; without tracking, HLF's recruitment use case cannot be reported on. Matrix Phase 3 maps to Growth & Engagement.

  • Vervefunksjonalitet for medlemsverving (appen som markedsfĂžrt medlemsfordel).
  • Verving / Referral (invite-link, rekruttering) | - | - | - | ✓ | ✓ | SHOULD (HLF) | 3
  • referral-program | Referral Program | Invite Link & QR Sharing, Recruitment Tracking

Analysis

Business Value

HLF identified recruitment as a strategic priority and the matrix marks Verving / Referral as a SHOULD for them. Without attribution and tracking, an invite-link feature is just a share button - recruitment tracking is what converts the mechanic into a measurable program HLF and other adopting orgs can report on internally and use to recognize active recruiters. For coordinators, the dashboard answers a question they cannot currently answer at all: "where are our new members actually coming from?" That data feeds local-association planning, recognition decisions, and longer-term partnership conversations Norse Digital Products is pursuing in mobilization (Fase 0).

Implementation Notes

Tracking is built on the `referral_tracking` table joined to `referrals`, with state transitions (pending → accepted → expired) driven by sign-up events from the Authentication Module and a scheduled expiry sweep. Per-user counts are denormalized into a small projection refreshed on tracking-event write to keep the Recruitment Dashboard fast on mobile. Visibility follows role boundaries: peer mentors see only their own invitations and counts; coordinators see their local association's roll-up; org admins access cross-association views via the Admin Web Portal rather than the mobile dashboard. Because the feature depends on actual sign-ups, it ships behind the same `referral-program` module toggle as invite sharing.

Quality Assurance

Coordinator (primary)
1
Scenarios
5
UAT Steps
15
A11y Annotations
2
Role Boundaries
Coordinator (Koordinator)

Coordinator (Koordinator)

Quick UAT

  1. Logg inn i Meander Mobile App som Koordinator og Ă„pne Arbeid-fanen.
  2. Trykk Rekruttering for Ă„ Ă„pne Rekrutteringsdashbordet.
  3. Bekreft at tellerne Invitasjoner sendt, Åpnet, PĂ„meldt og Aktive vises med tall for ditt lokallag.
  4. Velg en likeperson fra listen for Ă„ se vedkommendes attribusjonsdetaljer.
  5. Bytt kanalfilter (f.eks. Verksted vs Personlig nettverk) og bekreft at tallene oppdateres deretter.

Quick UAT — Accessibility

  1. Logg inn i Meander Mobile App som Koordinator og Ă„pne Arbeid-fanen.
    • Screen reader Skjermleser annonserer 'Arbeid, fane 4 av 5, valgt'.
    • Keyboard / focus Bunnavigasjon nĂ„s via Tab; piltaster bytter fane.
    • Touch target Fane-ikon er minst 24×24 CSS-piksler.
  2. Trykk Rekruttering for Ă„ Ă„pne Rekrutteringsdashbordet.
    • Screen reader Sideoverskrift 'Rekruttering' annonseres ved sideĂ„pning.
    • Focus visibility Synlig fokusring pĂ„ Rekruttering-lenken.
    • Touch target Lenke-treffareal ≄ 24×24 CSS-piksler.
  3. Bekreft at tellerne Invitasjoner sendt, Åpnet, PĂ„meldt og Aktive vises med tall for ditt lokallag.
    • Screen reader Hver telle-kortets etikett og verdi leses opp (f.eks. 'Invitasjoner sendt, 42').
    • Zoom Tellerkortene forblir lesbare ved 200 % zoom uten horisontal scroll.
    • Contrast Talltekst har kontrast minst 4.5:1; trakttrinn skilles ikke kun ved farge — etikett stĂ„r ved siden av.
  4. Velg en likeperson fra listen for Ă„ se vedkommendes attribusjonsdetaljer.
    • Keyboard / focus Listen er tastaturnavigerbar; Enter Ă„pner detalj.
    • Focus visibility Synlig fokusring pĂ„ valgt rad; rad-rolle annonseres som 'knapp'.
    • Live region 'Viser rekrutteringsdetaljer for [navn].'
  5. Bytt kanalfilter (f.eks. Verksted vs Personlig nettverk) og bekreft at tallene oppdateres deretter.
    • Screen reader Filterknapp annonseres med valgt tilstand ('Verksted, valgt').
    • Live region 'Tall oppdatert for kanal Verksted.'
    • Contrast Aktivt filter markeres med bĂ„de farge OG ikon/understreking — ikke kun farge.

Role Boundaries

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

    Peer mentor ser kun sine egne rekrutteringstall (personlig motivasjon) — aggregert lokallags-/organisasjonsvisning er skjult; deep-link til aggregert visning returnerer 403.

  • Prospective Buyer

    Har ingen tilgang til Mobile App; innlogging avvises og dashbordet er ikke nÄbart.

Expected End State

Koordinatoren ser oppdaterte rekrutteringsmetrikker (invitasjoner sendt, Äpnet, pÄmeldt, aktive) for sitt lokallag, med per-likeperson- og per-kanal-attribusjon synlig og filtrerbar.

Components (7)

User Interface (2)

ui Invite Share Screen medium ui Recruitment Dashboard medium

Service Layer (2)

service Invite Service medium service Recruitment Tracking Service medium

Data Layer (1)

data Invite Store medium

Shared Components

These components are reused across multiple features

User Stories

No user stories have been generated for this feature yet.