How embarkxofficial/ecom-microservices works
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: services/CartService.java Cart workflow · OrderService.java Order workflow · service/CartService.java Cart workflow · UserService.java User management
Components 34
Service entry points
- Order API
order/src/main/java/com/ecommerce/order/controller/OrderController.java - Cart API
order/src/main/java/com/ecommerce/order/controller/CartController.java - Product API
product/src/main/java/com/ecommerce/product/controllers/ProductController.java - User API
user/src/main/java/com/ecommerce/user/controllers/UserController.java
Commerce services
- Order workflow
order/src/main/java/com/ecommerce/order/services/OrderService.java - Cart workflow
order/src/main/java/com/ecommerce/order/services/CartService.java - Order store
order/src/main/java/com/ecommerce/order/repositories/OrderRepository.java - Cart store
order/src/main/java/com/ecommerce/order/repositories/CartItemRepository.java - Product client
order/src/main/java/com/ecommerce/order/clients/ProductServiceClient.java - User client
order/src/main/java/com/ecommerce/order/clients/UserServiceClient.java - Product catalog
product/src/main/java/com/ecommerce/product/services/ProductService.java - Product store
product/src/main/java/com/ecommerce/product/repositories/ProductRepository.java - User management
user/src/main/java/com/ecommerce/user/services/UserService.java - User store
user/src/main/java/com/ecommerce/user/repository/UserRepository.java - Keycloak admin
user/src/main/java/com/ecommerce/user/services/KeyCloakAdminService.java
Platform services
- Order consumer
notification/src/main/java/com/ecommerce/notification/OrderEventConsumer.java - API gateway
gateway/src/main/java/com/ecommerce/gateway/GatewayConfig.java - Service discovery
eureka/src/main/java/com/ecommerce/eureka/EurekaApplication.java - Config server
configserver/src/main/java/com/ecommerce/configserver/ConfigserverApplication.java
Standalone commerce
- Product workflow
additional/ecom-application/src/main/java/com/app/ecom/service/ProductService.java - User workflow
additional/ecom-application/src/main/java/com/app/ecom/service/UserService.java - Cart workflow
additional/ecom-application/src/main/java/com/app/ecom/service/CartService.java - Product endpoint
additional/ecom-application/src/main/java/com/app/ecom/controller/ProductController.java - User endpoint
additional/ecom-application/src/main/java/com/app/ecom/controller/UserController.java - Product store
additional/ecom-application/src/main/java/com/app/ecom/repository/ProductRepository.java - User store
additional/ecom-application/src/main/java/com/app/ecom/repository/UserRepository.java - Cart store
additional/ecom-application/src/main/java/com/app/ecom/repository/CartItemRepository.java
Learning demos
- PKCE demo UI
additional/keycloak/keycloak-oauth-demos/pkce-flow/pkce-demo-react/src/App.jsx - Hello controller
additional/FirstSpring/src/main/java/com/embarkx/FirstSpring/HelloController.java - Build info API
additional/config-mgmt/configdemo/src/main/java/com/info/configdemo/BuildInfoController.java
Other components
- API client
- Keycloak
- Event broker
- Hello API
Connections 29
- 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
order/src/main/java/com/ecommerce/order/controller/OrderController.java - Cart API → Cart workflow: delegates to
order/src/main/java/com/ecommerce/order/controller/CartController.java - Product API → Product catalog: delegates to
product/src/main/java/com/ecommerce/product/controllers/ProductController.java - User API → User management: delegates to
user/src/main/java/com/ecommerce/user/controllers/UserController.java - Order workflow → Cart workflow: reads and clears
order/src/main/java/com/ecommerce/order/services/OrderService.java - Order workflow → Order store: saves
order/src/main/java/com/ecommerce/order/services/OrderService.java - Order workflow → Event broker: publishes event
order/src/main/java/com/ecommerce/order/services/OrderService.java - Cart workflow → Cart store: reads and writes
order/src/main/java/com/ecommerce/order/services/CartService.java - Cart workflow → Product client: fetches product
order/src/main/java/com/ecommerce/order/services/CartService.java - Cart workflow → User client: fetches user
order/src/main/java/com/ecommerce/order/services/CartService.java - Product catalog → Product store: reads and writes
product/src/main/java/com/ecommerce/product/services/ProductService.java - User management → User store: reads and writes
user/src/main/java/com/ecommerce/user/services/UserService.java - User management → Keycloak admin: manages identity
user/src/main/java/com/ecommerce/user/services/UserService.java - Keycloak admin → Keycloak: calls admin API
user/src/main/java/com/ecommerce/user/services/KeyCloakAdminService.java - Order consumer → Event broker: consumes events
- Product endpoint → Product workflow: delegates to
additional/ecom-application/src/main/java/com/app/ecom/controller/ProductController.java - User endpoint → User workflow: delegates to
additional/ecom-application/src/main/java/com/app/ecom/controller/UserController.java - Product workflow → Product store: reads and writes
additional/ecom-application/src/main/java/com/app/ecom/service/ProductService.java - User workflow → User store: reads and writes
additional/ecom-application/src/main/java/com/app/ecom/service/UserService.java - Cart workflow → Product store: looks up products
additional/ecom-application/src/main/java/com/app/ecom/service/CartService.java - Cart workflow → User store: looks up users
additional/ecom-application/src/main/java/com/app/ecom/service/CartService.java - Cart workflow → Cart store: reads and writes
additional/ecom-application/src/main/java/com/app/ecom/service/CartService.java - PKCE demo UI → Hello API: fetches with token
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