yaleyoo / sakura

A class project for SWEN90007 Software Design and Architecture.

Sakura Hotel Booking System

This system is developed for a start-up hotel company named Sakura Hotel to support their daily operation and enable customer to book online. Sakura Hotel is a hot-spring hotel and currently owns two buildings, and is considering to extend its business.

Live Demo

Sakura Hotel Booking System(Backup)

Note: a known bug in backup server is, in error page, servlet would trying to navigate the user into the referer page (previous page). But the uri in backup server is slightly different with the main server, that would makes the servlet regards the uri illegal. However, it will not interference the process.

Roles

• Customer
  • Customer can search for the available rooms based on his/her check-in time and check-out time and book the available room. After the order has been placed, customer can check his order in user center. In user center, customer can also cancel his order at least 2 days in advance.
• Staff
  • Receptionist
    • Receptionist can help customer to place the order. Receptionist can also modify the information of orders whose status are not Finished.
  • Manager
    • Manager can also help customer to place the order. Manager can modify the information of all history order, including Finished orders. Manager is able to manage the property information regarding buildings and rooms.

Order Status

• Booking
  • Order has been placed and the related room has been booked during the check-in time to check-out time, but the Customer hasn't checked in.
• Cancel
  • Order has been cancelled, the related room has been released.
• Active
  • Customer has checked in, but hasn't checked out yet.
• Finished
  • Customer has checked out, the order is completed.

Test Senario

Part 2 (Feature A):

Customer can search for the available rooms based on his/her check-in time and check-out time and book the available room. After the order has been placed, customer can check his order in user center. In user center, customer can also cancel his order at least 2 days in advance.

1. Enter Sakura Hotel Index Page

2. Click Customer button on the right-top coner to login as a customer.

3. Click Book a Room button on the navibar or in the central of the page.

4. You would be navigated to the page which listed all of the rooms.

5. Fill the Check In Time and Check Out Time fields following the format:yyyy-MM-dd hh:mm:ss. For instance:

   Check In Date	Check Out Date
   2018-11-06 10:00:00	2018-11-08 17:00:00

   

6. Select the building in the building dropdown list. Click Search button, a list of the available rooms would be shown up.

7. Select a room, click the Book button to place the order. The details about the order will show up. (This step is authorisaiton required, you have to login first, otherwise, you will be redirected to a permission denied page.) In this step, check-out-time should be after the check-in-time, also check-in-time should be a future time. If those requirements are failed to meet, an error message will show up.

8. Check the details of the orders. If they are correct, click confirm button to place your order. If the order is successfully placed, a successfully booked message will display.

9. However, if the room has been booked by others at that period, An error page will be shown.

10. To enter the user center, click the Hello, James on the top-right coner, then your history orders will be listed. This step is authorisation required, please login first, otherwise, you would be navigated to a permission denied page.

11. Customer can cancel their own orders 2 days in advance by clicking the cancel order button. If the order is successfully cancelled, customer will see a successful message. If it's failed, which is usually caused by trying to cancel the order whose check-in-time is within 2 days, then an error message will be poped.

12. If an order has been successfully cancelled, when you check it in the user center, its status should be Cancel.

Part 3 (Feature B)

• Staff - Receptionist Receptionist can help customer to place the order. Receptionist can also modify the information of orders whose status are not Finished. - Manager Manager can also help customer to place the order. Manager can modify the information of all history order, including Finished orders. Manager is able to manage the property information regarding buildings and rooms.

Receptionist manages orders

1. From the Index Page, click the Staff button to access the staff management page.
2. Then click Receptionist to login as a receptionist. Click the Manage Orders link, a dropdown list will show up. Click the Place New Order link to place a new order. The user will be navigated to a choose customer page. (NOTE that this step is authorisation required).
3. Receptionist should ask whether the customer already has an account, if the customer doesn't have one, this Receptionist should click New Customer tablet to create an account for him or her. Click the Create button to insert the new customer or click the Cancel button to return to the Satff Index page. (NOTE that if the input email is already in database, an error messgae will show after receptionist clicks Create button.)
4. Check the customer details again, if they are all correct, click Next button to confirm or click the Cancel button to cancel the creation action.
5. If the customer has been successfully created, user would be navigated to the page that lists all the rooms. Then the receptionist should input the check-in-time and check-out-time to search the available rooms. The current customer id would be shown be on the left-top corner.
6. The Next step is similar to the process on how customer places the order by themselves: select a room, book it, confirm the order's details, then place the order.
7. Receptionist can also check the details of history orders. In Staff Management Page, click the Manage Orders link, then select Check Current Orders, a page for searching the orders will show up.
8. Then input the order ID to search a specific order. A example order ID is 1810052334281.
9. Click the search button, if the order with the specific orderId has been found, its detail will be listed.
10. Do the neccessary modification. Then click Edit Order button to perform the modification. NOTE that the Receptionist cannot modify the order whose status is Finished. When the receptionist tries to search the detail about Finished order, the request will be denied.
11. In case the customer is already the existing customer of the Sakura Hotel, select the Existing Customer when choosing customer.
12. Inputting customer's email address and press Search button, if there is any existing customer in the database, that customer's details would be shown.
13. If the information is correct, click Next button. Then doing the remaining steps of placing order, which is exactly the same as the case of creating a new customer.

Manager manages orders

The process of how manager place the order is pretty the same with "Receptionist place the order", except the manager can also modify the Finished orders.

Manager manages the properties

1. From the Index Page, click the Staff on the top-right corner to access the staff management page.
2. Click the Manager button on the top-right side to login as a manager. Then click the Manage Properties button, a list of buildings would show up.
3. Click Delete button to delete a building. NOTE: please don't delete the first 2 buildings, otherwise the related rooms would be deleted as well, which will cause the order information ruined in the database.
4. Click Add a New Building button at the bottom to insert a new building. User would be navigated to a page to input the new building information. Then input the details of the new building, click confirm button to make the change. Or click the cancel button to return to the previous page.
5. By clicking the confirm button, the new building would be created. A success or error message will be shown. Then check the properties again (by clicking the manage properties link on the navigation bar), the information about new building will be listed.
6. To edit the building's details, click the edit button, the details of the selected building would be automatically filled in the form. Note that the building Id is uneditable. When finish the modification, click confirm button to make the change, or click the cancel button to return to the previous page.
7. Then user would be redirected to the Manage Properties page, the details of the building has been changed.
8. Click the check rooms button to view the rooms in that building.
   
9. The modification for room list is similar with modifying the buildings.