How sandokandias/spring-boot-ddd works
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: PaymentController.java Payment controller · Payment.java Payment aggregate · PaymentEventRepositoryImpl.java Event repository · PaymentEventRepository.java Event repository contract
Components 17
REST interface
- Payment controller
src/main/java/com/github/sandokandias/payments/interfaces/rest/controller/PaymentController.java - Exception handler
src/main/java/com/github/sandokandias/payments/interfaces/rest/controller/DefaultExceptionHandler.java - Payment response
src/main/java/com/github/sandokandias/payments/interfaces/rest/model/PerformPaymentResponse.java
Application orchestration
- Process manager
src/main/java/com/github/sandokandias/payments/application/impl/PaymentProcessManagerImpl.java
Payment domain
- Payment aggregate
src/main/java/com/github/sandokandias/payments/domain/entity/Payment.java - Request handler
src/main/java/com/github/sandokandias/payments/domain/command/handler/PerformPaymentHandler.java - Request validation
src/main/java/com/github/sandokandias/payments/domain/command/validation/PerformPaymentValidator.java - Authorization handler
src/main/java/com/github/sandokandias/payments/domain/command/handler/AuthorizePaymentHandler.java - Authorization validation
src/main/java/com/github/sandokandias/payments/domain/command/validation/AuthorizePaymentValidator.java - Confirmation handler
src/main/java/com/github/sandokandias/payments/domain/command/handler/ConfirmPaymentHandler.java - Event repository contract
src/main/java/com/github/sandokandias/payments/domain/entity/PaymentEventRepository.java
Persistence support
- Event repository
src/main/java/com/github/sandokandias/payments/infrastructure/persistence/repository/PaymentEventRepositoryImpl.java - Event store
src/main/java/com/github/sandokandias/payments/infrastructure/persistence/repository/EventStore.java - Event table mapping
src/main/java/com/github/sandokandias/payments/infrastructure/persistence/mapping/PaymentEventTable.java - JSON mapper
src/main/java/com/github/sandokandias/payments/infrastructure/util/json/JsonMapper.java - Messages and codes
src/main/java/com/github/sandokandias/payments/infrastructure/util/i18n/I18nMessage.java
Other components
- API client
Connections 21
- 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