Documentation
Functional reference for the upgraded CBT workflow across admin, teacher, and student dashboards.
Core Workflow
1Setup
Admin/Teacher creates exam, assigns students, configures schedule, attempts, access controls, and mode (standard/practice/adaptive).
2Question Authoring
Teacher manages question bank with tags, difficulty, Bloom level, hints, explanations, and media metadata.
3Delivery
Students take exam with resume support, randomization, timer controls, and optional AI monitoring.
4Grading and Analytics
Auto-graded objective items + manual queue for text/essay, then result recomputation and item analysis views.
Supported Question Types
- mcq_single - one correct option
- mcq_multi - multiple correct options
- true_false - binary options
- fill_blank - blank answers with match mode
- numeric - numeric with tolerance support
- short_text - short response (manual or keyed grading)
- essay - manual grading workflow
- matching / ordering - pair/sequence structures
Upload Template Fields (CSV/XLSX)
| Field |
Description |
Example |
| question |
Question prompt text |
What is NaCl? |
| question_type |
Type key for renderer and grading logic |
mcq_single / fill_blank |
| difficulty |
Difficulty level (1-5) |
3 |
| tags |
Comma-separated tags/topics |
Chemistry, Salt |
| hint / explanation |
Feedback support |
Think ionic compounds... |
| option1..optionN |
Option text for option-based types |
Sodium chloride |
| is_correct1..is_correctN |
Mark correct options (1/0) |
1 |
| blank1..blankN |
Model answers for blank/numeric/text grading |
NaCl |
| blank1_match_type |
exact / contains / regex / numeric_range |
exact |
| blank1_tolerance |
Tolerance for numeric matching |
0.05 |
| video_link |
Optional explanation media link (e.g., YouTube) |
https://youtube.com/... |
AI Proctoring Notes
- Set
GOOGLE_CLOUD_VISION_API_KEY in .env.
- Enable Cloud Vision API and billing on your Google Cloud project.
- Enable exam-level device lock / proctoring policy where needed.
- Teacher results provide categorized violations and snapshot evidence.