How alicanakkus/modular-architecture-hexagonal-demo-project works
The repository demonstrates two Spring Boot microservices using ports-and-adapters architecture: Ticket API manages meetups, ticket retrieval and purchase/reservation; Payment API manages payments and account balances. A ticket reservation handler coordinates account and meetup lookup, payment, ticket creation, and notification or rollback. The graph includes the major storage and event-adapter capabilities visible in the tree, but their runtime wiring is not shown in the excerpts, so those links are omitted. Several domain stages are represented by their exact enclosing directories because their implementations were not sampled.
Main entry points: TicketReserveUseCaseHandler.java Ticket reservation · ticketapi/adapters Ticket REST · paymentapi/adapters Payment REST · TicketDataAdapter.java Ticket storage adapter
Components 21
Ticket API
- Ticket REST
ticket-api/infra/src/main/java/com/hexagonaldemo/ticketapi/adapters
Payment API
- Payment REST
payment-api/infra/src/main/java/com/hexagonaldemo/paymentapi/adapters
Domain logic
- Meetup management
ticket-api/domain/src/main/java/com/hexagonaldemo/ticketapi/meetup - Ticket reservation
ticket-api/domain/src/main/java/com/hexagonaldemo/ticketapi/reservation/TicketReserveUseCaseHandler.java - Ticket retrieval
ticket-api/domain/src/main/java/com/hexagonaldemo/ticketapi/ticket/TicketRetrieveUseCaseHandler.java - Payment creation
payment-api/domain/src/main/java/com/hexagonaldemo/paymentapi/payment/PaymentCreateUseCaseHandler.java - Payment rollback
payment-api/domain/src/main/java/com/hexagonaldemo/paymentapi/payment/PaymentRollbackUseCaseHandler.java - Balance operations
payment-api/domain/src/main/java/com/hexagonaldemo/paymentapi/balance
Integration adapters
- Ticket storage adapter
ticket-api/infra/src/main/java/com/hexagonaldemo/ticketapi/adapters/ticket/jpa/TicketDataAdapter.java - Meetup storage adapter
ticket-api/infra/src/main/java/com/hexagonaldemo/ticketapi/adapters/meetup/jpa/MeetupDataAdapter.java - Account adapter
ticket-api/infra/src/main/java/com/hexagonaldemo/ticketapi/adapters/account/AccountFakeAdapter.java - Payment client adapter
ticket-api/infra/src/main/java/com/hexagonaldemo/ticketapi/adapters/payment/rest/PaymentRestAdapter.java - Reservation events
ticket-api/infra/src/main/java/com/hexagonaldemo/ticketapi/adapters/reservation/event - Payment event adapters
ticket-api/infra/src/main/java/com/hexagonaldemo/ticketapi/adapters/payment/event - Payment storage adapter
payment-api/infra/src/main/java/com/hexagonaldemo/paymentapi/adapters/payment/jpa/PaymentDataAdapter.java - Balance storage adapter
payment-api/infra/src/main/java/com/hexagonaldemo/paymentapi/adapters/balance/jpa/BalanceDataAdapter.java - Payment event stream
payment-api/infra/src/main/java/com/hexagonaldemo/paymentapi/adapters/payment/event/PaymentEventKafkaStream.java - Account lock
payment-api/infra/src/main/java/com/hexagonaldemo/paymentapi/adapters/account/lock/AccountLockRedisAdapter.java
Other components
- API client
- Kafka
- Relational database
Connections 23
- API client → Ticket REST: calls API
README.md - Ticket REST → Ticket reservation: dispatches reservation
ticket-api/infra/src/main/java/com/hexagonaldemo/ticketapi/adapters/reservation/rest/ReservationController.java - Ticket REST → Ticket retrieval: dispatches retrieval
ticket-api/infra/src/main/java/com/hexagonaldemo/ticketapi/adapters/ticket/rest/TicketController.java - Ticket reservation → Account adapter: retrieves account
ticket-api/domain/src/main/java/com/hexagonaldemo/ticketapi/reservation/TicketReserveUseCaseHandler.java - Ticket reservation → Meetup storage adapter: retrieves meetup
ticket-api/domain/src/main/java/com/hexagonaldemo/ticketapi/reservation/TicketReserveUseCaseHandler.java - Ticket reservation → Payment client adapter: requests payment
ticket-api/domain/src/main/java/com/hexagonaldemo/ticketapi/reservation/TicketReserveUseCaseHandler.java - Ticket reservation → Ticket storage adapter: creates ticket
ticket-api/domain/src/main/java/com/hexagonaldemo/ticketapi/reservation/TicketReserveUseCaseHandler.java - Ticket reservation → Reservation events: publishes reservation
ticket-api/domain/src/main/java/com/hexagonaldemo/ticketapi/reservation/TicketReserveUseCaseHandler.java - Ticket reservation → Payment event adapters: publishes rollback
ticket-api/domain/src/main/java/com/hexagonaldemo/ticketapi/reservation/TicketReserveUseCaseHandler.java - Ticket retrieval → Ticket storage adapter: retrieves tickets
ticket-api/domain/src/main/java/com/hexagonaldemo/ticketapi/ticket/TicketRetrieveUseCaseHandler.java - API client → Payment REST: calls API
README.md - Payment REST → Payment creation: dispatches payment
payment-api/infra/src/main/java/com/hexagonaldemo/paymentapi/adapters/payment/rest/PaymentController.java - Payment REST → Balance operations: dispatches balance
payment-api/infra/src/main/java/com/hexagonaldemo/paymentapi/adapters/balance/rest/BalanceController.java - Balance operations → Balance storage adapter: reads balance
- Payment creation → Payment storage adapter: persists payment
- Payment rollback → Payment storage adapter: updates payment
- Payment event adapters → Kafka: consumes events
- Reservation events → Kafka: publishes events
- Payment event stream → Kafka: streams events
- Payment storage adapter → Relational database: stores payment
- Balance storage adapter → Relational database: stores balance
- Ticket storage adapter → Relational database: stores tickets
- Meetup storage adapter → Relational database: stores meetups