Service Layer medium complexity backend
0
Dependencies
0
Dependents
0
Entities
0
Integrations

Description

Backend service that issues, validates, and resolves invite tokens, attributing each redemption to the originating inviter and organization. Enforces module-toggle gating per tenant and produces QR-ready payloads for the client.

Feature: Invite Link & QR Sharing

invite-service

Sources & reasoning

Listed verbatim in the canonical area taxonomy under referral-program, and motivated by HLF's stated need for app-as-marketed-membership-benefit recruitment functionality. Matrix row 114 places it in Phase 3, which maps to the Growth & Engagement phase name used in §5.

Responsibilities

  • Generate unique invite tokens scoped to inviter and organization
  • Resolve incoming invite tokens during sign-up to attach the new volunteer
  • Record attribution events linking recruit to inviter
  • Enforce per-organization module toggle for invite functionality
  • Expire and rotate invite tokens per policy

Interfaces

createInvite(userId, orgId): Invite
resolveInvite(token): InviteContext
listInvitesByUser(userId): Invite[]
revokeInvite(inviteId): void