Track Status of Referred Sign-Ups
The recruitment screen displays a list of referral events recorded in the member_recruitments table. For each referral, the peer mentor can see whether the person has clicked the link (pending), completed registration (registered), or become a fully active member as synced from the member system (active). Each entry shows the date of first click and the current status. The Recruitment Repository queries this data in real time via Supabase. The peer mentor does not see the referred person's personal details — only their anonymised status — to preserve privacy.
User Story
Acceptance Criteria
- Given the peer mentor has referral events recorded, when they view the recruitment screen, then each referral appears as a list item with a status indicator (pending, registered, active)
- Given a referral is in 'pending' state and the attribution window has not expired, when the referred person completes registration, then the status updates to 'registered' on the peer mentor's screen
- Given a referral event is older than the configured attribution window (default 30 days) and the person has not registered, when the screen loads, then the referral is shown as expired or removed from the active list
- Given a referral list entry is displayed, when tapped, then no personally identifiable information about the referred person is shown — only status and date
- Given the referral count updates (new sign-up attributed), when the peer mentor's recruitment count crosses a threshold tied to achievement badges, then the achievement system is notified
Business Value
Status tracking transforms the referral link from a one-way broadcast into an actionable recruitment tool. Peer mentors who can see their pipeline are more likely to follow up personally and remain engaged. For HLF, this data also provides attribution analytics — identifying which peer mentors are most active in community building — which directly informs recognition strategies and the achievement badges system.
Components
- Recruitment Screen ui
- Recruitment Service service
- Recruitment Repository data