Welcome to the Hostel Management System! This web application streamlines hostel operations, providing a centralized platform for managing students, staff, mess, and various administrative tasks.
- Record student details, including personal information.
- Allocate and track rooms, manage room occupancy, and handle room vacancies.
- Manage details of cleaning staff, cooking staff, and other personnel.
- Generate bills and invoices for students based on their chosen meal plans and transactions.
- Manage details of each room including the students associated with the room.
- Admin can manage the records of the room including the facilities that room provides
-
Clone the Repository:
git clone https://github.com/your-username/hostel-management.git
-
Navigate to the Project Directory:
cd hostel-management
-
Install Dependencies:
For installation of client dependencies
cd client npm install
For installation of server dependencies
```bash cd server pip install -r requirements.txt ```
-
Run the Application: If you have setup for the make command then use the below command it will automatically type the required commands
make
Otherwise you have to run client and server manually using
Terminal 1
cd client npm start
Terminal 2
cd server python manage.py runserver
-
Access the Application:
- Open a web browser and go to
http://localhost:3000
.
- Open a web browser and go to
-
Login:
- Use your admin credentials to log in to the system.
- For demo purposes here use this credentials:
- Username: admin
- Password: password@123
-
Navigate Dashboard:
- Explore the dashboard for an overview of hostel activities.
-
Manage Students:
- Add, update, or remove student records.
- Allocate rooms and track occupancy.
-
Staff Management:
- Add and manage details of cleaning staff, cooking staff, etc.
-
Financial Management:
- Track and manage financial transactions and invoices (bills).
If you'd like to contribute to the project, please follow these guidelines:
- Fork the repository on GitHub.
- Clone your forked repository (
git clone https://github.com/your-username/hostel-management.git
). - Create a new branch for your feature or bug fix (
git checkout -b feature-name
). - Make your changes and commit them (
git commit -am 'Add feature'
). - Push to the branch (
git push origin feature-name
). - Create a new Pull Request on GitHub.