Lesson Completion & Progress Tracking
Lesson Completion & Progress Tracking
Available since v1.0.39
The platform tracks each learner's progress through a course by recording individual lesson completions and maintaining an up-to-date progress percentage for every enrollment. This data powers the progress indicators visible in the learner sidebar and dashboard.
How It Works
1. Marking a Lesson Complete
When a learner completes a lesson, a completion event is recorded against their enrollment. Each event captures:
- The lesson that was completed
- The enrollment (learner + course) it belongs to
- A completion timestamp recording exactly when the lesson was finished
Completion events are persisted permanently, so progress history is preserved even if a learner revisits content.
2. Progress Recalculation
Every time a lesson is marked complete, the platform recalculates the learner's overall course progress percentage for that enrollment:
Progress (%) = (Completed Lessons / Total Lessons in Course) × 100
This recalculation happens automatically and is reflected immediately in the learner's record.
3. Progress Indicators
The recalculated progress percentage is surfaced in two places:
- Learner Sidebar — A per-course progress bar updates as lessons are completed, allowing learners to see how far through each course they are while navigating content.
- Dashboard — The learner dashboard displays an aggregate view of progress across all enrolled courses, updated in real time as completions are recorded.
Completion Timestamps
Each lesson completion record stores a timestamp at the moment the learner marks the lesson as done. This enables:
- Accurate audit trails of learner activity
- Future reporting on completion rates and time-to-completion
- Idempotent re-checks (a lesson already marked complete will not create duplicate records)