# jamalnihal07/coffee-shop-microservices architecture

> Architecture diagram of the GitHub repository jamalnihal07/coffee-shop-microservices, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jamalnihal07/coffee-shop-microservices
- Repository: https://github.com/jamalnihal07/coffee-shop-microservices

## Overview

Coffee Shop is a Spring Boot microservices backend for identity, customer records, order fulfillment, and payments. The principal flow is a customer request through the gateway to create an order, followed by an order-created Kafka event, payment processing, and a payment-result event that advances or cancels the order; staff then progress paid orders through fulfillment. Separate branches cover Keycloak-backed user management, customer CRUD and rewards, read-only payment queries, and service discovery. The README documents routes and integrations; edges involving unsampled gateway, listener, and publisher wiring are shown only where documented.

Main entry points: [`api-gateway/src/main/java/com/coffeeshop/gateway/ApiGatewayApplication.java`](https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/api-gateway/src/main/java/com/coffeeshop/gateway/ApiGatewayApplication.java) (API gateway), [`order-service/src/main/java/com/coffeeshop/order/service/OrderService.java`](https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/order-service/src/main/java/com/coffeeshop/order/service/OrderService.java) (Order lifecycle and saga), [`payment-service/src/main/java/com/coffeeshop/payment/service/PaymentProcessor.java`](https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/payment-service/src/main/java/com/coffeeshop/payment/service/PaymentProcessor.java) (Payment processing), [`user-service/src/main/java/com/coffeeshop/user/service/UserService.java`](https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/user-service/src/main/java/com/coffeeshop/user/service/UserService.java) (User and token workflows)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_edge["API edge and discovery"]
  node_gateway["API gateway"]
  node_gateway_security["JWT and routes"]
  node_gateway_filters["Rate limit and logs"]
  node_registry["Eureka registry"]
end

subgraph group_identity["Identity and access"]
  node_keycloak["Keycloak"]
  node_user_api["User API"]
  node_user_logic["User and token workflows<br/>[UserService.java]"]
  node_keycloak_client["Identity provider client"]
  node_user_store[("User database")]
end

subgraph group_customer["Customer records"]
  node_customer_api["Customer API"]
  node_customer_logic["Customer CRUD and rewards"]
  node_customer_store[("Customer database")]
end

subgraph group_commerce["Orders and payments"]
  node_order_api["Order API"]
  node_order_logic["Order lifecycle and saga<br/>[OrderService.java]"]
  node_order_store[("Order database")]
  node_order_publish["Outbound event publisher"]
  node_payment_listener["Order-created listener"]
  node_payment_logic["Payment processing"]
  node_sim_gateway["Simulated payment gateway"]
  node_payment_store[("Payment database")]
  node_payment_api["Payment queries"]
  node_payment_events["Payment result events"]
  node_order_results["Payment result listener"]
end

node_frontend(("Frontend / clients"))
node_kafka["Kafka topics"]

node_frontend -->|"sends requests"| node_gateway
node_gateway -.->|"validates and routes"| node_gateway_security
node_gateway -.->|"limits and logs"| node_gateway_filters
node_gateway -.->|"discovers services"| node_registry
node_gateway -.->|"routes users"| node_user_api
node_gateway -.->|"routes customers"| node_customer_api
node_gateway -.->|"routes orders"| node_order_api
node_gateway -.->|"routes payments"| node_payment_api
node_user_api -->|"delegates to"| node_user_logic
node_user_logic -->|"calls identity provider"| node_keycloak_client
node_keycloak_client -->|"manages identities"| node_keycloak
node_user_logic -->|"reads and writes"| node_user_store
node_customer_api -->|"delegates to"| node_customer_logic
node_customer_logic -->|"reads and writes"| node_customer_store
node_customer_logic -->|"publishes customer-created"| node_kafka
node_order_api -->|"delegates to"| node_order_logic
node_order_logic -->|"reads and writes"| node_order_store
node_order_logic -->|"emits order events"| node_kafka
node_order_logic -.->|"publishes after commit"| node_order_publish
node_kafka -.->|"delivers order-created"| node_payment_listener
node_payment_listener -.->|"dispatches payment"| node_payment_logic
node_payment_logic -.->|"charges payment"| node_sim_gateway
node_payment_logic -.->|"records payment"| node_payment_store
node_payment_logic -.->|"publishes payment result"| node_kafka
node_kafka -.->|"delivers payment result"| node_order_results
node_order_results -.->|"advances or cancels"| node_order_logic
node_payment_api -->|"queries payments"| node_payment_store

