Recruitment Contribution Counts Towards Achievement Badges
Each time a referred sign-up is confirmed as a successful new member, the Recruitment Service increments the peer mentor's recruitment count in the member_recruitments table. This count is read by the Achievement Service, which checks milestone thresholds (e.g. first referral, 5 referrals, 10 referrals) and awards the corresponding achievement badge. The integration is one-way from the Recruitment Service to the Achievement Service — the peer mentor does not need to take any additional action to claim the badge.
User Story
Acceptance Criteria
- Given a referred user completes registration and is confirmed as a new member, when the Recruitment Service processes the confirmation, then the peer mentor's recruitment_count in member_recruitments is incremented by 1
- Given the recruitment count reaches a milestone threshold (e.g. 1, 5, 10 successful referrals), when the Achievement Service checks for new badges, then the appropriate recruitment badge is awarded to the peer mentor
- Given a badge is awarded for recruitment, when the peer mentor opens the Achievements screen, then the badge is visible with a label indicating it was earned through member recruitment
- Given the attribution window expires before a referred person registers, when the count is evaluated, then only confirmed registrations within the window increment the count — expired pending referrals are excluded
Business Value
Connecting recruitment activity to the gamification system extends the motivational value of both features. Peer mentors who already engage with achievement badges have an additional concrete path to earning recognition. For HLF, this creates a virtuous cycle: engaged members recruit new members who in turn become engaged — directly addressing the organisation's growth strategy at minimal additional implementation cost given the achievement system already exists.
Components
- Recruitment Service service
- Recruitment Repository data