# 1. Learning Progress Tracking

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

---

## 1. Learning Progress Tracking

### 1.1 Course Progress Tracking
**What it does:** Tracks the Student's progress through each course: video completion, lesson completion, and overall course completion percentage. The Student sees how far they are in each course and can pick up where they left off. Progress is updated in real time as the Student studies.

**Sub-features:**
- Video completion tracking per course
- Lesson completion tracking per course
- Overall course completion percentage
- "Continue where you left off" per course
- Progress bar per course
- Progress list across all enrolled courses
- Progress updates in real time
- Progress event logging (updated)
- Audit logging of the course progress tracking

**Student User Journey:**
1. Student opens "Progress" and sees the list of enrolled courses with completion bars.
2. Mathematics is 45% complete; Physics is 80%.
3. Student taps a course and sees the per-lesson completion.
4. Student taps "Continue" and resumes the last unwatched video.
5. As Student watches, the progress updates in real time.
6. Student opens Profile → "Activity" and confirms the progress events are recorded.

**Rules & Edge Cases:**
- Video completion is recorded when a video is watched to the completion threshold.
- Course completion is the percentage of lessons completed.
- "Continue where you left off" resumes the last position.
- Progress updates in real time as the Student studies.
- Progress events (updated) are logged with the course and the timestamp.
- The course progress tracking is audit-logged with the account, the course, and the timestamp.

### 1.2 Time Spent Tracking
**What it does:** Tracks the time the Student spends studying: total time, time per course and subject, and time per day/week. The Student sees their study time trends and can compare periods. Time spent is a key input for the AI score prediction and study planner.

**Sub-features:**
- Total study time tracked
- Time per course and per subject
- Time per day and per week
- Study time trends over time
- Compare study time across periods
- Study time available on web and mobile
- Time tracking event logging (session recorded)
- Audit logging of the time spent tracking

**Student User Journey:**
1. Student opens "Progress" → "Time spent" and sees the total study time.
2. The time per subject shows Mathematics at 12 hours and Physics at 8 hours.
3. The daily and weekly time is shown with a trend.
4. Student compares this week's time with last week's.
5. Student sees the time spent on the mobile app.
6. Student opens Profile → "Activity" and confirms the time tracking events are recorded.

**Rules & Edge Cases:**
- Study time is accumulated from active study sessions.
- Time is broken down per course, subject, day, and week.
- Trends are computed over the selected period.
- Time spent is an input to the AI score prediction and study planner.
- Time tracking events (session recorded) are logged with the course and the timestamp.
- The time spent tracking is audit-logged with the account, the course, and the timestamp.

### 1.3 Activity Log
**What it does:** Provides the Student with a chronological activity log of their learning: videos watched, quizzes taken, exams attempted, flashcards studied, and other actions. The Student can filter the log by type and date to review their recent activity.

**Sub-features:**
- Chronological activity log of learning actions
- Log entries for videos, quizzes, exams, flashcards, and more
- Filter the log by action type
- Filter the log by date range
- Activity log available on web and mobile
- Log is read-only to the Student
- Activity log event logging (viewed)
- Audit logging of the activity log

**Student User Journey:**
1. Student opens "Profile" → "Activity" and sees the chronological log.
2. Entries show videos watched, quizzes taken, and exams attempted.
3. Student filters to "Quizzes" for the last week.
4. Student reviews the log to see what they studied.
5. Student views the log on the mobile app.
6. Student opens Profile → "Activity" and confirms the log events are recorded.

**Rules & Edge Cases:**
- The activity log is chronological and read-only.
- Each entry records the action, the item, and the timestamp.
- Filters operate on action type and date range.
- The log is available on web and mobile.
- Activity log events (viewed) are logged with the timestamp.
- The activity log is audit-logged with the account and the timestamp.