QuizAI V2

QuizAI V2 is a web-based quizzing system designed optionally as an extension of the ACCESS School Management System. It provides a robust environment for teachers to create, manage, and deliver quizzes to students, supporting both synchronous (live) and asynchronous delivery modes.

🚀 Features

For Teachers

  • Quiz Management: Create, update, and delete quizzes with titles, descriptions, and customizable settings.
  • Question Groups: Organize questions into reusable groups that can be attached to multiple quizzes.
  • Question Types: Support for multiple-choice questions with text and image options, with Markdown support for formatting.
  • Bulk Import: Quickly add multiple questions to a quiz using a simplified text-based format.
  • OMR Functionality:
    • Questionnaire Generation: Generate PDF answer sheets with unique 5-digit reference codes for any quiz.
    • Automated Scoring: Printed answer sheets can be scanned and automatically scored against the correct-answer mapping.
    • Multiple Submission Modes: Supports both manual image uploads and automated submissions via a dedicated REST API.
    • Server-side OMR Engine: Built-in image processing for parsing scanned answer sheets.
  • Delivery Modes:
    • Async: Students take the quiz at their own pace.
    • Sync (Live): Teacher-controlled live quiz flow where all students progress through questions together.
  • Customizable Timers: Set default timers per quiz or override them for specific questions.
  • Question Randomization: Option to randomize question order for each student session.
  • Real-time Monitoring: Track student progress and security violations during live sessions.
  • Detailed Results: View comprehensive results and performance metrics for each quiz, including OMR scan history and automated Item Analysis to identify question performance and difficulty.

For Students

  • Personalized Dashboard: View available quizzes filtered by schedule and subject.
  • Secure Quiz Interface: Take quizzes with server-side timer enforcement and security monitoring.
  • Progress Tracking: Automatic saving of answers and session heartbeat to ensure continuity.
  • Immediate Feedback: View quiz results and scores upon completion (if enabled).
  • Violation Reporting: Automatic detection and reporting of session security violations.

📖 Usage

Authentication

The system uses the ACCESS Web API for authentication. Users log in with their existing ACCESS credentials. The roles (teacher/student) are automatically identified during login.

Alternatively, users can be generated and/or modified at the Admin Dashboard which will decouple the authentication from the ACCESS Web API. Schedules, student-base, and class records may still require the ACCESS Web API.

Teacher Workflow

  1. Dashboard: View your schedules and existing quizzes.
  2. Groups: Create question groups for reusable content.
  3. Create Quiz: New quizzes are created as "Drafts".
  4. Add Questions: Add questions directly to the quiz or attach existing question groups.
  5. Publish: Change status to "Published" or "Active" to make the quiz available to students.
  6. Live Quiz: For "Sync" mode, use the "Live" control panel to start and advance questions.
  7. OMR Workflow:
    • Generate: Create PDF answer sheets from any quiz details page.
    • Scan: Upload scanned images via the "OMR Scans" tab or use an API-connected scanner.
    • Review: Validate scored results and manual overrides if necessary.

OMR External API

QuizAI provides a REST API (v1) for submitting OMR data from third-party scanners or mobile apps.

  • Authentication: Ephemeral (2h) session keys or long-lived CLI-generated keys.
  • Endpoints: Supports both synchronous (parsed JSON) and asynchronous (base64 image) submissions.
  • Background Worker: A cron-based worker processes the async OMR queue.

See API-specification.md for full integration details.

Student Workflow

  1. Dashboard: See a list of active quizzes for your enrolled subjects.
  2. Start Quiz: Click "Start" on an active quiz to begin the session.
  3. Take Quiz: Answer questions within the allotted time. For "Sync" mode, wait for the teacher to advance the question.
  4. Results: Once submitted, view your score and detailed feedback in the results section.

🤝 Support

For technical support or inquiries, please contact the ACCESS development team.