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

Description

This feature provides peer mentors and coordinators with visibility into their referral activity, showing how many people they have invited, how many have completed registration, and the current status of each referral. A dashboard widget surfaces key metrics inline on the home screen or within a dedicated referral section, giving users immediate feedback on their recruitment impact. Coordinators can view aggregated referral statistics across their local association, enabling them to identify top recruiters and recognize contributions. The feature ties into the gamification system to surface recruitment milestones as part of the annual summary.

User Flow

Recruitment Tracking user flow
Click to expand

Analysis

Business Value

Tracking recruitment outcomes closes the feedback loop for peer mentors who invest effort in inviting others. Without visibility into whether their invites led to sign-ups, referrers lose motivation and the program stalls. Recruitment tracking transforms referral activity into a measurable, rewarding experience - directly supporting retention of active peer mentors and encouraging continued recruitment behavior. For organizations, the data enables strategic decisions about where to focus recruitment campaigns, which regions are under-resourced, and which individuals are most effective at growing the network. This feature also supports the gamification roadmap by providing the underlying data for recruitment-based badges and wrapped summaries.

Implementation Notes

Referral tracking state is persisted in the referrals table, with status transitions (invited, registered, active) updated via REST API webhooks triggered during onboarding completion. The Flutter dashboard widget reads referral summary data from a dedicated API endpoint that aggregates counts by status. Coordinator-level views query across all referrals linked to their local association, requiring RBAC enforcement at the API layer to prevent cross-organization data leakage. Pagination and filtering should be supported for coordinators with large networks. The referral data model must support nullifying referrer identity for GDPR compliance if a referred user requests deletion. Push notifications can optionally alert the referrer when an invite is accepted.

Components (38)

User Interface (2)

Service Layer (2)

Data Layer (1)

Infrastructure (1)

Shared Components

These components are reused across multiple features

User Stories

No user stories have been generated for this feature yet.