🎓 Smart Exam Allocator

A web-based Smart Exam Allocator designed to simplify examination scheduling, classroom allocation, faculty invigilation assignment, and conflict detection. The system helps educational institutions automate the exam management process while ensuring fairness, transparency, and efficient resource utilization.

---

📌 Features

👨‍💼 Admin Module

• Secure admin login
• Dashboard with examination overview
• Manage classrooms
• Manage faculty members
• Create and manage examination schedules
• Assign invigilators automatically
• Detect scheduling conflicts
• Generate allocation reports

👨‍🏫 Faculty Module

• Faculty login
• View assigned invigilation duties
• View exam schedule
• Check classroom allocations
• View duty history

🤖 AI Features

• AI-powered invigilation allocation
• Automatic conflict detection
• Smart classroom allocation
• Faculty workload balancing

---

🛠️ Technologies Used

Frontend

• React.js
• Vite
• Tailwind CSS
• JavaScript
• HTML5
• CSS3

Database

• MySQL

Development Tools

• VS Code
• Git
• GitHub

---

📂 Project Structure

SmartExamAllocator/
│
├── src/
│   ├── components/
│   ├── data/
│   ├── utils/
│   ├── App.jsx
│   └── main.jsx
│
├── sql/
│   ├── schema.sql
│   └── sample_data.sql
│
├── public/
├── package.json
├── vite.config.js
└── README.md

---

🚀 Installation

Clone the repository

git clone https://github.com/yourusername/smart-exam-allocator.git

Navigate to project

cd smart-exam-allocator

Install dependencies

npm install

Start development server

npm run dev

---

🗄️ Database Setup

1. Install MySQL.
2. Create a new database.

CREATE DATABASE smart_exam_allocator;

3. Import

• schema.sql
• sample_data.sql

4. Update database configuration in the backend.

---

👥 User Roles

Administrator

• Manage exams
• Manage faculty
• Manage classrooms
• Assign invigilators
• Resolve conflicts
• View reports

Faculty

• Login securely
• View assigned duties
• Check schedules
• View classroom details

---

📊 System Modules

• Authentication
• Dashboard
• Faculty Management
• Classroom Management
• Exam Scheduling
• Invigilator Allocation
• Conflict Detection
• Reports
• AI Assistant

---

📸 Screenshots

Add screenshots here.

Example:

• Login Page
• Dashboard
• Faculty Portal
• AI Allocation
• Conflict Detection
• Reports

---

🔒 Future Enhancements

• Email Notifications
• PDF Report Generation
• Attendance Tracking
• Mobile Application
• QR Code Verification
• Multi-College Support
• Cloud Deployment

---

🤝 Contributing

Contributions are welcome.

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to your branch
5. Open a Pull Request

---

📄 License

This project is developed for educational purposes.

---

👨‍💻 Developed By

Basava Reddy, Athmi-S, Lahari

Sahyadri College of Engineering and Management

Department of Computer Science & Engineering (AI & ML)

---

⭐ Support

If you found this project useful, please give it a ⭐ on GitHub.