https://github.com/nuricanozturk01/can-travel-company

Project for SE-4458
https://github.com/nuricanozturk01/can-travel-company

Last synced: about 2 months ago
JSON representation

Project for SE-4458

• Host: GitHub
• URL: https://github.com/nuricanozturk01/can-travel-company
• Owner: nuricanozturk01
• Created: 2023-11-15T21:12:11.000Z (about 1 year ago)
• Default Branch: master
• Last Pushed: 2023-12-02T15:10:16.000Z (about 1 year ago)
• Last Synced: 2023-12-02T16:25:12.641Z (about 1 year ago)
• Language: Java
• Size: 650 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Can-Travel-Company

### Midterm Project For SE-4458 lesson.

- Database:

    - Development: PostgreSQL

    - Test: H2

- General:

    - Spring boot 3.1.5

    - Java 17

    - Mapstruct

    - Swagger

    - JUnit

    - JWT

### Database Design:

![db_design.png](image%2Fdb_design.png)

### Unit Tests:

##### Read Service:

![unit_tests.png](image%2Funit_tests.png)

##### Authentication Service:

![auth_test.png](image%2Fauth_test.png)

##### Booking Service:

![booking_test.png](image%2Fbooking_test.png)

# Booking Service Documentation

## Assumptions

- The Query Service allows anyone to make queries without authentication.

- The Booking Service functionality includes:

  - Users can only make reservations through a POST request.

  - Admin users can add new houses and perform specific queries.

## Invalid Reservation Scenarios

When making a reservation, the following invalid scenarios are considered:

1. **Exceeding House Capacity:**

   - Users cannot make a reservation with a number of people exceeding the capacity of the house.

   - The system responds with a DataServiceException.

2. **Invalid Username:**

   - Users cannot make a reservation using another user's username or a username that does not exist in the system.

   - The system responds with a DataServiceException.

3. **Invalid house_id:**

   - Users cannot make a reservation with an invalid house_id.

   - The system responds with a DataServiceException.

4. **Invalid Date Intervals:**

   - Reservations are subject to the following date interval conditions:

      - Past time interval: All reservations can be made from the current date onwards.

      - The finish_date cannot be before the start_date.

      - If a reservation has been made for the same house on the same dates before, that date is considered invalid.

## Date Format

The accepted date format for requests is: dd/MM/yyyy (e.g., 25/01/1999).

## Swagger Documentation

Before making a request, please refer to the bottom section of the Swagger documentation, which displays the Data Transfer Objects (DTOs) for accurate parameter information.