Students Module Deep Guide

This document is the detailed operational guide for the Student module. It follows the real tutor workflow from roster -> student detail -> lesson planning -> practice link -> review queue.

Route Map

• Roster: /students
• Student detail: /students/{studentId}
• Scope & Sequence: /students/{studentId}/scope
• Session logging: /students/{studentId}/session
• Practice review queue: /students/{studentId}/practice
• Public student practice link: /practice/{token}

1. Open Student Detail from Roster

What this feature does

• Finds the correct student quickly.
• Filters the roster before entering profile-level work.

How it works on the UI

Entry Point

• Open Students from the left sidebar.

Steps

1. Use Active or Archived tab based on roster state.
2. Use search to narrow by student name.
3. Use curriculum filter to narrow by program.
4. Use sort to prioritize view (Name, Date Joined, Recent Session).
5. Click the student row to open /students/{studentId}.

Result

• You land on Student Detail, ready for planning, session logging, notes, and review.

UI illustrations

2. Understand Student Detail Layout

What this feature does

• Provides one central operating page per student.
• Exposes top actions and progress blocks for daily teaching decisions.

How it works on the UI

Entry Point

• Open a student row from /students.

Steps

1. Use the top action cluster: New Lesson Plan or Plan (Clone Last), New Session or Add Session, Scope & Sequence, and ... for notes/actions.
2. Read quick status blocks: Last Session summary, Today's Plan, Current Review Cycle, and Coming Up Next.
3. Use lower sections for ongoing operations: WPM Trend Analysis, Session Timeline, Lesson Plan History, and Practice Queue.

Result

• Student Detail becomes the daily control center for instruction and follow-up.

UI illustrations

3. Manage Student Notes

What this feature does

• Separates internal tutor context from report-facing academic notes.

How it works on the UI

Entry Point

• On Student Detail header, click ....

Steps

1. Choose Private Notes for tutor-only operational context.
2. Choose Academic Notes for instructional/report-ready narrative.
3. Edit inside modal and click save.
4. Close modal and continue on Student Detail.

Result

• Notes stay attached to the same student and are available in future planning/reports.

UI illustration

4. Use Scope and Sequence

What this feature does

• Tracks mastery state and progression targets.
• Feeds planning decisions with current status.

How it works on the UI

Entry Point

• Click Scope & Sequence from Student Detail header.

Steps

1. Review current statuses per target.
2. Update progression states where needed.
3. Return to Student Detail to continue planning/session work.

Result

• Updated scope state is reflected in planning context and student progression signals.

UI illustration

5. Log Sessions and Review Timeline

What this feature does

• Records session outcomes and preserves a chronological history.
• Supports post-session inspection and editing from timeline details.

How it works on the UI

Entry Point

• Use New Session/Add Session on Student Detail, or start from a plan action.

Steps

1. Log target, mastery after-session state, note, WPM, and duration.
2. Save session to add it into timeline history.
3. Open Session Timeline and click View Detail for a record.
4. In detail modal, review lesson-plan link, error patterns, and metrics.
5. Edit session fields when needed (if account has write access).

Result

• Student history stays auditable and usable for planning/report continuity.

UI illustrations

6. Build Lesson Plans Inside Student Detail

What this feature does

• Creates or clones student-scoped plans from the same profile page.
• Defines instructional protocol and assignment-ready activity structure.
• Auto-generates student practice links after save.

How it works on the UI

Entry Point

• On Student Detail header, click New Lesson Plan or Plan (Clone Last).

Steps

1. Confirm student context and plan date/time.
2. Select target phoneme or custom target.
3. Add tutor coaching notes and objective context.
4. Build phase list: add phase, reorder phase, remove phase, and set per-phase duration.
5. For each phase, choose Interaction Mode and define protocol/input behavior.
6. Configure evidence and grading toggles: Audio Record, Smart Grading, and optional protocol details (Objective, Error Focus, Rubric).
7. Save plan with Save Lesson Plan.

Interaction Modes (8)

Result

• Plan is saved to history and ready for session start and/or independent practice publishing.

UI illustrations

7. Use Lesson Plan History

What this feature does

• Maintains reusable plan history and action controls per plan state.
• Handles start-session, edit, and existing practice-link reuse.

How it works on the UI

Entry Point

• Scroll to Lesson Plan History in Student Detail.

Steps

