# sushmitha-katika-dev/ecommerce-microservices-platform architecture

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

- Interactive diagram: https://gitdiagram.com/sushmitha-katika-dev/ecommerce-microservices-platform
- Repository: https://github.com/sushmitha-katika-dev/ecommerce-microservices-platform

## Overview

This is a Spring Boot e-commerce microservices platform. Customers enter through the API gateway, authenticate or manage accounts, browse products, maintain a cart, and place orders; order creation then drives payment, inventory-related processing, and notifications through Kafka. The graph preserves the product, cart, order, payment, user, and notification domains plus gateway security. Only cart/order controllers and services, authentication implementation, and service contracts were sampled; other interactions are documented at the subsystem level or left unverified.

Main entry points: [`api-gateway/src/main/java/com/ecommerce/api_gateway`](https://github.com/sushmitha-katika-dev/ecommerce-microservices-platform/tree/main/api-gateway/src/main/java/com/ecommerce/api_gateway) (API gateway), [`order-service/src/main/java/com/ecommerce/order_service/service/impl/OrderServiceImpl.java`](https://github.com/sushmitha-katika-dev/ecommerce-microservices-platform/blob/main/order-service/src/main/java/com/ecommerce/order_service/service/impl/OrderServiceImpl.java) (Order service), [`user-service/src/main/java/com/ecommerce/user_service/service/impl/AuthServiceImpl.java`](https://github.com/sushmitha-katika-dev/ecommerce-microservices-platform/blob/main/user-service/src/main/java/com/ecommerce/user_service/service/impl/AuthServiceImpl.java) (Authentication), [`cart-service/src/main/java/com/ecommerce/cart_service/service/impl/CartServiceImpl.java`](https://github.com/sushmitha-katika-dev/ecommerce-microservices-platform/blob/main/cart-service/src/main/java/com/ecommerce/cart_service/service/impl/CartServiceImpl.java) (Cart operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["API entry"]
  node_gateway["API gateway"]
end

subgraph group_identity["Identity"]
  node_auth["Authentication"]
  node_user["User accounts"]
end

subgraph group_catalog["Catalog and cart"]
  node_products["Products and categories"]
  node_inventory["Inventory"]
  node_cart["Shopping cart"]
  node_cart_core["Cart operations"]
end

subgraph group_fulfillment["Order and payment"]
  node_orders["Order processing"]
  node_order_core["Order service"]
  node_payments["Payments"]
  node_databases[("Service databases")]
end

subgraph group_messaging["Events and notifications"]
  node_kafka["Kafka event bus"]
  node_notifications["Notifications"]
end

node_customer(("Customer"))

node_customer -->|"sends requests"| node_gateway
node_gateway -.->|"routes auth"| node_auth
node_gateway -.->|"routes API"| node_products
node_gateway -.->|"routes API"| node_cart
node_gateway -.->|"routes API"| node_orders
node_gateway -.->|"routes API"| node_user
node_auth -->|"returns JWT"| node_customer
node_cart -->|"delegates"| node_cart_core
node_customer -->|"manages cart"| node_cart
node_customer -->|"places orders"| node_orders
node_orders -.->|"delegates"| node_order_core
node_order_core -->|"persists orders"| node_databases
node_order_core -->|"publishes order event"| node_kafka
node_cart_core -.->|"publishes checkout"| node_kafka
node_kafka -.->|"dispatches order event"| node_payments
node_kafka -.->|"dispatches order event"| node_inventory
node_payments -.->|"publishes payment event"| node_kafka
node_kafka -.->|"dispatches payment status"| node_order_core
node_kafka -.->|"dispatches business events"| node_notifications
node_notifications -.->|"sends email"| node_customer
node_products -.->|"stores catalog"| node_databases
node_cart_core -.->|"validates products"| node_products
node_auth -->|"stores accounts"| node_databases

click node_gateway "https://github.com/sushmitha-katika-dev/ecommerce-microservices-platform/tree/main/api-gateway/src/main/java/com/ecommerce/api_gateway"
click node_auth "https://github.com/sushmitha-katika-dev/ecommerce-microservices-platform/blob/main/user-service/src/main/java/com/ecommerce/user_service/service/impl/AuthServiceImpl.java"
click node_user "https://github.com/sushmitha-katika-dev/ecommerce-microservices-platform/blob/main/user-service/src/main/java/com/ecommerce/user_service/controller/UserController.java"
click node_products "https://github.com/sushmitha-katika-dev/ecommerce-microservices-platform/tree/main/product-service/src/main/java/com/ecommerce/product_service"
click node_inventory "https://github.com/sushmitha-katika-dev/ecommerce-microservices-platform/blob/main/product-service/src/main/java/com/ecommerce/product_service/service/impl/InventoryServiceImpl.java"
click node_cart "https://github.com/sushmitha-katika-dev/ecommerce-microservices-platform/blob/main/cart-service/src/main/java/com/ecommerce/cart_service/controller/CartController.java"
click node_cart_core "https://github.com/sushmitha-katika-dev/ecommerce-microservices-platform/blob/main/cart-service/src/main/java/com/ecommerce/cart_service/service/impl/CartServiceImpl.java"
click node_orders "https://github.com/sushmitha-katika-dev/ecommerce-microservices-platform/blob/main/order-service/src/main/java/com/ecommerce/order_service/controller/OrderController.java"
click node_order_core "https://github.com/sushmitha-katika-dev/ecommerce-microservices-platform/blob/main/order-service/src/main/java/com/ecommerce/order_service/service/impl/OrderServiceImpl.java"
click node_payments "https://github.com/sushmitha-katika-dev/ecommerce-microservices-platform/tree/main/payment-service/src/main/java/com/ecommerce/payment_service"
click node_notifications "https://github.com/sushmitha-katika-dev/ecommerce-microservices-platform/tree/main/notification-service/src/main/java/com/ecommerce/notification_service"

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 toneBlue
class node_auth,node_user toneAmber
class node_products,node_inventory,node_cart,node_cart_core toneMint
class node_orders,node_order_core,node_payments,node_databases toneRose
class node_kafka,node_notifications,node_customer toneIndigo
```

## Components

### API entry

- [API gateway](https://github.com/sushmitha-katika-dev/ecommerce-microservices-platform/tree/main/api-gateway/src/main/java/com/ecommerce/api_gateway): `api-gateway/src/main/java/com/ecommerce/api_gateway`

### Identity

- [Authentication](https://github.com/sushmitha-katika-dev/ecommerce-microservices-platform/blob/main/user-service/src/main/java/com/ecommerce/user_service/service/impl/AuthServiceImpl.java): `user-service/src/main/java/com/ecommerce/user_service/service/impl/AuthServiceImpl.java`
- [User accounts](https://github.com/sushmitha-katika-dev/ecommerce-microservices-platform/blob/main/user-service/src/main/java/com/ecommerce/user_service/controller/UserController.java): `user-service/src/main/java/com/ecommerce/user_service/controller/UserController.java`

### Catalog and cart

- [Products and categories](https://github.com/sushmitha-katika-dev/ecommerce-microservices-platform/tree/main/product-service/src/main/java/com/ecommerce/product_service): `product-service/src/main/java/com/ecommerce/product_service`
- [Inventory](https://github.com/sushmitha-katika-dev/ecommerce-microservices-platform/blob/main/product-service/src/main/java/com/ecommerce/product_service/service/impl/InventoryServiceImpl.java): `product-service/src/main/java/com/ecommerce/product_service/service/impl/InventoryServiceImpl.java`
- [Shopping cart](https://github.com/sushmitha-katika-dev/ecommerce-microservices-platform/blob/main/cart-service/src/main/java/com/ecommerce/cart_service/controller/CartController.java): `cart-service/src/main/java/com/ecommerce/cart_service/controller/CartController.java`
- [Cart operations](https://github.com/sushmitha-katika-dev/ecommerce-microservices-platform/blob/main/cart-service/src/main/java/com/ecommerce/cart_service/service/impl/CartServiceImpl.java): `cart-service/src/main/java/com/ecommerce/cart_service/service/impl/CartServiceImpl.java`

### Order and payment

- [Order processing](https://github.com/sushmitha-katika-dev/ecommerce-microservices-platform/blob/main/order-service/src/main/java/com/ecommerce/order_service/controller/OrderController.java): `order-service/src/main/java/com/ecommerce/order_service/controller/OrderController.java`
- [Order service](https://github.com/sushmitha-katika-dev/ecommerce-microservices-platform/blob/main/order-service/src/main/java/com/ecommerce/order_service/service/impl/OrderServiceImpl.java): `order-service/src/main/java/com/ecommerce/order_service/service/impl/OrderServiceImpl.java`
- [Payments](https://github.com/sushmitha-katika-dev/ecommerce-microservices-platform/tree/main/payment-service/src/main/java/com/ecommerce/payment_service): `payment-service/src/main/java/com/ecommerce/payment_service`
- **Service databases**

### Events and notifications

- **Kafka event bus**
- [Notifications](https://github.com/sushmitha-katika-dev/ecommerce-microservices-platform/tree/main/notification-service/src/main/java/com/ecommerce/notification_service): `notification-service/src/main/java/com/ecommerce/notification_service`

### Other components

- **Customer**

## Connections

- Customer → API gateway: sends requests (evidence: `README.md`)
- API gateway → Authentication: routes auth (evidence: `README.md`)
- API gateway → Products and categories: routes API (evidence: `README.md`)
- API gateway → Shopping cart: routes API (evidence: `README.md`)
- API gateway → Order processing: routes API (evidence: `README.md`)
- API gateway → User accounts: routes API (evidence: `README.md`)
- Authentication → Customer: returns JWT (evidence: `user-service/src/main/java/com/ecommerce/user_service/service/impl/AuthServiceImpl.java`)
- Shopping cart → Cart operations: delegates (evidence: `cart-service/src/main/java/com/ecommerce/cart_service/controller/CartController.java`)
- Customer → Shopping cart: manages cart (evidence: `cart-service/src/main/java/com/ecommerce/cart_service/controller/CartController.java`)
- Customer → Order processing: places orders (evidence: `order-service/src/main/java/com/ecommerce/order_service/controller/OrderController.java`)
- Order processing → Order service: delegates (evidence: `order-service/src/main/java/com/ecommerce/order_service/controller/OrderController.java`)
- Order service → Service databases: persists orders (evidence: `order-service/src/main/java/com/ecommerce/order_service/service/impl/OrderServiceImpl.java`)
- Order service → Kafka event bus: publishes order event (evidence: `order-service/src/main/java/com/ecommerce/order_service/service/impl/OrderServiceImpl.java`)
- Cart operations → Kafka event bus: publishes checkout
- Kafka event bus → Payments: dispatches order event
- Kafka event bus → Inventory: dispatches order event
- Payments → Kafka event bus: publishes payment event
- Kafka event bus → Order service: dispatches payment status
- Kafka event bus → Notifications: dispatches business events
- Notifications → Customer: sends email
- Products and categories → Service databases: stores catalog
- Cart operations → Products and categories: validates products (evidence: `cart-service/src/main/java/com/ecommerce/cart_service/service/impl/CartServiceImpl.java`)
- Authentication → Service databases: stores accounts (evidence: `user-service/src/main/java/com/ecommerce/user_service/service/impl/AuthServiceImpl.java`)
