# 3. Family Engagement Analytics

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

---

## 3. Family Engagement Analytics

### 3.1 Collaboration Activity
**What it does:** The Super Admin reviews the collaboration activity so the parent-student engagement is measured.

**Sub-features:**
- Activity count: the count of collaboration activities
- Activity types: the types of collaboration activities
- Activity frequency: the frequency of the activities
- Per-family breakdown: the activity per family
- Activity trend: the activity over time
- Available on web
- Event logging (action performed)
- Audit logging of collaboration activity

**Super Admin User Journey:**
1. As a Super Admin, open the collaboration activity analytics.
2. Review the activity count and types.
3. Check the frequency and per-family breakdown.
4. Export the report.

**Rules & Edge Cases:**
- An activity count is the number of collaboration activities.
- An activity type is a goal update, celebration, or challenge.
- An activity frequency is the activities per period.
- A per-family breakdown separates the activity by family.
- An activity trend shows the change over time.
- A report is exportable in CSV.
- Report generation is audit-logged with the actor and timestamp.

### 3.2 Goal Completion Rate
**What it does:** The Super Admin reviews the goal completion rate so the effectiveness of the shared goals is measured.

**Sub-features:**
- Completion count: the count of completed goals
- Completion rate: the rate of goal completion
- Per-family breakdown: the completion per family
- Completion by goal type: the completion per goal type
- Completion trend: the completion over time
- Available on web
- Event logging (action performed)
- Audit logging of goal completion rate

**Super Admin User Journey:**
1. As a Super Admin, open the goal completion rate analytics.
2. Review the completion count and rate.
3. Check the per-family breakdown and by goal type.
4. Export the report.

**Rules & Edge Cases:**
- A completion count is the number of completed goals.
- A completion rate is the completions over the total goals.
- A per-family breakdown separates the completion by family.
- A completion by goal type separates the completion per type.
- A completion trend shows the change over time.
- A report is exportable in CSV.
- Report generation is audit-logged with the actor and timestamp.

### 3.3 Reward Redemption
**What it does:** The Super Admin reviews the reward redemption so the reward system's usage is measured.

**Sub-features:**
- Redemption count: the count of redeemed rewards
- Redemption rate: the rate of reward redemption
- Per-reward breakdown: the redemption per reward
- Token usage: the usage of the digital tokens
- Redemption trend: the redemption over time
- Available on web
- Event logging (action performed)
- Audit logging of reward redemption

**Super Admin User Journey:**
1. As a Super Admin, open the reward redemption analytics.
2. Review the redemption count and rate.
3. Check the per-reward breakdown and token usage.
4. Export the report.

**Rules & Edge Cases:**
- A redemption count is the number of redeemed rewards.
- A redemption rate is the redemptions over the earned rewards.
- A per-reward breakdown separates the redemption per reward.
- A token usage is the tokens spent on rewards.
- A redemption trend shows the change over time.
- A report is exportable in CSV.
- Report generation is audit-logged with the actor and timestamp.

### 3.4 Family Engagement Score
**What it does:** The Super Admin reviews the family engagement score so the overall family engagement is measured.

**Sub-features:**
- Score computation: the computation of the engagement score
- Score components: the components of the score
- Score ranking: the ranking of the families by score
- Per-institute breakdown: the score per institute
- Score trend: the score over time
- Available on web
- Event logging (action performed)
- Audit logging of family engagement score

**Super Admin User Journey:**
1. As a Super Admin, open the family engagement score analytics.
2. Review the score computation and components.
3. Check the score ranking and per-institute breakdown.
4. Export the report.

**Rules & Edge Cases:**
- A score computation aggregates the engagement metrics.
- A score component is a metric in the score (activity, completion, redemption).
- A score ranking orders the families by score.
- A per-institute breakdown separates the score by institute.
- A score trend shows the change over time.
- A report is exportable in CSV.
- Report generation is audit-logged with the actor and timestamp.