/HF-Student

The student section of the hf website

Primary LanguageHTML

Holy Family Youth Village Hostel Management System

The Holy Family Youth Village Hostel Management System is a web application designed to facilitate the management of hostel accommodations for the organization 'Holy Family Youth Village.'
The system provides features to manage hostel rooms, bookings, check-ins, and passing information efficiently.

Features

  • Room Management: Add, update, and delete hostel rooms, specifying their capacity and availability status.

  • Booking Management: Allow users to book available hostel rooms for a session.

  • Payment Duration: Keep track of students' crent durations.

  • Information: Pass information across students in the hostel.

  • Dashboard: Provide an intuitive dashboard for administrators to monitor room occupancy and bookings.

Installation and Setup

  1. Clone the repository to your local machine:

bash

https://github.com/Emydev-op/HF-Student.git cd holy-family-youth-village-hostel

  1. Install Python and Django (ensure you have Python 3.6 or higher):

bash

pip install django

  1. Apply database migrations:

bash

python manage.py migrate

  1. Create a superuser to access the admin panel:

bash

python manage.py createsuperuser

  1. Run the development server:

bash

python manage.py runserver

  1. Open your web browser and navigate to 'http://http://127.0.0.1/8000/' to access the application.

Dependencies

The following technologies and libraries were used in building this project:

  • Django 4.2
  • HTML, CSS, and JavaScript
  • Bootstrap (for styling and layout)

How to Contribute

We welcome contributions to improve the Holy Family Youth Village Hostel Management System. If you want to contribute, please follow these steps:

  • Fork the repository and create a new branch from the 'main' branch.
  • Make your changes, add new features, or fix issues.
  • Ensure your changes are appropriately tested.
  • Submit a pull request to the 'main' branch of this repository.

License

This project is licensed under the MIT License. You can find more details in the LICENSE file.

Contact

If you have any questions or need assistance, you can reach out to the development team at:

Email: alphaoseghe@gmail.com

Thank you for using the Holy Family Youth Village Hostel Management System!