🎓 Educational Assessment Laravel WebApp

A Laravel-based web application designed to streamline academic evaluations. Features include quizzes, student profiles, face-recognition authentication, dynamic exams, and real-time rankings.

---

🚀 Features

• 👥 Student Profiles: Manage detailed student information effortlessly.
• 📝 Quiz & Exams Module: Create timed assessments with automated grading logic.
• 📸 Facial Recognition Authentication: Secure login and exam access via webcam-based face recognition.
• 📊 Real-time Rankings & Results: View student performance, leaderboards, and analytics.
• 🔐 Role-Based Access Control: Secure access for Admin, Teacher, and Student roles with scoped permissions.

---

🧰 Tech Stack

• Backend: Laravel
• Frontend: Blade, JavaScript, HTML/CSS, Bootstrap (AdminLTE theme)
• Database: MySQL
• Facial Recognition: FaceAPI.js

---

📁 Project Structure

├── app/                 # Core application logic (Controllers, Models, Middleware)
├── database/            # Migrations and Seeders for all tables
├── public/              # Frontend assets (JS, CSS, Webcam scripts)
├── resources/views/     # Blade UI templates
├── routes/web.php       # Route definitions
├── .env.example         # Environment variable template
├── composer.json        # PHP dependencies
└── package.json         # JavaScript dependencies

---

⚙️ Installation Guide

1. Clone the repository:

   git clone https://github.com/qppd/educational-assessment.git
   cd educational-assessment

2. Install PHP and JS dependencies:

   composer install
   npm install
   npm run dev

3. Configure your environment:

   cp .env.example .env
   php artisan key:generate

   Update the .env file with your database and mail settings.
4. Run migrations and seeders:

   php artisan migrate --seed

5. Start the local server:

   php artisan serve

   Visit http://localhost:8000 in your browser.

---

📸 Facial Recognition Setup

• Ensure your browser allows webcam access.
• Face recognition is handled client-side using face-api.js.
• Training and detection scripts are located in the public/js folder.

---

📄 License

This project is open-source and available under the MIT License.

MIT License

Copyright (c) 2025 QPPD

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction...

---

🙌 Acknowledgements

• QPPD (Quezon Province Programmers and Developers)
• Laravel & PHP Community
• FaceAPI.js (for face recognition)
• AdminLTE Bootstrap Theme