# ecibienestar/circonio-booking-loans-services architecture

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

- Interactive diagram: https://gitdiagram.com/ecibienestar/circonio-booking-loans-services
- Repository: https://github.com/ecibienestar/circonio-booking-loans-services

## Overview

##### Project Type and Purpose
- This is a Spring Boot-based, monolithic RESTful backend service that manages room reservations and item loans.
- There is no dedicated “frontend” code here; the module exposes HTTP endpoints consumed by external clients (web UI, mobile app, scripts).

##### File Structure
- Top-level artifacts:
- Maven wrapper, pom.xml – build & dependency management
- README, .github/workflows – CI/CD pipelines (GitHub Actions, Azure)
- src/main/java/com/booking:
- config (CorsConfig, SwaggerConfig)
- controller (BookingController, HallController, ItemController)
- service (BookingService, HallService, etc.)
- repository (Spring Data JPA interfaces)
- entity + dto subpackages
- exception handlers
- src/main/resources/application.properties – runtime configuration (DB, app name)

##### Extract Architectural Insights from the README
- Layered, modular REST approach
- Uses PostgreSQL via Spring Data JPA
- CI/CD with GitHub Actions + Azure Pipelines / App Service
- Swagger UI for API docs

##### Main Components & Interactions
a. Client Layer
- External Client (Web/mobile)
- Swagger UI (interactive API docs)
b. API Layer
- Controllers (REST endpoints)
c. Business Logic Layer
- Services implementing use-cases (bookings, loans, halls, items)
d. Data Access Layer
- Repositories (Spring Data JPA)
- Entities / DTO conversion
e. Persistence
- PostgreSQL Database
f. Infrastructure & Tools (sidecar/external)
- GitHub Actions / Azure Pipelines
- Azure App Service (hosting)
- SonarCloud (code quality)
- JaCoCo (coverage reports)

##### Relationships & Data Flow
- Controller → Service (invoke business logic)
- Service → Repository (CRUD on Entities)
- Repository → Database (SQL queries)
- Database → Repository → Service → Controller → Client (HTTP response)
- Swagger UI wired into Controller layer
- CI/CD pipelines triggered on Git events → build/test/deploy to Azure

##### Architectural Patterns & Principles
- Layered architecture (Controller → Service → Repository)
- Dependency Injection (Spring Boot)
- DTO pattern for request/response separation
- Exception handling via custom exceptions
- Configuration via property files
- Automated testing (JUnit 5) and quality gates (SonarCloud)

