Repository files navigation

The Modern Hostel Management System is a comprehensive application designed to facilitate the management and operations of a hostel. It offers various features such as registration/sign-in, room booking, QR-based gate pass token, attendance with face and location verification, complaint section, feedback section, and an admin dashboard.

• Students can register and create an account to access the system.
• Existing students can sign in using their credentials.

• Students can view available rooms and book them based on their preferences and availability.

• Students can view their mess bill details, including their current balance, the bill for the current month, and previous expenses.

• Students have to fill leave form and can download their gate pass .
• The gate pass token will be scanned by security personnel at the gate for verification.

• Students' attendance will be marked after face and location verification.
• The system checks if the student is not on leave before verifying the location.
• Students need to scan their face for attendance verification.

• Students can submit complaints or issues they encounter within the hostel.
• They can track the status of their complaints and receive updates.

• Students can provide feedback on their experiences or suggest improvements.

• The admin dashboard provides access to manage and monitor various aspects of the hostel management system.
• Admins can view and manage registrations, room bookings, leave applications, attendance records, complaints, and feedback.

1. Clone the repository:

git clone https://github.com/paramsgit/Hostel_minor_project.git

2. Install the necessary dependencies:

cd Hostel_minor_projectnpm install

3. Start the server

npm start

Access the application viahttp://localhost:3000.

Now Setup Backend

1. Install the necessary dependencies:

cd Backendnpm install

2. Start the server

node index.js

Access the application viahttp://localhost:5000.

Now setup python server for Face recognition.

1. Install the necessary dependencies:

cd ..cd Pythonpip install -r requirements.txt

2. Start the microservice

python python.py

You need to set your MongoDB URL in thedb.js file located in the Backend folder.

const mongouri ="YOUR_MONGO_URL"

e.g. -> const mongouri ="mongodb://127.0.0.1:27017/app"

NodeJS,ExpressJS,MongoDB,ReactJS,Python,Tailwind,

Contributions are welcome! If you'd like to contribute to this project, please follow these steps:

• Fork the repository.
• Create a new branch for your feature/bug fix.
• Make your changes and commit them with descriptive commit messages.
• Push your changes to your forked repository.
• Submit a pull request detailing your changes.