Skip to content

Simplifying and automating the process of organizing exams with efficient seating plans, schedules, and student data management.

Notifications You must be signed in to change notification settings

Nir-Bhay/Seatwise

Repository files navigation

Paste your rich text content here. Yo

📋 Seat-Wise - Exam Hall Seating Arrangement System

Seat-Wise Logo

HTML5
CSS3
JavaScript
License

🎓 Professional Exam Hall Seating Arrangement Generator

Generate organized seating arrangements for examinations with customizable layouts and PDF export functionality

Live Demo • Features • Installation • Usage • Screenshots


📑 Table of Contents


🎯 About The Project

Seat-Wise is a comprehensive web-based application designed to streamline the process of creating exam hall seating arrangements. It helps educational institutions efficiently organize students across multiple rooms, generate professional PDF documents, and manage examination logistics with ease.

🌟 Key Benefits:

    • ⏱️ Save Time: Automate the tedious process of manual seating arrangement
    • 📊 Organized Layout: Create systematic seating patterns (vertical/horizontal)
    • 🎨 Customizable: Adapt to various room configurations and requirements
    • 📄 Professional Output: Generate print-ready PDF documents
    • 💾 Data Persistence: Auto-save functionality to prevent data loss

✨ Features

🔐 Authentication System

    • Secure login/logout functionality
    • Session management
    • User email display

📝 Form Management

    • Dynamic College/University Selection* * Pre-configured options
  • * *   Custom input support
    
    • Branch & Program Management* * Automated program listing based on branch selection
  • * *   Support for B.Tech, BCA, B.Sc, M.Tech, MCA, etc.
    
    • Flexible Exam Configuration* * Date and time selection
  • * *   Custom time slots
    
  • * *   Semester selection (I-VIII)
    
  • * *   Student status (Regular/ATKT/Both)
    

📊 Data Import

    • Excel File Support* * Upload up to 4 Excel files
  • * *   .xlsx format compatibility
    
  • * *   File size validation (< 10MB)
    
  • * *   Real-time file preview
    
    • Data Entry Types* * Single data entry
  • * *   Double data entry for paired seating
    

🏫 Room Configuration

    • Dynamic Room Management* * Add unlimited rooms
  • * *   Specify room numbers
    
  • * *   Set candidate capacity
    
  • * *   Configure column/row layout
    
    • Visual Room Cards* * Interactive room display
  • * *   Easy edit/remove options
    

🎨 Customization Options

    • Layout Configuration* * Vertical/Horizontal arrangement
  • * *   Blank row insertion
    
  • * *   Double data columns
    
  • * *   Custom headers
    
    • Styling Options* * Adjustable font size (5-20pt)
  • * *   Cell border toggle
    
  • * *   Variable row height
    

📄 PDF Generation

    • Professional Headers* * Institution name
  • * *   Room details
    
  • * *   Exam timing and date
    
  • * *   Program/Branch information
    
    • Smart Footer* * Attendance tracking
  • * *   Signature sections
    
  • * *   Page numbering
    
    • Preview & Download* * In-browser PDF preview
  • * *   Direct download option
    
  • * *   Print functionality
    

💾 Additional Features

    • Auto-Save* * Automatic form data preservation
  • * *   Session restoration
    
    • Progress Tracking* * Visual progress bar
  • * *   Form completion indicator
    
    • Toast Notifications* * Success/Error messages
  • * *   User feedback system
    
    • Keyboard Shortcuts* * Ctrl+G: Generate PDF
  • * *   Ctrl+D: Download PDF
    
  • * *   Ctrl+R: Reset form
    
  • * *   Esc: Close modals
    

🛠️ Built With

Frontend Technologies

    • HTML5 - Semantic markup
    • CSS3 - Modern styling with CSS Variables
    • JavaScript (ES6+) - Interactive functionality

Libraries & Frameworks

Features Used

    • CSS Grid & Flexbox
    • CSS Animations
    • LocalStorage API
    • FileReader API
    • Intersection Observer API

🚀 Getting Started

Prerequisites

    • Modern web browser (Chrome, Firefox, Safari, Edge)
    • Local web server (optional, for development)

Installation

    1. Clone the repository
  1. BASH
    
  2. `1git clone https://github.com/yourusername/seat-wise.git 2cd seat-wise`
    
    1. File Structure
  3. `1seat-wise/ 2├── index.html 3├── auth.html 4├── style.css 5├── app.js 6├── Image/ 7│   └── favicon/ 8└── README.md`
    
    1. Open in Browser
  4. * *   Simply open `auth.html` in your web browser
    
  5. * *   Or use a local server:
    
  6. BASH
    
  7. `1# Using Python 2python -m http.server 8000 3 4# Using Node.js 5npx http-server`
    

📖 Usage

Step 1: Authentication

    1. Open the application
    1. Enter your email address
    1. Click "Sign In" to access the main dashboard

Step 2: Basic Configuration

    1. Select or enter College/University name
    1. Choose Branch and Program
    1. Select Semester
    1. Configure exam date and time
    1. Choose student status and arrangement type

Step 3: Upload Student Data

    1. Prepare Excel files with student enrollment numbers
    1. Click on file upload areas
    1. Select .xlsx files (max 10MB each)
    1. Add more files if needed (up to 4)

Step 4: Configure Rooms

    1. Click "Add Room" button
    1. Enter room details:* * Room number
  1. * *   Number of candidates
    
  2. * *   Number of columns
    
  3. * *   Number of rows (optional)
    
    1. Add multiple rooms as needed

Step 5: Customize Layout (Optional)

    1. Set blank row intervals
    1. Specify double data columns
    1. Add custom headers
    1. Adjust font size and row height
    1. Toggle cell borders

Step 6: Generate PDF

    1. Click "Generate PDF" button
    1. Wait for processing
    1. Preview the generated document
    1. Download or print as needed

📸 Screenshots

Login Screen

Login Screen

Main Dashboard

Dashboard

Room Configuration

Room Config

PDF Preview

PDF Preview


🗺️ Roadmap

    •  Version 2.0
  • * *    Multiple exam support
    
  • * *    Batch processing
    
  • * *    Email integration
    
    •  Version 2.5
  • * *    Database integration
    
  • * *    User roles (Admin/Staff)
    
  • * *    Exam history
    
    •  Version 3.0
  • * *    Mobile application
    
  • * *    QR code generation
    
  • * *    Real-time collaboration
    

🤝 Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

    1. Fork the Project
    1. Create your Feature Branch (git checkout -b feature/AmazingFeature)
    1. Commit your Changes (git commit -m 'Add some AmazingFeature')
    1. Push to the Branch (git push origin feature/AmazingFeature)
    1. Open a Pull Request

Contribution Guidelines

    • Follow existing code style
    • Add comments for complex logic
    • Update documentation
    • Test thoroughly before submitting

📄 License

Distributed under the MIT License. See LICENSE file for more information.


📧 Contact

Your Name - @yourtwitter - email@example.com

Project Linkhttps://github.com/yourusername/seat-wise


🙏 Acknowledgments


Made with ❤️ by Your Name

Back to top

u can paste directly from Word or other rich text sources.

About

Simplifying and automating the process of organizing exams with efficient seating plans, schedules, and student data management.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •