# team-dodn/spring-boot-java-template architecture

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

- Interactive diagram: https://gitdiagram.com/team-dodn/spring-boot-java-template
- Repository: https://github.com/team-dodn/spring-boot-java-template

## Overview

This is a modular Spring Boot service template whose executable application exposes HTTP APIs. The principal example flow accepts GET or POST input, converts it to domain data, processes it in a service, and returns a standard API response. The repository also documents separate client, database, logging, monitoring, and shared-enum modules. The shown controller/service and response relationships are source-backed; module-level integration claims come from the README, so no unshown API-to-database or API-to-client call is asserted.

Main entry points: [`core/core-api/src/main/java/io/dodn/springboot/core/api/controller/v1/ExampleController.java`](https://github.com/team-dodn/spring-boot-java-template/blob/main/core/core-api/src/main/java/io/dodn/springboot/core/api/controller/v1/ExampleController.java) (Example API), [`core/core-api/src/main/java/io/dodn/springboot/core/domain/ExampleService.java`](https://github.com/team-dodn/spring-boot-java-template/blob/main/core/core-api/src/main/java/io/dodn/springboot/core/domain/ExampleService.java) (Example Service), [`core/core-api/src/main/java/io/dodn/springboot/core/domain/ExampleData.java`](https://github.com/team-dodn/spring-boot-java-template/blob/main/core/core-api/src/main/java/io/dodn/springboot/core/domain/ExampleData.java) (Domain Data), [`storage/db-core/src/main/java/io/dodn/springboot/storage/db/core/ExampleRepository.java`](https://github.com/team-dodn/spring-boot-java-template/blob/main/storage/db-core/src/main/java/io/dodn/springboot/storage/db/core/ExampleRepository.java) (JPA Repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Core API"]
  node_app["Executable App"]
  node_controller["Example API"]
  node_request["Request DTO"]
  node_health["Health API"]
  node_response_dto["Response DTOs"]
end

subgraph group_domain["Domain Example"]
  node_service["Example Service"]
  node_domain_data["Domain Data<br/>[ExampleData.java]"]
  node_domain_result["Domain Result<br/>[ExampleResult.java]"]
end

subgraph group_storage["Storage"]
  node_entity["Example Entity<br/>[ExampleEntity.java]"]
  node_base_entity["Entity Base<br/>[BaseEntity.java]"]
  node_repository["JPA Repository"]
  node_database[("MySQL")]
end

subgraph group_integrations["Integrations"]
  node_http_client["Feign Example Client<br/>[ExampleClient.java]"]
  node_logging["Logging Support"]
  node_monitoring["Monitoring Support"]
end

subgraph group_support["Shared Support"]
  node_api_response["API Envelope<br/>[ApiResponse.java]"]
  node_errors["Error Handling"]
  node_async_errors["Async Errors"]
  node_enums["Shared Enums<br/>[ExampleEnum.java]"]
end

node_caller(("API Caller"))
node_external_system(("External System"))

node_caller -->|"calls API"| node_controller
node_controller -->|"accepts"| node_request
node_controller -->|"calls"| node_service
node_controller -->|"creates"| node_domain_data
node_request -->|"converts to"| node_domain_data
node_service -->|"returns"| node_domain_result
node_service -->|"reads"| node_domain_data
node_controller -->|"builds"| node_response_dto
node_controller -->|"wraps result"| node_api_response
node_errors -->|"formats errors"| node_api_response
node_async_errors -.->|"logs exceptions"| node_errors
node_entity -->|"extends"| node_base_entity
node_repository -->|"repositories"| node_entity
node_repository -.->|"accesses"| node_database
node_http_client -.->|"communicates via HTTP"| node_external_system
node_app -.->|"serves API"| node_controller

click node_app "https://github.com/team-dodn/spring-boot-java-template/blob/main/core/core-api/src/main/java/io/dodn/springboot/CoreApiApplication.java"
click node_controller "https://github.com/team-dodn/spring-boot-java-template/blob/main/core/core-api/src/main/java/io/dodn/springboot/core/api/controller/v1/ExampleController.java"
click node_request "https://github.com/team-dodn/spring-boot-java-template/blob/main/core/core-api/src/main/java/io/dodn/springboot/core/api/controller/v1/request/ExampleRequestDto.java"
click node_health "https://github.com/team-dodn/spring-boot-java-template/blob/main/core/core-api/src/main/java/io/dodn/springboot/core/api/controller/HealthController.java"
click node_service "https://github.com/team-dodn/spring-boot-java-template/blob/main/core/core-api/src/main/java/io/dodn/springboot/core/domain/ExampleService.java"
click node_domain_data "https://github.com/team-dodn/spring-boot-java-template/blob/main/core/core-api/src/main/java/io/dodn/springboot/core/domain/ExampleData.java"
click node_domain_result "https://github.com/team-dodn/spring-boot-java-template/blob/main/core/core-api/src/main/java/io/dodn/springboot/core/domain/ExampleResult.java"
click node_response_dto "https://github.com/team-dodn/spring-boot-java-template/blob/main/core/core-api/src/main/java/io/dodn/springboot/core/api/controller/v1/response/ExampleResponseDto.java"
click node_api_response "https://github.com/team-dodn/spring-boot-java-template/blob/main/core/core-api/src/main/java/io/dodn/springboot/core/support/response/ApiResponse.java"
click node_errors "https://github.com/team-dodn/spring-boot-java-template/blob/main/core/core-api/src/main/java/io/dodn/springboot/core/api/controller/ApiControllerAdvice.java"
click node_async_errors "https://github.com/team-dodn/spring-boot-java-template/blob/main/core/core-api/src/main/java/io/dodn/springboot/core/api/config/AsyncExceptionHandler.java"
click node_enums "https://github.com/team-dodn/spring-boot-java-template/blob/main/core/core-enum/src/main/java/io/dodn/springboot/core/enums/ExampleEnum.java"
click node_entity "https://github.com/team-dodn/spring-boot-java-template/blob/main/storage/db-core/src/main/java/io/dodn/springboot/storage/db/core/ExampleEntity.java"
click node_base_entity "https://github.com/team-dodn/spring-boot-java-template/blob/main/storage/db-core/src/main/java/io/dodn/springboot/storage/db/core/BaseEntity.java"
click node_repository "https://github.com/team-dodn/spring-boot-java-template/blob/main/storage/db-core/src/main/java/io/dodn/springboot/storage/db/core/ExampleRepository.java"
click node_http_client "https://github.com/team-dodn/spring-boot-java-template/blob/main/clients/client-example/src/main/java/io/dodn/springboot/client/example/ExampleClient.java"
click node_logging "https://github.com/team-dodn/spring-boot-java-template/tree/main/support/logging"
click node_monitoring "https://github.com/team-dodn/spring-boot-java-template/tree/main/support/monitoring"

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_app,node_controller,node_request,node_health,node_response_dto toneBlue
class node_service,node_domain_data,node_domain_result toneAmber
class node_entity,node_base_entity,node_repository,node_database,node_caller toneMint
class node_http_client,node_logging,node_monitoring toneRose
class node_api_response,node_errors,node_async_errors,node_enums,node_external_system toneIndigo
```

## Components

### Core API

- [Executable App](https://github.com/team-dodn/spring-boot-java-template/blob/main/core/core-api/src/main/java/io/dodn/springboot/CoreApiApplication.java): `core/core-api/src/main/java/io/dodn/springboot/CoreApiApplication.java`
- [Example API](https://github.com/team-dodn/spring-boot-java-template/blob/main/core/core-api/src/main/java/io/dodn/springboot/core/api/controller/v1/ExampleController.java): `core/core-api/src/main/java/io/dodn/springboot/core/api/controller/v1/ExampleController.java`
- [Request DTO](https://github.com/team-dodn/spring-boot-java-template/blob/main/core/core-api/src/main/java/io/dodn/springboot/core/api/controller/v1/request/ExampleRequestDto.java): `core/core-api/src/main/java/io/dodn/springboot/core/api/controller/v1/request/ExampleRequestDto.java`
- [Health API](https://github.com/team-dodn/spring-boot-java-template/blob/main/core/core-api/src/main/java/io/dodn/springboot/core/api/controller/HealthController.java): `core/core-api/src/main/java/io/dodn/springboot/core/api/controller/HealthController.java`
- [Response DTOs](https://github.com/team-dodn/spring-boot-java-template/blob/main/core/core-api/src/main/java/io/dodn/springboot/core/api/controller/v1/response/ExampleResponseDto.java): `core/core-api/src/main/java/io/dodn/springboot/core/api/controller/v1/response/ExampleResponseDto.java`

### Domain Example

- [Example Service](https://github.com/team-dodn/spring-boot-java-template/blob/main/core/core-api/src/main/java/io/dodn/springboot/core/domain/ExampleService.java): `core/core-api/src/main/java/io/dodn/springboot/core/domain/ExampleService.java`
- [Domain Data](https://github.com/team-dodn/spring-boot-java-template/blob/main/core/core-api/src/main/java/io/dodn/springboot/core/domain/ExampleData.java): `core/core-api/src/main/java/io/dodn/springboot/core/domain/ExampleData.java`
- [Domain Result](https://github.com/team-dodn/spring-boot-java-template/blob/main/core/core-api/src/main/java/io/dodn/springboot/core/domain/ExampleResult.java): `core/core-api/src/main/java/io/dodn/springboot/core/domain/ExampleResult.java`

### Storage

- [Example Entity](https://github.com/team-dodn/spring-boot-java-template/blob/main/storage/db-core/src/main/java/io/dodn/springboot/storage/db/core/ExampleEntity.java): `storage/db-core/src/main/java/io/dodn/springboot/storage/db/core/ExampleEntity.java`
- [Entity Base](https://github.com/team-dodn/spring-boot-java-template/blob/main/storage/db-core/src/main/java/io/dodn/springboot/storage/db/core/BaseEntity.java): `storage/db-core/src/main/java/io/dodn/springboot/storage/db/core/BaseEntity.java`
- [JPA Repository](https://github.com/team-dodn/spring-boot-java-template/blob/main/storage/db-core/src/main/java/io/dodn/springboot/storage/db/core/ExampleRepository.java): `storage/db-core/src/main/java/io/dodn/springboot/storage/db/core/ExampleRepository.java`
- **MySQL**

### Integrations

- [Feign Example Client](https://github.com/team-dodn/spring-boot-java-template/blob/main/clients/client-example/src/main/java/io/dodn/springboot/client/example/ExampleClient.java): `clients/client-example/src/main/java/io/dodn/springboot/client/example/ExampleClient.java`
- [Logging Support](https://github.com/team-dodn/spring-boot-java-template/tree/main/support/logging): `support/logging`
- [Monitoring Support](https://github.com/team-dodn/spring-boot-java-template/tree/main/support/monitoring): `support/monitoring`

### Shared Support

- [API Envelope](https://github.com/team-dodn/spring-boot-java-template/blob/main/core/core-api/src/main/java/io/dodn/springboot/core/support/response/ApiResponse.java): `core/core-api/src/main/java/io/dodn/springboot/core/support/response/ApiResponse.java`
- [Error Handling](https://github.com/team-dodn/spring-boot-java-template/blob/main/core/core-api/src/main/java/io/dodn/springboot/core/api/controller/ApiControllerAdvice.java): `core/core-api/src/main/java/io/dodn/springboot/core/api/controller/ApiControllerAdvice.java`
- [Async Errors](https://github.com/team-dodn/spring-boot-java-template/blob/main/core/core-api/src/main/java/io/dodn/springboot/core/api/config/AsyncExceptionHandler.java): `core/core-api/src/main/java/io/dodn/springboot/core/api/config/AsyncExceptionHandler.java`
- [Shared Enums](https://github.com/team-dodn/spring-boot-java-template/blob/main/core/core-enum/src/main/java/io/dodn/springboot/core/enums/ExampleEnum.java): `core/core-enum/src/main/java/io/dodn/springboot/core/enums/ExampleEnum.java`

### Other components

- **API Caller**
- **External System**

## Connections

- API Caller → Example API: calls API (evidence: `README.md`)
- Example API → Request DTO: accepts (evidence: `core/core-api/src/main/java/io/dodn/springboot/core/api/controller/v1/ExampleController.java`)
- Example API → Example Service: calls (evidence: `core/core-api/src/main/java/io/dodn/springboot/core/api/controller/v1/ExampleController.java`)
- Example API → Domain Data: creates (evidence: `core/core-api/src/main/java/io/dodn/springboot/core/api/controller/v1/ExampleController.java`)
- Request DTO → Domain Data: converts to (evidence: `core/core-api/src/main/java/io/dodn/springboot/core/api/controller/v1/request/ExampleRequestDto.java`)
- Example Service → Domain Result: returns (evidence: `core/core-api/src/main/java/io/dodn/springboot/core/domain/ExampleService.java`)
- Example Service → Domain Data: reads (evidence: `core/core-api/src/main/java/io/dodn/springboot/core/domain/ExampleService.java`)
- Example API → Response DTOs: builds (evidence: `core/core-api/src/main/java/io/dodn/springboot/core/api/controller/v1/ExampleController.java`)
- Example API → API Envelope: wraps result (evidence: `core/core-api/src/main/java/io/dodn/springboot/core/api/controller/v1/ExampleController.java`)
- Error Handling → API Envelope: formats errors (evidence: `core/core-api/src/main/java/io/dodn/springboot/core/api/controller/ApiControllerAdvice.java`)
- Async Errors → Error Handling: logs exceptions
- Example Entity → Entity Base: extends (evidence: `storage/db-core/src/main/java/io/dodn/springboot/storage/db/core/ExampleEntity.java`)
- JPA Repository → Example Entity: repositories (evidence: `storage/db-core/src/main/java/io/dodn/springboot/storage/db/core/ExampleRepository.java`)
- JPA Repository → MySQL: accesses (evidence: `README.md`)
- Feign Example Client → External System: communicates via HTTP (evidence: `README.md`)
- Executable App → Example API: serves API (evidence: `README.md`)