1. Review each plan row (target, date, steps, total minutes).
2. Use available action by state: Start Session for valid plans, Logged badge for already-used plans, Edit or read-only view if locked, Delete when allowed, and Copy Link if a practice link exists.
3. Keep future-dated plans for scheduling context (not immediate start).

Result

• Tutor can reuse and operate plan lifecycle without leaving the student context.

UI illustration

8. Copy Practice Link and Open Student Public Practice

What this feature does

• Publishes a student-facing assignment URL based on selected plan activities.
• Opens a clean public practice interface at /practice/{token}.

How it works on the UI

Entry Point

• Save a student plan, then use the success bar Auto-Assigned! -> Copy Link, or use Copy Link in plan history when present.

Steps

1. Copy generated link in /practice/{token} format.
2. Open link in browser.
3. Student sees assignment status, expiry, and step navigator.
4. Student completes prompts by mode: self-report, MCQ, text response, chain response, tile build, and fluency timer/passage.
5. If audio is required, student records before final submit.
6. Student submits and sees completion state.

Result

• Tutor receives attempt data back in the student practice review queue.
• If link is expired or closed, public page shows blocked message state.

9. Monitor Practice Queue from Student Detail

What this feature does

• Provides queue health at a glance for the current student.
• Helps prioritize what to review first.

How it works on the UI

Entry Point

• Use Practice Queue block on Student Detail.

Steps

1. Read counters: Pending, Overdue, and Reviewed/Closed.
2. Check recent assignment cards: status, attempts, latest attempt index, and expiry.
3. Click Open Review Queue to go to /students/{studentId}/practice.

Result

• Review backlog is visible without leaving the student page.

UI illustration

10. Review Independent Practice (Tutor Side)

What this feature does

• Supports detailed grading and final review decisioning per assignment.
• Controls when a session draft can be generated from approved work.

How it works on the UI

Entry Point

• Open /students/{studentId}/practice, then select an assignment.

Steps

1. Review assignment header and queue status.
2. Inspect latest attempt summary: total time, responses, changed answers, unsure flags, and autograde indicators.
3. Switch All Items vs Flagged.
4. For each item, review: prompt, student response, expected answer, and audio playback when available.
5. Grade items needing manual decision (correct, approximate, incorrect, inaudible).
6. Submit final decision: Approve & Create Draft, Needs Retry, or Close.

Decision behavior

• Approve & Create Draft can be blocked until required audio-grade conditions are satisfied.
• Approved flow can redirect into session draft context for logging follow-up.

Result

• Assignment transitions to review outcome and updates Student Detail queue state.

UI illustrations

Groups Page Guide

Open this area from the left sidebar: Groups.

1. Group List and Overview

What this feature does

• Shows all teaching groups in one place.
• Provides high-level visibility before opening a specific group.

How it works on the UI

• Use the group list as the entry point for group-level work.
• Select a group to open full details and actions.

UI illustration

2. Group Detail Workspace

What this feature does

• Manages one group's roster, progress context, and operational actions.
• Supports tracking group-level session history and student management inside the group.

How it works on the UI

• Open a group from the overview list.
• Use the detail view to review members, manage participation, and work with group history/actions.

UI illustration

Calendar Page Guide

Open this area from the left sidebar: Calendar.

1. Scheduling Board

What this feature does

• Gives tutors a single calendar view for upcoming and past sessions.
• Supports day/week/month planning visibility.

How it works on the UI

• Switch calendar view mode based on planning horizon.
• Select an event to open session-level actions and details.

UI illustration

2. Create and Manage Sessions

What this feature does

• Creates new student or group sessions.
• Supports updates such as reschedule/cancel through event management flow.

How it works on the UI

• Open the scheduling form from the calendar workspace.
• Choose target type (student or group), time, and duration.
• Save to place the session on the calendar and continue management from event actions.

UI illustration

Reports Page Guide

Open this area from the left sidebar: Reports.

1. Report Workspace and Student Insights

What this feature does

• Provides a report center where tutors select a student and prepare communication output.
• Shows progress-oriented insights used to frame parent-facing reporting.

How it works on the UI

• Start from the report roster/list.
• Open a student report workspace to review content before sharing.

UI illustrations

2. Parent Report Publishing and Public View

What this feature does

• Publishes a parent-facing report link.
• Delivers a clean public report view for guardians without tutor-login context.

How it works on the UI

• From the report workspace, publish/share the parent report.
• Use the public link to view the same published content from the parent-facing side.

UI illustrations