Skip to content

Latest commit

 

History

History
71 lines (55 loc) · 2.65 KB

README.md

File metadata and controls

71 lines (55 loc) · 2.65 KB
Raw

HotelBookingApp

HotelBookingApp is a minimalistic web application designed to simplify the hotel reservation process for both customers and hotel managers. It is crafted with Java and Spring Boot in backend, and Thymeleaf in frontend. The system adheres to the Model-View-Controller (MVC) architectural pattern.

Features

  • User Registration & Management: Users can register, login, and manage their profiles. Various data validations (e.g. strong password requirement) have been implemented.
  • Hotel Management: Hotel managers can add/edit hotels, specifying details (e.g. name, address, room counts, prices) in a single interface.
  • Hotel Search: Enables customers to search for available hotels based on location and check-in/check-out dates.
  • Hotel Listing: Displays a list of available hotels with relevant details such as name, available room counts, and prices.
  • Hotel Details: Provides in-depth information on hotels, including name, address, room availability, pricing, and an interactive map leveraging the Nominatim geocoding API and Leaflet library.
  • Room Booking: Customers can select the desired number of rooms and get redirected to payment for finalizing the reservation.
  • Payment Processing: Secure credit card payment with validations like Luhn checks and custom validators for expiry dates and CVV. (No third-party payment gateways are implemented.)
  • Booking Management: Customers and hotel managers can view their bookings through the dashboard.
  • Admin Panel: Allows administrators to manage users, hotels, rooms, and bookings.
  • Responsive Design: The app is optimized for various devices including desktops, tablets, and smartphones.

Technology Stack

  • Backend:
    • Java 17
    • Spring Boot 3.1.1
    • MVC Architecture (Spring Web MVC 6.0.10)
  • Frontend:
    • Thymeleaf 3.1.1
    • Bootstrap 5.3.0
    • Bootstrap Icons 1.10.5
    • jQuery 3.7.0
    • jQuery-UI 1.13.2
    • Leaflet 1.9.4 (interactive maps)
  • Database:
    • MySQL
  • Security:
    • Spring Security 6.1.1 (authentication and authorization)
  • Other Tools:
    • Lombok (boilerplate code reduction)
    • Thymeleaf extras and layout dialect (enhanced UI functionality)

Prerequisites

  • Java JDK 17
  • Maven
  • MySQL

Installation & Running

  1. Clone the repository:

    git clone url

  2. Navigate to the project directory::

    cd HotelBookingApp

  3. Install the dependencies::

    mvn install

  4. Update application.properties with your MySQL database configurations.

  5. Run the application:

    mvn spring-boot:run

  6. Access the application via your browser at http://localhost:8080/.