# sandokandias/spring-boot-ddd architecture

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

- Interactive diagram: https://gitdiagram.com/sandokandias/spring-boot-ddd
- Repository: https://github.com/sandokandias/spring-boot-ddd

## Overview

This is a Spring Boot payment-processing service with a REST entry point and a DDD-style application/domain split. Its principal workflow accepts a payment request, validates and records a request event, authorizes it, and either returns an authorized status or confirms it and returns a captured status. The domain handlers persist payment events through an infrastructure repository and event store. The tree and README also identify persistence, serialization, validation, and i18n support; handler dispatch details beyond the sampled code are not asserted.

Main entry points: [`src/main/java/com/github/sandokandias/payments/interfaces/rest/controller/PaymentController.java`](https://github.com/sandokandias/spring-boot-ddd/blob/master/src/main/java/com/github/sandokandias/payments/interfaces/rest/controller/PaymentController.java) (Payment controller), [`src/main/java/com/github/sandokandias/payments/domain/entity/Payment.java`](https://github.com/sandokandias/spring-boot-ddd/blob/master/src/main/java/com/github/sandokandias/payments/domain/entity/Payment.java) (Payment aggregate), [`src/main/java/com/github/sandokandias/payments/infrastructure/persistence/repository/PaymentEventRepositoryImpl.java`](https://github.com/sandokandias/spring-boot-ddd/blob/master/src/main/java/com/github/sandokandias/payments/infrastructure/persistence/repository/PaymentEventRepositoryImpl.java) (Event repository), [`src/main/java/com/github/sandokandias/payments/domain/entity/PaymentEventRepository.java`](https://github.com/sandokandias/spring-boot-ddd/blob/master/src/main/java/com/github/sandokandias/payments/domain/entity/PaymentEventRepository.java) (Event repository contract)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["REST interface"]
  node_controller["Payment controller"]
  node_errorhandler["Exception handler"]
  node_response["Payment response"]
end

subgraph group_application["Application orchestration"]
  node_manager["Process manager"]
end

subgraph group_domain["Payment domain"]
  node_aggregate["Payment aggregate<br/>[Payment.java]"]
  node_requesthandler["Request handler"]
  node_requestvalidator["Request validation"]
  node_authorizehandler["Authorization handler"]
  node_authorizevalidator["Authorization validation"]
  node_confirmhandler["Confirmation handler"]
  node_paymentrepository["Event repository contract"]
end

subgraph group_infrastructure["Persistence support"]
  node_repositoryimpl["Event repository"]
  node_eventstore[("Event store<br/>[EventStore.java]")]
  node_table["Event table mapping"]
  node_json["JSON mapper<br/>[JsonMapper.java]"]
  node_i18n["Messages and codes<br/>[I18nMessage.java]"]
end

node_client(("API client"))

node_client -->|"submits request"| node_controller
node_controller -->|"processes command"| node_manager
node_manager -->|"handles commands"| node_aggregate
node_aggregate -->|"dispatches request"| node_requesthandler
node_aggregate -->|"dispatches authorization"| node_authorizehandler
node_aggregate -->|"dispatches confirmation"| node_confirmhandler
node_requesthandler -->|"validates"| node_requestvalidator
node_authorizehandler -->|"validates"| node_authorizevalidator
node_requesthandler -->|"stores request event"| node_paymentrepository
node_authorizehandler -->|"stores authorization"| node_paymentrepository
node_confirmhandler -->|"stores confirmation"| node_paymentrepository
node_paymentrepository -->|"implemented by"| node_repositoryimpl
node_repositoryimpl -->|"serializes event"| node_json
node_repositoryimpl -->|"maps event"| node_table
node_repositoryimpl -->|"saves record"| node_eventstore
node_manager -->|"returns outcome"| node_controller
node_controller -->|"builds success body"| node_response
node_controller -->|"returns HTTP response"| node_client
node_controller -->|"validation errors"| node_errorhandler
node_errorhandler -->|"formats messages"| node_i18n
node_errorhandler -->|"returns error"| node_client

click node_controller "https://github.com/sandokandias/spring-boot-ddd/blob/master/src/main/java/com/github/sandokandias/payments/interfaces/rest/controller/PaymentController.java"
click node_errorhandler "https://github.com/sandokandias/spring-boot-ddd/blob/master/src/main/java/com/github/sandokandias/payments/interfaces/rest/controller/DefaultExceptionHandler.java"
click node_manager "https://github.com/sandokandias/spring-boot-ddd/blob/master/src/main/java/com/github/sandokandias/payments/application/impl/PaymentProcessManagerImpl.java"
click node_aggregate "https://github.com/sandokandias/spring-boot-ddd/blob/master/src/main/java/com/github/sandokandias/payments/domain/entity/Payment.java"
click node_requesthandler "https://github.com/sandokandias/spring-boot-ddd/blob/master/src/main/java/com/github/sandokandias/payments/domain/command/handler/PerformPaymentHandler.java"
click node_requestvalidator "https://github.com/sandokandias/spring-boot-ddd/blob/master/src/main/java/com/github/sandokandias/payments/domain/command/validation/PerformPaymentValidator.java"
click node_authorizehandler "https://github.com/sandokandias/spring-boot-ddd/blob/master/src/main/java/com/github/sandokandias/payments/domain/command/handler/AuthorizePaymentHandler.java"
click node_authorizevalidator "https://github.com/sandokandias/spring-boot-ddd/blob/master/src/main/java/com/github/sandokandias/payments/domain/command/validation/AuthorizePaymentValidator.java"
click node_confirmhandler "https://github.com/sandokandias/spring-boot-ddd/blob/master/src/main/java/com/github/sandokandias/payments/domain/command/handler/ConfirmPaymentHandler.java"
click node_paymentrepository "https://github.com/sandokandias/spring-boot-ddd/blob/master/src/main/java/com/github/sandokandias/payments/domain/entity/PaymentEventRepository.java"
click node_repositoryimpl "https://github.com/sandokandias/spring-boot-ddd/blob/master/src/main/java/com/github/sandokandias/payments/infrastructure/persistence/repository/PaymentEventRepositoryImpl.java"
click node_eventstore "https://github.com/sandokandias/spring-boot-ddd/blob/master/src/main/java/com/github/sandokandias/payments/infrastructure/persistence/repository/EventStore.java"
click node_table "https://github.com/sandokandias/spring-boot-ddd/blob/master/src/main/java/com/github/sandokandias/payments/infrastructure/persistence/mapping/PaymentEventTable.java"
click node_json "https://github.com/sandokandias/spring-boot-ddd/blob/master/src/main/java/com/github/sandokandias/payments/infrastructure/util/json/JsonMapper.java"
click node_i18n "https://github.com/sandokandias/spring-boot-ddd/blob/master/src/main/java/com/github/sandokandias/payments/infrastructure/util/i18n/I18nMessage.java"
click node_response "https://github.com/sandokandias/spring-boot-ddd/blob/master/src/main/java/com/github/sandokandias/payments/interfaces/rest/model/PerformPaymentResponse.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_controller,node_errorhandler,node_response,node_client toneBlue
class node_manager toneAmber
class node_aggregate,node_requesthandler,node_requestvalidator,node_authorizehandler,node_authorizevalidator,node_confirmhandler,node_paymentrepository toneMint
class node_repositoryimpl,node_eventstore,node_table,node_json,node_i18n toneRose
```

## Components

### REST interface

- [Payment controller](https://github.com/sandokandias/spring-boot-ddd/blob/master/src/main/java/com/github/sandokandias/payments/interfaces/rest/controller/PaymentController.java): `src/main/java/com/github/sandokandias/payments/interfaces/rest/controller/PaymentController.java`
- [Exception handler](https://github.com/sandokandias/spring-boot-ddd/blob/master/src/main/java/com/github/sandokandias/payments/interfaces/rest/controller/DefaultExceptionHandler.java): `src/main/java/com/github/sandokandias/payments/interfaces/rest/controller/DefaultExceptionHandler.java`
- [Payment response](https://github.com/sandokandias/spring-boot-ddd/blob/master/src/main/java/com/github/sandokandias/payments/interfaces/rest/model/PerformPaymentResponse.java): `src/main/java/com/github/sandokandias/payments/interfaces/rest/model/PerformPaymentResponse.java`

### Application orchestration

- [Process manager](https://github.com/sandokandias/spring-boot-ddd/blob/master/src/main/java/com/github/sandokandias/payments/application/impl/PaymentProcessManagerImpl.java): `src/main/java/com/github/sandokandias/payments/application/impl/PaymentProcessManagerImpl.java`

### Payment domain

- [Payment aggregate](https://github.com/sandokandias/spring-boot-ddd/blob/master/src/main/java/com/github/sandokandias/payments/domain/entity/Payment.java): `src/main/java/com/github/sandokandias/payments/domain/entity/Payment.java`
- [Request handler](https://github.com/sandokandias/spring-boot-ddd/blob/master/src/main/java/com/github/sandokandias/payments/domain/command/handler/PerformPaymentHandler.java): `src/main/java/com/github/sandokandias/payments/domain/command/handler/PerformPaymentHandler.java`
- [Request validation](https://github.com/sandokandias/spring-boot-ddd/blob/master/src/main/java/com/github/sandokandias/payments/domain/command/validation/PerformPaymentValidator.java): `src/main/java/com/github/sandokandias/payments/domain/command/validation/PerformPaymentValidator.java`
- [Authorization handler](https://github.com/sandokandias/spring-boot-ddd/blob/master/src/main/java/com/github/sandokandias/payments/domain/command/handler/AuthorizePaymentHandler.java): `src/main/java/com/github/sandokandias/payments/domain/command/handler/AuthorizePaymentHandler.java`
- [Authorization validation](https://github.com/sandokandias/spring-boot-ddd/blob/master/src/main/java/com/github/sandokandias/payments/domain/command/validation/AuthorizePaymentValidator.java): `src/main/java/com/github/sandokandias/payments/domain/command/validation/AuthorizePaymentValidator.java`
- [Confirmation handler](https://github.com/sandokandias/spring-boot-ddd/blob/master/src/main/java/com/github/sandokandias/payments/domain/command/handler/ConfirmPaymentHandler.java): `src/main/java/com/github/sandokandias/payments/domain/command/handler/ConfirmPaymentHandler.java`
- [Event repository contract](https://github.com/sandokandias/spring-boot-ddd/blob/master/src/main/java/com/github/sandokandias/payments/domain/entity/PaymentEventRepository.java): `src/main/java/com/github/sandokandias/payments/domain/entity/PaymentEventRepository.java`

### Persistence support

- [Event repository](https://github.com/sandokandias/spring-boot-ddd/blob/master/src/main/java/com/github/sandokandias/payments/infrastructure/persistence/repository/PaymentEventRepositoryImpl.java): `src/main/java/com/github/sandokandias/payments/infrastructure/persistence/repository/PaymentEventRepositoryImpl.java`
- [Event store](https://github.com/sandokandias/spring-boot-ddd/blob/master/src/main/java/com/github/sandokandias/payments/infrastructure/persistence/repository/EventStore.java): `src/main/java/com/github/sandokandias/payments/infrastructure/persistence/repository/EventStore.java`
- [Event table mapping](https://github.com/sandokandias/spring-boot-ddd/blob/master/src/main/java/com/github/sandokandias/payments/infrastructure/persistence/mapping/PaymentEventTable.java): `src/main/java/com/github/sandokandias/payments/infrastructure/persistence/mapping/PaymentEventTable.java`
- [JSON mapper](https://github.com/sandokandias/spring-boot-ddd/blob/master/src/main/java/com/github/sandokandias/payments/infrastructure/util/json/JsonMapper.java): `src/main/java/com/github/sandokandias/payments/infrastructure/util/json/JsonMapper.java`
- [Messages and codes](https://github.com/sandokandias/spring-boot-ddd/blob/master/src/main/java/com/github/sandokandias/payments/infrastructure/util/i18n/I18nMessage.java): `src/main/java/com/github/sandokandias/payments/infrastructure/util/i18n/I18nMessage.java`

### Other components

- **API client**

## Connections

- API client → Payment controller: submits request
- Payment controller → Process manager: processes command
- Process manager → Payment aggregate: handles commands
- Payment aggregate → Request handler: dispatches request
- Payment aggregate → Authorization handler: dispatches authorization
- Payment aggregate → Confirmation handler: dispatches confirmation
- Request handler → Request validation: validates
- Authorization handler → Authorization validation: validates
- Request handler → Event repository contract: stores request event
- Authorization handler → Event repository contract: stores authorization
- Confirmation handler → Event repository contract: stores confirmation
- Event repository contract → Event repository: implemented by
- Event repository → JSON mapper: serializes event
- Event repository → Event table mapping: maps event
- Event repository → Event store: saves record
- Process manager → Payment controller: returns outcome
- Payment controller → Payment response: builds success body
- Payment controller → API client: returns HTTP response
- Payment controller → Exception handler: validation errors
- Exception handler → Messages and codes: formats messages
- Exception handler → API client: returns error
