# mawaaw/spring-boot-port-adapter-architecture architecture

> Architecture diagram of the GitHub repository mawaaw/spring-boot-port-adapter-architecture, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mawaaw/spring-boot-port-adapter-architecture
- Repository: https://github.com/mawaaw/spring-boot-port-adapter-architecture

## Overview

This is a Spring Boot reservation-management API for clients, rooms, and reservations. The main workflow accepts a REST request, delegates reservation rules to the application service, checks client and room eligibility and date availability, then persists and returns a reservation. Client and room management are separate API branches; persistence adapters and JPA repositories form the storage layer. The README is empty, and only some source was sampled, so links for unsampled branches are omitted rather than inferred.

Main entry points: [`src/main/java/org/mawaaw/springbootportadapterarchitecture/application/service/ReservationServiceImpl.java`](https://github.com/mawaaw/spring-boot-port-adapter-architecture/blob/master/src/main/java/org/mawaaw/springbootportadapterarchitecture/application/service/ReservationServiceImpl.java) (Reservation service), [`src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/adapter/in/persistence/impl/ReservationRepositoryImpl.java`](https://github.com/mawaaw/spring-boot-port-adapter-architecture/blob/master/src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/adapter/in/persistence/impl/ReservationRepositoryImpl.java) (Reservation adapter), [`src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/adapter/out/rest/ReservationController.java`](https://github.com/mawaaw/spring-boot-port-adapter-architecture/blob/master/src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/adapter/out/rest/ReservationController.java) (Reservation API), [`src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/adapter/out/rest/ClientController.java`](https://github.com/mawaaw/spring-boot-port-adapter-architecture/blob/master/src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/adapter/out/rest/ClientController.java) (Client API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_reservation_api["Reservation API"]
  node_client_api["Client API"]
  node_room_api["Room API"]
  node_error_handler["Exception handler"]
end

subgraph group_application["Application"]
  node_reservation_service["Reservation service"]
  node_client_service["Client service"]
  node_room_service["Room service"]
  node_dto["API DTOs"]
  node_client_port["Client repository port"]
  node_reservation_port["Reservation repository port"]
  node_room_port["Room repository port"]
end

subgraph group_domain["Domain"]
  node_domain_models["Reservation domain"]
  node_domain_exceptions["Domain exceptions"]
end

subgraph group_persistence["Persistence"]
  node_reservation_adapter["Reservation adapter"]
  node_reservation_jpa["Reservation JPA"]
  node_entities[("JPA entities")]
  node_mappers["Entity mappers"]
end

node_user(("API caller"))

node_user -->|"sends request"| node_reservation_api
node_user -->|"sends request"| node_client_api
node_user -->|"sends request"| node_room_api
node_reservation_api -->|"delegates to"| node_reservation_service
node_client_api -->|"delegates to"| node_client_service
node_room_api -->|"delegates to"| node_room_service
node_reservation_service -->|"checks client"| node_client_port
node_reservation_service -->|"looks up room"| node_room_service
node_reservation_service -->|"checks and saves"| node_reservation_port
node_reservation_service -->|"uses models"| node_domain_models
node_reservation_service -->|"raises errors"| node_domain_exceptions
node_reservation_service -->|"maps data"| node_mappers
node_reservation_service -->|"accepts and returns"| node_dto
node_reservation_adapter -->|"implements"| node_reservation_port
node_reservation_adapter -->|"uses"| node_reservation_jpa
node_reservation_adapter -->|"maps entities"| node_mappers
node_reservation_adapter -->|"converts"| node_entities
node_reservation_jpa -->|"queries"| node_entities
node_error_handler -->|"handles"| node_domain_exceptions

click node_reservation_api "https://github.com/mawaaw/spring-boot-port-adapter-architecture/blob/master/src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/adapter/out/rest/ReservationController.java"
click node_client_api "https://github.com/mawaaw/spring-boot-port-adapter-architecture/blob/master/src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/adapter/out/rest/ClientController.java"
click node_room_api "https://github.com/mawaaw/spring-boot-port-adapter-architecture/blob/master/src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/adapter/out/rest/RoomController.java"
click node_reservation_service "https://github.com/mawaaw/spring-boot-port-adapter-architecture/blob/master/src/main/java/org/mawaaw/springbootportadapterarchitecture/application/service/ReservationServiceImpl.java"
click node_client_service "https://github.com/mawaaw/spring-boot-port-adapter-architecture/blob/master/src/main/java/org/mawaaw/springbootportadapterarchitecture/application/service/ClientServiceImpl.java"
click node_room_service "https://github.com/mawaaw/spring-boot-port-adapter-architecture/blob/master/src/main/java/org/mawaaw/springbootportadapterarchitecture/application/service/RoomServiceImpl.java"
click node_dto "https://github.com/mawaaw/spring-boot-port-adapter-architecture/tree/master/src/main/java/org/mawaaw/springbootportadapterarchitecture/application/dto"
click node_client_port "https://github.com/mawaaw/spring-boot-port-adapter-architecture/blob/master/src/main/java/org/mawaaw/springbootportadapterarchitecture/application/port/out/ClientRepository.java"
click node_reservation_port "https://github.com/mawaaw/spring-boot-port-adapter-architecture/blob/master/src/main/java/org/mawaaw/springbootportadapterarchitecture/application/port/out/ReservationRepository.java"
click node_room_port "https://github.com/mawaaw/spring-boot-port-adapter-architecture/blob/master/src/main/java/org/mawaaw/springbootportadapterarchitecture/application/port/out/RoomRepository.java"
click node_domain_models "https://github.com/mawaaw/spring-boot-port-adapter-architecture/tree/master/src/main/java/org/mawaaw/springbootportadapterarchitecture/domain/model"
click node_domain_exceptions "https://github.com/mawaaw/spring-boot-port-adapter-architecture/tree/master/src/main/java/org/mawaaw/springbootportadapterarchitecture/domain/exception"
click node_reservation_adapter "https://github.com/mawaaw/spring-boot-port-adapter-architecture/blob/master/src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/adapter/in/persistence/impl/ReservationRepositoryImpl.java"
click node_reservation_jpa "https://github.com/mawaaw/spring-boot-port-adapter-architecture/blob/master/src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/adapter/in/persistence/jpa/ReservationJpaRepository.java"
click node_entities "https://github.com/mawaaw/spring-boot-port-adapter-architecture/tree/master/src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/entity"
click node_mappers "https://github.com/mawaaw/spring-boot-port-adapter-architecture/tree/master/src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/mapper"
click node_error_handler "https://github.com/mawaaw/spring-boot-port-adapter-architecture/blob/master/src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/exception/GlobalExceptionHandler.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_reservation_api,node_client_api,node_room_api,node_error_handler toneBlue
class node_reservation_service,node_client_service,node_room_service,node_dto,node_client_port,node_reservation_port,node_room_port toneAmber
class node_domain_models,node_domain_exceptions,node_user toneMint
class node_reservation_adapter,node_reservation_jpa,node_entities,node_mappers toneRose
```

## Components

### REST API

- [Reservation API](https://github.com/mawaaw/spring-boot-port-adapter-architecture/blob/master/src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/adapter/out/rest/ReservationController.java): `src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/adapter/out/rest/ReservationController.java`
- [Client API](https://github.com/mawaaw/spring-boot-port-adapter-architecture/blob/master/src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/adapter/out/rest/ClientController.java): `src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/adapter/out/rest/ClientController.java`
- [Room API](https://github.com/mawaaw/spring-boot-port-adapter-architecture/blob/master/src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/adapter/out/rest/RoomController.java): `src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/adapter/out/rest/RoomController.java`
- [Exception handler](https://github.com/mawaaw/spring-boot-port-adapter-architecture/blob/master/src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/exception/GlobalExceptionHandler.java): `src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/exception/GlobalExceptionHandler.java`

### Application

- [Reservation service](https://github.com/mawaaw/spring-boot-port-adapter-architecture/blob/master/src/main/java/org/mawaaw/springbootportadapterarchitecture/application/service/ReservationServiceImpl.java): `src/main/java/org/mawaaw/springbootportadapterarchitecture/application/service/ReservationServiceImpl.java`
- [Client service](https://github.com/mawaaw/spring-boot-port-adapter-architecture/blob/master/src/main/java/org/mawaaw/springbootportadapterarchitecture/application/service/ClientServiceImpl.java): `src/main/java/org/mawaaw/springbootportadapterarchitecture/application/service/ClientServiceImpl.java`
- [Room service](https://github.com/mawaaw/spring-boot-port-adapter-architecture/blob/master/src/main/java/org/mawaaw/springbootportadapterarchitecture/application/service/RoomServiceImpl.java): `src/main/java/org/mawaaw/springbootportadapterarchitecture/application/service/RoomServiceImpl.java`
- [API DTOs](https://github.com/mawaaw/spring-boot-port-adapter-architecture/tree/master/src/main/java/org/mawaaw/springbootportadapterarchitecture/application/dto): `src/main/java/org/mawaaw/springbootportadapterarchitecture/application/dto`
- [Client repository port](https://github.com/mawaaw/spring-boot-port-adapter-architecture/blob/master/src/main/java/org/mawaaw/springbootportadapterarchitecture/application/port/out/ClientRepository.java): `src/main/java/org/mawaaw/springbootportadapterarchitecture/application/port/out/ClientRepository.java`
- [Reservation repository port](https://github.com/mawaaw/spring-boot-port-adapter-architecture/blob/master/src/main/java/org/mawaaw/springbootportadapterarchitecture/application/port/out/ReservationRepository.java): `src/main/java/org/mawaaw/springbootportadapterarchitecture/application/port/out/ReservationRepository.java`
- [Room repository port](https://github.com/mawaaw/spring-boot-port-adapter-architecture/blob/master/src/main/java/org/mawaaw/springbootportadapterarchitecture/application/port/out/RoomRepository.java): `src/main/java/org/mawaaw/springbootportadapterarchitecture/application/port/out/RoomRepository.java`

### Domain

- [Reservation domain](https://github.com/mawaaw/spring-boot-port-adapter-architecture/tree/master/src/main/java/org/mawaaw/springbootportadapterarchitecture/domain/model): `src/main/java/org/mawaaw/springbootportadapterarchitecture/domain/model`
- [Domain exceptions](https://github.com/mawaaw/spring-boot-port-adapter-architecture/tree/master/src/main/java/org/mawaaw/springbootportadapterarchitecture/domain/exception): `src/main/java/org/mawaaw/springbootportadapterarchitecture/domain/exception`

### Persistence

- [Reservation adapter](https://github.com/mawaaw/spring-boot-port-adapter-architecture/blob/master/src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/adapter/in/persistence/impl/ReservationRepositoryImpl.java): `src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/adapter/in/persistence/impl/ReservationRepositoryImpl.java`
- [Reservation JPA](https://github.com/mawaaw/spring-boot-port-adapter-architecture/blob/master/src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/adapter/in/persistence/jpa/ReservationJpaRepository.java): `src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/adapter/in/persistence/jpa/ReservationJpaRepository.java`
- [JPA entities](https://github.com/mawaaw/spring-boot-port-adapter-architecture/tree/master/src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/entity): `src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/entity`
- [Entity mappers](https://github.com/mawaaw/spring-boot-port-adapter-architecture/tree/master/src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/mapper): `src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/mapper`

### Other components

- **API caller**

## Connections

- API caller → Reservation API: sends request
- API caller → Client API: sends request
- API caller → Room API: sends request
- Reservation API → Reservation service: delegates to (evidence: `src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/adapter/out/rest/ReservationController.java`)
- Client API → Client service: delegates to (evidence: `src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/adapter/out/rest/ClientController.java`)
- Room API → Room service: delegates to (evidence: `src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/adapter/out/rest/RoomController.java`)
- Reservation service → Client repository port: checks client (evidence: `src/main/java/org/mawaaw/springbootportadapterarchitecture/application/service/ReservationServiceImpl.java`)
- Reservation service → Room service: looks up room (evidence: `src/main/java/org/mawaaw/springbootportadapterarchitecture/application/service/ReservationServiceImpl.java`)
- Reservation service → Reservation repository port: checks and saves (evidence: `src/main/java/org/mawaaw/springbootportadapterarchitecture/application/service/ReservationServiceImpl.java`)
- Reservation service → Reservation domain: uses models (evidence: `src/main/java/org/mawaaw/springbootportadapterarchitecture/application/service/ReservationServiceImpl.java`)
- Reservation service → Domain exceptions: raises errors (evidence: `src/main/java/org/mawaaw/springbootportadapterarchitecture/application/service/ReservationServiceImpl.java`)
- Reservation service → Entity mappers: maps data (evidence: `src/main/java/org/mawaaw/springbootportadapterarchitecture/application/service/ReservationServiceImpl.java`)
- Reservation service → API DTOs: accepts and returns (evidence: `src/main/java/org/mawaaw/springbootportadapterarchitecture/application/service/ReservationServiceImpl.java`)
- Reservation adapter → Reservation repository port: implements (evidence: `src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/adapter/in/persistence/impl/ReservationRepositoryImpl.java`)
- Reservation adapter → Reservation JPA: uses (evidence: `src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/adapter/in/persistence/impl/ReservationRepositoryImpl.java`)
- Reservation adapter → Entity mappers: maps entities (evidence: `src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/adapter/in/persistence/impl/ReservationRepositoryImpl.java`)
- Reservation adapter → JPA entities: converts (evidence: `src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/adapter/in/persistence/impl/ReservationRepositoryImpl.java`)
- Reservation JPA → JPA entities: queries (evidence: `src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/adapter/in/persistence/jpa/ReservationJpaRepository.java`)
- Exception handler → Domain exceptions: handles (evidence: `src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/exception/GlobalExceptionHandler.java`)
