End-to-end collaborative platform for authoring, reviewing, and managing national examination questions — built for a national education ministry.
National exam question production involved distributed educator teams managing content through spreadsheets and email threads — with no audit trail, no enforced review workflow, and no centralized repository. Questions could skip review stages, reviewers had no visibility into revision history, and quality control was entirely manual.
A full-stack web platform that enforces a multi-stage collaborative authoring pipeline — from framework/outline definition through question writing, peer review, verification, and publication. Every action is audit-logged, access is role-controlled, and no question reaches students without passing through defined quality gates.
Login — Clean, professional authentication interface
Dashboard — Role-based overview with activity statistics
Framework List — All frameworks with server-side data tables
Framework Detail — Hierarchical tree structure with detail view
Framework Templates — Template management with CRUD operations
Framework Preparation — Preparation instances with status tracking and filters
Outline List — All outlines with filtering
Outline Detail — Hierarchical outline structure
Outline Templates — Template management for outlines
Outline Preparation — Preparation instances with progress tracking
Question Writing — Event-based cards showing writing assignments with progress indicators
Writing Detail — Individual question authoring interface
Question Review — Review pipeline with status-based filtering
Review Detail — Peer review interface with revision tracking
Question Collection — Centralized repository of published questions
Question Detail — Full question view with metadata
Event List — All exam events with status and team assignments
Event Creation — Form for creating new exam events
Pending Reviews — Events awaiting review assignment
Active Reviews — Events with assigned review teams
User Management — User accounts with role assignments
Roles — Role definitions with permission mapping
Permissions — Granular permission management
Framework/Outline Definition → Question Writing → Peer Review → Verification → Publication
(templates) (authors) (reviewers) (verifiers) (final)
Each stage enforces role-based access control. Questions cannot advance without passing defined quality gates. The entire lifecycle is tracked with audit logging.
Educational frameworks and outlines use N-level hierarchical tree structures — arbitrary-depth taxonomies where each node can have unlimited children. The tree engine supports:
- Dynamic depth — no hardcoded level limitations
- Real-time UI rendering via recursive Livewire components
- Excel import/export with automatic hierarchical row flattening
- Tree codes (
parent_code/tree_code) for efficient traversal
Bulk question authoring through Excel import/export where the template structure adapts dynamically based on the user-defined framework:
- Column headers auto-generated from template definitions
- Hierarchical data flattened into rows with parent context
- Multiple question types supported (MCQ, complex MCQ, situational judgment)
- Export preserves the tree hierarchy for round-trip editing
Exam events organize the entire question lifecycle:
- Writing events — assign authors to specific outline sections with deadlines
- Review events — auto-linked to writing events, assign reviewers to evaluate
- Verification events — independent quality gate before publication
- Self-referencing event model — review events link back to their parent writing event
8 distinct roles with granular permissions:
Super Admin → Administrator → Teacher → Lecturer → Person in Charge → Reviewer → Verifier → User
Each role sees a scoped dashboard and can only access features within their permission set.
┌──────────────────────────────────────────────────────────┐
│ Browser │
│ Livewire 3 + Blade + Bootstrap 5.3 │
│ (Keen Themes Metronic UI) │
├──────────────────────────────────────────────────────────┤
│ Laravel 11 │
│ ┌─────────┐ ┌──────────────┐ ┌───────────────────────┐ │
│ │Controllers│ │Livewire Comp.│ │ DataTables (yajra) │ │
│ └────┬─────┘ └──────┬───────┘ └───────────┬───────────┘ │
│ │ │ │ │
│ ┌────▼───────────────▼─────────────────────▼───────────┐ │
│ │ Eloquent ORM + Custom Traits │ │
│ │ CascadeSoftDeletes │ GenUid │ FileUpload │ │
│ └───────────────────────┬─────────────────────────────┘ │
├──────────────────────────┼───────────────────────────────┤
│ PostgreSQL 15 │
│ Session │ Cache │ Queue │ Audit Log │ Application Data │
└──────────────────────────────────────────────────────────┘
Production deployment: FrankenPHP (Caddy-based) behind Nginx reverse proxy, containerized with Docker.
| Layer | Technology |
|---|---|
| Backend | Laravel 11, PHP 8.3 |
| Frontend | Livewire 3, Blade, Bootstrap 5.3 (Keen Themes Metronic) |
| Database | PostgreSQL 15 |
| Runtime | FrankenPHP (production), Artisan Serve (development) |
| Assets | Vite, CKEditor 5 (rich text), DataTables |
| Auth & RBAC | Laravel Breeze, Spatie Permission |
| Audit | Spatie Activity Log |
| Exports | dompdf (PDF), Maatwebsite Excel |
| Containerization | Docker, Docker Compose |
mavolty — github.com/mavolty
Built as a full-stack developer for a national education ministry.