chhavigupta986/centre-allocation-system

Developed a portal to optimize the allocation of exam centers based on candidates' top 3 preferences, venue availability, and a first-come-first-serve basis

🎓Centre Allocation System

The Centre Allocation System is a Java-based portal designed to simplify the examination hall allotment and seating arrangement for local or state-level competitive exams.

Table of Contents

• 📄 Introduction
• ✨ Features
• ⚙️ Installation
• 📝 Usage
• 🤝 Contributing

Introduction

The Centre Allocation System streamlines the process of allocating examination centers and seating arrangements. Administrators can register institutes as venues for exams, and candidates can select their preferred locations during registration.

Features

• 🏫 Institute Registration: Administrators can register institutes by entering details such as institute name, location, and capacity.
• 📝 Candidate Registration: Candidates can register by providing their top 3 location preferences for the exam venue.
• 📍Automatic Center Allocation: Candidates receive a center allocation and a unique roll number immediately after registration based on factors such as availability of centres in the location, first come first serve basis etc.
• 🔐 Student Login: Students can log in to view their allocated center and roll number.
• 👩‍💼 Admin View: Administrators can view the list of students allocated to each institute.

Installation

1. 📥 Clone the repository:

   git clone https://github.com/chhaviGupta986/Centre-Allocation-System-in-Java.git
   cd Centre-Allocation-System-in-Java

2. 🔧 Set up the environment: Ensure you have Java Development Kit (JDK) installed. You can download it from here.

3. 🛠 Compile the project:

   javac -d bin Exam_Centre_Allocation.java exam_seating/*.java

4. 🚀 Run the project:

   java -cp bin Exam_Centre_Allocation

Usage

1. 🔑 Administrator Functions:

   • Register institutes by providing details such as name, location, and capacity.
   • View the list of students allocated to each institute.

2. 👩‍🎓 Candidate Functions:

   • Register by providing personal details and top 3 location preferences.
   • Log in to view allocated center and roll number.

Contributing

Contributions are welcome! Please fork the repository and submit a pull request with your changes.

1. Fork the repository.
2. Create a new branch (git checkout -b feature-branch).
3. Commit your changes (git commit -am 'Add new feature').
4. Push to the branch (git push origin feature-branch).
5. Create a new Pull Request.