🏠 Overview › 🎯 Features ›🎯 Membership Recruitment (Verving)

Membership Recruitment (Verving)

Feature Detail

medium complexity extracted Gamification & Engagement Confidence: 100%
8
Components
198
Shared
6
User Stories
Yes
Analyzed

Description

A feature enabling peer mentors to actively recruit new members to their organisation directly from the app. This includes a shareable referral link or QR code tied to the peer mentor's identity, a simple onboarding flow for the recruited member, and tracking of successful recruitments attributed to each peer mentor. HLF specifically requested this as a way to use the app as a marketed membership benefit and to leverage peer mentors' existing social networks. Successful recruitments can feed into the badge and recognition system, creating a closed motivation loop.

Analysis

Business Value

Turns peer mentors into an active recruitment channel at near-zero marginal cost. HLF views the app itself as a membership benefit — recruitment tracking validates that positioning and creates measurable ROI for the app investment.

Implementation Notes

Generate unique referral codes per peer mentor stored in Supabase. Share via system share sheet (Flutter Share plugin). Landing page or deep link for new member signup must be coordinated with each organisation's membership system. Track conversion from referral click to completed registration. Attribution data exposed in coordinator dashboard and feeds badge criteria.

Components (206)

User Interface (4)

ui Coordinator Recruitment Dashboard medium ui New Member Onboarding Screen medium ui Recruitment Stats Widget low ui Referral Code Screen medium

Service Layer (2)

service Referral Attribution Service high service Referral Code Service medium

Data Layer (2)

data Recruitment Attribution Repository medium data Referral Code Repository low

Shared Components

These components are reused across multiple features

User Interface (59)

ui Role Switch Widget medium Shared ui Role-Aware Bottom Navigation medium Shared ui Activity Type Selection Screen low Shared ui Speech-to-Text Field Overlay medium Shared ui Receipt Capture Widget medium Shared ui Peer Mentor Single Selector low Shared ui Proxy Audit Badge Widget low Shared ui Export Period Picker low Shared ui Contact Card Widget low Shared ui Contact Search Bar low Shared ui Peer Mentor Card Widget low Shared ui Activity History List low Shared ui Multi-Chapter Affiliation Chip Widget medium Shared ui Certification Status Badge low Shared ui Duplicate Activity Warning Dialog medium Shared ui Mentor Multi-Select Widget medium Shared ui Map Filter Panel medium Shared ui Claim Status Badge low Shared ui Export Date Range Picker low Shared ui Custom Date Range Picker low Shared ui Duplicate Activity Warning Dialog low Shared ui Proxy Activity Form medium Shared ui Proxy Peer Mentor Selector medium Shared ui Expected Return Date Picker low Shared ui Pause Activation Screen low Shared ui Pause Status Indicator low Shared ui Admin KPI Stat Widget low Shared ui Organisation Hierarchy Navigator high Shared ui Bufdir Period Selector Widget low Shared ui Export History List medium Shared ui Activity Type Donut Chart medium Shared ui Monthly Activity Bar Chart medium Shared ui Statistics Period Filter Bar low Shared ui Statistics Summary Cards low Shared ui Notification Badge Widget low Shared ui Certificate Expiry Status Indicator low Shared ui Animated Stat Card Widget medium Shared ui In-App Notification Banner low Shared ui Accessible Modal Sheet Widget high Shared ui Live Region Announcer medium Shared ui Semantics Wrapper Widget medium Shared ui Sensitive Field Warning Dialog high Shared ui Confirm Before Submit Screen medium Shared ui Inline Contextual Help Widget low Shared ui Labelled Navigation Bar low Shared ui Plain Language Error Display low Shared ui Single-Action Screen Layout medium Shared ui Wizard Progress Indicator low Shared ui Accessible Text Style System medium Shared ui Accessible Touch Target Wrapper low Shared ui Contrast-Safe Color Palette Widget medium Shared ui Accessible Bottom Navigation Bar medium Shared ui Modal Close Button low Shared ui Persistent Back Button low Shared ui Vertical Scroll Container low Shared ui Organization Card Widget low Shared ui Terminology-Aware Text Widget low Shared ui FeatureGate Widget low Shared ui Chapter Switcher medium Shared

Service Layer (52)

service Authentication Service medium Shared service Authentication Session Manager medium Shared service Biometric Authentication Service medium Shared service Biometric Authentication Service medium Shared service Biometric Authentication Service medium Shared service Permission Checker Service medium Shared service Role State Manager medium Shared service No-Access Route Guard low Shared service Activity Type Metadata Resolver low Shared service Chapter Scope Resolver medium Shared service Organisation Hierarchy Resolver medium Shared service Coordinator Notification Service medium Shared service Duplicate Activity Detection Service high Shared service Mentor Filter Service low Shared service Receipt Threshold Validator low Shared service Approval Status Notification Service medium Shared service Threshold Evaluation Service medium Shared service Declaration Encryption Service high Shared service Organization Feature Flag Service low Shared service Participant Deduplication Service high Shared service Reporting Period Service medium Shared service Activity Attribution Service low Shared service Proxy Duplicate Detection Service medium Shared service Pause Management Service medium Shared service Pause Notification Service medium Shared service Admin Export Service medium Shared service Admin Row-Level Security Guard high Shared service Organisation Hierarchy Service high Shared service User Management Service high Shared service Role Access Validator low Shared service Peer Mentor Stats Aggregator medium Shared service Push Notification Dispatcher medium Shared service Notification Preference Service low Shared service Scenario Deep-Link Router medium Shared service Scenario Notification Content Builder medium Shared service Badge Criteria Integration medium Shared service Activity Summary Aggregator low Shared service Focus Management Service medium Shared service Screen Reader Detection Service medium Shared service Sensitive Field Privacy Guard high Shared service Plain Language Content Service medium Shared service Wizard State Manager medium Shared service Tab State Manager medium Shared service Organization Route Guard medium Shared service Tenant Context Service high Shared service Label Key Resolver Service low Shared service Organization Labels Notifier medium Shared service FeatureFlagProvider (Riverpod) medium Shared service Access Scope Service high Shared service Hierarchy Aggregation Service high Shared service Hierarchy Service high Shared service Unit Assignment Service medium Shared

Data Layer (33)

data Authentication Repository low Shared data Auth Token Store low Shared data Secure Session Storage low Shared data Activity Type Cache Provider medium Shared data Receipt Storage Adapter medium Shared data Proxy Contact List Provider low Shared data Contact Repository medium Shared data Contact Detail Repository medium Shared data Peer Mentor Repository low Shared data Mentor Status Repository low Shared data Contact Chapter Repository medium Shared data Contact Cache Sync Repository low Shared data Organisation Rate Configuration Repository low Shared data Multi-Organization Data Isolator medium Shared data Bufdir Aggregation Repository low Shared data Report File Storage Client low Shared data Certification Status Repository low Shared data Peer Mentor Status Repository medium Shared data Statistics Cache Manager low Shared data In-App Notification Repository low Shared data Pause Status Record Repository low Shared data Activity Aggregation Repository medium Shared data Notification Preferences Repository low Shared data Scenario Notification Repository medium Shared data Sensitive Field Configuration low Shared data Error Message Registry low Shared data Help Content Registry low Shared data Wizard Draft Repository low Shared data Design Token Provider medium Shared data Organization Repository medium Shared data Terminology Local Cache Adapter low Shared data Organization Unit Repository high Shared data Unit Assignment Repository medium Shared

Infrastructure (54)

infrastructure Keyboard-Aware Layout Utility low Shared infrastructure Supabase Auth Client low Shared infrastructure Deep Link / OAuth Redirect Handler medium Shared infrastructure Secure Storage Adapter low Shared infrastructure Supabase Session Manager medium Shared infrastructure URL Launcher Utility low Shared infrastructure Local Storage Adapter low Shared infrastructure Supabase Activity Client low Shared infrastructure Organization Labels Provider low Shared infrastructure Supabase Client low Shared infrastructure Organisation Field Config Loader medium Shared infrastructure Speech-to-Text Adapter medium Shared infrastructure File Download Handler low Shared infrastructure Duplicate Reviewed Flag Middleware low Shared infrastructure Contact RLS Query Builder low Shared infrastructure Contact Form Validator low Shared infrastructure Design Token Theme low Shared infrastructure Organization Labels Provider low Shared infrastructure Supabase Client Provider low Shared infrastructure Search Debounce Utility low Shared infrastructure Expense Type Analytics Tracker low Shared infrastructure Receipt Image Picker Integration low Shared infrastructure CSV / JSON File Generator medium Shared infrastructure Coordinator Role Guard low Shared infrastructure Nightly Job Scheduler medium Shared infrastructure Supabase RLS Policy Configuration high Shared infrastructure Export File Storage Adapter low Shared infrastructure Supabase Storage Adapter low Shared infrastructure Peer Mentor Pause Management Service medium Shared infrastructure Push Notification Service medium Shared infrastructure fl_chart Adapter medium Shared infrastructure Push Notification Service low Shared infrastructure FCM Push Notification Sender medium Shared infrastructure FCM Notification Dispatcher medium Shared infrastructure Push Notification Dispatcher medium Shared infrastructure Supabase Realtime Subscription Service medium Shared infrastructure Organisation Data Isolation Guard low Shared infrastructure Push Notification Dispatcher medium Shared infrastructure Deep Link Handler medium Shared infrastructure QR Code Generator low Shared infrastructure Share Sheet Bridge low Shared infrastructure Semantics Service Facade medium Shared infrastructure Accessibility Design Token Enforcer medium Shared infrastructure Accessible Theme Builder medium Shared infrastructure Navigation Route Configuration medium Shared infrastructure Accessibility Live Region Announcer low Shared infrastructure Feature Flag Provider low Shared infrastructure Secure Storage Adapter low Shared infrastructure Supabase RLS Tenant Scope Configurator medium Shared infrastructure Label Key Registry low Shared infrastructure Terminology Riverpod Providers low Shared infrastructure WCAG Semantics Label Resolver low Shared infrastructure Feature Flag Key Constants low Shared infrastructure RLS Policy Manager high Shared

