Dashboards
AdvancedReportService produces reports for:
- Student — mastery, misconceptions, episodic insights, quiz performance, study time, risk, gamification and conduct, grouped by course.
- Course — common misconceptions, weak concepts, RAG coverage, quiz analytics.
- Tutor efficacy — how effective the AI tutor is over time, with a history endpoint.
- Overview — tenant-wide KPIs.
RiskAssessmentService (6 weighted factors)
| Factor | Weight |
|---|---|
| Inactivity | 25% |
| Performance trend | 20% |
| Concept mastery | 20% |
| Quiz failure | 15% |
| Engagement | 10% |
| Misconceptions (active vs resolving) | 10% |
Score 0–100 → levels low (<25), medium (25–49), high (50–74), critical (≥75). The score is cached on the Enrollment (riskScore/riskLevel/riskUpdatedAt) and refreshed by a cron; it powers the teacher dashboard, alerts and reports.
Alerts
The alert engine fires on low activity and at-risk goals (e.g., goal_at_risk), routed to teachers via the class group, and to guardians via the parent portal.
Parent portal
Verified guardians get a monitoring dashboard: clickable report cards open a detail page with an LLM narrative + metrics + topics + gamification, plus B2B per-course progress. Everything respects ProgressSharingConfig, and safety/well-being signals from the AI supervisor appear only to roles allowed to see them, with a supportive tone.