🎉 Initial Release #

First public release of zeba_academy_exam_engine.

✨ Added #

Core Exam Engine

• ExamController for managing exam state and navigation

• Support for multiple question types:

  • MCQ (Multiple Choice Questions)
  • True / False
  • Descriptive questions (model ready)

• Randomized question ordering

• Answer tracking system

Scoring System

• Automatic scoring engine
• Configurable negative marking
• Skip detection
• Marks per question support

Timer Support

• Countdown exam timer
• Tick updates
• Auto finish callback support

Analytics

• ResultAnalyzer for performance insights
• Accuracy percentage calculation
• Automatic grade evaluation

UI Components

• ExamView widget for quick integration
• Navigation controls (Next / Previous)
• Option selection interface

Architecture

• Modular clean structure
• Testable business logic
• Separation of models, engine, analytics, and UI

Testing

• Unit tests for controller logic
• Scoring validation tests
• Navigation and analytics tests

---

🧱 Project Structure #

lib/
 ├── src/
 │   ├── models/
 │   ├── engine/
 │   ├── analytics/
 │   └── ui/

---

🔐 License #

Licensed under GNU General Public License v3.0 (GPL-3.0).

---

Planned (Upcoming Releases) #

• Section-based exams
• Question categories
• Resume exam session
• Improved UI customization

• Offline persistence support
• Local storage integration
• Advanced analytics dashboard

• Enterprise exam workflow
• Cloud sync integration
• Adaptive difficulty engine
• Anti-cheat mechanisms

---

Maintained by Zeba Academy.