User Stories (6)

View Personal Recruitment Statistics
medium 5 pts

As a As a Peer Mentor (Likeperson)

I want to see how many people I have recruited through my referral code and their onboarding status

So that I feel recognized for my recruitment contribution and can follow up with prospective members who have not yet completed their membership

Acceptance Criteria
  • Given a peer mentor opens the recruitment stats widget, when the data loads, then they see total referral links shared, total sign-ups attributed to their code, and total completed memberships
  • Given a peer mentor views their recruitment stats, when they look at the status of each referral, then they can see whether each referred person has clicked the link, registered, or completed full membership
  • Given a peer mentor has zero recruits, when they view the stats screen, then a motivational empty state is shown with a prompt to share their referral code
  • +2 more
View Full Story →
Earn Badges for Recruitment Milestones
medium 5 pts

As a As a Peer Mentor (Likeperson)

I want to earn recognition badges when I reach recruitment milestones such as referring my first member, fifth member, or tenth member

So that I feel proud of my contribution to growing the organization and am motivated to continue recruiting

Acceptance Criteria
  • Given a peer mentor's referral results in a completed membership, when the attribution is confirmed in the system, then the peer mentor's badge progress is automatically updated
  • Given a peer mentor earns a recruitment badge, when they next open the app, then a celebratory badge-earned overlay appears with the badge name, description, and share option
  • Given a peer mentor has earned recruitment badges, when they view their badge shelf, then recruitment badges are displayed alongside activity badges with a distinct visual identifier
  • +2 more
View Full Story →
Calculate and Share Membership Benefits
medium 5 pts

As a As a Peer Mentor (Likeperson)

I want to use a benefit calculator to show prospective members the concrete value they would receive from joining the organization

So that I can make a compelling, personalized case for membership based on the prospective member's specific situation rather than relying on abstract arguments

Acceptance Criteria
  • Given a peer mentor opens the benefit calculator, when they input parameters such as estimated monthly activities and distance traveled, then the app displays a calculated annual benefit value in Norwegian kroner
  • Given benefit calculation results are shown, when the peer mentor taps the share button, then a visual summary card is generated and the native share sheet opens
  • Given the device is offline, when a peer mentor uses the benefit calculator, then the calculation still works using locally cached rate configurations
  • +2 more
View Full Story →
Guide New Member Through Onboarding After Referral
low 8 pts

As a As a Peer Mentor (Likeperson)

I want to be notified when someone I referred completes the app download and registration process

So that I can personally welcome them and offer immediate support during their first week as a member, reducing drop-off during the critical onboarding period

Acceptance Criteria
  • Given a new member completes registration using a peer mentor's referral code, when the registration is confirmed, then the referring peer mentor receives an in-app notification stating '[First Name] joined using your referral'
  • Given the peer mentor has push notifications enabled, when a referred member completes registration, then a push notification is also delivered within 5 minutes
  • Given a peer mentor views the recruitment stats screen, when they tap on a specific recruit's entry, then they see onboarding milestone completion status (app installed, profile complete, first activity logged) without revealing private personal data
  • +2 more
View Full Story →
Generate and View Personal Referral Code
high 3 pts

As a As a Peer Mentor (Likeperson)

I want to access my unique referral code and QR code within the app

So that I can easily share it with prospective members during conversations, home visits, or group activities to recruit them to the organization

Acceptance Criteria
  • Given a peer mentor opens the referral code screen, when the screen loads, then their unique alphanumeric referral code is displayed prominently in large readable text
  • Given a peer mentor views the referral code screen, when the QR code is rendered, then it is large enough (minimum 200x200px equivalent) and high-contrast enough to be scanned with a standard phone camera from 30cm distance
  • Given a peer mentor's referral code screen is open, when the peer mentor taps the copy button, then the referral code is copied to clipboard and a confirmation toast is shown
  • +2 more
View Full Story →
Share Referral Code via Native Share Sheet
high 5 pts

As a As a Peer Mentor (Likeperson)

I want to share my referral code through SMS, email, WhatsApp, or any app on my phone using the native share sheet

So that I can reach prospective members through whatever communication channel they prefer without having to manually copy and paste the code

Acceptance Criteria
  • Given a peer mentor taps the share button on the referral code screen, when the native share sheet appears, then it contains a pre-composed message in Norwegian that includes the referral code and an app download deep link
  • Given the pre-composed message is displayed in the share sheet, when the peer mentor selects a messaging app (SMS, WhatsApp, email), then the message is pre-filled in that app ready to send
  • Given a prospective member taps the deep link from a shared message, when they open the app store or app, then the referral code is automatically attributed to the correct peer mentor without manual entry
  • +2 more
View Full Story →