# 5. Commission Tracking

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

---

## 5. Commission Tracking

### 5.1 Track Pending, Earned, and Paid Commissions
**What it does:** Tracks the commissions: the commissions of the affiliates (the pending, the earned, the paid) are tracked, so the affiliate earnings are visible (the commissions are recorded per status). The Super Administrator views the commission tracking (the affiliate, the pending, the earned, the paid) so the tracking is structured and the commissions are explicit.

**Sub-features:**
- Commission status: the status (the pending, the earned, the paid)
- Pending commission: the pending (the commission that is not yet earned, e.g., the referral is not confirmed)
- Earned commission: the earned (the commission that is earned, e.g., the referral is confirmed)
- Paid commission: the paid (the commission that is paid, e.g., the payout is made)
- Commission record: the record (the affiliate, the commission, the status, the date)
- Commission view: the view (the commissions per affiliate, per status)
- Audit logging of the commission tracking

**Super Administrator User Journey:**
1. Super Admin views the commission tracking: the affiliates (the name, the commissions), the statuses (the pending, the earned, the paid), and the dates (the date of the commission); the tracking is explicit.
2. Views the pending commissions: the pending (the commission that is not yet earned, e.g., the referral is not confirmed); the pending is the in-progress.
3. Views the earned commissions: the earned (the commission that is earned, e.g., the referral is confirmed); the earned is the confirmed.
4. Views the paid commissions: the paid (the commission that is paid, e.g., the payout is made); the paid is the settled.
5. The commissions are visible: the commissions per affiliate, per status, so the tracking is complete.
6. For an affiliate (a specific affiliate), Super Admin views the affiliate's commissions (the pending, the earned, the paid, the period); the commissions are the detail.
7. Exports the commissions (the commission report, the period); the export is the record.
8. The commission tracking is audit-logged with the affiliate, the commission, and the timestamp.

**Rules & Edge Cases:**
- The commission status is the pending, the earned, or the paid; the status is the control.
- The pending commission is the in-progress (the commission that is not yet earned, e.g., the referral is not confirmed); the pending is the state.
- The earned commission is the confirmed (the commission that is earned, e.g., the referral is confirmed); the earned is the state.
- The paid commission is the settled (the commission that is paid, e.g., the payout is made); the paid is the state.
- The commissions are visible (the commissions per affiliate, per status); the tracking is managed.
- Commission tracking is audit-logged with the affiliate, commission, and timestamp.

### 5.2 Track Subscription Renewals from Referrals
**What it does:** Tracks the subscription renewals from the referrals: the renewals of the referred subscriptions (the renewal, the affiliate, the commission) are tracked, so the renewal commissions are visible (the renewals are recorded). The Super Administrator views the renewal tracking (the affiliate, the referral, the renewal, the commission) so the tracking is structured and the renewals are explicit.

**Sub-features:**
- Renewal tracking: the tracking (the affiliate, the referral, the renewal, the commission)
- Renewal scope: the scope (the referral, the renewal)
- Renewal commission: the commission (the commission for the renewal, e.g., a percentage of the renewal)
- Renewal record: the record (the affiliate, the referral, the renewal, the commission, the date)
- Renewal view: the view (the renewals per affiliate, per period)
- Renewal trend: the trend (the renewal trend, the period)
- Audit logging of the renewal tracking

**Super Administrator User Journey:**
1. Super Admin views the renewal tracking: the affiliates (the name, the referrals), the renewals (the renewal of the referred subscriptions), and the commissions (the commission for the renewal); the tracking is explicit.
2. Sets the renewal scope: the scope (the referral, the renewal); the scope is the tracking.
3. Views the renewal commission: the commission (the commission for the renewal, e.g., a percentage of the renewal); the commission is the value.
4. Views the renewal record: the record (the affiliate, the referral, the renewal, the commission, the date); the record is the proof.
5. The renewals are visible: the renewals per affiliate, per period, so the tracking is complete.
6. For an affiliate (a specific affiliate), Super Admin views the affiliate's renewals (the referrals, the renewals, the commissions, the period); the renewals are the detail.
7. Exports the renewals (the renewal report, the period); the export is the record.
8. The renewal tracking is audit-logged with the affiliate, the referral, and the timestamp.

**Rules & Edge Cases:**
- The renewal tracking is explicit (the affiliate, the referral, the renewal, the commission); the tracking is the visibility.
- The renewal scope is the referral and the renewal; the scope is the control.
- The renewal commission is the value (the commission for the renewal, e.g., a percentage of the renewal); the commission is the measure.
- The renewal record is the proof (the affiliate, the referral, the renewal, the commission, the date); the record is the audit.
- The renewals are visible (the renewals per affiliate, per period); the tracking is managed.
- Renewal tracking is audit-logged with the affiliate, referral, and timestamp.

### 5.3 Commission Calculator Configuration
**What it does:** Configures the commission calculator: the calculator for the commissions (the inputs, the calculation, the output) is set, so the commissions are calculated (the calculator is the tool). The Super Administrator defines the calculator configuration (the inputs, the calculation rules, the output) so the calculator is structured and the calculation is explicit.

**Sub-features:**
- Calculator input: the input (the input for the calculator, e.g., the purchase amount, the rate)
- Calculation rule: the rule (the rule for the calculation, e.g., the percentage, the fixed amount)
- Calculator output: the output (the output of the calculator, e.g., the commission)
- Calculator definition: the calculator defined by the Super Admin (the inputs, the rules, the output)
- Calculator use: the use (the calculator is used to calculate the commission)
- Calculator record: the record (the input, the rule, the output, the date)
- Audit logging of the calculator definition and the uses

**Super Administrator User Journey:**
1. Super Admin defines the calculator configuration: the inputs (the input for the calculator, e.g., the purchase amount, the rate), the calculation rules (the rule for the calculation, e.g., the percentage, the fixed amount), and the output (the output of the calculator, e.g., the commission); the calculator is explicit.
2. Sets the calculator input: the input (the input for the calculator, e.g., the purchase amount, the rate); the input is the basis.
3. Sets the calculation rule: the rule (the rule for the calculation, e.g., the percentage, the fixed amount); the rule is the method.
4. Sets the calculator output: the output (the output of the calculator, e.g., the commission); the output is the result.
5. Saves; the calculator is live, and the commissions are calculated (the calculator is the tool).
6. A commission is calculated; the calculator is used (the input is provided, the rule is applied, the output is the commission); the calculation is recorded.
7. For a calculator change (the inputs, the rules, the output updated), Super Admin changes the calculator (the new inputs, the new rules, the new output, the time); the change is recorded.
8. The calculator definition and the uses are audit-logged with the input, the rule, and the timestamp.

**Rules & Edge Cases:**
- The calculator input is the basis (the input for the calculator, e.g., the purchase amount, the rate); the input is the data.
- The calculation rule is the method (the rule for the calculation, e.g., the percentage, the fixed amount); the rule is the logic.
- The calculator output is the result (the output of the calculator, e.g., the commission); the output is the value.
- A calculator change (the inputs, the rules, the output updated) is recorded (the new inputs, the new rules, the new output, the time); it is auditable.
- The calculator is visible (the inputs, the rules, the outputs); the calculation is managed.
- Calculator definition and uses are audit-logged with the input, rule, and timestamp.