# useraar/booking-management-application architecture

> Architecture diagram of the GitHub repository useraar/booking-management-application, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-03-31). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/useraar/booking-management-application
- Repository: https://github.com/useraar/booking-management-application

## Overview

##### Main Components
- API Gateway / Controllers: Represent the REST endpoints (BookingController, FlightController, TestController, MyConfigController) that serve as entry points for the client requests.
- Service Layer: Encapsulated by the various service classes (BookingService, FlightService, PassengerService) which manage business logic.
- Data Access Layer (DAO/Repositories): Contains repository interfaces (BookingRepository, FlightRepository, PassengerRepository) that interface with the PostgreSQL database.
- Domain/Entities and DTOs: Include the entity classes (BookingEntity, FlightEntity, PassengerEntity) and DTO objects for requests and responses that model the data.
- Configuration and Exception Handling: Components such as MyConfigProperties and custom exceptions (EntityNotFoundException) support configuration management and error handling.
- Database & Migrations: PostgreSQL (often managed via Docker and referenced by docker-compose.yml) and database version control via Liquibase change logs.
- Infrastructure: Dockerfile, docker-compose.yml, and Gradle scripts (build.gradle.kts, gradlew, gradlew.bat) that support building, containerization, and deployment.

##### Relationships and Data Flow
- Service layer interactions with Data Access Components (Repositories) which perform CRUD operations on the database.
- Flow for both incoming requests (from API to service, then to repository, to the database) and outgoing responses.
- Where configuration settings (from MyConfigProperties) and exception management are tied into the overall flow.

##### Architectural Patterns and Technologies
- Layered Architecture (Controller -> Service -> Repository -> Database) is the fundamental pattern here.
- Use of Spring Boot for REST API creation and dependency injection.
- That JPA/Hibernate abstracts interaction with PostgreSQL.
- Integration with Liquibase for automated database migrations.
- Existence of Docker components (Dockerfile, docker-compose.yml) as enabling containerized deployment.
- Mention Gradle as the build automation tool that ties the code together.

## Diagram (Mermaid)

