Learning progress¶
The Progress page aggregates activity across AI Medical Assistant modules: tutor, cases, and exam.
Access¶
| Setting | Value |
|---|---|
| URL | http://localhost:8001/progress |
| Flag | MEDICAL_ASSISTANT_ENABLED=true |
| Roles | student, resident, and other LEARNING_ROLES |
Data is personal: you only see your own progress.
What the dashboard shows¶
The summary includes:
| Field | Description |
|---|---|
total_sessions |
Total activity rows |
total_time_spent |
Sum of time_spent (seconds) when provided |
overall_avg_score |
Average of module averages that have a score |
modules |
Breakdown for tutor / cases / exam |
recent |
Last ~20 events |
Per module:
| Metric | Meaning |
|---|---|
sessions |
Number of rows |
avg_score |
Average score |
time_spent |
Total time |
last_activity |
Last activity timestamp (ISO) |
How scores accumulate¶
| Module | When recorded | Score |
|---|---|---|
tutor |
After an answer | confidence × 100 |
cases |
After a step submit | 0 or 100 (wrong/correct) |
exam |
After test submit | Percent correct (0–100) |
Interpretation
A high tutor score reflects model / heuristic confidence, not a faculty grade. Case and exam scores track answer correctness more directly.
Recent activity¶
Each recent row includes:
module— source;score,time_spent;completed_at;extra_data— e.g.session_id,case_id+step_index,test_id+correct.
Use this to reopen a weak case or tutor session.
Suggested learning loop¶
- Work a case at /cases.
- Reinforce with a test at /exam.
- Review mistakes with the tutor at /tutor.
- Check trends on
/progress.
Limits¶
- No global leaderboard across users.
- Deleting a tutor session does not remove already recorded progress.
- If the assistant is off (
MEDICAL_ASSISTANT_ENABLED=false), the dashboard is unavailable.
FAQ¶
Why is tutor time_spent 0?
The tutor does not send timing by default; cases and exams count it when the UI posts seconds.
Why does overall score look odd?
It averages module averages that already have a score — not a weighted GPA.
Can faculty see my progress?
Not via this dashboard: only your JWT / account. There is no teacher-view in the learning API.