{"id":23177245,"url":"https://github.com/nexusgksoftwares/django-project","last_synced_at":"2025-05-13T10:51:03.814Z","repository":{"id":263106120,"uuid":"888890016","full_name":"NexusGKSoftwares/DJANGO-PROJECT","owner":"NexusGKSoftwares","description":"Hotel Booking System A web-based application designed to streamline the process of booking hotel rooms online. It provides a user-friendly interface for customers to browse available rooms, make reservations, and manage bookings. Admins can manage rooms, bookings, and customer information efficiently.  ","archived":false,"fork":false,"pushed_at":"2024-11-19T18:10:27.000Z","size":2105,"stargazers_count":8,"open_issues_count":0,"forks_count":5,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-01T06:41:24.727Z","etag":null,"topics":["bootstrap","css","django","django-rest-framework","django-rest-framework-simplejwt","hotel-booking","hotel-management-system","hotels","html","javascript","python"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NexusGKSoftwares.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-15T07:48:59.000Z","updated_at":"2025-03-31T18:39:03.000Z","dependencies_parsed_at":"2024-11-16T08:24:38.422Z","dependency_job_id":"1d5d0c5a-e26b-440a-93c7-d961e000109b","html_url":"https://github.com/NexusGKSoftwares/DJANGO-PROJECT","commit_stats":null,"previous_names":["nexusgksoftwares/django-project"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NexusGKSoftwares%2FDJANGO-PROJECT","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NexusGKSoftwares%2FDJANGO-PROJECT/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NexusGKSoftwares%2FDJANGO-PROJECT/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NexusGKSoftwares%2FDJANGO-PROJECT/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NexusGKSoftwares","download_url":"https://codeload.github.com/NexusGKSoftwares/DJANGO-PROJECT/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253928818,"owners_count":21985794,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bootstrap","css","django","django-rest-framework","django-rest-framework-simplejwt","hotel-booking","hotel-management-system","hotels","html","javascript","python"],"created_at":"2024-12-18T06:32:15.024Z","updated_at":"2025-05-13T10:51:03.794Z","avatar_url":"https://github.com/NexusGKSoftwares.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"🏨 Hotel Booking Management System Documentation\n\n📋 Project Overview\n\nThe Hotel Booking Management System is a web-based platform designed to simplify and streamline the operations of hotel room management. This system enables administrators to:\n\nManage room information (add, edit, delete).\n\nApprove or reject customer bookings.\n\nProvide an intuitive and efficient interface for handling administrative tasks.\n\n\nThis project is built using Django, a high-level Python web framework, and incorporates Bootstrap for responsive and attractive frontend design.\n\n\n---\n\n🛠️ Technologies Used\n\nBackend:\n\nPython (3.10.12): Primary programming language.\n\nDjango (5.1.3): Web framework for rapid development.\n\n\nFrontend:\n\nHTML/CSS: Core for page structure and styling.\n\nBootstrap: Used for creating responsive and modern UI components.\n\n\nDatabase:\n\nSQLite: Default database used for development and testing.\n\n\n\n---\n\n🚀 Features\n\n1️⃣ Admin Panel:\n\nDashboard: Quick access to key functionalities and an overview of the system.\n\nRoom Management:\n\nAdd new rooms with details such as name, description, pricing, and images.\n\nEdit existing room details.\n\nDelete rooms no longer in use.\n\n\nBooking Management:\n\nApprove or reject booking requests with a single click.\n\n\n\n2️⃣ Room Management:\n\nStore and display detailed information about rooms.\n\nEnsure customers and admins have access to accurate and up-to-date data.\n\n\n3️⃣ Booking Approval:\n\nProvide an easy workflow for handling booking requests.\n\n\n\n---\n\n🏃‍♂️ Steps to Run the Project\n\n🧰 Prerequisites\n\nBefore running the project, make sure the following are installed on your system:\n\nPython (3.10 or higher)\n\nDjango (installation steps provided below).\n\nA Virtual Environment setup is recommended for managing dependencies.\n\n\n\n---\n\n💻 Step-by-Step Guide\n\nStep 1️⃣: Clone the Project Repository\n\nOpen a terminal and run the following command:\n\ngit clone https://github.com/\u003cyour-username\u003e/hotel_booking.git\ncd hotel_booking\n\nThis command downloads the project to your system and navigates to the project directory.\n\n\n---\n\nStep 2️⃣: Set Up a Virtual Environment (Optional but Recommended)\n\nA virtual environment keeps project dependencies isolated.\nRun the following commands:\n\npython -m venv venv         # Create a virtual environment\nsource venv/bin/activate    # Activate on Linux/Mac\nvenv\\Scripts\\activate       # Activate on Windows\n\n\n---\n\nStep 3️⃣: Install Project Dependencies\n\nInstall the required Python packages using pip:\n\npip install -r requirements.txt\n\nThis ensures you have all the necessary libraries installed.\n\n\n---\n\nStep 4️⃣: Apply Database Migrations\n\nDjango requires setting up the database structure. Run:\n\npython manage.py makemigrations\npython manage.py migrate\n\nThis will create the necessary tables in the database.\n\n\n---\n\nStep 5️⃣: Create a Superuser\n\nTo access the admin panel, you need a superuser account. Run:\n\npython manage.py createsuperuser\n\nProvide a username, email, and password as prompted.\n\n\n---\n\nStep 6️⃣: Run the Development Server\n\nLaunch the application locally using:\n\npython manage.py runserver\n\nAccess the project by opening your browser and navigating to:\nhttp://127.0.0.1:8000/\n\n\n---\n\n📂 Project Structure\n\nHere's a breakdown of the project files and their purpose:\n\nhotel_booking/\n├── hotel_booking/\n│   ├── settings.py         # Main settings for the project\n│   ├── urls.py             # URL routing for the application\n│   ├── wsgi.py             # Deployment entry point for WSGI servers\n│   └── asgi.py             # Deployment entry point for ASGI servers\n├── templates/\n│   ├── hotel_booking/\n│   │   ├── base_site.html  # Base layout for admin templates\n│   │   ├── add_room.html   # Page to add a new room\n│   │   ├── edit_room.html  # Page to edit room details\n│   │   ├── admin_home.html # Admin dashboard\n├── static/                 # Static files (CSS, JS, Images)\n├── manage.py               # Django's management script\n└── README.md               # Project documentation\n\n\n---\n\n🧪 Testing the Application\n\n1. Navigate to the admin panel: http://127.0.0.1:8000/admin/\n\n\n2. Login using the superuser account created earlier.\n\n\n3. Add rooms, manage bookings, and explore other features.\n\n\n\n\n---\n\n✨ Future Enhancements\n\nHere are some potential improvements to the system:\n\nUser Authentication: Allow customers to create accounts and book rooms.\n\nPayment Gateway: Integrate services like Stripe or PayPal for online payments.\n\nEmail Notifications: Notify customers of booking confirmations and status updates.\n\nEnhanced UI/UX: Improve the frontend design for a better user experience.\n\n\n\n---\n\n📬 Contact Information\n\nIf you encounter any issues or need support, feel free to reach out:\n\nEmail: nexusgksoftwares@gmail.com\n\nGitHub: NexusGK Softwares\n\n\n\n---\n\nEnjoy managing your hotel bookings effortlessly! 🌟\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnexusgksoftwares%2Fdjango-project","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnexusgksoftwares%2Fdjango-project","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnexusgksoftwares%2Fdjango-project/lists"}