# ahmedsaad123456/e-commerce-microservices architecture

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

- Interactive diagram: https://gitdiagram.com/ahmedsaad123456/e-commerce-microservices
- Repository: https://github.com/ahmedsaad123456/e-commerce-microservices

## Overview

This repository is a Spring Boot e-commerce microservices backend. A customer request enters through Nginx and the API Gateway; order creation validates the customer and purchases product stock before persisting an order. Kafka events then drive payment, order confirmation or compensation, while notifications are recorded and email is queued for delivery. The README also documents customer/product APIs, service discovery and centralized configuration, security, and observability. Relationships below follow README-documented behavior; source excerpts were unavailable, so implementation-level call paths are not asserted.

Main entry points: [`order-service/src/main/java/com/example/order_service/service/OrderService.java`](https://github.com/ahmedsaad123456/e-commerce-microservices/blob/main/order-service/src/main/java/com/example/order_service/service/OrderService.java) (Order workflow), [`gateway-service/src/main/java/com/example/gateway`](https://github.com/ahmedsaad123456/e-commerce-microservices/tree/main/gateway-service/src/main/java/com/example/gateway) (API Gateway), [`customer-service/src/main/java/com/example/customer`](https://github.com/ahmedsaad123456/e-commerce-microservices/tree/main/customer-service/src/main/java/com/example/customer) (Customer API), [`product-service/src/main`](https://github.com/ahmedsaad123456/e-commerce-microservices/tree/main/product-service/src/main) (Product and stock)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_edge["Ingress and platform"]
  node_nginx["Nginx balancer<br/>[nginx.conf]"]
  node_gateway["API Gateway"]
  node_config["Config Server"]
  node_discovery["Eureka discovery"]
  node_redis[("Redis")]
end

subgraph group_commerce["Commerce services"]
  node_customer["Customer API"]
  node_product["Product and stock"]
  node_postgres[("PostgreSQL")]
  node_mongodb[("MongoDB")]
end

subgraph group_saga["Order and payment saga"]
  node_order["Order workflow<br/>[OrderService.java]"]
  node_payment["Payment processing"]
  node_orderoutbox["Order outbox<br/>[OutboxRelay.java]"]
  node_paymentoutbox["Payment outbox<br/>[OutboxRelay.java]"]
  node_orderconsumer["Payment event consumer"]
end

subgraph group_messaging["Events and notifications"]
  node_kafka["Kafka"]
  node_rabbit["RabbitMQ"]
  node_notification["Notification service"]
  node_emailworker["Email worker<br/>[EmailWorker.java]"]
  node_maildev["MailDev"]
end

subgraph group_ops["Security and observability"]
  node_keycloak["Keycloak"]
  node_observability["Metrics and tracing<br/>[prometheus.yml]"]
end

node_shopper(("Customer"))

node_shopper -->|"sends requests"| node_nginx
node_nginx -->|"balances traffic"| node_gateway
node_gateway -->|"routes requests"| node_customer
node_gateway -->|"routes requests"| node_product
node_gateway -->|"routes requests"| node_order
node_order -->|"validates customer"| node_customer
node_order -->|"purchases stock"| node_product
node_customer -->|"stores profiles"| node_mongodb
node_product -->|"stores products"| node_postgres
node_product -->|"caches reads"| node_redis
node_order -->|"stores orders"| node_postgres
node_payment -->|"stores payments"| node_postgres
node_order -->|"records events"| node_orderoutbox
node_orderoutbox -->|"publishes events"| node_kafka
node_payment -->|"consumes order events"| node_kafka
node_payment -->|"records results"| node_paymentoutbox
node_paymentoutbox -->|"publishes results"| node_kafka
node_kafka -->|"delivers payment results"| node_orderconsumer
node_orderconsumer -->|"confirms or cancels"| node_order
node_order -->|"restores stock"| node_product
node_kafka -->|"delivers events"| node_notification
node_notification -->|"stores notifications"| node_mongodb
node_notification -->|"queues email jobs"| node_rabbit
node_rabbit -->|"delivers jobs"| node_emailworker
node_emailworker -->|"sends email"| node_maildev
node_config -->|"provides configuration"| node_customer
node_config -->|"provides configuration"| node_gateway
node_discovery -->|"resolves services"| node_gateway
node_gateway -->|"validates identity"| node_keycloak
node_customer -->|"secures APIs"| node_keycloak
node_gateway -->|"limits requests"| node_redis
node_order -->|"exposes telemetry"| node_observability

click node_nginx "https://github.com/ahmedsaad123456/e-commerce-microservices/blob/main/nginx/nginx.conf"
click node_gateway "https://github.com/ahmedsaad123456/e-commerce-microservices/tree/main/gateway-service/src/main/java/com/example/gateway"
click node_config "https://github.com/ahmedsaad123456/e-commerce-microservices/blob/main/config-server/src/main/java/com/example/config_server/ConfigServerApplication.java"
click node_discovery "https://github.com/ahmedsaad123456/e-commerce-microservices/blob/main/discovery-service/src/main/java/com/example/discovery/DiscoveryApplication.java"
click node_customer "https://github.com/ahmedsaad123456/e-commerce-microservices/tree/main/customer-service/src/main/java/com/example/customer"
click node_product "https://github.com/ahmedsaad123456/e-commerce-microservices/tree/main/product-service/src/main"
click node_order "https://github.com/ahmedsaad123456/e-commerce-microservices/blob/main/order-service/src/main/java/com/example/order_service/service/OrderService.java"
click node_payment "https://github.com/ahmedsaad123456/e-commerce-microservices/tree/main/payment-service/src/main/java/com/example/payment_service"
click node_orderoutbox "https://github.com/ahmedsaad123456/e-commerce-microservices/blob/main/order-service/src/main/java/com/example/order_service/outbox/OutboxRelay.java"
click node_paymentoutbox "https://github.com/ahmedsaad123456/e-commerce-microservices/blob/main/payment-service/src/main/java/com/example/payment_service/outbox/OutboxRelay.java"
click node_orderconsumer "https://github.com/ahmedsaad123456/e-commerce-microservices/blob/main/order-service/src/main/java/com/example/order_service/kafka/PaymentResultConsumer.java"
click node_notification "https://github.com/ahmedsaad123456/e-commerce-microservices/blob/main/notification-service/src/main/java/com/example/notification_service/service/NotificationService.java"
click node_emailworker "https://github.com/ahmedsaad123456/e-commerce-microservices/blob/main/notification-service/src/main/java/com/example/notification_service/rabbitmq/EmailWorker.java"
click node_observability "https://github.com/ahmedsaad123456/e-commerce-microservices/blob/main/docker/prometheus/prometheus.yml"

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_nginx,node_gateway,node_config,node_discovery,node_redis toneBlue
class node_customer,node_product,node_postgres,node_mongodb toneAmber
class node_order,node_payment,node_orderoutbox,node_paymentoutbox,node_orderconsumer toneMint
class node_kafka,node_rabbit,node_notification,node_emailworker,node_maildev toneRose
class node_keycloak,node_observability,node_shopper toneIndigo
```

## Components

### Ingress and platform

- [Nginx balancer](https://github.com/ahmedsaad123456/e-commerce-microservices/blob/main/nginx/nginx.conf): `nginx/nginx.conf`
- [API Gateway](https://github.com/ahmedsaad123456/e-commerce-microservices/tree/main/gateway-service/src/main/java/com/example/gateway): `gateway-service/src/main/java/com/example/gateway`
- [Config Server](https://github.com/ahmedsaad123456/e-commerce-microservices/blob/main/config-server/src/main/java/com/example/config_server/ConfigServerApplication.java): `config-server/src/main/java/com/example/config_server/ConfigServerApplication.java`
- [Eureka discovery](https://github.com/ahmedsaad123456/e-commerce-microservices/blob/main/discovery-service/src/main/java/com/example/discovery/DiscoveryApplication.java): `discovery-service/src/main/java/com/example/discovery/DiscoveryApplication.java`
- **Redis**

### Commerce services

- [Customer API](https://github.com/ahmedsaad123456/e-commerce-microservices/tree/main/customer-service/src/main/java/com/example/customer): `customer-service/src/main/java/com/example/customer`
- [Product and stock](https://github.com/ahmedsaad123456/e-commerce-microservices/tree/main/product-service/src/main): `product-service/src/main`
- **PostgreSQL**
- **MongoDB**

### Order and payment saga

- [Order workflow](https://github.com/ahmedsaad123456/e-commerce-microservices/blob/main/order-service/src/main/java/com/example/order_service/service/OrderService.java): `order-service/src/main/java/com/example/order_service/service/OrderService.java`
- [Payment processing](https://github.com/ahmedsaad123456/e-commerce-microservices/tree/main/payment-service/src/main/java/com/example/payment_service): `payment-service/src/main/java/com/example/payment_service`
- [Order outbox](https://github.com/ahmedsaad123456/e-commerce-microservices/blob/main/order-service/src/main/java/com/example/order_service/outbox/OutboxRelay.java): `order-service/src/main/java/com/example/order_service/outbox/OutboxRelay.java`
- [Payment outbox](https://github.com/ahmedsaad123456/e-commerce-microservices/blob/main/payment-service/src/main/java/com/example/payment_service/outbox/OutboxRelay.java): `payment-service/src/main/java/com/example/payment_service/outbox/OutboxRelay.java`
- [Payment event consumer](https://github.com/ahmedsaad123456/e-commerce-microservices/blob/main/order-service/src/main/java/com/example/order_service/kafka/PaymentResultConsumer.java): `order-service/src/main/java/com/example/order_service/kafka/PaymentResultConsumer.java`

### Events and notifications

- **Kafka**
- **RabbitMQ**
- [Notification service](https://github.com/ahmedsaad123456/e-commerce-microservices/blob/main/notification-service/src/main/java/com/example/notification_service/service/NotificationService.java): `notification-service/src/main/java/com/example/notification_service/service/NotificationService.java`
- [Email worker](https://github.com/ahmedsaad123456/e-commerce-microservices/blob/main/notification-service/src/main/java/com/example/notification_service/rabbitmq/EmailWorker.java): `notification-service/src/main/java/com/example/notification_service/rabbitmq/EmailWorker.java`
- **MailDev**

### Security and observability

- **Keycloak**
- [Metrics and tracing](https://github.com/ahmedsaad123456/e-commerce-microservices/blob/main/docker/prometheus/prometheus.yml): `docker/prometheus/prometheus.yml`

### Other components

- **Customer**

## Connections

- Customer → Nginx balancer: sends requests (evidence: `README.md`)
- Nginx balancer → API Gateway: balances traffic (evidence: `README.md`)
- API Gateway → Customer API: routes requests (evidence: `README.md`)
- API Gateway → Product and stock: routes requests (evidence: `README.md`)
- API Gateway → Order workflow: routes requests (evidence: `README.md`)
- Order workflow → Customer API: validates customer (evidence: `README.md`)
- Order workflow → Product and stock: purchases stock (evidence: `README.md`)
- Customer API → MongoDB: stores profiles (evidence: `README.md`)
- Product and stock → PostgreSQL: stores products (evidence: `README.md`)
- Product and stock → Redis: caches reads (evidence: `README.md`)
- Order workflow → PostgreSQL: stores orders (evidence: `README.md`)
- Payment processing → PostgreSQL: stores payments (evidence: `README.md`)
- Order workflow → Order outbox: records events (evidence: `README.md`)
- Order outbox → Kafka: publishes events (evidence: `README.md`)
- Payment processing → Kafka: consumes order events (evidence: `README.md`)
- Payment processing → Payment outbox: records results (evidence: `README.md`)
- Payment outbox → Kafka: publishes results (evidence: `README.md`)
- Kafka → Payment event consumer: delivers payment results (evidence: `README.md`)
- Payment event consumer → Order workflow: confirms or cancels (evidence: `README.md`)
- Order workflow → Product and stock: restores stock (evidence: `README.md`)
- Kafka → Notification service: delivers events (evidence: `README.md`)
- Notification service → MongoDB: stores notifications (evidence: `README.md`)
- Notification service → RabbitMQ: queues email jobs (evidence: `README.md`)
- RabbitMQ → Email worker: delivers jobs (evidence: `README.md`)
- Email worker → MailDev: sends email (evidence: `README.md`)
- Config Server → Customer API: provides configuration (evidence: `README.md`)
- Config Server → API Gateway: provides configuration (evidence: `README.md`)
- Eureka discovery → API Gateway: resolves services (evidence: `README.md`)
- API Gateway → Keycloak: validates identity (evidence: `README.md`)
- Customer API → Keycloak: secures APIs (evidence: `README.md`)
- API Gateway → Redis: limits requests (evidence: `README.md`)
- Order workflow → Metrics and tracing: exposes telemetry (evidence: `README.md`)
