Test guide
How to use ExamOS
Follow this path to try the full flow: upload book → blueprint → generate → approve → export PDF.
1. Test accounts
| Role | Password | Access | |
|---|---|---|---|
| Admin | admin@school.com | password123 | Full access |
| Maths teacher | maths@school.com | password123 | Mathematics only |
| Science teacher | science@school.com | password123 | Science only |
Teachers may be asked to set a stronger password on first login (8+ chars, upper + lower + number). Use Admin and a teacher in two browser windows to test approval.
2. Recommended path
- 1
Admin — Upload a textbook
Login as Admin → Curriculum Hub → upload a Class 10 PDF (Science or Maths). Wait until status is Published and chapters appear.
- 2
Create a blueprint
Blueprint Studio → create (or open) a blueprint for that class/subject. Add sections (MCQ, Short, Long) with marks and difficulty, then save.
- 3
Teacher — Generate a paper
Login as the matching teacher → Exam Studio → generate new paper. Pick blueprint + chapters → generate → edit if needed → Submit for approval.
- 4
Admin — Approve & export
Login as Admin → open the paper → Approve → export Question Paper PDF and Answer Key PDF. Optionally Publish.
3. Privacy check
Login as Maths teacher — you should only see Mathematics. Science papers and books must stay hidden. Then try Science teacher for the reverse.
4. Optional extras
- Alternate set (Set B): From an approved paper, generate an alternate set
- Exam Calendar: Schedule an exam and link an approved paper
- Assessments: Record topic scores for a class
- Remedials: Create a weak-topic pack and download the PDF
- Question Bank: Confirm generated questions appear for reuse
- Users (Admin): Create a teacher and assign subjects
If something fails
- Slow first load → free database may be waking; wait 10–20s and retry.
- Cannot generate → need a Published book for the same class + subject, plus a blueprint.
- Large PDF (up to 50 MB) upload fails → ask admin to enable Vercel Blob storage, then retry.
- Book stuck on PROCESSING → use Retry Index; big textbooks take a few minutes.
- Cannot export PDF → Admin must Approve the paper first.
- Teacher cannot see a paper → subject not assigned to that teacher.
Feedback: note which account you used, steps tried, and any error message or screenshot.