Skip to content

👩‍🏫 Teacher journey

Main scenario: analyze your lesson, target struggling students, act and follow up.

1. Login & navigation

  1. /login → [email protected] / demo1234 → redirected to /dashboard.
  2. Topbar: Post-Lesson (default), History, Stats, Messages, Follow-Up.

2. Select a lesson

  1. Class selector (class “March 2026”).
  2. Course button (remembers the class) → PlanningModal (month/day view).
  3. Click a day → detail → Open this lesson →.
  4. The dashboard loads: class metrics + timeline + students table.

Intermediate states

  • No course selected → “No lesson selected” screen + “Choose a lesson →” button.
  • Selection persisted in localStorage; the URL ?class=&session= takes priority.

3. Read the lesson

  • Metrics row (7 tiles, see metrics) — hover the “?”.
  • Engagement chart per minute (colored segments).
  • Students table sorted by score; flags ⚠/🚨, trend ▲/▼.

4. Dive into a student

  1. Click the row → student panel (right).
  2. 6 domains, Attention metrics (6 tiles), Cumulative record (5 lessons), interpretation (advisory/priority), Tomorrow's recommendation.
  3. Actions:
  4. + Save to plan → the student appears in Follow-Up.
  5. 🎯 Generate IEP → individual intervention plan (LLM, OPENROUTER_API_KEY required).
  6. ✉ Parent report → parent summary (LLM).
  7. ↓ Full report → full report (PDF via textToPdf).

5. Review the video

▶ Watch video → player; selecting a student filters the synchronized timeline; seek works (HTTP Range).

6. Follow up

  • Follow-Up tab: the list of planned students (add/remove).
  • Messages tab: talk to parents per student (or from the student panel).
  • History / Stats: class context over the last lessons / the month.

Journey diagram

flowchart TD
  A[Login teacher] --> B[Dashboard]
  B --> C{Choose a lesson}
  C -->|PlanningModal| D[Lesson loaded]
  D --> E[Metrics + timeline]
  E --> F[Click student]
  F --> G[Profile: domains + attention + cumulative]
  G -->|Save to plan| H[Follow-Up]
  G -->|IEP/report| I[LLM modal or PDF]
  G -->|Watch video| J[Player + synced timeline]

To check in tests

The teacher “own lessons” filter applies to the session list in the DB; the Post-Lesson view stays complete (lake). Know this discrepancy if you test a teacher account before the import.