Practice PYQ routes

Files:

• practice-pyq-public.routes.ts — students
• practice-pyq-admin.routes.ts — staff

PYQ = exam-style question bank with subjects → topics → subtopics → questions.

Students practice and get SRS cards (when to review again). Admins import and edit the catalog.

Public router (/api/v1/practice-pyq)

Typical flows:

1. Browse taxonomy (subjects, topics, subtopics)
2. Start / continue a practice session
3. Submit answers → grading + scheduler updates card
4. Week review, review summaries

Uses:

• practice-pyq-learner.service.ts
• practice-pyq-srs-scheduler.ts / practice-pyq-ce-asrs-scheduler.ts
• Validators in validators/practice-pyq-*.ts

YouTube practice router (/api/v1/practice-yt)

Same file exports practiceYtPublicRouter for questions generated from user screenshots (parallel catalog kind).

Admin router

CRUD on taxonomy, bulk import, question editor, forbidden checks for production safety.

See models under models/practice-pyq/ and Services — practice PYQ.