```mermaid
flowchart TD
    Client["Client"]:::client

    subgraph "API Controllers"
        BookingController["BookingController"]:::api
        FlightController["FlightController"]:::api
        TestController["TestController"]:::api
        MyConfigController["MyConfigController"]:::api
    end

    subgraph "Service Interfaces"
        IBookingService["IBookingService"]:::service
        IFlightService["IFlightService"]:::service
        IPassengerService["IPassengerService"]:::service
    end

    subgraph "Service Layer"
        BookingService["BookingService"]:::service
        FlightService["FlightService"]:::service
        PassengerService["PassengerService"]:::service
    end

    subgraph "Data Access Layer"
        BookingRepository["BookingRepository"]:::repo
        FlightRepository["FlightRepository"]:::repo
        PassengerRepository["PassengerRepository"]:::repo
    end

    subgraph "Domain Model"
        subgraph "Entities"
            BookingEntity["BookingEntity"]:::domain
            FlightEntity["FlightEntity"]:::domain
            PassengerEntity["PassengerEntity"]:::domain
        end
        subgraph "DTOs"
            BookingRequest["BookingRequest"]:::domain
            FlightRequest["FlightRequest"]:::domain
            PassengerRequest["PassengerRequest"]:::domain
            BookingResponse["BookingResponse"]:::domain
            FlightResponse["FlightResponse"]:::domain
            PassengerResponse["PassengerResponse"]:::domain
        end
    end

    Database["PostgreSQL Database"]:::db

    subgraph "Configuration & Exception"
        MyConfigProperties["MyConfigProperties"]:::config
        EntityNotFoundException["EntityNotFoundException"]:::config
    end

    subgraph "Infrastructure"
        LiquibaseConfig["Liquibase Configurations"]:::infra
        DockerfileNode["Dockerfile"]:::infra
        DockerCompose["docker-compose.yml"]:::infra
        GradleScripts["Gradle Build Scripts"]:::infra
        ApplicationYaml["application.yaml"]:::infra
    end

    %% Main Data Flow Connections
    Client --> BookingController
    Client --> FlightController
    Client --> TestController
    Client --> MyConfigController

    BookingController --> BookingService
    FlightController --> FlightService
    TestController --> PassengerService
    MyConfigController --> MyConfigProperties

    %% Service Interfaces to Service Implementations (dashed)
    IBookingService --- BookingService
    IFlightService --- FlightService
    IPassengerService --- PassengerService

    %% Service to Repository Layer
    BookingService --> BookingRepository
    FlightService --> FlightRepository
    PassengerService --> PassengerRepository

    %% Repository to Database
    BookingRepository --> Database
    FlightRepository --> Database
    PassengerRepository --> Database

    %% Service usage of Domain Entities and DTOs (dashed)
    BookingService -.-> BookingEntity
    FlightService -.-> FlightEntity
    PassengerService -.-> PassengerEntity

    BookingService -.-> BookingRequest
    FlightService -.-> FlightRequest
    PassengerService -.-> PassengerRequest

    %% Exception Handling association (dashed)
    BookingService -.-> EntityNotFoundException
    FlightService -.-> EntityNotFoundException
    PassengerService -.-> EntityNotFoundException

    %% Infrastructure supporting Database and Configuration (dashed)
    LiquibaseConfig -.-> Database
    DockerCompose -.-> Database
    ApplicationYaml -.-> MyConfigProperties
    GradleScripts -.-> BookingService

%% Click Events for API Controllers
click BookingController "https://github.com/useraar/booking-management-application/blob/main/src/main/java/com/devaar/booking_append/controller/BookingController.java"
click FlightController "https://github.com/useraar/booking-management-application/blob/main/src/main/java/com/devaar/booking_append/controller/FlightController.java"
click TestController "https://github.com/useraar/booking-management-application/blob/main/src/main/java/com/devaar/booking_append/controller/TestController.java"
click MyConfigController "https://github.com/useraar/booking-management-application/blob/main/src/main/java/com/devaar/booking_append/controller/MyConfigController.java"

%% Click Events for Service Layer and Interfaces
click BookingService "https://github.com/useraar/booking-management-application/blob/main/src/main/java/com/devaar/booking_append/service/concretes/BookingService.java"
click FlightService "https://github.com/useraar/booking-management-application/blob/main/src/main/java/com/devaar/booking_append/service/concretes/FlightService.java"
click PassengerService "https://github.com/useraar/booking-management-application/blob/main/src/main/java/com/devaar/booking_append/service/concretes/PassengerService.java"
click IBookingService "https://github.com/useraar/booking-management-application/blob/main/src/main/java/com/devaar/booking_append/service/abstracts/IBookingService.java"
click IFlightService "https://github.com/useraar/booking-management-application/blob/main/src/main/java/com/devaar/booking_append/service/abstracts/IFlightService.java"
click IPassengerService "https://github.com/useraar/booking-management-application/blob/main/src/main/java/com/devaar/booking_append/service/abstracts/IPassengerService.java"

%% Click Events for Repositories
click BookingRepository "https://github.com/useraar/booking-management-application/blob/main/src/main/java/com/devaar/booking_append/dao/repository/BookingRepository.java"
click FlightRepository "https://github.com/useraar/booking-management-application/blob/main/src/main/java/com/devaar/booking_append/dao/repository/FlightRepository.java"
click PassengerRepository "https://github.com/useraar/booking-management-application/blob/main/src/main/java/com/devaar/booking_append/dao/repository/PassengerRepository.java"

%% Click Events for Domain Entities and DTOs
click BookingEntity "https://github.com/useraar/booking-management-application/blob/main/src/main/java/com/devaar/booking_append/dao/entity/BookingEntity.java"
click FlightEntity "https://github.com/useraar/booking-management-application/blob/main/src/main/java/com/devaar/booking_append/dao/entity/FlightEntity.java"
click PassengerEntity "https://github.com/useraar/booking-management-application/blob/main/src/main/java/com/devaar/booking_append/dao/entity/PassengerEntity.java"
click BookingRequest "https://github.com/useraar/booking-management-application/blob/main/src/main/java/com/devaar/booking_append/model/dtos/BookingRequest.java"
click FlightRequest "https://github.com/useraar/booking-management-application/blob/main/src/main/java/com/devaar/booking_append/model/dtos/FlightRequest.java"
click PassengerRequest "https://github.com/useraar/booking-management-application/blob/main/src/main/java/com/devaar/booking_append/model/dtos/PassengerRequest.java"
click BookingResponse "https://github.com/useraar/booking-management-application/blob/main/src/main/java/com/devaar/booking_append/model/dtos/BookingResponse.java"
click FlightResponse "https://github.com/useraar/booking-management-application/blob/main/src/main/java/com/devaar/booking_append/model/dtos/FlightResponse.java"
click PassengerResponse "https://github.com/useraar/booking-management-application/blob/main/src/main/java/com/devaar/booking_append/model/dtos/PassengerResponse.java"

%% Click Events for Configuration & Exception
click MyConfigProperties "https://github.com/useraar/booking-management-application/blob/main/src/main/java/com/devaar/booking_append/config/MyConfigProperties.java"
click EntityNotFoundException "https://github.com/useraar/booking-management-application/blob/main/src/main/java/com/devaar/booking_append/exceptions/EntityNotFoundException.java"

%% Click Events for Infrastructure
click LiquibaseConfig "https://github.com/useraar/booking-management-application/blob/main/src/main/java/liquibase/changelog-master.yml"
click DockerfileNode "https://github.com/useraar/booking-management-application/tree/main/Dockerfile"
click DockerCompose "https://github.com/useraar/booking-management-application/blob/main/docker-compose.yml"
click GradleScripts "https://github.com/useraar/booking-management-application/blob/main/build.gradle.kts"
click ApplicationYaml "https://github.com/useraar/booking-management-application/blob/main/src/main/resources/application.yaml"

%% Style Definitions
classDef client fill:#FFD700,stroke:#B8860B,stroke-width:2px;
classDef api fill:#A8DADC,stroke:#457B9D,stroke-width:2px;
classDef service fill:#F4A261,stroke:#E76F51,stroke-width:2px;
classDef repo fill:#E9C46A,stroke:#F4A261,stroke-width:2px;
classDef domain fill:#F0E68C,stroke:#BDB76B,stroke-width:2px;
classDef db fill:#2A9D8F,stroke:#264653,stroke-width:2px;
classDef config fill:#E0FBFC,stroke:#000,stroke-width:2px;
classDef infra fill:#B5838D,stroke:#6D6875,stroke-width:2px;
```
