# 1. Commission Structure

User Type: **Super Administrator**
Source: *Mi Digital Academy - Education CRM Features Document*

---

## 1. Commission Structure

### 1.1 Configure Commission Rates
**What it does:** Configures the commission rates: the rate at which the affiliate earns the commission (the percentage of the referred purchase, or the fixed amount) is set, so the affiliate earnings are explicit (the rate is the basis of the commission). The Super Administrator defines the commission rates (the rate type, the rate value, the scope) so the commission structure is structured and the rates are explicit.

**Sub-features:**
- Rate type: the type (the percentage, the fixed amount)
- Rate value: the value (the percentage, e.g., 20%, or the fixed amount, e.g., 200)
- Rate scope: the scope (the rate applies to the items, the plans, the courses)
- Rate definition: the rate defined by the Super Admin (the type, the value, the scope)
- Rate application: the rate applied (the commission is calculated per the rate)
- Rate record: the rate recorded (the rate type, the rate value, the scope)
- Audit logging of the rate definition and the changes

**Super Administrator User Journey:**
1. Super Admin defines the commission rate: the rate type (the percentage, the fixed amount), the rate value (the percentage, e.g., 20%, or the fixed amount, e.g., 200), and the scope (the items, the plans, the courses); the rate is explicit.
2. Sets the rate type: the type (the percentage, the fixed amount); the type is the basis.
3. Sets the rate value: the value (the percentage, e.g., 20%, or the fixed amount, e.g., 200); the value is the amount.
4. Sets the rate scope: the scope (the rate applies to the items, the plans, the courses); the scope is the application.
5. Saves; the commission rate is live, and the commission is calculated per the rate.
6. A referred purchase is made; the commission is calculated (the rate is applied to the purchase, the commission is the rate's value); the commission is recorded.
7. For a rate change (the type, the value, the scope updated), Super Admin changes the rate (the new type, the new value, the new scope, the time); the change is recorded.
8. The rate definition and the changes are audit-logged with the rate type, the value, and the timestamp.

**Rules & Edge Cases:**
- The rate type is the percentage or the fixed amount; the type is the basis.
- The rate value is the amount (the percentage, e.g., 20%, or the fixed amount, e.g., 200); the value is the measure.
- The rate scope is the application (the items, the plans, the courses); the scope is the control.
- A rate change (the type, the value, the scope updated) is recorded (the new type, the new value, the new scope, the time); it is auditable.
- The commission rates are visible (the types, the values, the scopes); the commission structure is managed.
- Rate definition and changes are audit-logged with the rate type, value, and timestamp.

### 1.2 Multi-Tier Commission Structure (Tier 1 Direct Referrals, Tier 2 Sub-Affiliates)
**What it does:** Configures the multi-tier commission structure: the commissions are structured in tiers (the Tier 1 for the direct referrals, the Tier 2 for the sub-affiliates), so the affiliate earnings are tiered (the affiliate earns the Tier 1 commission for the direct referrals and the Tier 2 commission for the sub-affiliates). The Super Administrator defines the tier structure (the tiers, the rates per tier, the scope) so the multi-tier structure is structured and the tiers are explicit.

**Sub-features:**
- Tier definition: the tier (the Tier 1, the Tier 2)
- Tier rate: the rate (the rate per tier, e.g., Tier 1 20%, Tier 2 10%)
- Tier scope: the scope (the tier applies to the referrals, the sub-affiliates)
- Structure definition: the structure defined by the Super Admin (the tiers, the rates, the scope)
- Commission application: the commission applied (the Tier 1 for the direct, the Tier 2 for the sub)
- Commission record: the commission recorded (the affiliate, the tier, the rate, the commission)
- Audit logging of the structure definition and the applications

**Super Administrator User Journey:**
1. Super Admin defines the tier structure: the tiers (the Tier 1, the Tier 2), the rates per tier (e.g., Tier 1 20%, Tier 2 10%), and the scope (the referrals, the sub-affiliates); the structure is explicit.
2. Sets the Tier 1: the tier (the Tier 1, the direct referrals) and the rate (e.g., 20%); the tier is the direct.
3. Sets the Tier 2: the tier (the Tier 2, the sub-affiliates) and the rate (e.g., 10%); the tier is the sub.
4. Sets the tier scope: the scope (the tier applies to the referrals, the sub-affiliates); the scope is the application.
5. Saves; the tier structure is live, and the commission is tiered (the Tier 1 for the direct, the Tier 2 for the sub).
6. A referred purchase is made; the commission is calculated (the Tier 1 for the direct referral, the Tier 2 for the sub-affiliate); the commission is recorded.
7. For a structure change (the tiers, the rates, the scope updated), Super Admin changes the structure (the new tiers, the new rates, the new scope, the time); the change is recorded.
8. The structure definition and the applications are audit-logged with the affiliate, the tier, and the timestamp.

**Rules & Edge Cases:**
- The tier is explicit (the Tier 1, the Tier 2); the tier is the structure.
- The tier rate is the measure (the rate per tier, e.g., Tier 1 20%, Tier 2 10%); the rate is the basis.
- The tier scope is the application (the referrals, the sub-affiliates); the scope is the control.
- A structure change (the tiers, the rates, the scope updated) is recorded (the new tiers, the new rates, the new scope, the time); it is auditable.
- The tier structure is visible (the tiers, the rates, the scopes); the multi-tier structure is managed.
- Structure definition and applications are audit-logged with the affiliate, tier, and timestamp.

### 1.3 Recruitment Rewards and Leadership Bonuses
**What it does:** Configures the recruitment rewards and leadership bonuses: the rewards for the affiliates who recruit other affiliates (the recruitment reward, the leadership bonus) are set, so the affiliate recruitment is incentivized (the recruiter earns the reward for the recruit). The Super Administrator defines the recruitment rewards (the reward, the condition, the scope) so the recruitment incentives are structured and the rewards are explicit.

**Sub-features:**
- Recruitment reward: the reward (the reward for the recruit, e.g., a fixed amount, a percentage)
- Reward condition: the condition (the condition for the reward, e.g., the recruit makes a purchase)
- Leadership bonus: the bonus (the bonus for the leader, e.g., a percentage of the team's commissions)
- Reward definition: the reward defined by the Super Admin (the reward, the condition, the scope)
- Reward application: the reward applied (the recruiter earns the reward for the recruit)
- Reward record: the reward recorded (the recruiter, the recruit, the reward, the condition)
- Audit logging of the reward definition and the applications

**Super Administrator User Journey:**
1. Super Admin defines the recruitment reward: the reward (the reward for the recruit, e.g., a fixed amount, a percentage), the condition (the condition for the reward, e.g., the recruit makes a purchase), and the scope (the scope of the reward); the reward is explicit.
2. Sets the recruitment reward: the reward (the reward for the recruit); the reward is the incentive.
3. Sets the reward condition: the condition (the condition for the reward, e.g., the recruit makes a purchase); the condition is the trigger.
4. Sets the leadership bonus: the bonus (the bonus for the leader, e.g., a percentage of the team's commissions); the bonus is the leadership incentive.
5. Saves; the recruitment rewards are live, and the recruiter earns the reward for the recruit.
6. An affiliate recruits another affiliate; the reward is applied (the recruit makes a purchase, the recruiter earns the reward); the reward is recorded.
7. For a reward change (the reward, the condition, the scope updated), Super Admin changes the reward (the new reward, the new condition, the new scope, the time); the change is recorded.
8. The reward definition and the applications are audit-logged with the recruiter, the recruit, and the timestamp.

**Rules & Edge Cases:**
- The recruitment reward is the incentive (the reward for the recruit, e.g., a fixed amount, a percentage); the reward is the value.
- The reward condition is the trigger (the condition for the reward, e.g., the recruit makes a purchase); the condition is the gate.
- The leadership bonus is the leadership incentive (the bonus for the leader, e.g., a percentage of the team's commissions); the bonus is the value.
- A reward change (the reward, the condition, the scope updated) is recorded (the new reward, the new condition, the new scope, the time); it is auditable.
- The recruitment rewards are visible (the rewards, the conditions, the scopes); the recruitment incentives are managed.
- Reward definition and applications are audit-logged with the recruiter, recruit, and timestamp.