Welcome to the Hostel Management System project! This system aims to streamline the management of student accommodation in a hostel environment. It provides features for room allocation, feedback and complaints, an admin dashboard for monitoring and managing student information and requests, an address page, and a 3D room viewing feature.
- HTML: Used for structuring the web pages and creating their content.
- CSS: Employed for styling the HTML elements, enhancing the visual presentation and layout of the web pages.
- JavaScript (JS): Used to add interactivity and dynamic behavior to the web pages, enhancing user experience.
- Tailwind CSS: A utility-first CSS framework utilized for rapidly building custom user interfaces. It offers a set of pre-designed components and utility classes to style the application efficiently.
- Node.js: A JavaScript runtime environment that allows running JavaScript code outside a web browser. It is used to build scalable and server-side applications.
- Express.js: A minimalist web application framework for Node.js used to build web applications and APIs. It simplifies the process of building robust web servers.
- MongoDB: A NoSQL database used for storing data in a flexible, document-based format. It is well-suited for applications with dynamic schemas or those requiring high scalability and performance.
- Git: A version control system used for tracking changes in the project codebase, facilitating collaboration among developers, and managing project history.
- Allows administrators to allocate rooms to students.
- Provides a user-friendly interface for selecting and assigning rooms based on various criteria such as availability, preferences, etc.
- Enables students to submit feedback and complaints regarding hostel facilities, services, etc.
- Admins can view and address these feedback and complaints through the admin dashboard.
- Provides administrators with a centralized dashboard to monitor and manage student information.
- Allows admins to view room allocation details, handle feedback and complaints, and manage student requests effectively.
- Displays the address and contact information of the hostel.
- Helps students and visitors to easily find and contact the hostel administration.
- Offers a unique feature allowing users to view hostel rooms in a 3D environment.
- Enhances the user experience by providing a visual representation of the hostel rooms before allocation.
- Clone the repository:
git clone https://github.com/yourusername/hostel-management-system.git - Navigate to the project directory:
cd hostel-management-system - Install dependencies:
npm install - Set up MongoDB and configure the connection and write username and admin in Admin collection in HostelMS Database.
- Run the application:
node localserver.js - Access the application in your browser at
http://localhost:3000
- As an administrator, log in to the admin dashboard to manage student information, room allocation, feedback, and complaints.
- Students can access features such as room allocation, feedback submission, and viewing the hostel address.
Contributions are welcome! If you'd like to contribute to the project, please follow these steps:
- Fork the repository.
- Create a new branch:
git checkout -b feature/new-feature - Make your changes and commit them:
git commit -am 'Add new feature' - Push to the branch:
git push origin feature/new-feature - Submit a pull request.
For any inquiries or support, please contact on my email.