# embarkxofficial/ecom-microservices architecture

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

- Interactive diagram: https://gitdiagram.com/embarkxofficial/ecom-microservices
- Repository: https://github.com/embarkxofficial/ecom-microservices

## Overview

This repository is a Spring Boot microservices e-commerce course codebase, alongside standalone Spring and OAuth demos. In the microservices workflow, clients reach service APIs, order/cart operations coordinate with product and user services, and order creation persists an order and publishes an event for notification. A separate e-commerce application demonstrates similar product, user, and cart behavior in one service. Sampled excerpts establish selected service calls; gateway routing, discovery, configuration, and event-consumer wiring are not shown, so those connections are omitted.

Main entry points: [`order/src/main/java/com/ecommerce/order/services/CartService.java`](https://github.com/embarkxofficial/ecom-microservices/blob/main/order/src/main/java/com/ecommerce/order/services/CartService.java) (Cart workflow), [`order/src/main/java/com/ecommerce/order/services/OrderService.java`](https://github.com/embarkxofficial/ecom-microservices/blob/main/order/src/main/java/com/ecommerce/order/services/OrderService.java) (Order workflow), [`additional/ecom-application/src/main/java/com/app/ecom/service/CartService.java`](https://github.com/embarkxofficial/ecom-microservices/blob/main/additional/ecom-application/src/main/java/com/app/ecom/service/CartService.java) (Cart workflow), [`user/src/main/java/com/ecommerce/user/services/UserService.java`](https://github.com/embarkxofficial/ecom-microservices/blob/main/user/src/main/java/com/ecommerce/user/services/UserService.java) (User management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_edge["Service entry points"]
  node_order_api["Order API"]
  node_cart_api["Cart API"]
  node_product_api["Product API"]
  node_user_api["User API"]
end

subgraph group_domain["Commerce services"]
  node_order_service["Order workflow<br/>[OrderService.java]"]
  node_cart_service["Cart workflow<br/>[CartService.java]"]
  node_order_store[("Order store")]
  node_cart_store[("Cart store")]
  node_product_client["Product client"]
  node_user_client["User client"]
  node_product_service["Product catalog"]
  node_product_store[("Product store")]
  node_user_service["User management<br/>[UserService.java]"]
  node_user_store[("User store")]
  node_keycloak_admin["Keycloak admin"]
end

subgraph group_platform["Platform services"]
  node_notification["Order consumer"]
  node_gateway["API gateway<br/>[GatewayConfig.java]"]
  node_discovery["Service discovery"]
  node_config_server["Config server"]
end

subgraph group_monolith["Standalone commerce"]
  node_mono_product["Product workflow"]
  node_mono_user["User workflow<br/>[UserService.java]"]
  node_mono_cart["Cart workflow<br/>[CartService.java]"]
  node_mono_product_api["Product endpoint"]
  node_mono_user_api["User endpoint"]
  node_mono_product_store[("Product store")]
  node_mono_user_store[("User store")]
  node_mono_cart_store[("Cart store")]
end

subgraph group_demos["Learning demos"]
  node_oauth_ui["PKCE demo UI<br/>[App.jsx]"]
  node_spring_demo["Hello controller"]
  node_build_info["Build info API"]
end

node_client(("API client"))
node_keycloak["Keycloak"]
node_event_bus["Event broker"]
node_hello_api["Hello API"]

node_client -.->|"requests"| node_order_api
node_client -.->|"requests"| node_cart_api
node_client -.->|"requests"| node_product_api
node_client -.->|"requests"| node_user_api
node_order_api -->|"delegates to"| node_order_service
node_cart_api -->|"delegates to"| node_cart_service
node_product_api -->|"delegates to"| node_product_service
node_user_api -->|"delegates to"| node_user_service
node_order_service -->|"reads and clears"| node_cart_service
node_order_service -->|"saves"| node_order_store
node_order_service -->|"publishes event"| node_event_bus
node_cart_service -->|"reads and writes"| node_cart_store
node_cart_service -->|"fetches product"| node_product_client
node_cart_service -->|"fetches user"| node_user_client
node_product_service -->|"reads and writes"| node_product_store
node_user_service -->|"reads and writes"| node_user_store
node_user_service -->|"manages identity"| node_keycloak_admin
node_keycloak_admin -->|"calls admin API"| node_keycloak
node_notification -.->|"consumes events"| node_event_bus
node_mono_product_api -->|"delegates to"| node_mono_product
node_mono_user_api -->|"delegates to"| node_mono_user
node_mono_product -->|"reads and writes"| node_mono_product_store
node_mono_user -->|"reads and writes"| node_mono_user_store
node_mono_cart -->|"looks up products"| node_mono_product_store
node_mono_cart -->|"looks up users"| node_mono_user_store
node_mono_cart -->|"reads and writes"| node_mono_cart_store
node_oauth_ui -->|"fetches with token"| node_hello_api
node_client -.->|"calls endpoint"| node_spring_demo
node_client -.->|"calls endpoint"| node_build_info

click node_order_api "https://github.com/embarkxofficial/ecom-microservices/blob/main/order/src/main/java/com/ecommerce/order/controller/OrderController.java"
click node_cart_api "https://github.com/embarkxofficial/ecom-microservices/blob/main/order/src/main/java/com/ecommerce/order/controller/CartController.java"
click node_product_api "https://github.com/embarkxofficial/ecom-microservices/blob/main/product/src/main/java/com/ecommerce/product/controllers/ProductController.java"
click node_user_api "https://github.com/embarkxofficial/ecom-microservices/blob/main/user/src/main/java/com/ecommerce/user/controllers/UserController.java"
click node_order_service "https://github.com/embarkxofficial/ecom-microservices/blob/main/order/src/main/java/com/ecommerce/order/services/OrderService.java"
click node_cart_service "https://github.com/embarkxofficial/ecom-microservices/blob/main/order/src/main/java/com/ecommerce/order/services/CartService.java"
click node_order_store "https://github.com/embarkxofficial/ecom-microservices/blob/main/order/src/main/java/com/ecommerce/order/repositories/OrderRepository.java"
click node_cart_store "https://github.com/embarkxofficial/ecom-microservices/blob/main/order/src/main/java/com/ecommerce/order/repositories/CartItemRepository.java"
click node_product_client "https://github.com/embarkxofficial/ecom-microservices/blob/main/order/src/main/java/com/ecommerce/order/clients/ProductServiceClient.java"
click node_user_client "https://github.com/embarkxofficial/ecom-microservices/blob/main/order/src/main/java/com/ecommerce/order/clients/UserServiceClient.java"
click node_product_service "https://github.com/embarkxofficial/ecom-microservices/blob/main/product/src/main/java/com/ecommerce/product/services/ProductService.java"
click node_product_store "https://github.com/embarkxofficial/ecom-microservices/blob/main/product/src/main/java/com/ecommerce/product/repositories/ProductRepository.java"
click node_user_service "https://github.com/embarkxofficial/ecom-microservices/blob/main/user/src/main/java/com/ecommerce/user/services/UserService.java"
click node_user_store "https://github.com/embarkxofficial/ecom-microservices/blob/main/user/src/main/java/com/ecommerce/user/repository/UserRepository.java"
click node_keycloak_admin "https://github.com/embarkxofficial/ecom-microservices/blob/main/user/src/main/java/com/ecommerce/user/services/KeyCloakAdminService.java"
click node_notification "https://github.com/embarkxofficial/ecom-microservices/blob/main/notification/src/main/java/com/ecommerce/notification/OrderEventConsumer.java"
click node_gateway "https://github.com/embarkxofficial/ecom-microservices/blob/main/gateway/src/main/java/com/ecommerce/gateway/GatewayConfig.java"
click node_discovery "https://github.com/embarkxofficial/ecom-microservices/blob/main/eureka/src/main/java/com/ecommerce/eureka/EurekaApplication.java"
click node_config_server "https://github.com/embarkxofficial/ecom-microservices/blob/main/configserver/src/main/java/com/ecommerce/configserver/ConfigserverApplication.java"
click node_mono_product "https://github.com/embarkxofficial/ecom-microservices/blob/main/additional/ecom-application/src/main/java/com/app/ecom/service/ProductService.java"
click node_mono_user "https://github.com/embarkxofficial/ecom-microservices/blob/main/additional/ecom-application/src/main/java/com/app/ecom/service/UserService.java"
click node_mono_cart "https://github.com/embarkxofficial/ecom-microservices/blob/main/additional/ecom-application/src/main/java/com/app/ecom/service/CartService.java"
click node_mono_product_api "https://github.com/embarkxofficial/ecom-microservices/blob/main/additional/ecom-application/src/main/java/com/app/ecom/controller/ProductController.java"
click node_mono_user_api "https://github.com/embarkxofficial/ecom-microservices/blob/main/additional/ecom-application/src/main/java/com/app/ecom/controller/UserController.java"
click node_mono_product_store "https://github.com/embarkxofficial/ecom-microservices/blob/main/additional/ecom-application/src/main/java/com/app/ecom/repository/ProductRepository.java"
click node_mono_user_store "https://github.com/embarkxofficial/ecom-microservices/blob/main/additional/ecom-application/src/main/java/com/app/ecom/repository/UserRepository.java"
click node_mono_cart_store "https://github.com/embarkxofficial/ecom-microservices/blob/main/additional/ecom-application/src/main/java/com/app/ecom/repository/CartItemRepository.java"
click node_oauth_ui "https://github.com/embarkxofficial/ecom-microservices/blob/main/additional/keycloak/keycloak-oauth-demos/pkce-flow/pkce-demo-react/src/App.jsx"
click node_spring_demo "https://github.com/embarkxofficial/ecom-microservices/blob/main/additional/FirstSpring/src/main/java/com/embarkx/FirstSpring/HelloController.java"
click node_build_info "https://github.com/embarkxofficial/ecom-microservices/blob/main/additional/config-mgmt/configdemo/src/main/java/com/info/configdemo/BuildInfoController.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_order_api,node_cart_api,node_product_api,node_user_api,node_client toneBlue
class node_order_service,node_cart_service,node_order_store,node_cart_store,node_product_client,node_user_client,node_product_service,node_product_store,node_user_service,node_user_store,node_keycloak_admin toneAmber
class node_notification,node_gateway,node_discovery,node_config_server,node_hello_api toneMint
class node_mono_product,node_mono_user,node_mono_cart,node_mono_product_api,node_mono_user_api,node_mono_product_store,node_mono_user_store,node_mono_cart_store toneRose
class node_oauth_ui,node_spring_demo,node_build_info,node_keycloak,node_event_bus toneIndigo
```

## Components

### Service entry points

- [Order API](https://github.com/embarkxofficial/ecom-microservices/blob/main/order/src/main/java/com/ecommerce/order/controller/OrderController.java): `order/src/main/java/com/ecommerce/order/controller/OrderController.java`
- [Cart API](https://github.com/embarkxofficial/ecom-microservices/blob/main/order/src/main/java/com/ecommerce/order/controller/CartController.java): `order/src/main/java/com/ecommerce/order/controller/CartController.java`
- [Product API](https://github.com/embarkxofficial/ecom-microservices/blob/main/product/src/main/java/com/ecommerce/product/controllers/ProductController.java): `product/src/main/java/com/ecommerce/product/controllers/ProductController.java`
- [User API](https://github.com/embarkxofficial/ecom-microservices/blob/main/user/src/main/java/com/ecommerce/user/controllers/UserController.java): `user/src/main/java/com/ecommerce/user/controllers/UserController.java`

### Commerce services

- [Order workflow](https://github.com/embarkxofficial/ecom-microservices/blob/main/order/src/main/java/com/ecommerce/order/services/OrderService.java): `order/src/main/java/com/ecommerce/order/services/OrderService.java`
- [Cart workflow](https://github.com/embarkxofficial/ecom-microservices/blob/main/order/src/main/java/com/ecommerce/order/services/CartService.java): `order/src/main/java/com/ecommerce/order/services/CartService.java`
- [Order store](https://github.com/embarkxofficial/ecom-microservices/blob/main/order/src/main/java/com/ecommerce/order/repositories/OrderRepository.java): `order/src/main/java/com/ecommerce/order/repositories/OrderRepository.java`
- [Cart store](https://github.com/embarkxofficial/ecom-microservices/blob/main/order/src/main/java/com/ecommerce/order/repositories/CartItemRepository.java): `order/src/main/java/com/ecommerce/order/repositories/CartItemRepository.java`
- [Product client](https://github.com/embarkxofficial/ecom-microservices/blob/main/order/src/main/java/com/ecommerce/order/clients/ProductServiceClient.java): `order/src/main/java/com/ecommerce/order/clients/ProductServiceClient.java`
- [User client](https://github.com/embarkxofficial/ecom-microservices/blob/main/order/src/main/java/com/ecommerce/order/clients/UserServiceClient.java): `order/src/main/java/com/ecommerce/order/clients/UserServiceClient.java`
- [Product catalog](https://github.com/embarkxofficial/ecom-microservices/blob/main/product/src/main/java/com/ecommerce/product/services/ProductService.java): `product/src/main/java/com/ecommerce/product/services/ProductService.java`
- [Product store](https://github.com/embarkxofficial/ecom-microservices/blob/main/product/src/main/java/com/ecommerce/product/repositories/ProductRepository.java): `product/src/main/java/com/ecommerce/product/repositories/ProductRepository.java`
- [User management](https://github.com/embarkxofficial/ecom-microservices/blob/main/user/src/main/java/com/ecommerce/user/services/UserService.java): `user/src/main/java/com/ecommerce/user/services/UserService.java`
- [User store](https://github.com/embarkxofficial/ecom-microservices/blob/main/user/src/main/java/com/ecommerce/user/repository/UserRepository.java): `user/src/main/java/com/ecommerce/user/repository/UserRepository.java`
- [Keycloak admin](https://github.com/embarkxofficial/ecom-microservices/blob/main/user/src/main/java/com/ecommerce/user/services/KeyCloakAdminService.java): `user/src/main/java/com/ecommerce/user/services/KeyCloakAdminService.java`

### Platform services

- [Order consumer](https://github.com/embarkxofficial/ecom-microservices/blob/main/notification/src/main/java/com/ecommerce/notification/OrderEventConsumer.java): `notification/src/main/java/com/ecommerce/notification/OrderEventConsumer.java`
- [API gateway](https://github.com/embarkxofficial/ecom-microservices/blob/main/gateway/src/main/java/com/ecommerce/gateway/GatewayConfig.java): `gateway/src/main/java/com/ecommerce/gateway/GatewayConfig.java`
- [Service discovery](https://github.com/embarkxofficial/ecom-microservices/blob/main/eureka/src/main/java/com/ecommerce/eureka/EurekaApplication.java): `eureka/src/main/java/com/ecommerce/eureka/EurekaApplication.java`
- [Config server](https://github.com/embarkxofficial/ecom-microservices/blob/main/configserver/src/main/java/com/ecommerce/configserver/ConfigserverApplication.java): `configserver/src/main/java/com/ecommerce/configserver/ConfigserverApplication.java`

### Standalone commerce

- [Product workflow](https://github.com/embarkxofficial/ecom-microservices/blob/main/additional/ecom-application/src/main/java/com/app/ecom/service/ProductService.java): `additional/ecom-application/src/main/java/com/app/ecom/service/ProductService.java`
- [User workflow](https://github.com/embarkxofficial/ecom-microservices/blob/main/additional/ecom-application/src/main/java/com/app/ecom/service/UserService.java): `additional/ecom-application/src/main/java/com/app/ecom/service/UserService.java`
- [Cart workflow](https://github.com/embarkxofficial/ecom-microservices/blob/main/additional/ecom-application/src/main/java/com/app/ecom/service/CartService.java): `additional/ecom-application/src/main/java/com/app/ecom/service/CartService.java`
- [Product endpoint](https://github.com/embarkxofficial/ecom-microservices/blob/main/additional/ecom-application/src/main/java/com/app/ecom/controller/ProductController.java): `additional/ecom-application/src/main/java/com/app/ecom/controller/ProductController.java`
- [User endpoint](https://github.com/embarkxofficial/ecom-microservices/blob/main/additional/ecom-application/src/main/java/com/app/ecom/controller/UserController.java): `additional/ecom-application/src/main/java/com/app/ecom/controller/UserController.java`
- [Product store](https://github.com/embarkxofficial/ecom-microservices/blob/main/additional/ecom-application/src/main/java/com/app/ecom/repository/ProductRepository.java): `additional/ecom-application/src/main/java/com/app/ecom/repository/ProductRepository.java`
- [User store](https://github.com/embarkxofficial/ecom-microservices/blob/main/additional/ecom-application/src/main/java/com/app/ecom/repository/UserRepository.java): `additional/ecom-application/src/main/java/com/app/ecom/repository/UserRepository.java`
- [Cart store](https://github.com/embarkxofficial/ecom-microservices/blob/main/additional/ecom-application/src/main/java/com/app/ecom/repository/CartItemRepository.java): `additional/ecom-application/src/main/java/com/app/ecom/repository/CartItemRepository.java`

### Learning demos

- [PKCE demo UI](https://github.com/embarkxofficial/ecom-microservices/blob/main/additional/keycloak/keycloak-oauth-demos/pkce-flow/pkce-demo-react/src/App.jsx): `additional/keycloak/keycloak-oauth-demos/pkce-flow/pkce-demo-react/src/App.jsx`
- [Hello controller](https://github.com/embarkxofficial/ecom-microservices/blob/main/additional/FirstSpring/src/main/java/com/embarkx/FirstSpring/HelloController.java): `additional/FirstSpring/src/main/java/com/embarkx/FirstSpring/HelloController.java`
- [Build info API](https://github.com/embarkxofficial/ecom-microservices/blob/main/additional/config-mgmt/configdemo/src/main/java/com/info/configdemo/BuildInfoController.java): `additional/config-mgmt/configdemo/src/main/java/com/info/configdemo/BuildInfoController.java`

### Other components

- **API client**
- **Keycloak**
- **Event broker**
- **Hello API**

## Connections

- API client → Order API: requests
- API client → Cart API: requests
- API client → Product API: requests
- API client → User API: requests
- Order API → Order workflow: delegates to (evidence: `order/src/main/java/com/ecommerce/order/controller/OrderController.java`)
- Cart API → Cart workflow: delegates to (evidence: `order/src/main/java/com/ecommerce/order/controller/CartController.java`)
- Product API → Product catalog: delegates to (evidence: `product/src/main/java/com/ecommerce/product/controllers/ProductController.java`)
- User API → User management: delegates to (evidence: `user/src/main/java/com/ecommerce/user/controllers/UserController.java`)
- Order workflow → Cart workflow: reads and clears (evidence: `order/src/main/java/com/ecommerce/order/services/OrderService.java`)
- Order workflow → Order store: saves (evidence: `order/src/main/java/com/ecommerce/order/services/OrderService.java`)
- Order workflow → Event broker: publishes event (evidence: `order/src/main/java/com/ecommerce/order/services/OrderService.java`)
- Cart workflow → Cart store: reads and writes (evidence: `order/src/main/java/com/ecommerce/order/services/CartService.java`)
- Cart workflow → Product client: fetches product (evidence: `order/src/main/java/com/ecommerce/order/services/CartService.java`)
- Cart workflow → User client: fetches user (evidence: `order/src/main/java/com/ecommerce/order/services/CartService.java`)
- Product catalog → Product store: reads and writes (evidence: `product/src/main/java/com/ecommerce/product/services/ProductService.java`)
- User management → User store: reads and writes (evidence: `user/src/main/java/com/ecommerce/user/services/UserService.java`)
- User management → Keycloak admin: manages identity (evidence: `user/src/main/java/com/ecommerce/user/services/UserService.java`)
- Keycloak admin → Keycloak: calls admin API (evidence: `user/src/main/java/com/ecommerce/user/services/KeyCloakAdminService.java`)
- Order consumer → Event broker: consumes events
- Product endpoint → Product workflow: delegates to (evidence: `additional/ecom-application/src/main/java/com/app/ecom/controller/ProductController.java`)
- User endpoint → User workflow: delegates to (evidence: `additional/ecom-application/src/main/java/com/app/ecom/controller/UserController.java`)
- Product workflow → Product store: reads and writes (evidence: `additional/ecom-application/src/main/java/com/app/ecom/service/ProductService.java`)
- User workflow → User store: reads and writes (evidence: `additional/ecom-application/src/main/java/com/app/ecom/service/UserService.java`)
- Cart workflow → Product store: looks up products (evidence: `additional/ecom-application/src/main/java/com/app/ecom/service/CartService.java`)
- Cart workflow → User store: looks up users (evidence: `additional/ecom-application/src/main/java/com/app/ecom/service/CartService.java`)
- Cart workflow → Cart store: reads and writes (evidence: `additional/ecom-application/src/main/java/com/app/ecom/service/CartService.java`)
- PKCE demo UI → Hello API: fetches with token (evidence: `additional/keycloak/keycloak-oauth-demos/pkce-flow/pkce-demo-react/src/App.jsx`)
- API client → Hello controller: calls endpoint
- API client → Build info API: calls endpoint