click node_gateway "https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/api-gateway/src/main/java/com/coffeeshop/gateway/ApiGatewayApplication.java"
click node_gateway_security "https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/api-gateway/src/main/java/com/coffeeshop/gateway/config/SecurityConfig.java"
click node_gateway_filters "https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/api-gateway/src/main/java/com/coffeeshop/gateway/filter/RateLimitFilter.java"
click node_registry "https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/eureka-server/src/main/java/com/coffeeshop/eureka/EurekaServerApplication.java"
click node_user_api "https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/user-service/src/main/java/com/coffeeshop/user/web/UserController.java"
click node_user_logic "https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/user-service/src/main/java/com/coffeeshop/user/service/UserService.java"
click node_keycloak_client "https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/user-service/src/main/java/com/coffeeshop/user/keycloak/KeycloakClient.java"
click node_user_store "https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/user-service/src/main/java/com/coffeeshop/user/repo/UserRepository.java"
click node_customer_api "https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/customer-service/src/main/java/com/coffeeshop/customer/web/CustomerController.java"
click node_customer_logic "https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/customer-service/src/main/java/com/coffeeshop/customer/service/CustomerService.java"
click node_customer_store "https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/customer-service/src/main/java/com/coffeeshop/customer/repo/CustomerRepository.java"
click node_order_api "https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/order-service/src/main/java/com/coffeeshop/order/web/OrderController.java"
click node_order_logic "https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/order-service/src/main/java/com/coffeeshop/order/service/OrderService.java"
click node_order_store "https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/order-service/src/main/java/com/coffeeshop/order/repo/OrderRepository.java"
click node_order_publish "https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/order-service/src/main/java/com/coffeeshop/order/messaging/OutboundEventPublisher.java"
click node_payment_listener "https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/payment-service/src/main/java/com/coffeeshop/payment/messaging/OrderCreatedListener.java"
click node_payment_logic "https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/payment-service/src/main/java/com/coffeeshop/payment/service/PaymentProcessor.java"
click node_sim_gateway "https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/payment-service/src/main/java/com/coffeeshop/payment/service/SimulatedPaymentGateway.java"
click node_payment_store "https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/payment-service/src/main/java/com/coffeeshop/payment/repo/PaymentRepository.java"
click node_payment_api "https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/payment-service/src/main/java/com/coffeeshop/payment/web/PaymentController.java"
click node_payment_events "https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/payment-service/src/main/java/com/coffeeshop/payment/messaging/OrderCreatedListener.java"
click node_order_results "https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/order-service/src/main/java/com/coffeeshop/order/messaging/PaymentResultListener.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_gateway,node_gateway_security,node_gateway_filters,node_registry,node_frontend toneBlue
class node_keycloak,node_user_api,node_user_logic,node_keycloak_client,node_user_store toneAmber
class node_customer_api,node_customer_logic,node_customer_store toneMint
class node_order_api,node_order_logic,node_order_store,node_order_publish,node_payment_listener,node_payment_logic,node_sim_gateway,node_payment_store,node_payment_api,node_payment_events,node_order_results toneRose
class node_kafka toneIndigo
```

## Components

### API edge and discovery

- [API gateway](https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/api-gateway/src/main/java/com/coffeeshop/gateway/ApiGatewayApplication.java): `api-gateway/src/main/java/com/coffeeshop/gateway/ApiGatewayApplication.java`
- [JWT and routes](https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/api-gateway/src/main/java/com/coffeeshop/gateway/config/SecurityConfig.java): `api-gateway/src/main/java/com/coffeeshop/gateway/config/SecurityConfig.java`
- [Rate limit and logs](https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/api-gateway/src/main/java/com/coffeeshop/gateway/filter/RateLimitFilter.java): `api-gateway/src/main/java/com/coffeeshop/gateway/filter/RateLimitFilter.java`
- [Eureka registry](https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/eureka-server/src/main/java/com/coffeeshop/eureka/EurekaServerApplication.java): `eureka-server/src/main/java/com/coffeeshop/eureka/EurekaServerApplication.java`

### Identity and access

- **Keycloak**
- [User API](https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/user-service/src/main/java/com/coffeeshop/user/web/UserController.java): `user-service/src/main/java/com/coffeeshop/user/web/UserController.java`
- [User and token workflows](https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/user-service/src/main/java/com/coffeeshop/user/service/UserService.java): `user-service/src/main/java/com/coffeeshop/user/service/UserService.java`
- [Identity provider client](https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/user-service/src/main/java/com/coffeeshop/user/keycloak/KeycloakClient.java): `user-service/src/main/java/com/coffeeshop/user/keycloak/KeycloakClient.java`
- [User database](https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/user-service/src/main/java/com/coffeeshop/user/repo/UserRepository.java): `user-service/src/main/java/com/coffeeshop/user/repo/UserRepository.java`

### Customer records

- [Customer API](https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/customer-service/src/main/java/com/coffeeshop/customer/web/CustomerController.java): `customer-service/src/main/java/com/coffeeshop/customer/web/CustomerController.java`
- [Customer CRUD and rewards](https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/customer-service/src/main/java/com/coffeeshop/customer/service/CustomerService.java): `customer-service/src/main/java/com/coffeeshop/customer/service/CustomerService.java`
- [Customer database](https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/customer-service/src/main/java/com/coffeeshop/customer/repo/CustomerRepository.java): `customer-service/src/main/java/com/coffeeshop/customer/repo/CustomerRepository.java`

### Orders and payments

- [Order API](https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/order-service/src/main/java/com/coffeeshop/order/web/OrderController.java): `order-service/src/main/java/com/coffeeshop/order/web/OrderController.java`
- [Order lifecycle and saga](https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/order-service/src/main/java/com/coffeeshop/order/service/OrderService.java): `order-service/src/main/java/com/coffeeshop/order/service/OrderService.java`
- [Order database](https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/order-service/src/main/java/com/coffeeshop/order/repo/OrderRepository.java): `order-service/src/main/java/com/coffeeshop/order/repo/OrderRepository.java`
- [Outbound event publisher](https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/order-service/src/main/java/com/coffeeshop/order/messaging/OutboundEventPublisher.java): `order-service/src/main/java/com/coffeeshop/order/messaging/OutboundEventPublisher.java`
- [Order-created listener](https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/payment-service/src/main/java/com/coffeeshop/payment/messaging/OrderCreatedListener.java): `payment-service/src/main/java/com/coffeeshop/payment/messaging/OrderCreatedListener.java`
- [Payment processing](https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/payment-service/src/main/java/com/coffeeshop/payment/service/PaymentProcessor.java): `payment-service/src/main/java/com/coffeeshop/payment/service/PaymentProcessor.java`
- [Simulated payment gateway](https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/payment-service/src/main/java/com/coffeeshop/payment/service/SimulatedPaymentGateway.java): `payment-service/src/main/java/com/coffeeshop/payment/service/SimulatedPaymentGateway.java`
- [Payment database](https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/payment-service/src/main/java/com/coffeeshop/payment/repo/PaymentRepository.java): `payment-service/src/main/java/com/coffeeshop/payment/repo/PaymentRepository.java`
- [Payment queries](https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/payment-service/src/main/java/com/coffeeshop/payment/web/PaymentController.java): `payment-service/src/main/java/com/coffeeshop/payment/web/PaymentController.java`
- [Payment result events](https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/payment-service/src/main/java/com/coffeeshop/payment/messaging/OrderCreatedListener.java): `payment-service/src/main/java/com/coffeeshop/payment/messaging/OrderCreatedListener.java`
- [Payment result listener](https://github.com/jamalnihal07/coffee-shop-microservices/blob/main/order-service/src/main/java/com/coffeeshop/order/messaging/PaymentResultListener.java): `order-service/src/main/java/com/coffeeshop/order/messaging/PaymentResultListener.java`

### Other components

- **Frontend / clients**
- **Kafka topics**

## Connections

- Frontend / clients → API gateway: sends requests (evidence: `README.md`)
- API gateway → JWT and routes: validates and routes (evidence: `README.md`)
- API gateway → Rate limit and logs: limits and logs (evidence: `README.md`)
- API gateway → Eureka registry: discovers services (evidence: `README.md`)
- API gateway → User API: routes users (evidence: `README.md`)
- API gateway → Customer API: routes customers (evidence: `README.md`)
- API gateway → Order API: routes orders (evidence: `README.md`)
- API gateway → Payment queries: routes payments (evidence: `README.md`)
- User API → User and token workflows: delegates to (evidence: `user-service/src/main/java/com/coffeeshop/user/web/UserController.java`)
- User and token workflows → Identity provider client: calls identity provider (evidence: `user-service/src/main/java/com/coffeeshop/user/service/UserService.java`)
- Identity provider client → Keycloak: manages identities (evidence: `user-service/src/main/java/com/coffeeshop/user/keycloak/KeycloakClient.java`)
- User and token workflows → User database: reads and writes (evidence: `user-service/src/main/java/com/coffeeshop/user/service/UserService.java`)
- Customer API → Customer CRUD and rewards: delegates to (evidence: `customer-service/src/main/java/com/coffeeshop/customer/web/CustomerController.java`)
- Customer CRUD and rewards → Customer database: reads and writes (evidence: `customer-service/src/main/java/com/coffeeshop/customer/service/CustomerService.java`)
- Customer CRUD and rewards → Kafka topics: publishes customer-created (evidence: `customer-service/src/main/java/com/coffeeshop/customer/service/CustomerService.java`)
- Order API → Order lifecycle and saga: delegates to (evidence: `order-service/src/main/java/com/coffeeshop/order/web/OrderController.java`)
- Order lifecycle and saga → Order database: reads and writes (evidence: `order-service/src/main/java/com/coffeeshop/order/service/OrderService.java`)
- Order lifecycle and saga → Kafka topics: emits order events (evidence: `README.md`)
- Order lifecycle and saga → Outbound event publisher: publishes after commit (evidence: `README.md`)
- Kafka topics → Order-created listener: delivers order-created (evidence: `README.md`)
- Order-created listener → Payment processing: dispatches payment (evidence: `README.md`)
- Payment processing → Simulated payment gateway: charges payment (evidence: `README.md`)
- Payment processing → Payment database: records payment (evidence: `README.md`)
- Payment processing → Kafka topics: publishes payment result (evidence: `README.md`)
- Kafka topics → Payment result listener: delivers payment result (evidence: `README.md`)
- Payment result listener → Order lifecycle and saga: advances or cancels (evidence: `README.md`)
- Payment queries → Payment database: queries payments (evidence: `payment-service/src/main/java/com/coffeeshop/payment/web/PaymentController.java`)