##### Essential Elements
- Clear labels: e.g., “BookingController,” “BookingService,” “BookingRepository”

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% External Clients
    ExternalClient["External Client (Web/Mobile)"]:::external
    SwaggerUI["Swagger UI"]:::external

    %% Application Entry
    EciBienestarApplication["EciBienestarApplication"]:::config

    subgraph "Application"
        direction TB

        subgraph "Configuration Layer"
            direction TB
            CorsConfig["CorsConfig"]:::config
            SwaggerConfig["SwaggerConfig"]:::config
        end

        subgraph "Controller Layer"
            direction TB
            BookingController["BookingController"]:::controller
            HallController["HallController"]:::controller
            ItemController["ItemController"]:::controller
        end

        subgraph "Service Layer"
            direction TB
            BookingService["BookingService"]:::service
            HallService["HallService"]:::service
            ItemService["ItemService"]:::service
            LoanService["LoanService"]:::service
        end

        subgraph "Repository Layer"
            direction TB
            BookingRepository["BookingRepository"]:::repo
            HallRepository["HallRepository"]:::repo
            ItemRepository["ItemRepository"]:::repo
            LoanRepository["LoanRepository"]:::repo
        end

        subgraph "Entities & DTOs"
            direction TB
            BookingEntity["BookingEntity"]:::entity
            HallEntity["HallEntity"]:::entity
            ItemEntity["ItemEntity"]:::entity
            LoanEntity["LoanEntity"]:::entity
            BookingRequestDTO["BookingRequestDTO"]:::dto
            HallEntityRequestDTO["HallEntityRequestDTO"]:::dto
            ItemEntityRequest["ItemEntityRequest"]:::dto
            LoanRequestDTO["LoanRequestDTO"]:::dto
        end
    end

    %% Database
    PostgreSQLDB["PostgreSQL Database"]:::db

    %% Infrastructure
    subgraph "Infrastructure & Tools"
        direction TB
        GitHubActions_Main["GitHub Actions: main_ecibienestar-booking.yml"]:::infra
        GitHubActions_Develop["GitHub Actions: pipeline-develop.yml"]:::infra
        AzureAppService["Azure App Service"]:::infra
        SonarCloud["SonarCloud"]:::infra
        JaCoCo["JaCoCo"]:::infra
    end

    %% Connections
    ExternalClient -->|"HTTP Request"| BookingController
    ExternalClient -->|"HTTP Request"| HallController
    ExternalClient -->|"HTTP Request"| ItemController
    SwaggerUI -->|"HTTP Request"| BookingController

    BookingController -->|"calls"| BookingService
    HallController -->|"calls"| HallService
    ItemController -->|"calls"| ItemService

    BookingService -->|"uses JPA"| BookingRepository
    HallService -->|"uses JPA"| HallRepository
    ItemService -->|"uses JPA"| ItemRepository
    LoanService -->|"uses JPA"| LoanRepository

    BookingRepository -->|"SQL Queries"| PostgreSQLDB
    HallRepository -->|"SQL Queries"| PostgreSQLDB
    ItemRepository -->|"SQL Queries"| PostgreSQLDB
    LoanRepository -->|"SQL Queries"| PostgreSQLDB

    EciBienestarApplication --> CorsConfig
    EciBienestarApplication --> SwaggerConfig

    GitHubActions_Main -->|"CI/CD"| AzureAppService
    GitHubActions_Develop -->|"CI/CD"| AzureAppService
    AzureAppService -->|hosts| BookingController

    SonarCloud -->|"Quality Analysis"| GitHubActions_Main
    JaCoCo -->|"Coverage Reports"| GitHubActions_Main

    %% Click Events
    click EciBienestarApplication "https://github.com/ecibienestar/circonio-booking-loans-services/blob/main/src/main/java/com/booking/EciBienestarApplication.java"
    click CorsConfig "https://github.com/ecibienestar/circonio-booking-loans-services/blob/main/src/main/java/com/booking/config/CorsConfig.java"
    click SwaggerConfig "https://github.com/ecibienestar/circonio-booking-loans-services/blob/main/src/main/java/com/booking/config/SwaggerConfig.java"
    click BookingController "https://github.com/ecibienestar/circonio-booking-loans-services/blob/main/src/main/java/com/booking/controller/BookingController.java"
    click HallController "https://github.com/ecibienestar/circonio-booking-loans-services/blob/main/src/main/java/com/booking/controller/HallController.java"
    click ItemController "https://github.com/ecibienestar/circonio-booking-loans-services/blob/main/src/main/java/com/booking/controller/ItemController.java"
    click BookingService "https://github.com/ecibienestar/circonio-booking-loans-services/blob/main/src/main/java/com/booking/service/BookingService.java"
    click HallService "https://github.com/ecibienestar/circonio-booking-loans-services/blob/main/src/main/java/com/booking/service/HallService.java"
    click ItemService "https://github.com/ecibienestar/circonio-booking-loans-services/blob/main/src/main/java/com/booking/service/ItemService.java"
    click LoanService "https://github.com/ecibienestar/circonio-booking-loans-services/blob/main/src/main/java/com/booking/service/LoanService.java"
    click BookingRepository "https://github.com/ecibienestar/circonio-booking-loans-services/blob/main/src/main/java/com/booking/repository/BookingRepository.java"
    click HallRepository "https://github.com/ecibienestar/circonio-booking-loans-services/blob/main/src/main/java/com/booking/repository/HallRepository.java"
    click ItemRepository "https://github.com/ecibienestar/circonio-booking-loans-services/blob/main/src/main/java/com/booking/repository/ItemRepository.java"
    click LoanRepository "https://github.com/ecibienestar/circonio-booking-loans-services/blob/main/src/main/java/com/booking/repository/LoanRepository.java"
    click BookingEntity "https://github.com/ecibienestar/circonio-booking-loans-services/blob/main/src/main/java/com/booking/entity/BookingEntity.java"
    click HallEntity "https://github.com/ecibienestar/circonio-booking-loans-services/blob/main/src/main/java/com/booking/entity/HallEntity.java"
    click ItemEntity "https://github.com/ecibienestar/circonio-booking-loans-services/blob/main/src/main/java/com/booking/entity/ItemEntity.java"
    click LoanEntity "https://github.com/ecibienestar/circonio-booking-loans-services/blob/main/src/main/java/com/booking/entity/LoanEntity.java"
    click BookingRequestDTO "https://github.com/ecibienestar/circonio-booking-loans-services/blob/main/src/main/java/com/booking/entity/dto/BookingRequestDTO.java"
    click HallEntityRequestDTO "https://github.com/ecibienestar/circonio-booking-loans-services/blob/main/src/main/java/com/booking/entity/dto/HallEntityRequestDTO.java"
    click ItemEntityRequest "https://github.com/ecibienestar/circonio-booking-loans-services/blob/main/src/main/java/com/booking/entity/dto/ItemEntityRequest.java"
    click LoanRequestDTO "https://github.com/ecibienestar/circonio-booking-loans-services/blob/main/src/main/java/com/booking/entity/dto/LoanRequestDTO.java"
    click GitHubActions_Main "https://github.com/ecibienestar/circonio-booking-loans-services/blob/main/.github/workflows/main_ecibienestar-booking.yml"
    click GitHubActions_Develop "https://github.com/ecibienestar/circonio-booking-loans-services/blob/main/.github/workflows/pipeline-develop.yml"
    click AzureAppService "https://github.com/ecibienestar/circonio-booking-loans-services/tree/main/Azure App Service"
    click SonarCloud "https://github.com/ecibienestar/circonio-booking-loans-services/tree/main/SonarCloud"
    click JaCoCo "https://github.com/ecibienestar/circonio-booking-loans-services/tree/main/JaCoCo"
    click applicationProperties "https://github.com/ecibienestar/circonio-booking-loans-services/blob/main/src/main/resources/application.properties"

    %% Styles
    classDef controller fill:#89CFF0,stroke:#333,stroke-width:1px
    classDef service fill:#90EE90,stroke:#333,stroke-width:1px
    classDef repo fill:#D8BFD8,stroke:#333,stroke-width:1px
    classDef config fill:#FFD580,stroke:#333,stroke-width:1px
    classDef entity fill:#FFE4C4,stroke:#333,stroke-width:1px
    classDef dto fill:#FFFACD,stroke:#333,stroke-width:1px
    classDef db fill:#E0FFFF,stroke:#333,stroke-width:1px,stroke-dasharray: 5 5
    classDef external fill:#F0E68C,stroke:#333,stroke-width:1px
    classDef infra fill:#D3D3D3,stroke:#333,stroke-width:1px
```
