Django & Django REST framework test project.

The test project won't be used in any real environment.

Summary:

Extend Django Project with Django REST Framework for a simple prebuild booking app that have:

Listing object with two types - booking_engine.models :
- Apartment(single_unit) have booking information (price) directly connected to it.
- Hotels(multi-unit) have booking information (price) connected to each of their HotelRoomTypes.
filtering through Listings and returning JSON response with available units based on search criterias.
should handle large dataset of Listings.

There is a pre-build structure for Hotels/Apartments (could be changed or extended). Database is prefilled with information - db.sqlite3.
- superuser
  - username: admin
  - password: admin
We should be able to block days ( make reservations ) for each Apartment or HotelRoom.
- new Model for blocked (reserved) days must be created
NEW endpoint where we will get available Apartments and Hotels based on:
- available days (date range ex.: "from 2021-12-09 to 2021-12-12") - Apartment should not have any blocked day inside the range - Hotel should have at least 1 Hotel Room available from any of the HotelRoomTypes
- max_price (100):
  - Apartment price must be lower than max_price.
  - Hotel should have at least 1 Hotel Room without any blocked days in the range with price lower than max_price.
- returned objects should be sorted from lowest to highest price.
  - hotels should display the price of the cheapest HotelRoomType with available HotelRoom.

Initial Project setup

git clone https://bitbucket.org/staykeepersdev/bookingengine.git
python -m venv venv
pip install -r requirements.txt
python manage.py runserver

Test Case example:

For covering more test cases we are going to need at least one hotel with 3 Hotel Room Types:

First with price=50 (below max_price) with blocked day inside the search criteria for all rooms(could be 1 room)
Second with price=60 (below max_price) with blocked day insde the search criteria for one out of few rooms
Third with price 200 (above max_price)

Request example:

http://localhost:8000/api/v1/units/?max_price=100&check_in=2021-12-09&check_out=2021-12-12

Response example:

{
    "items": [
        {
            "listing_type": "Apartment",
            "title": "Luxurious Studio",
            "country": "UK",
            "city": "London",
            "price": "40"

        },
        {
            "listing_type": "Hotel",
            "title": "Hotel Lux 3***",
            "country": "BG",
            "city": "Sofia",
            "price": "60" # This the price of the first Hotel Room Type with a Room without blocked days in the range

        },
        {
            "listing_type": "Apartment",
            "title": "Excellent 2 Bed Apartment Near Tower Bridge",
            "country": "UK",
            "city": "London",
            "price": "90"
        },
    ]
}

jaitungodhani / bookingengine