# dineshrajbhar-cloud/microservices-ecom architecture

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

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

## Overview

This is a Spring Boot e-commerce microservices application. Users can manage products and inventory, authenticate, and place orders; order creation checks stock through an OpenFeign inventory client, reduces inventory, then saves the order. Product and inventory CRUD are separate service branches. The README documents Eureka discovery and an API gateway. Authentication and gateway JWT components are present in the tree, but their wiring and several service integrations were not sampled, so those connections are left unverified.

Main entry points: [`api-gateway/api-gateway/src/main/java/com/ecom/apigateway/ApiGatewayApplication.java`](https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/api-gateway/api-gateway/src/main/java/com/ecom/apigateway/ApiGatewayApplication.java) (API Gateway), [`order-service/order-service/src/main/java/com/ecom/order_service/serviceImpl/OrderServiceImpl.java`](https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/order-service/order-service/src/main/java/com/ecom/order_service/serviceImpl/OrderServiceImpl.java) (Order Service), [`security/src/main/java/com/ecom/auth_service/service/AuthService.java`](https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/security/src/main/java/com/ecom/auth_service/service/AuthService.java) (Auth Service), [`product-service/product-service/src/main/java/com/ecom/product_service/serviceImpl/ProductServiceImpl.java`](https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/product-service/product-service/src/main/java/com/ecom/product_service/serviceImpl/ProductServiceImpl.java) (Product Service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_edge["Gateway and Discovery"]
  node_gateway["API Gateway"]
  node_gateway_jwt["Gateway JWT<br/>[JwtAuthFilter.java]"]
  node_discovery["Eureka Server"]
end

subgraph group_catalog["Product Catalog"]
  node_product_api["Product API"]
  node_product_logic["Product Service"]
  node_product_store[("Product Repository")]
  node_product_model["Product Model<br/>[Product.java]"]
end

subgraph group_stock["Inventory"]
  node_inventory_api["Inventory API"]
  node_inventory_logic["Inventory Service"]
  node_inventory_store[("Inventory Repository")]
  node_inventory_model["Inventory Model<br/>[Inventory.java]"]
end

subgraph group_orders["Orders"]
  node_order_api["Order API"]
  node_order_logic["Order Service"]
  node_inventory_client["Inventory Client"]
  node_order_store[("Order Repository")]
  node_order_model["Order Model<br/>[Order.java]"]
end

subgraph group_auth["Authentication"]
  node_auth_api["Auth API"]
  node_auth_logic["Auth Service<br/>[AuthService.java]"]
  node_user_store[("User Repository")]
  node_user_model["User and Role<br/>[User.java]"]
  node_jwt_service["JWT Service<br/>[JwtService.java]"]
  node_auth_filter["Auth JWT Filter"]
end

node_customer(("Client"))

node_customer -.->|"sends requests"| node_gateway
node_gateway -.->|"filters with"| node_gateway_jwt
node_gateway -.->|"routes to"| node_product_api
node_gateway -.->|"routes to"| node_inventory_api
node_gateway -.->|"routes to"| node_order_api
node_gateway -.->|"routes to"| node_auth_api
node_gateway -.->|"discovers services"| node_discovery
node_product_api -->|"calls"| node_product_logic
node_product_logic -->|"reads and writes"| node_product_store
node_product_logic -->|"manages"| node_product_model
node_inventory_api -->|"calls"| node_inventory_logic
node_inventory_logic -->|"reads and writes"| node_inventory_store
node_inventory_logic -->|"updates"| node_inventory_model
node_order_api -->|"calls"| node_order_logic
node_order_logic -->|"checks and reduces"| node_inventory_client
node_inventory_client -.->|"calls remotely"| node_inventory_api
node_order_logic -->|"reads and writes"| node_order_store
node_order_logic -->|"creates"| node_order_model
node_auth_api -->|"calls"| node_auth_logic
node_auth_logic -->|"checks and saves"| node_user_store
node_auth_logic -->|"creates"| node_user_model
node_auth_logic -->|"generates token"| node_jwt_service
node_auth_filter -.->|"validates tokens"| node_jwt_service

click node_gateway "https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/api-gateway/api-gateway/src/main/java/com/ecom/apigateway/ApiGatewayApplication.java"
click node_gateway_jwt "https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/api-gateway/api-gateway/src/main/java/com/ecom/apigateway/security/JwtAuthFilter.java"
click node_discovery "https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/discovery-server/discovery-server/src/main/java/com/ecom/discovery_server/DiscoveryServerApplication.java"
click node_product_api "https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/product-service/product-service/src/main/java/com/ecom/product_service/controller/ProductController.java"
click node_product_logic "https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/product-service/product-service/src/main/java/com/ecom/product_service/serviceImpl/ProductServiceImpl.java"
click node_product_store "https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/product-service/product-service/src/main/java/com/ecom/product_service/repository/ProductRepository.java"
click node_product_model "https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/product-service/product-service/src/main/java/com/ecom/product_service/entities/Product.java"
click node_inventory_api "https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/inventory-service/inventory-service/src/main/java/com/ecom/inventory_service/controller/InventoryController.java"
click node_inventory_logic "https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/inventory-service/inventory-service/src/main/java/com/ecom/inventory_service/serviceImpl/InventoryServiceImpl.java"
click node_inventory_store "https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/inventory-service/inventory-service/src/main/java/com/ecom/inventory_service/repository/InventoryRepository.java"
click node_inventory_model "https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/inventory-service/inventory-service/src/main/java/com/ecom/inventory_service/entities/Inventory.java"
click node_order_api "https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/order-service/order-service/src/main/java/com/ecom/order_service/controller/OrderController.java"
click node_order_logic "https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/order-service/order-service/src/main/java/com/ecom/order_service/serviceImpl/OrderServiceImpl.java"
click node_inventory_client "https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/order-service/order-service/src/main/java/com/ecom/order_service/client/InventoryClient.java"
click node_order_store "https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/order-service/order-service/src/main/java/com/ecom/order_service/repository/OrderRepository.java"
click node_order_model "https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/order-service/order-service/src/main/java/com/ecom/order_service/entities/Order.java"
click node_auth_api "https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/security/src/main/java/com/ecom/auth_service/controller/AuthController.java"
click node_auth_logic "https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/security/src/main/java/com/ecom/auth_service/service/AuthService.java"
click node_user_store "https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/security/src/main/java/com/ecom/auth_service/repository/UserRepository.java"
click node_user_model "https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/security/src/main/java/com/ecom/auth_service/entity/User.java"
click node_jwt_service "https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/security/src/main/java/com/ecom/auth_service/service/JwtService.java"
click node_auth_filter "https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/security/src/main/java/com/ecom/auth_service/security/JwtAuthenticationFilter.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_gateway_jwt,node_discovery,node_customer toneBlue
class node_product_api,node_product_logic,node_product_store,node_product_model toneAmber
class node_inventory_api,node_inventory_logic,node_inventory_store,node_inventory_model toneMint
class node_order_api,node_order_logic,node_inventory_client,node_order_store,node_order_model toneRose
class node_auth_api,node_auth_logic,node_user_store,node_user_model,node_jwt_service,node_auth_filter toneIndigo
```

## Components

### Gateway and Discovery

- [API Gateway](https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/api-gateway/api-gateway/src/main/java/com/ecom/apigateway/ApiGatewayApplication.java): `api-gateway/api-gateway/src/main/java/com/ecom/apigateway/ApiGatewayApplication.java`
- [Gateway JWT](https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/api-gateway/api-gateway/src/main/java/com/ecom/apigateway/security/JwtAuthFilter.java): `api-gateway/api-gateway/src/main/java/com/ecom/apigateway/security/JwtAuthFilter.java`
- [Eureka Server](https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/discovery-server/discovery-server/src/main/java/com/ecom/discovery_server/DiscoveryServerApplication.java): `discovery-server/discovery-server/src/main/java/com/ecom/discovery_server/DiscoveryServerApplication.java`

### Product Catalog

- [Product API](https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/product-service/product-service/src/main/java/com/ecom/product_service/controller/ProductController.java): `product-service/product-service/src/main/java/com/ecom/product_service/controller/ProductController.java`
- [Product Service](https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/product-service/product-service/src/main/java/com/ecom/product_service/serviceImpl/ProductServiceImpl.java): `product-service/product-service/src/main/java/com/ecom/product_service/serviceImpl/ProductServiceImpl.java`
- [Product Repository](https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/product-service/product-service/src/main/java/com/ecom/product_service/repository/ProductRepository.java): `product-service/product-service/src/main/java/com/ecom/product_service/repository/ProductRepository.java`
- [Product Model](https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/product-service/product-service/src/main/java/com/ecom/product_service/entities/Product.java): `product-service/product-service/src/main/java/com/ecom/product_service/entities/Product.java`

### Inventory

- [Inventory API](https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/inventory-service/inventory-service/src/main/java/com/ecom/inventory_service/controller/InventoryController.java): `inventory-service/inventory-service/src/main/java/com/ecom/inventory_service/controller/InventoryController.java`
- [Inventory Service](https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/inventory-service/inventory-service/src/main/java/com/ecom/inventory_service/serviceImpl/InventoryServiceImpl.java): `inventory-service/inventory-service/src/main/java/com/ecom/inventory_service/serviceImpl/InventoryServiceImpl.java`
- [Inventory Repository](https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/inventory-service/inventory-service/src/main/java/com/ecom/inventory_service/repository/InventoryRepository.java): `inventory-service/inventory-service/src/main/java/com/ecom/inventory_service/repository/InventoryRepository.java`
- [Inventory Model](https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/inventory-service/inventory-service/src/main/java/com/ecom/inventory_service/entities/Inventory.java): `inventory-service/inventory-service/src/main/java/com/ecom/inventory_service/entities/Inventory.java`

### Orders

- [Order API](https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/order-service/order-service/src/main/java/com/ecom/order_service/controller/OrderController.java): `order-service/order-service/src/main/java/com/ecom/order_service/controller/OrderController.java`
- [Order Service](https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/order-service/order-service/src/main/java/com/ecom/order_service/serviceImpl/OrderServiceImpl.java): `order-service/order-service/src/main/java/com/ecom/order_service/serviceImpl/OrderServiceImpl.java`
- [Inventory Client](https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/order-service/order-service/src/main/java/com/ecom/order_service/client/InventoryClient.java): `order-service/order-service/src/main/java/com/ecom/order_service/client/InventoryClient.java`
- [Order Repository](https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/order-service/order-service/src/main/java/com/ecom/order_service/repository/OrderRepository.java): `order-service/order-service/src/main/java/com/ecom/order_service/repository/OrderRepository.java`
- [Order Model](https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/order-service/order-service/src/main/java/com/ecom/order_service/entities/Order.java): `order-service/order-service/src/main/java/com/ecom/order_service/entities/Order.java`

### Authentication

- [Auth API](https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/security/src/main/java/com/ecom/auth_service/controller/AuthController.java): `security/src/main/java/com/ecom/auth_service/controller/AuthController.java`
- [Auth Service](https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/security/src/main/java/com/ecom/auth_service/service/AuthService.java): `security/src/main/java/com/ecom/auth_service/service/AuthService.java`
- [User Repository](https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/security/src/main/java/com/ecom/auth_service/repository/UserRepository.java): `security/src/main/java/com/ecom/auth_service/repository/UserRepository.java`
- [User and Role](https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/security/src/main/java/com/ecom/auth_service/entity/User.java): `security/src/main/java/com/ecom/auth_service/entity/User.java`
- [JWT Service](https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/security/src/main/java/com/ecom/auth_service/service/JwtService.java): `security/src/main/java/com/ecom/auth_service/service/JwtService.java`
- [Auth JWT Filter](https://github.com/dineshrajbhar-cloud/microservices-ecom/blob/main/security/src/main/java/com/ecom/auth_service/security/JwtAuthenticationFilter.java): `security/src/main/java/com/ecom/auth_service/security/JwtAuthenticationFilter.java`

### Other components

- **Client**

## Connections

- Client → API Gateway: sends requests
- API Gateway → Gateway JWT: filters with
- API Gateway → Product API: routes to
- API Gateway → Inventory API: routes to
- API Gateway → Order API: routes to
- API Gateway → Auth API: routes to
- API Gateway → Eureka Server: discovers services
- Product API → Product Service: calls (evidence: `product-service/product-service/src/main/java/com/ecom/product_service/controller/ProductController.java`)
- Product Service → Product Repository: reads and writes (evidence: `product-service/product-service/src/main/java/com/ecom/product_service/serviceImpl/ProductServiceImpl.java`)
- Product Service → Product Model: manages (evidence: `product-service/product-service/src/main/java/com/ecom/product_service/serviceImpl/ProductServiceImpl.java`)
- Inventory API → Inventory Service: calls (evidence: `inventory-service/inventory-service/src/main/java/com/ecom/inventory_service/controller/InventoryController.java`)
- Inventory Service → Inventory Repository: reads and writes (evidence: `inventory-service/inventory-service/src/main/java/com/ecom/inventory_service/serviceImpl/InventoryServiceImpl.java`)
- Inventory Service → Inventory Model: updates (evidence: `inventory-service/inventory-service/src/main/java/com/ecom/inventory_service/serviceImpl/InventoryServiceImpl.java`)
- Order API → Order Service: calls (evidence: `order-service/order-service/src/main/java/com/ecom/order_service/controller/OrderController.java`)
- Order Service → Inventory Client: checks and reduces (evidence: `order-service/order-service/src/main/java/com/ecom/order_service/serviceImpl/OrderServiceImpl.java`)
- Inventory Client → Inventory API: calls remotely
- Order Service → Order Repository: reads and writes (evidence: `order-service/order-service/src/main/java/com/ecom/order_service/serviceImpl/OrderServiceImpl.java`)
- Order Service → Order Model: creates (evidence: `order-service/order-service/src/main/java/com/ecom/order_service/serviceImpl/OrderServiceImpl.java`)
- Auth API → Auth Service: calls (evidence: `security/src/main/java/com/ecom/auth_service/controller/AuthController.java`)
- Auth Service → User Repository: checks and saves (evidence: `security/src/main/java/com/ecom/auth_service/service/AuthService.java`)
- Auth Service → User and Role: creates (evidence: `security/src/main/java/com/ecom/auth_service/service/AuthService.java`)
- Auth Service → JWT Service: generates token (evidence: `security/src/main/java/com/ecom/auth_service/service/AuthService.java`)
- Auth JWT Filter → JWT Service: validates tokens (evidence: `security/src/main/java/com/ecom/auth_service/security/JwtAuthenticationFilter.java`)
