Referral Tracking Service
Component Detail
Service Layer
medium complexity
backend
1
Dependencies
1
Dependents
5
Entities
0
Integrations
Description
Backend service that aggregates referral conversion data, computes recruitment metrics, and manages the referral lifecycle from link generation through account activation. Enforces tenant isolation so coordinators only see their own organization's data.
referral-tracking-service
Responsibilities
- Aggregate conversion counts grouped by referring user and time period
- Track referral lifecycle events (link clicked, app installed, account created, first login)
- Compute top-recruiter rankings within an organization
- Enforce organization-scoped tenant isolation on all queries
Interfaces
getConversionMetrics(organizationId, timePeriod)
getTopRecruiters(organizationId, limit)
getReferralFunnel(organizationId)
trackConversionEvent(referralLinkId, eventType, timestamp)
getReferralStatus(referralTrackingId)
listReferralsByUser(userId, organizationId)
getRecruitmentSummary(organizationId, startDate, endDate)
Relationships
Related Data Entities (5)
Data entities managed by this component