# kevmenea/ecommerce-microservices architecture

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

- Interactive diagram: https://gitdiagram.com/kevmenea/ecommerce-microservices
- Repository: https://github.com/kevmenea/ecommerce-microservices

## Overview

This is a Java/Spring e-commerce microservices backend. Its principal workflow accepts an order, calculates and persists order state, reserves inventory, and records an order-created event through an outbox; inventory also supports warehouse, stock, reservation, and movement operations. Product catalog and user registration/profile services are separate capabilities. The README documents gateway, service discovery/configuration, security, Kafka, and distributed-transaction patterns, but their detailed wiring is not shown in the excerpts, so those links are marked unverified or omitted.

Main entry points: [`apigateway/src/main/java/com/meneabank/apigateway/ApigatewayApplication.java`](https://github.com/kevmenea/ecommerce-microservices/blob/main/apigateway/src/main/java/com/meneabank/apigateway/ApigatewayApplication.java) (API gateway), [`inventory-service/src/main/java/com/ecommerce/inventory/inventory_service/application/InventoryApplicationService.java`](https://github.com/kevmenea/ecommerce-microservices/blob/main/inventory-service/src/main/java/com/ecommerce/inventory/inventory_service/application/InventoryApplicationService.java) (Inventory application), [`order-service/src/main/java/com/ecommerce/order_service/application/OrderApplicationService.java`](https://github.com/kevmenea/ecommerce-microservices/blob/main/order-service/src/main/java/com/ecommerce/order_service/application/OrderApplicationService.java) (Order orchestration), [`configserver/src/main/java/com/ecommerce/configserver/ConfigserverApplication.java`](https://github.com/kevmenea/ecommerce-microservices/blob/main/configserver/src/main/java/com/ecommerce/configserver/ConfigserverApplication.java) (Configuration server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_edge["Entry and platform"]
  node_gateway{{"API gateway"}}
  node_security["Gateway security"]
  node_discovery{{"Service discovery"}}
  node_configuration["Configuration server"]
end

subgraph group_orders["Order lifecycle"]
  node_orderapi["Order API"]
  node_orderflow["Order orchestration"]
  node_inventoryclient["Inventory client"]
  node_outbox["Outbox service<br/>[OutboxService.java]"]
  node_outboxstore[("Outbox records")]
  node_eventpublisher["Outbox publisher"]
  node_kafka["Kafka events"]
end

subgraph group_stock["Inventory operations"]
  node_inventoryapi["Inventory API"]
  node_warehouseapi["Warehouse API"]
  node_reservationapi["Reservation API"]
  node_stockflow["Inventory application"]
  node_stockdomain["Stock domain<br/>[Inventory.java]"]
  node_stockdata[("Inventory repositories")]
end

subgraph group_catalog["Catalog and identity"]
  node_productapi["Product API"]
  node_productflow["Product service"]
  node_productdata[("Product repository")]
  node_userapi["User API"]
  node_userflow["User service"]
  node_userdata[("User repository")]
end

node_shopper(("API client"))

node_shopper -.->|"sends requests"| node_gateway
node_gateway -.->|"applies security"| node_security
node_gateway -.->|"routes requests"| node_orderapi
node_gateway -.->|"routes requests"| node_inventoryapi
node_gateway -.->|"routes requests"| node_productapi
node_gateway -.->|"routes requests"| node_userapi
node_orderapi -->|"delegates to"| node_orderflow
node_orderflow -->|"calls reservations"| node_inventoryclient
node_inventoryclient -.->|"requests stock"| node_reservationapi
node_orderflow -->|"saves event"| node_outbox
node_outbox -->|"persists event"| node_outboxstore
node_eventpublisher -.->|"reads events"| node_outboxstore
node_eventpublisher -.->|"publishes events"| node_kafka
node_inventoryapi -->|"delegates to"| node_stockflow
node_warehouseapi -->|"delegates to"| node_stockflow
node_reservationapi -.->|"delegates to"| node_stockflow
node_stockflow -->|"uses repositories"| node_stockdata
node_stockflow -->|"updates stock"| node_stockdomain
node_productapi -->|"delegates to"| node_productflow
node_productflow -->|"reads and writes"| node_productdata
node_userapi -->|"delegates to"| node_userflow
node_userflow -->|"reads and writes"| node_userdata
node_configuration -.->|"configures service"| node_gateway
node_configuration -.->|"configures service"| node_orderflow
node_discovery -.->|"registers services"| node_gateway

click node_gateway "https://github.com/kevmenea/ecommerce-microservices/blob/main/apigateway/src/main/java/com/meneabank/apigateway/ApigatewayApplication.java"
click node_security "https://github.com/kevmenea/ecommerce-microservices/blob/main/apigateway/src/main/java/com/meneabank/apigateway/config/SecurityConfig.java"
click node_discovery "https://github.com/kevmenea/ecommerce-microservices/blob/main/eureka-server/src/main/java/com/meneabank/eureka_server/EurekaServerApplication.java"
click node_configuration "https://github.com/kevmenea/ecommerce-microservices/blob/main/configserver/src/main/java/com/ecommerce/configserver/ConfigserverApplication.java"
click node_orderapi "https://github.com/kevmenea/ecommerce-microservices/blob/main/order-service/src/main/java/com/ecommerce/order_service/api/OrderController.java"
click node_orderflow "https://github.com/kevmenea/ecommerce-microservices/blob/main/order-service/src/main/java/com/ecommerce/order_service/application/OrderApplicationService.java"
click node_inventoryclient "https://github.com/kevmenea/ecommerce-microservices/blob/main/order-service/src/main/java/com/ecommerce/order_service/client/inventory/InventoryReservationClient.java"
click node_outbox "https://github.com/kevmenea/ecommerce-microservices/blob/main/order-service/src/main/java/com/ecommerce/order_service/outbox/OutboxService.java"
click node_outboxstore "https://github.com/kevmenea/ecommerce-microservices/blob/main/order-service/src/main/java/com/ecommerce/order_service/outbox/OutboxEventRepository.java"
click node_eventpublisher "https://github.com/kevmenea/ecommerce-microservices/blob/main/order-service/src/main/java/com/ecommerce/order_service/outbox/OutboxPublisher.java"
click node_inventoryapi "https://github.com/kevmenea/ecommerce-microservices/blob/main/inventory-service/src/main/java/com/ecommerce/inventory/inventory_service/api/InventoryController.java"
click node_warehouseapi "https://github.com/kevmenea/ecommerce-microservices/blob/main/inventory-service/src/main/java/com/ecommerce/inventory/inventory_service/api/WarehouseController.java"
click node_reservationapi "https://github.com/kevmenea/ecommerce-microservices/blob/main/inventory-service/src/main/java/com/ecommerce/inventory/inventory_service/api/ReservationController.java"
click node_stockflow "https://github.com/kevmenea/ecommerce-microservices/blob/main/inventory-service/src/main/java/com/ecommerce/inventory/inventory_service/application/InventoryApplicationService.java"
click node_stockdomain "https://github.com/kevmenea/ecommerce-microservices/blob/main/inventory-service/src/main/java/com/ecommerce/inventory/inventory_service/domain/Inventory.java"
click node_stockdata "https://github.com/kevmenea/ecommerce-microservices/blob/main/inventory-service/src/main/java/com/ecommerce/inventory/inventory_service/repository/InventoryRepository.java"
click node_productapi "https://github.com/kevmenea/ecommerce-microservices/blob/main/product-service/src/main/java/com/menea/ecommerce/product_service/api/ProductController.java"
click node_productflow "https://github.com/kevmenea/ecommerce-microservices/blob/main/product-service/src/main/java/com/menea/ecommerce/product_service/application/ProductApplicationService.java"
click node_productdata "https://github.com/kevmenea/ecommerce-microservices/blob/main/product-service/src/main/java/com/menea/ecommerce/product_service/domain/ProductRepository.java"
click node_userapi "https://github.com/kevmenea/ecommerce-microservices/blob/main/user-service/src/main/java/com/menea/ecommerce/user_service/api/UserController.java"
click node_userflow "https://github.com/kevmenea/ecommerce-microservices/blob/main/user-service/src/main/java/com/menea/ecommerce/user_service/application/UserApplicationService.java"
click node_userdata "https://github.com/kevmenea/ecommerce-microservices/blob/main/user-service/src/main/java/com/menea/ecommerce/user_service/domain/UserRepository.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_discovery,node_configuration,node_shopper toneBlue
class node_orderapi,node_orderflow,node_inventoryclient,node_outbox,node_outboxstore,node_eventpublisher,node_kafka toneAmber
class node_inventoryapi,node_warehouseapi,node_reservationapi,node_stockflow,node_stockdomain,node_stockdata toneMint
class node_productapi,node_productflow,node_productdata,node_userapi,node_userflow,node_userdata toneRose
```

## Components

### Entry and platform

- [API gateway](https://github.com/kevmenea/ecommerce-microservices/blob/main/apigateway/src/main/java/com/meneabank/apigateway/ApigatewayApplication.java): `apigateway/src/main/java/com/meneabank/apigateway/ApigatewayApplication.java`
- [Gateway security](https://github.com/kevmenea/ecommerce-microservices/blob/main/apigateway/src/main/java/com/meneabank/apigateway/config/SecurityConfig.java): `apigateway/src/main/java/com/meneabank/apigateway/config/SecurityConfig.java`
- [Service discovery](https://github.com/kevmenea/ecommerce-microservices/blob/main/eureka-server/src/main/java/com/meneabank/eureka_server/EurekaServerApplication.java): `eureka-server/src/main/java/com/meneabank/eureka_server/EurekaServerApplication.java`
- [Configuration server](https://github.com/kevmenea/ecommerce-microservices/blob/main/configserver/src/main/java/com/ecommerce/configserver/ConfigserverApplication.java): `configserver/src/main/java/com/ecommerce/configserver/ConfigserverApplication.java`

### Order lifecycle

- [Order API](https://github.com/kevmenea/ecommerce-microservices/blob/main/order-service/src/main/java/com/ecommerce/order_service/api/OrderController.java): `order-service/src/main/java/com/ecommerce/order_service/api/OrderController.java`
- [Order orchestration](https://github.com/kevmenea/ecommerce-microservices/blob/main/order-service/src/main/java/com/ecommerce/order_service/application/OrderApplicationService.java): `order-service/src/main/java/com/ecommerce/order_service/application/OrderApplicationService.java`
- [Inventory client](https://github.com/kevmenea/ecommerce-microservices/blob/main/order-service/src/main/java/com/ecommerce/order_service/client/inventory/InventoryReservationClient.java): `order-service/src/main/java/com/ecommerce/order_service/client/inventory/InventoryReservationClient.java`
- [Outbox service](https://github.com/kevmenea/ecommerce-microservices/blob/main/order-service/src/main/java/com/ecommerce/order_service/outbox/OutboxService.java): `order-service/src/main/java/com/ecommerce/order_service/outbox/OutboxService.java`
- [Outbox records](https://github.com/kevmenea/ecommerce-microservices/blob/main/order-service/src/main/java/com/ecommerce/order_service/outbox/OutboxEventRepository.java): `order-service/src/main/java/com/ecommerce/order_service/outbox/OutboxEventRepository.java`
- [Outbox publisher](https://github.com/kevmenea/ecommerce-microservices/blob/main/order-service/src/main/java/com/ecommerce/order_service/outbox/OutboxPublisher.java): `order-service/src/main/java/com/ecommerce/order_service/outbox/OutboxPublisher.java`
- **Kafka events**

### Inventory operations

- [Inventory API](https://github.com/kevmenea/ecommerce-microservices/blob/main/inventory-service/src/main/java/com/ecommerce/inventory/inventory_service/api/InventoryController.java): `inventory-service/src/main/java/com/ecommerce/inventory/inventory_service/api/InventoryController.java`
- [Warehouse API](https://github.com/kevmenea/ecommerce-microservices/blob/main/inventory-service/src/main/java/com/ecommerce/inventory/inventory_service/api/WarehouseController.java): `inventory-service/src/main/java/com/ecommerce/inventory/inventory_service/api/WarehouseController.java`
- [Reservation API](https://github.com/kevmenea/ecommerce-microservices/blob/main/inventory-service/src/main/java/com/ecommerce/inventory/inventory_service/api/ReservationController.java): `inventory-service/src/main/java/com/ecommerce/inventory/inventory_service/api/ReservationController.java`
- [Inventory application](https://github.com/kevmenea/ecommerce-microservices/blob/main/inventory-service/src/main/java/com/ecommerce/inventory/inventory_service/application/InventoryApplicationService.java): `inventory-service/src/main/java/com/ecommerce/inventory/inventory_service/application/InventoryApplicationService.java`
- [Stock domain](https://github.com/kevmenea/ecommerce-microservices/blob/main/inventory-service/src/main/java/com/ecommerce/inventory/inventory_service/domain/Inventory.java): `inventory-service/src/main/java/com/ecommerce/inventory/inventory_service/domain/Inventory.java`
- [Inventory repositories](https://github.com/kevmenea/ecommerce-microservices/blob/main/inventory-service/src/main/java/com/ecommerce/inventory/inventory_service/repository/InventoryRepository.java): `inventory-service/src/main/java/com/ecommerce/inventory/inventory_service/repository/InventoryRepository.java`

### Catalog and identity

- [Product API](https://github.com/kevmenea/ecommerce-microservices/blob/main/product-service/src/main/java/com/menea/ecommerce/product_service/api/ProductController.java): `product-service/src/main/java/com/menea/ecommerce/product_service/api/ProductController.java`
- [Product service](https://github.com/kevmenea/ecommerce-microservices/blob/main/product-service/src/main/java/com/menea/ecommerce/product_service/application/ProductApplicationService.java): `product-service/src/main/java/com/menea/ecommerce/product_service/application/ProductApplicationService.java`
- [Product repository](https://github.com/kevmenea/ecommerce-microservices/blob/main/product-service/src/main/java/com/menea/ecommerce/product_service/domain/ProductRepository.java): `product-service/src/main/java/com/menea/ecommerce/product_service/domain/ProductRepository.java`
- [User API](https://github.com/kevmenea/ecommerce-microservices/blob/main/user-service/src/main/java/com/menea/ecommerce/user_service/api/UserController.java): `user-service/src/main/java/com/menea/ecommerce/user_service/api/UserController.java`
- [User service](https://github.com/kevmenea/ecommerce-microservices/blob/main/user-service/src/main/java/com/menea/ecommerce/user_service/application/UserApplicationService.java): `user-service/src/main/java/com/menea/ecommerce/user_service/application/UserApplicationService.java`
- [User repository](https://github.com/kevmenea/ecommerce-microservices/blob/main/user-service/src/main/java/com/menea/ecommerce/user_service/domain/UserRepository.java): `user-service/src/main/java/com/menea/ecommerce/user_service/domain/UserRepository.java`

### Other components

- **API client**

## Connections

- API client → API gateway: sends requests
- API gateway → Gateway security: applies security
- API gateway → Order API: routes requests
- API gateway → Inventory API: routes requests
- API gateway → Product API: routes requests
- API gateway → User API: routes requests
- Order API → Order orchestration: delegates to (evidence: `order-service/src/main/java/com/ecommerce/order_service/api/OrderController.java`)
- Order orchestration → Inventory client: calls reservations (evidence: `order-service/src/main/java/com/ecommerce/order_service/application/OrderApplicationService.java`)
- Inventory client → Reservation API: requests stock
- Order orchestration → Outbox service: saves event (evidence: `order-service/src/main/java/com/ecommerce/order_service/application/OrderApplicationService.java`)
- Outbox service → Outbox records: persists event (evidence: `order-service/src/main/java/com/ecommerce/order_service/outbox/OutboxService.java`)
- Outbox publisher → Outbox records: reads events
- Outbox publisher → Kafka events: publishes events
- Inventory API → Inventory application: delegates to (evidence: `inventory-service/src/main/java/com/ecommerce/inventory/inventory_service/api/InventoryController.java`)
- Warehouse API → Inventory application: delegates to (evidence: `inventory-service/src/main/java/com/ecommerce/inventory/inventory_service/api/WarehouseController.java`)
- Reservation API → Inventory application: delegates to (evidence: `inventory-service/src/main/java/com/ecommerce/inventory/inventory_service/api/ReservationController.java`)
- Inventory application → Inventory repositories: uses repositories (evidence: `inventory-service/src/main/java/com/ecommerce/inventory/inventory_service/application/InventoryApplicationService.java`)
- Inventory application → Stock domain: updates stock (evidence: `inventory-service/src/main/java/com/ecommerce/inventory/inventory_service/application/InventoryApplicationService.java`)
- Product API → Product service: delegates to (evidence: `product-service/src/main/java/com/menea/ecommerce/product_service/api/ProductController.java`)
- Product service → Product repository: reads and writes (evidence: `product-service/src/main/java/com/menea/ecommerce/product_service/application/ProductApplicationService.java`)
- User API → User service: delegates to (evidence: `user-service/src/main/java/com/menea/ecommerce/user_service/api/UserController.java`)
- User service → User repository: reads and writes (evidence: `user-service/src/main/java/com/menea/ecommerce/user_service/application/UserApplicationService.java`)
- Configuration server → API gateway: configures service
- Configuration server → Order orchestration: configures service
- Service discovery → API gateway: registers services
