RecruitmentTrackingService
Component Detail
Description
Backend service responsible for tracking and aggregating referral activity data linked to invite links. It records click events, maps completed registrations back to the originating mentor, and computes conversion metrics. It also exposes coordinator-level aggregation queries across the peer mentors within their oversight scope.
recruitment-tracking-service
Sources & reasoning
The priority matrix (line 164) groups invite-link and rekruttering as a single Phase 3 entry, implying tracking is the natural complement to link sharing. Phase 3 normalizes to v1.1. The blueprint area taxonomy lists Recruitment Tracking as the second canonical feature under referral-program. Without tracking, the referral program has no feedback loop, making it operationally incomplete.
-
docs/source/likeperson.md · line 164Verving / Referral (invite-link, rekruttering) | - | - | - | ✓ | ✓ | SHOULD (HLF) | 3
-
docs/source/likeperson.md · line 117Vervefunksjonalitet for medlemsverving (appen som markedsført medlemsfordel).
-
docs/source/likeperson.md · line 361Verving / Referral (HLF)
Responsibilities
- Record and deduplicate invite link click events keyed to mentor and campaign
- Map completed member registrations to the originating referral link and mentor
- Compute per-mentor conversion rates and referral funnel metrics
- Aggregate mentor referral performance across coordinator oversight scope
- Enforce role-based data scoping so mentors see only their own data
Interfaces
trackInviteClick(inviteLinkId: string, visitorMeta: VisitorMeta): void
recordRegistrationConversion(inviteLinkId: string, newUserId: string): ConversionRecord
getMentorReferralStats(mentorId: string): MentorReferralStats
getCoordinatorAggregate(coordinatorId: string): MentorPerformanceSummary[]
getRecruitProfiles(mentorId: string): RecruitProfile[]
Related Data Entities (2)
Data entities managed by this component