# alicanakkus/modular-architecture-hexagonal-demo-project architecture

> Architecture diagram of the GitHub repository alicanakkus/modular-architecture-hexagonal-demo-project, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/alicanakkus/modular-architecture-hexagonal-demo-project
- Repository: https://github.com/alicanakkus/modular-architecture-hexagonal-demo-project

## Overview

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: [`ticket-api/domain/src/main/java/com/hexagonaldemo/ticketapi/reservation/TicketReserveUseCaseHandler.java`](https://github.com/alicanakkus/modular-architecture-hexagonal-demo-project/blob/main/ticket-api/domain/src/main/java/com/hexagonaldemo/ticketapi/reservation/TicketReserveUseCaseHandler.java) (Ticket reservation), [`ticket-api/infra/src/main/java/com/hexagonaldemo/ticketapi/adapters`](https://github.com/alicanakkus/modular-architecture-hexagonal-demo-project/tree/main/ticket-api/infra/src/main/java/com/hexagonaldemo/ticketapi/adapters) (Ticket REST), [`payment-api/infra/src/main/java/com/hexagonaldemo/paymentapi/adapters`](https://github.com/alicanakkus/modular-architecture-hexagonal-demo-project/tree/main/payment-api/infra/src/main/java/com/hexagonaldemo/paymentapi/adapters) (Payment REST), [`ticket-api/infra/src/main/java/com/hexagonaldemo/ticketapi/adapters/ticket/jpa/TicketDataAdapter.java`](https://github.com/alicanakkus/modular-architecture-hexagonal-demo-project/blob/main/ticket-api/infra/src/main/java/com/hexagonaldemo/ticketapi/adapters/ticket/jpa/TicketDataAdapter.java) (Ticket storage adapter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ticket["Ticket API"]
  node_ticket_http["Ticket REST"]
end

subgraph group_payment["Payment API"]
  node_payment_http["Payment REST"]
end

subgraph group_domain["Domain logic"]
  node_meetup["Meetup management"]
  node_reservation["Ticket reservation"]
  node_ticket_retrieval["Ticket retrieval"]
  node_payment_create["Payment creation"]
  node_payment_rollback["Payment rollback"]
  node_balance["Balance operations"]
end

subgraph group_adapters["Integration adapters"]
  node_ticket_data["Ticket storage adapter"]
  node_meetup_data["Meetup storage adapter"]
  node_account_adapter["Account adapter"]
  node_payment_client["Payment client adapter"]
  node_ticket_events["Reservation events"]
  node_payment_events["Payment event adapters"]
  node_payment_data["Payment storage adapter"]
  node_balance_data["Balance storage adapter"]
  node_payment_stream["Payment event stream"]
  node_redis_lock["Account lock"]
end

node_client(("API client"))
node_kafka["Kafka"]
node_database[("Relational database")]

node_client -->|"calls API"| node_ticket_http
node_ticket_http -->|"dispatches reservation"| node_reservation
node_ticket_http -->|"dispatches retrieval"| node_ticket_retrieval
node_reservation -->|"retrieves account"| node_account_adapter
node_reservation -->|"retrieves meetup"| node_meetup_data
node_reservation -->|"requests payment"| node_payment_client
node_reservation -->|"creates ticket"| node_ticket_data
node_reservation -->|"publishes reservation"| node_ticket_events
node_reservation -->|"publishes rollback"| node_payment_events
node_ticket_retrieval -->|"retrieves tickets"| node_ticket_data
node_client -->|"calls API"| node_payment_http
node_payment_http -->|"dispatches payment"| node_payment_create
node_payment_http -->|"dispatches balance"| node_balance
node_balance -.->|"reads balance"| node_balance_data
node_payment_create -.->|"persists payment"| node_payment_data
node_payment_rollback -.->|"updates payment"| node_payment_data
node_payment_events -.->|"consumes events"| node_kafka
node_ticket_events -.->|"publishes events"| node_kafka
node_payment_stream -.->|"streams events"| node_kafka
node_payment_data -.->|"stores payment"| node_database
node_balance_data -.->|"stores balance"| node_database
node_ticket_data -.->|"stores tickets"| node_database
node_meetup_data -.->|"stores meetups"| node_database

click node_ticket_http "https://github.com/alicanakkus/modular-architecture-hexagonal-demo-project/tree/main/ticket-api/infra/src/main/java/com/hexagonaldemo/ticketapi/adapters"
click node_meetup "https://github.com/alicanakkus/modular-architecture-hexagonal-demo-project/tree/main/ticket-api/domain/src/main/java/com/hexagonaldemo/ticketapi/meetup"
click node_reservation "https://github.com/alicanakkus/modular-architecture-hexagonal-demo-project/blob/main/ticket-api/domain/src/main/java/com/hexagonaldemo/ticketapi/reservation/TicketReserveUseCaseHandler.java"
click node_ticket_retrieval "https://github.com/alicanakkus/modular-architecture-hexagonal-demo-project/blob/main/ticket-api/domain/src/main/java/com/hexagonaldemo/ticketapi/ticket/TicketRetrieveUseCaseHandler.java"
click node_ticket_data "https://github.com/alicanakkus/modular-architecture-hexagonal-demo-project/blob/main/ticket-api/infra/src/main/java/com/hexagonaldemo/ticketapi/adapters/ticket/jpa/TicketDataAdapter.java"
click node_meetup_data "https://github.com/alicanakkus/modular-architecture-hexagonal-demo-project/blob/main/ticket-api/infra/src/main/java/com/hexagonaldemo/ticketapi/adapters/meetup/jpa/MeetupDataAdapter.java"
click node_account_adapter "https://github.com/alicanakkus/modular-architecture-hexagonal-demo-project/blob/main/ticket-api/infra/src/main/java/com/hexagonaldemo/ticketapi/adapters/account/AccountFakeAdapter.java"
click node_payment_client "https://github.com/alicanakkus/modular-architecture-hexagonal-demo-project/blob/main/ticket-api/infra/src/main/java/com/hexagonaldemo/ticketapi/adapters/payment/rest/PaymentRestAdapter.java"
click node_ticket_events "https://github.com/alicanakkus/modular-architecture-hexagonal-demo-project/tree/main/ticket-api/infra/src/main/java/com/hexagonaldemo/ticketapi/adapters/reservation/event"
click node_payment_events "https://github.com/alicanakkus/modular-architecture-hexagonal-demo-project/tree/main/ticket-api/infra/src/main/java/com/hexagonaldemo/ticketapi/adapters/payment/event"
click node_payment_http "https://github.com/alicanakkus/modular-architecture-hexagonal-demo-project/tree/main/payment-api/infra/src/main/java/com/hexagonaldemo/paymentapi/adapters"
click node_payment_create "https://github.com/alicanakkus/modular-architecture-hexagonal-demo-project/blob/main/payment-api/domain/src/main/java/com/hexagonaldemo/paymentapi/payment/PaymentCreateUseCaseHandler.java"
click node_payment_rollback "https://github.com/alicanakkus/modular-architecture-hexagonal-demo-project/blob/main/payment-api/domain/src/main/java/com/hexagonaldemo/paymentapi/payment/PaymentRollbackUseCaseHandler.java"
click node_balance "https://github.com/alicanakkus/modular-architecture-hexagonal-demo-project/tree/main/payment-api/domain/src/main/java/com/hexagonaldemo/paymentapi/balance"
click node_payment_data "https://github.com/alicanakkus/modular-architecture-hexagonal-demo-project/blob/main/payment-api/infra/src/main/java/com/hexagonaldemo/paymentapi/adapters/payment/jpa/PaymentDataAdapter.java"
click node_balance_data "https://github.com/alicanakkus/modular-architecture-hexagonal-demo-project/blob/main/payment-api/infra/src/main/java/com/hexagonaldemo/paymentapi/adapters/balance/jpa/BalanceDataAdapter.java"
click node_payment_stream "https://github.com/alicanakkus/modular-architecture-hexagonal-demo-project/blob/main/payment-api/infra/src/main/java/com/hexagonaldemo/paymentapi/adapters/payment/event/PaymentEventKafkaStream.java"
click node_redis_lock "https://github.com/alicanakkus/modular-architecture-hexagonal-demo-project/blob/main/payment-api/infra/src/main/java/com/hexagonaldemo/paymentapi/adapters/account/lock/AccountLockRedisAdapter.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_ticket_http,node_client toneBlue
class node_payment_http,node_database toneAmber
class node_meetup,node_reservation,node_ticket_retrieval,node_payment_create,node_payment_rollback,node_balance toneMint
class node_ticket_data,node_meetup_data,node_account_adapter,node_payment_client,node_ticket_events,node_payment_events,node_payment_data,node_balance_data,node_payment_stream,node_redis_lock toneRose
class node_kafka toneIndigo
```

## Components

### Ticket API

- [Ticket REST](https://github.com/alicanakkus/modular-architecture-hexagonal-demo-project/tree/main/ticket-api/infra/src/main/java/com/hexagonaldemo/ticketapi/adapters): `ticket-api/infra/src/main/java/com/hexagonaldemo/ticketapi/adapters`

### Payment API

- [Payment REST](https://github.com/alicanakkus/modular-architecture-hexagonal-demo-project/tree/main/payment-api/infra/src/main/java/com/hexagonaldemo/paymentapi/adapters): `payment-api/infra/src/main/java/com/hexagonaldemo/paymentapi/adapters`

### Domain logic

- [Meetup management](https://github.com/alicanakkus/modular-architecture-hexagonal-demo-project/tree/main/ticket-api/domain/src/main/java/com/hexagonaldemo/ticketapi/meetup): `ticket-api/domain/src/main/java/com/hexagonaldemo/ticketapi/meetup`
- [Ticket reservation](https://github.com/alicanakkus/modular-architecture-hexagonal-demo-project/blob/main/ticket-api/domain/src/main/java/com/hexagonaldemo/ticketapi/reservation/TicketReserveUseCaseHandler.java): `ticket-api/domain/src/main/java/com/hexagonaldemo/ticketapi/reservation/TicketReserveUseCaseHandler.java`
- [Ticket retrieval](https://github.com/alicanakkus/modular-architecture-hexagonal-demo-project/blob/main/ticket-api/domain/src/main/java/com/hexagonaldemo/ticketapi/ticket/TicketRetrieveUseCaseHandler.java): `ticket-api/domain/src/main/java/com/hexagonaldemo/ticketapi/ticket/TicketRetrieveUseCaseHandler.java`
- [Payment creation](https://github.com/alicanakkus/modular-architecture-hexagonal-demo-project/blob/main/payment-api/domain/src/main/java/com/hexagonaldemo/paymentapi/payment/PaymentCreateUseCaseHandler.java): `payment-api/domain/src/main/java/com/hexagonaldemo/paymentapi/payment/PaymentCreateUseCaseHandler.java`
- [Payment rollback](https://github.com/alicanakkus/modular-architecture-hexagonal-demo-project/blob/main/payment-api/domain/src/main/java/com/hexagonaldemo/paymentapi/payment/PaymentRollbackUseCaseHandler.java): `payment-api/domain/src/main/java/com/hexagonaldemo/paymentapi/payment/PaymentRollbackUseCaseHandler.java`
- [Balance operations](https://github.com/alicanakkus/modular-architecture-hexagonal-demo-project/tree/main/payment-api/domain/src/main/java/com/hexagonaldemo/paymentapi/balance): `payment-api/domain/src/main/java/com/hexagonaldemo/paymentapi/balance`

### Integration adapters

- [Ticket storage adapter](https://github.com/alicanakkus/modular-architecture-hexagonal-demo-project/blob/main/ticket-api/infra/src/main/java/com/hexagonaldemo/ticketapi/adapters/ticket/jpa/TicketDataAdapter.java): `ticket-api/infra/src/main/java/com/hexagonaldemo/ticketapi/adapters/ticket/jpa/TicketDataAdapter.java`
- [Meetup storage adapter](https://github.com/alicanakkus/modular-architecture-hexagonal-demo-project/blob/main/ticket-api/infra/src/main/java/com/hexagonaldemo/ticketapi/adapters/meetup/jpa/MeetupDataAdapter.java): `ticket-api/infra/src/main/java/com/hexagonaldemo/ticketapi/adapters/meetup/jpa/MeetupDataAdapter.java`
- [Account adapter](https://github.com/alicanakkus/modular-architecture-hexagonal-demo-project/blob/main/ticket-api/infra/src/main/java/com/hexagonaldemo/ticketapi/adapters/account/AccountFakeAdapter.java): `ticket-api/infra/src/main/java/com/hexagonaldemo/ticketapi/adapters/account/AccountFakeAdapter.java`
- [Payment client adapter](https://github.com/alicanakkus/modular-architecture-hexagonal-demo-project/blob/main/ticket-api/infra/src/main/java/com/hexagonaldemo/ticketapi/adapters/payment/rest/PaymentRestAdapter.java): `ticket-api/infra/src/main/java/com/hexagonaldemo/ticketapi/adapters/payment/rest/PaymentRestAdapter.java`
- [Reservation events](https://github.com/alicanakkus/modular-architecture-hexagonal-demo-project/tree/main/ticket-api/infra/src/main/java/com/hexagonaldemo/ticketapi/adapters/reservation/event): `ticket-api/infra/src/main/java/com/hexagonaldemo/ticketapi/adapters/reservation/event`
- [Payment event adapters](https://github.com/alicanakkus/modular-architecture-hexagonal-demo-project/tree/main/ticket-api/infra/src/main/java/com/hexagonaldemo/ticketapi/adapters/payment/event): `ticket-api/infra/src/main/java/com/hexagonaldemo/ticketapi/adapters/payment/event`
- [Payment storage adapter](https://github.com/alicanakkus/modular-architecture-hexagonal-demo-project/blob/main/payment-api/infra/src/main/java/com/hexagonaldemo/paymentapi/adapters/payment/jpa/PaymentDataAdapter.java): `payment-api/infra/src/main/java/com/hexagonaldemo/paymentapi/adapters/payment/jpa/PaymentDataAdapter.java`
- [Balance storage adapter](https://github.com/alicanakkus/modular-architecture-hexagonal-demo-project/blob/main/payment-api/infra/src/main/java/com/hexagonaldemo/paymentapi/adapters/balance/jpa/BalanceDataAdapter.java): `payment-api/infra/src/main/java/com/hexagonaldemo/paymentapi/adapters/balance/jpa/BalanceDataAdapter.java`
- [Payment event stream](https://github.com/alicanakkus/modular-architecture-hexagonal-demo-project/blob/main/payment-api/infra/src/main/java/com/hexagonaldemo/paymentapi/adapters/payment/event/PaymentEventKafkaStream.java): `payment-api/infra/src/main/java/com/hexagonaldemo/paymentapi/adapters/payment/event/PaymentEventKafkaStream.java`
- [Account lock](https://github.com/alicanakkus/modular-architecture-hexagonal-demo-project/blob/main/payment-api/infra/src/main/java/com/hexagonaldemo/paymentapi/adapters/account/lock/AccountLockRedisAdapter.java): `payment-api/infra/src/main/java/com/hexagonaldemo/paymentapi/adapters/account/lock/AccountLockRedisAdapter.java`

### Other components

- **API client**
- **Kafka**
- **Relational database**

## Connections

- API client → Ticket REST: calls API (evidence: `README.md`)
- Ticket REST → Ticket reservation: dispatches reservation (evidence: `ticket-api/infra/src/main/java/com/hexagonaldemo/ticketapi/adapters/reservation/rest/ReservationController.java`)
- Ticket REST → Ticket retrieval: dispatches retrieval (evidence: `ticket-api/infra/src/main/java/com/hexagonaldemo/ticketapi/adapters/ticket/rest/TicketController.java`)
- Ticket reservation → Account adapter: retrieves account (evidence: `ticket-api/domain/src/main/java/com/hexagonaldemo/ticketapi/reservation/TicketReserveUseCaseHandler.java`)
- Ticket reservation → Meetup storage adapter: retrieves meetup (evidence: `ticket-api/domain/src/main/java/com/hexagonaldemo/ticketapi/reservation/TicketReserveUseCaseHandler.java`)
- Ticket reservation → Payment client adapter: requests payment (evidence: `ticket-api/domain/src/main/java/com/hexagonaldemo/ticketapi/reservation/TicketReserveUseCaseHandler.java`)
- Ticket reservation → Ticket storage adapter: creates ticket (evidence: `ticket-api/domain/src/main/java/com/hexagonaldemo/ticketapi/reservation/TicketReserveUseCaseHandler.java`)
- Ticket reservation → Reservation events: publishes reservation (evidence: `ticket-api/domain/src/main/java/com/hexagonaldemo/ticketapi/reservation/TicketReserveUseCaseHandler.java`)
- Ticket reservation → Payment event adapters: publishes rollback (evidence: `ticket-api/domain/src/main/java/com/hexagonaldemo/ticketapi/reservation/TicketReserveUseCaseHandler.java`)
- Ticket retrieval → Ticket storage adapter: retrieves tickets (evidence: `ticket-api/domain/src/main/java/com/hexagonaldemo/ticketapi/ticket/TicketRetrieveUseCaseHandler.java`)
- API client → Payment REST: calls API (evidence: `README.md`)
- Payment REST → Payment creation: dispatches payment (evidence: `payment-api/infra/src/main/java/com/hexagonaldemo/paymentapi/adapters/payment/rest/PaymentController.java`)
- Payment REST → Balance operations: dispatches balance (evidence: `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
