An underwater volcano formed a new small island in the Pacific Ocean last month. All the conditions on the island seems perfect and it was decided to open it up for the general public to experience the pristine uncharted territory.

The island is big enough to host a single campsite so everybody is very excited to visit. In order to regulate the number of people on the island, it was decided to come up with an online web application to manage the reservations. You are responsible for design and development of a REST API service that will manage the campsite reservations.

• The campsite will be free for all.
• The campsite can be reserved for max 3 days.
• The campsite can be reserved minimum 1 day(s) ahead of arrival and up to 1 month in advance.
• Reservations can be cancelled anytime.
• For sake of simplicity assume the check-in & check-out time is 12:00 AM

• The users will need to find out when the campsite is available. So the system should expose an API to provide information of the availability of the campsite for a given date range with the default being 1 month.
• Provide an end point for reserving the campsite. The user will provide his/her email & full name at the time of reserving the campsite along with intended arrival date and departure date. Return a unique booking identifier back to the caller if the reservation is successful.
• The unique booking identifier can be used to modify or cancel the reservation later on. Provide appropriate end point(s) to allow modification/cancellation of an existing reservation
• Due to the popularity of the island, there is a high likelihood of multiple users attempting to reserve the campsite for the same/overlapping date(s). Demonstrate with appropriate test cases that the system can gracefully handle concurrent requests to reserve the campsite.
• Provide appropriate error messages to the caller to indicate the error cases.
• In general, the system should be able to handle large volume of requests for getting the campsite availability.
• There are no restrictions on how reservations are stored as as long as system constraints are not violated.

Clone the project

  git clone https://github.com/alvesfc/pacificCampsiteAPI.git

Go to the project directory

  cd pacificCampsiteAPI

Start Postgres database

  docker-compose -f /docker/postgresql.yml up -d

Start the server

  ./gradlew bootrun

To run tests, run the following command

  ./gradlew clean build