Compensation Plans
Tiered pay plans with condition trees that auto-assign a tier to each statement.
A compensation plan defines how a host gets paid based on performance. Plans are tiered, and each tier carries a condition tree that decides whether a host qualifies.
Plans and tiers #
An AgencyCompensationPlan holds ordered tiers (AgencyCompensationTier).
Each tier has:
- a condition tree (the same AND/OR format as campaigns),
- a reward type — cash (BRL/USD), points, or a service,
- a reward value/label.
Plans can be agency-wide, and platform-specific plans override the agency default for that platform.
Condition trees #
Tiers match on stat fields and deltas — diamonds_earned, valid_live_days,
live_duration_minutes, diamonds_delta, and more — combined with AND/OR groups.
Example: a "Gold" tier might require diamonds_earned >= 5000 AND
valid_live_days >= 15.
Automatic tier assignment #
When a monthly statement is saved, the
CompensationCalculator evaluates the plan's tiers against that statement and
assigns the correct one automatically — no manual matching.
Proximity alerts #
When a host reaches ≥ 80% of the next tier's threshold, a tier-proximity alert can notify them (WhatsApp + portal) to push for the next level. See WhatsApp.