Intelligent Exam Hall Seating Arrangement System
Features • Tech Stack • Getting Started • Structure • Roadmap
SeatWise is a modern, AI-powered web examination management system designed to streamline the complex process of exam hall seating arrangements. It transforms chaotic manual scheduling into an organized, efficient, and error-free digital workflow.
Newly Redesigned: Now featuring a premium Dark Glassmorphism UI/UX for a futuristic and professional experience.
| Feature | Description |
|---|---|
| 🤖 Intelligent AI Allocation | Algorithms that automatically distribute students to ensure fairness and prevent cheating. |
| 📊 Excel Integration | Seamlessly import student data and export seating charts using SheetJS. |
| 📄 PDF Generation | Generate professional, printable seating plans and attendance sheets with jsPDF. |
| 🎨 Modern UI/UX | A stunning Dark Glassmorphism interface with smooth animations and responsive design. |
| 📱 Mobile Responsive | Fully accessible on all devices, from desktops to mobile phones. |
| ⚡ Real-time Stats | Live dashboard showing student counts, room allocation, and efficiency metrics. |
Follow these steps to set up the project locally.
- A modern web browser (Chrome, Firefox, Edge)
- Node.js (optional, for development server)
-
Clone the repository
git clone https://github.com/yourusername/Seatwise.git cd Seatwise -
Run the project
- Option A (Simple): Open
index.htmldirectly in your browser. - Option B (Developer): Use a local server for best performance.
npx http-server . -p 8080
- Option A (Simple): Open
-
Access the App Open
http://localhost:8080in your browser.
Seatwise/
├── 📄 index.html # Landing Page (Redesigned)
├── 📄 auth.html # Authentication / Login Page
├── 📄 app.js # Main Application Logic
├── 📄 script.js # UI Interactions & Animations
├── 📄 style.css # Global Styles (Dark Theme)
├── 📂 Image/ # Assets & Icons
├── 📂 docs/ # Documentation & Audit Reports
│ └── 📂 audit-reports/ # System Analysis
├── 📂 marge/ # Excel Merging Tool
├── 📂 pdf/ # Generated PDF Output Examples
└── 📂 .agent/ # AI Agent Config & Skills- Phase 1: UI Redesign - Dark Glassmorphism Theme
- Phase 2: Code Cleanup - Removal of legacy files
- Phase 3: Backend Integration - Cloud database support
- Phase 4: Advanced AI - Smart shuffling algorithms
Contributions are always welcome! Please check out our contribution guidelines first.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request