# enescelebii/microservice-e-commerce-app architecture

> Architecture diagram of the GitHub repository enescelebii/microservice-e-commerce-app, 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/enescelebii/microservice-e-commerce-app
- Repository: https://github.com/enescelebii/microservice-e-commerce-app

## Overview

This is a Spring Boot e-commerce microservices system. A client enters through the secured API Gateway; order creation coordinates customer lookup, product purchase, payment, order-line persistence, and an order-confirmation event. Payment processing also emits a payment event; notifications consume events, send email, and retain history. The graph includes catalog, customer, order, payment, and platform capabilities documented in the README. Some wiring is documented rather than shown in sampled code, so those links cite the README; unsampled implementation details are not inferred.

Main entry points: [`services/gateway/src/main/java/com/vena/gateway/GatewayApplication.java`](https://github.com/enescelebii/microservice-e-commerce-app/blob/master/services/gateway/src/main/java/com/vena/gateway/GatewayApplication.java) (API Gateway), [`services/order/src/main/java/com/vena/order/order/OrderService.java`](https://github.com/enescelebii/microservice-e-commerce-app/blob/master/services/order/src/main/java/com/vena/order/order/OrderService.java) (Order lifecycle), [`services/payment/src/main/java/com/vena/payment/payment/PaymentService.java`](https://github.com/enescelebii/microservice-e-commerce-app/blob/master/services/payment/src/main/java/com/vena/payment/payment/PaymentService.java) (Payment processing), [`services/notification/src/main/java/com/vena/notification/kafka/NotificationConsumer.java`](https://github.com/enescelebii/microservice-e-commerce-app/blob/master/services/notification/src/main/java/com/vena/notification/kafka/NotificationConsumer.java) (Notification consumer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["API access"]
  node_gateway["API Gateway"]
  node_security["Gateway security"]
  node_keycloak["Keycloak"]
end

subgraph group_commerce["Commerce domains"]
  node_customer_api["Customer API"]
  node_customer_service["Customer management"]
  node_product_api["Product API"]
  node_product_service["Catalog and stock"]
  node_order_api["Order API"]
  node_order_service["Order lifecycle<br/>[OrderService.java]"]
  node_order_lines["Order lines"]
  node_payment_api["Payment API"]
  node_payment_service["Payment processing"]
end

subgraph group_messaging["Events and notifications"]
  node_kafka["Kafka event bus"]
  node_order_producer["Order event producer<br/>[OrderProducer.java]"]
  node_payment_producer["Payment event producer"]
  node_notification_consumer["Notification consumer"]
  node_email["Email delivery<br/>[EmailService.java]"]
  node_smtp["SMTP service"]
end

subgraph group_platform["Platform services"]
  node_discovery["Service discovery"]
  node_config["Configuration server"]
  node_zipkin["Distributed tracing"]
end

subgraph group_state["Persistence"]
  node_customer_db[("Customer MongoDB")]
  node_product_db[("Product PostgreSQL")]
  node_order_db[("Order PostgreSQL")]
  node_payment_db[("Payment PostgreSQL")]
  node_notification_db[("Notification MongoDB")]
end

node_client(("API client"))

node_client -->|"sends requests"| node_gateway
node_gateway -->|"enforces access"| node_security
node_security -->|"authenticates with"| node_keycloak
node_gateway -->|"routes requests"| node_customer_api
node_gateway -->|"routes requests"| node_product_api
node_gateway -->|"routes requests"| node_order_api
node_gateway -->|"routes requests"| node_payment_api
node_customer_api -->|"delegates to"| node_customer_service
node_customer_service -->|"reads and writes"| node_customer_db
node_product_api -->|"delegates to"| node_product_service
node_product_service -->|"reads and updates stock"| node_product_db
node_order_api -->|"delegates to"| node_order_service
node_order_service -->|"looks up customer"| node_customer_api
node_order_service -->|"purchases products"| node_product_api
node_order_service -->|"saves order lines"| node_order_lines
node_order_service -->|"requests payment"| node_payment_api
node_order_service -->|"persists orders"| node_order_db
node_order_service -->|"publishes confirmation"| node_order_producer
node_order_producer -->|"sends event"| node_kafka
node_payment_api -->|"delegates to"| node_payment_service
node_payment_service -->|"persists payment"| node_payment_db
node_payment_service -->|"requests notification"| node_payment_producer
node_payment_producer -->|"sends event"| node_kafka
node_kafka -->|"dispatches events"| node_notification_consumer
node_notification_consumer -->|"sends email"| node_email
node_notification_consumer -->|"records history"| node_notification_db
node_email -->|"delivers mail"| node_smtp
node_discovery -.->|"supports routing"| node_gateway
node_config -.->|"provides configuration"| node_gateway
node_zipkin -.->|"traces requests"| node_gateway

click node_gateway "https://github.com/enescelebii/microservice-e-commerce-app/blob/master/services/gateway/src/main/java/com/vena/gateway/GatewayApplication.java"
click node_security "https://github.com/enescelebii/microservice-e-commerce-app/blob/master/services/gateway/src/main/java/com/vena/gateway/security/SecurityConfig.java"
click node_customer_api "https://github.com/enescelebii/microservice-e-commerce-app/blob/master/services/customer/src/main/java/com/vena/ecommerce/controller/CustomerController.java"
click node_customer_service "https://github.com/enescelebii/microservice-e-commerce-app/blob/master/services/customer/src/main/java/com/vena/ecommerce/service/CustomerService.java"
click node_product_api "https://github.com/enescelebii/microservice-e-commerce-app/blob/master/services/product/src/main/java/com/vena/ecommerce/product/controller/ProductController.java"
click node_product_service "https://github.com/enescelebii/microservice-e-commerce-app/blob/master/services/product/src/main/java/com/vena/ecommerce/product/service/ProductService.java"
click node_order_api "https://github.com/enescelebii/microservice-e-commerce-app/blob/master/services/order/src/main/java/com/vena/order/order/OrderController.java"
click node_order_service "https://github.com/enescelebii/microservice-e-commerce-app/blob/master/services/order/src/main/java/com/vena/order/order/OrderService.java"
click node_order_lines "https://github.com/enescelebii/microservice-e-commerce-app/blob/master/services/order/src/main/java/com/vena/order/orderLine/OrderLineService.java"
click node_payment_api "https://github.com/enescelebii/microservice-e-commerce-app/blob/master/services/payment/src/main/java/com/vena/payment/payment/PaymentController.java"
click node_payment_service "https://github.com/enescelebii/microservice-e-commerce-app/blob/master/services/payment/src/main/java/com/vena/payment/payment/PaymentService.java"
click node_order_producer "https://github.com/enescelebii/microservice-e-commerce-app/blob/master/services/order/src/main/java/com/vena/order/kafka/OrderProducer.java"
click node_payment_producer "https://github.com/enescelebii/microservice-e-commerce-app/blob/master/services/payment/src/main/java/com/vena/payment/notification/NotificationProducer.java"
click node_notification_consumer "https://github.com/enescelebii/microservice-e-commerce-app/blob/master/services/notification/src/main/java/com/vena/notification/kafka/NotificationConsumer.java"
click node_email "https://github.com/enescelebii/microservice-e-commerce-app/blob/master/services/notification/src/main/java/com/vena/notification/email/EmailService.java"
click node_discovery "https://github.com/enescelebii/microservice-e-commerce-app/blob/master/services/discovery/src/main/java/com/vena/discovery/DiscoveryApplication.java"
click node_config "https://github.com/enescelebii/microservice-e-commerce-app/blob/master/services/config-server/src/main/java/com/vena/config_server/ConfigServerApplication.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_security,node_keycloak,node_client toneBlue
class node_customer_api,node_customer_service,node_product_api,node_product_service,node_order_api,node_order_service,node_order_lines,node_payment_api,node_payment_service toneAmber
class node_kafka,node_order_producer,node_payment_producer,node_notification_consumer,node_email,node_smtp toneMint
class node_discovery,node_config,node_zipkin toneRose
class node_customer_db,node_product_db,node_order_db,node_payment_db,node_notification_db toneIndigo
```

## Components

### API access

- [API Gateway](https://github.com/enescelebii/microservice-e-commerce-app/blob/master/services/gateway/src/main/java/com/vena/gateway/GatewayApplication.java): `services/gateway/src/main/java/com/vena/gateway/GatewayApplication.java`
- [Gateway security](https://github.com/enescelebii/microservice-e-commerce-app/blob/master/services/gateway/src/main/java/com/vena/gateway/security/SecurityConfig.java): `services/gateway/src/main/java/com/vena/gateway/security/SecurityConfig.java`
- **Keycloak**

### Commerce domains

- [Customer API](https://github.com/enescelebii/microservice-e-commerce-app/blob/master/services/customer/src/main/java/com/vena/ecommerce/controller/CustomerController.java): `services/customer/src/main/java/com/vena/ecommerce/controller/CustomerController.java`
- [Customer management](https://github.com/enescelebii/microservice-e-commerce-app/blob/master/services/customer/src/main/java/com/vena/ecommerce/service/CustomerService.java): `services/customer/src/main/java/com/vena/ecommerce/service/CustomerService.java`
- [Product API](https://github.com/enescelebii/microservice-e-commerce-app/blob/master/services/product/src/main/java/com/vena/ecommerce/product/controller/ProductController.java): `services/product/src/main/java/com/vena/ecommerce/product/controller/ProductController.java`
- [Catalog and stock](https://github.com/enescelebii/microservice-e-commerce-app/blob/master/services/product/src/main/java/com/vena/ecommerce/product/service/ProductService.java): `services/product/src/main/java/com/vena/ecommerce/product/service/ProductService.java`
- [Order API](https://github.com/enescelebii/microservice-e-commerce-app/blob/master/services/order/src/main/java/com/vena/order/order/OrderController.java): `services/order/src/main/java/com/vena/order/order/OrderController.java`
- [Order lifecycle](https://github.com/enescelebii/microservice-e-commerce-app/blob/master/services/order/src/main/java/com/vena/order/order/OrderService.java): `services/order/src/main/java/com/vena/order/order/OrderService.java`
- [Order lines](https://github.com/enescelebii/microservice-e-commerce-app/blob/master/services/order/src/main/java/com/vena/order/orderLine/OrderLineService.java): `services/order/src/main/java/com/vena/order/orderLine/OrderLineService.java`
- [Payment API](https://github.com/enescelebii/microservice-e-commerce-app/blob/master/services/payment/src/main/java/com/vena/payment/payment/PaymentController.java): `services/payment/src/main/java/com/vena/payment/payment/PaymentController.java`
- [Payment processing](https://github.com/enescelebii/microservice-e-commerce-app/blob/master/services/payment/src/main/java/com/vena/payment/payment/PaymentService.java): `services/payment/src/main/java/com/vena/payment/payment/PaymentService.java`

### Events and notifications

- **Kafka event bus**
- [Order event producer](https://github.com/enescelebii/microservice-e-commerce-app/blob/master/services/order/src/main/java/com/vena/order/kafka/OrderProducer.java): `services/order/src/main/java/com/vena/order/kafka/OrderProducer.java`
- [Payment event producer](https://github.com/enescelebii/microservice-e-commerce-app/blob/master/services/payment/src/main/java/com/vena/payment/notification/NotificationProducer.java): `services/payment/src/main/java/com/vena/payment/notification/NotificationProducer.java`
- [Notification consumer](https://github.com/enescelebii/microservice-e-commerce-app/blob/master/services/notification/src/main/java/com/vena/notification/kafka/NotificationConsumer.java): `services/notification/src/main/java/com/vena/notification/kafka/NotificationConsumer.java`
- [Email delivery](https://github.com/enescelebii/microservice-e-commerce-app/blob/master/services/notification/src/main/java/com/vena/notification/email/EmailService.java): `services/notification/src/main/java/com/vena/notification/email/EmailService.java`
- **SMTP service**

### Platform services

- [Service discovery](https://github.com/enescelebii/microservice-e-commerce-app/blob/master/services/discovery/src/main/java/com/vena/discovery/DiscoveryApplication.java): `services/discovery/src/main/java/com/vena/discovery/DiscoveryApplication.java`
- [Configuration server](https://github.com/enescelebii/microservice-e-commerce-app/blob/master/services/config-server/src/main/java/com/vena/config_server/ConfigServerApplication.java): `services/config-server/src/main/java/com/vena/config_server/ConfigServerApplication.java`
- **Distributed tracing**

### Persistence

- **Customer MongoDB**
- **Product PostgreSQL**
- **Order PostgreSQL**
- **Payment PostgreSQL**
- **Notification MongoDB**

### Other components

- **API client**

## Connections

- API client → API Gateway: sends requests
- API Gateway → Gateway security: enforces access
- Gateway security → Keycloak: authenticates with
- API Gateway → Customer API: routes requests
- API Gateway → Product API: routes requests
- API Gateway → Order API: routes requests
- API Gateway → Payment API: routes requests
- Customer API → Customer management: delegates to (evidence: `services/customer/src/main/java/com/vena/ecommerce/controller/CustomerController.java`)
- Customer management → Customer MongoDB: reads and writes
- Product API → Catalog and stock: delegates to (evidence: `services/product/src/main/java/com/vena/ecommerce/product/controller/ProductController.java`)
- Catalog and stock → Product PostgreSQL: reads and updates stock (evidence: `services/product/src/main/java/com/vena/ecommerce/product/service/ProductService.java`)
- Order API → Order lifecycle: delegates to (evidence: `services/order/src/main/java/com/vena/order/order/OrderController.java`)
- Order lifecycle → Customer API: looks up customer (evidence: `services/order/src/main/java/com/vena/order/order/OrderService.java`)
- Order lifecycle → Product API: purchases products (evidence: `services/order/src/main/java/com/vena/order/order/OrderService.java`)
- Order lifecycle → Order lines: saves order lines (evidence: `services/order/src/main/java/com/vena/order/order/OrderService.java`)
- Order lifecycle → Payment API: requests payment (evidence: `services/order/src/main/java/com/vena/order/order/OrderService.java`)
- Order lifecycle → Order PostgreSQL: persists orders
- Order lifecycle → Order event producer: publishes confirmation (evidence: `services/order/src/main/java/com/vena/order/order/OrderService.java`)
- Order event producer → Kafka event bus: sends event
- Payment API → Payment processing: delegates to (evidence: `services/payment/src/main/java/com/vena/payment/payment/PaymentController.java`)
- Payment processing → Payment PostgreSQL: persists payment (evidence: `services/payment/src/main/java/com/vena/payment/payment/PaymentService.java`)
- Payment processing → Payment event producer: requests notification (evidence: `services/payment/src/main/java/com/vena/payment/payment/PaymentService.java`)
- Payment event producer → Kafka event bus: sends event
- Kafka event bus → Notification consumer: dispatches events
- Notification consumer → Email delivery: sends email (evidence: `services/notification/src/main/java/com/vena/notification/kafka/NotificationConsumer.java`)
- Notification consumer → Notification MongoDB: records history
- Email delivery → SMTP service: delivers mail (evidence: `services/notification/src/main/java/com/vena/notification/email/EmailService.java`)
- Service discovery → API Gateway: supports routing
- Configuration server → API Gateway: provides configuration
- Distributed tracing → API Gateway: traces requests
