Recruitment Tracking

Without attribution feedback, peer mentor recruiting effort is invisible, which breaks the motivation loop that makes referral programs effective. Showing each peer mentor their personal recruitment count creates a tangible signal that their outreach matters. HLF positioned the referral capability as a strategic member-growth tool, and tracking outcomes is what converts a one-off sharing action into an ongoing behavior. Coordinators benefit from team-level recruitment KPIs that inform recognition decisions and flag which peer mentors may need encouragement. Aggregated organizational data also informs which channels and events drive the most registrations, enabling smarter resource allocation over time.

The backend exposes a recruitment stats endpoint that aggregates referral_events rows by referring user, returning total recruited count and a paginated list of recent recruits with registration timestamps. The Flutter widget uses a Riverpod AsyncNotifierProvider to fetch and cache stats, displayed as a stat card on the coordinator home screen and as a personal counter on the peer mentor home. Coordinator team view queries across all peer mentors in the organization, requiring organization-scoped authorization. The feature is purely read-only on the client - all writes happen via the registration flow in invite-link-qr-sharing. Pagination with cursor-based navigation handles organizations with many recruits.