Mastery Tracking Interview

Project Brief

This repository gives you a seeded tutoring scenario, the supporting curriculum data, and the local report API surface. Use the sections below to understand what is available, then decide what kind of mastery-tracking experience you want to build.

The seeded scenario centers on tutor Sasha Patel working with Mia Rivera, a Grade 2 student, on the priority cluster "Use place value understanding and properties of operations to add and subtract."

The repo includes one tutoring transcript for that interaction, along with sub-skills, sample problems, tutor guidance, and starter report routes tied to the same tutor, student, and session.

Starter materials

The repo already includes these pieces for you to work from.

  • One seeded tutor, one seeded student, and one transcript-based session
  • One Grade 2 priority cluster with sub-skills, sample problems, and tutor guidance
  • Local report-style routes for latest, latest detailed, and generate
  • A rough generator implementation that you can inspect, replace, or ignore

Available data

You can read these directly in code or through the local routes.

  • Tutor profile
  • Student profile
  • Session transcript
  • Curriculum cluster, sub-skills, sample problems, and tutor moves
  • Generated summary and detailed report responses from the local API

7 sub-skills, 4 sample problems, and 2 scaffold ideas are already seeded.

Seeded IDs and context

Use these exact values when calling the seeded endpoints.

Tutor
Sasha Patel (2025-t27049)
Student
Mia Rivera (2025-s12123)
Session
session-2025-04-24
Focus
Grade 2 major work

Useful endpoints

These routes expose the starter report flow and generated data.

GET/api/public-reports/latest?tutor_id=2025-t27049&student_id=2025-s12123
GET/api/public-reports/latest/detailed?tutor_id=2025-t27049&student_id=2025-s12123
POST/api/internal-api/mastery-reports/generate

Code starting points

These files are the fastest way to orient yourself in the codebase.

Seeded data
lib/seed.ts
Generator
lib/generator.ts
In-memory store
lib/store.ts
Routes
app/api/...