# 2. Reward System Management

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

---

## 2. Reward System Management

### 2.1 Reward Catalog
**What it does:** The Super Admin manages the catalog of rewards so parents can set real-world rewards for their children's achievements.

**Sub-features:**
- Reward creation: the creation of a reward
- Reward categories: the categories of rewards
- Reward value: the value or points of the reward
- Reward enablement: the reward toggled active or inactive
- Reward catalog: the catalog of all rewards
- Available on web
- Event logging (action performed)
- Audit logging of reward catalog

**Super Admin User Journey:**
1. As a Super Admin, open the reward catalog.
2. Create a reward with a category and value.
3. Activate the reward.
4. Verify it appears in the catalog.

**Rules & Edge Cases:**
- A reward creation requires a name and a value.
- A reward category groups the rewards by type.
- A reward value is the points or cost of the reward.
- A reward enablement controls whether it can be redeemed.
- A reward catalog lists all rewards.
- A reward with no value cannot be redeemed.
- Reward actions are audit-logged with the actor and timestamp.

### 2.2 Real-World Reward Configuration
**What it does:** The Super Admin configures the real-world rewards so parents can define the tangible rewards for achievements.

**Sub-features:**
- Reward definition: the definition of a real-world reward
- Reward conditions: the conditions to earn the reward
- Reward redemption: the redemption of the reward
- Reward tracking: the tracking of the reward status
- Reward history: the history of the rewards
- Available on web
- Event logging (action performed)
- Audit logging of real-world reward configuration

**Super Admin User Journey:**
1. As a Super Admin, open the real-world reward configuration.
2. Define a real-world reward with conditions.
3. Set the redemption process.
4. Track the reward status and history.

**Rules & Edge Cases:**
- A reward definition names the real-world reward.
- A reward condition is the achievement needed to earn it.
- A reward redemption is the claim of the reward.
- A reward tracking records the status (earned, redeemed).
- A reward history stores the past rewards.
- A reward without a met condition cannot be redeemed.
- Configuration changes are audit-logged with the actor and timestamp.

### 2.3 Digital Reward Tokens
**What it does:** The Super Admin manages the digital reward tokens so learners can earn and spend tokens on rewards.

**Sub-features:**
- Token issuance: the issuance of tokens to a learner
- Token earning rules: the rules for earning tokens
- Token balance: the balance of tokens per learner
- Token spending: the spending of tokens on rewards
- Token ledger: the ledger of token transactions
- Available on web
- Event logging (action performed)
- Audit logging of digital reward tokens

**Super Admin User Journey:**
1. As a Super Admin, open the digital reward tokens.
2. Set the token earning rules.
3. Issue tokens to a learner.
4. Review the token balance and ledger.

**Rules & Edge Cases:**
- A token issuance adds tokens to a learner's balance.
- A token earning rule defines how tokens are earned.
- A token balance is the current tokens per learner.
- A token spending deducts tokens for a reward.
- A token ledger records all token transactions.
- A token spending exceeding the balance is blocked.
- Token actions are audit-logged with the actor and timestamp.

### 2.4 Privilege Unlocks
**What it does:** The Super Admin manages the privilege unlocks so learners can unlock privileges with their achievements.

**Sub-features:**
- Privilege definition: the definition of a privilege
- Unlock threshold: the threshold to unlock a privilege
- Privilege assignment: the assignment of the privilege to a learner
- Privilege status: the status of the privilege (locked, unlocked)
- Privilege log: the log of the privilege unlocks
- Available on web
- Event logging (action performed)
- Audit logging of privilege unlocks

**Super Admin User Journey:**
1. As a Super Admin, open the privilege unlocks.
2. Define a privilege with an unlock threshold.
3. Assign the privilege to a learner.
4. Review the privilege status and log.

**Rules & Edge Cases:**
- A privilege definition names the privilege (screen time, outing).
- An unlock threshold is the points or tokens needed.
- A privilege assignment links the privilege to a learner.
- A privilege status reflects the state (locked, unlocked).
- A privilege log records the past unlocks.
- A privilege below the threshold remains locked.
- Privilege actions are audit-logged with the actor and timestamp.

### 2.5 Achievement Showcase
**What it does:** The Super Admin enables the achievement showcase so the family can see the learner's achievements.

**Sub-features:**
- Showcase creation: the creation of a family achievement showcase
- Achievement display: the display of the achievements
- Showcase sharing: the sharing of the showcase with the family
- Showcase customization: the customization of the showcase
- Showcase history: the history of the showcase
- Available on web
- Event logging (action performed)
- Audit logging of achievement showcase

**Super Admin User Journey:**
1. As a Super Admin, open the achievement showcase.
2. Create a family achievement showcase.
3. Display the achievements and customize the showcase.
4. Share the showcase with the family.

**Rules & Edge Cases:**
- A showcase creation links the showcase to a family.
- An achievement display lists the learner's achievements.
- A showcase sharing makes the showcase visible to the family.
- A showcase customization allows the family to personalize it.
- A showcase history stores the past showcases.
- A showcase with no achievements shows an empty state.
- Showcase actions are audit-logged with the actor and timestamp.