Hotel Reservationn App

This hotel reservation application will allow customers to find and book a hotel room based on room availability.

Main Components of the App

The major components of the Hotel Reservation Application will consist of the following:

1. CLI for the User Interface: We'll use the Command Line Interface (or CLI) for the user interface. For this, we'll need to have Java monitor the CLI for user input, so the user can enter commands to search for available rooms, book rooms, and so on.
2. Java code: The second main component is the Java code itself—this is where we add our business logic for the app.
3. Java collections: Finally, we'll use Java collections for in-memory storage of the data we need for the app, such as the users' names, room availability, and so on.

Application Architecture

The app can be separated into the following layers:

1. User interface (UI): including a main menu for the users who want to book a room, and an admin menu for administrative functions.
2. Resources: will act as our Application Programming Interface (API) to our UI.
3. Services: will communicate with our resources, and each other, to build the business logic necessary to provide feedback to our UI.
4. Data models: will be used to represent the domain that we're using within the system (e.g., rooms, reservations, and customers).

Project Requirements

User Scenarios

The application provides four user scenarios:

• Creating a customer account. The user needs to first create a customer account before they can create a reservation.
• Searching for rooms. The app should allow the user to search for available rooms based on provided checkin and checkout dates. If the application has available rooms for the specified date range, a list of the corresponding rooms will be displayed to the user for choosing.
• Booking a room. Once the user has chosen a room, the app will allow them to book the room and create a reservation.
• Viewing reservations. After booking a room, the app allows customers to view a list of all their reservations.

Admin Scenarios

The application provides four administrative scenarios:

• Displaying all customers accounts.
• Viewing all of the rooms in the hotel.
• Viewing all of the hotel reservations.
• Adding a room to the hotel application.

Reserving a Room – Requirements

The application allows customers to reserve a room. Here are the specifics:

• Avoid conflicting reservations. A single room may only be reserved by a single customer per check-in and check-out date range.
• Search for recommended rooms. If there are no available rooms for the customer's date range, a search will be performed that displays recommended rooms on alternative dates. The recommended room search will add upto seven days to the original check-in and check-out dates to see if the hotel has any availabilities and then display the recommended rooms/dates to the customer.

Room Requirements

• Room cost. Rooms will contain a price per night. When displaying rooms, paid rooms will display the price per night and free rooms will display "Free" or have a $0 price.
• Unique room numbers. Each room will have a unique room number, meaning that no two rooms can have the same room number.
• Room type. Rooms can be either single occupant or double occupant (Enumeration: SINGLE, DOUBLE).

Customer Requirements

The application will have customer accounts. Each account has:

• A unique email for the customer. RegEx is used to check that the email is in the correct format (i.e., name@domain.com).
• A first name and last name.

Error Requirements

The hotel reservation application handles all exceptions gracefully (user inputs included), meaning:

• No crashing. The application does not crash based on user input.
• No unhandled exceptions. The app has try and catch blocks that are used to capture exceptions and provide useful information to the user. There are no unhandled exceptions.

Getting Started

To run this projects follow these steps -

• Open git and go to the directory where you want to download the project and type the following command

git clone https://github.com/codeslash21/hotel-reservation.git

• After you execute the above command type to enter into the project directory hotel-reservation

cd hotel-reservatoin

• Then go to the src folder by typing cd src
• Run javac HotelApplication.java to compile the java which contains the main method
• Run java HotelApplication to execute the .class file that is created by compiling using above command.
• Now, you can see the application UI and can interact with the application by giving input through CLI.