# shrikar411/ecom-backned architecture

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

- Interactive diagram: https://gitdiagram.com/shrikar411/ecom-backned
- Repository: https://github.com/shrikar411/ecom-backned

## Overview

This Spring Boot e-commerce API supports product catalog management and search, customer records, cart management, and order creation. A client request enters through the corresponding controller; services apply the domain logic and repositories persist or retrieve entities. The clearest end-to-end flow is cart to order: OrderService reads the cart, saves a confirmed order, clears the cart, and returns an order response. Controller-to-service and service-to-repository calls are supported by the index; links to unsampled controller/service relationships are not independently verified in excerpts.

Main entry points: [`src/main/java/com/app/ecom/service/OrderService.java`](https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/service/OrderService.java) (Order service), [`src/main/java/com/app/ecom/service/CartService.java`](https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/service/CartService.java) (Cart service), [`src/main/java/com/app/ecom/controller/CartController.java`](https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/controller/CartController.java) (Cart endpoints), [`src/main/java/com/app/ecom/service/ProductService.java`](https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/service/ProductService.java) (Catalog service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API"]
  node_product_api["Product endpoints"]
  node_user_api["User endpoints"]
  node_cart_api["Cart endpoints"]
  node_order_api["Order endpoints"]
end

subgraph group_domain["Domain services"]
  node_product_service["Catalog service"]
  node_user_service["User service<br/>[UserService.java]"]
  node_cart_service["Cart service<br/>[CartService.java]"]
  node_order_service["Order service<br/>[OrderService.java]"]
end

subgraph group_persistence["Persistence"]
  node_product_repo[("Product records")]
  node_user_repo[("User records")]
  node_cart_repo[("Cart records")]
  node_order_repo[("Order records")]
  node_product_model["Product entity<br/>[Product.java]"]
  node_user_model["User and address<br/>[User.java]"]
  node_cart_model["Cart item<br/>[CartItem.java]"]
  node_order_model["Order and items<br/>[Order.java]"]
end

subgraph group_contracts["API contracts"]
  node_product_dto["Product contracts"]
  node_user_dto["User contracts<br/>[UserResponse.java]"]
  node_cart_dto["Cart request"]
  node_order_dto["Order response<br/>[OrderResponse.java]"]
end

node_client(("API client"))

node_client -->|"requests"| node_product_api
node_client -->|"requests"| node_user_api
node_client -->|"requests"| node_cart_api
node_client -->|"requests"| node_order_api
node_product_api -->|"delegates"| node_product_service
node_user_api -->|"delegates"| node_user_service
node_cart_api -->|"delegates"| node_cart_service
node_order_api -->|"delegates"| node_order_service
node_product_service -->|"queries and saves"| node_product_repo
node_user_service -->|"queries and saves"| node_user_repo
node_cart_service -->|"looks up products"| node_product_repo
node_cart_service -->|"looks up users"| node_user_repo
node_cart_service -->|"reads and writes"| node_cart_repo
node_order_service -->|"loads and clears"| node_cart_service
node_order_service -->|"looks up user"| node_user_repo
node_order_service -->|"saves order"| node_order_repo
node_product_service -->|"maps requests"| node_product_dto
node_user_service -->|"maps requests"| node_user_dto
node_cart_api -->|"accepts"| node_cart_dto
node_order_service -->|"builds response"| node_order_dto

click node_product_api "https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/controller/ProductController.java"
click node_user_api "https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/controller/UserController.java"
click node_cart_api "https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/controller/CartController.java"
click node_order_api "https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/controller/OrderController.java"
click node_product_service "https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/service/ProductService.java"
click node_user_service "https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/service/UserService.java"
click node_cart_service "https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/service/CartService.java"
click node_order_service "https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/service/OrderService.java"
click node_product_repo "https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/repository/ProductRepository.java"
click node_user_repo "https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/repository/UserRepository.java"
click node_cart_repo "https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/repository/CartItemRepository.java"
click node_order_repo "https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/repository/OrderRepository.java"
click node_product_model "https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/model/Product.java"
click node_user_model "https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/model/User.java"
click node_cart_model "https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/model/CartItem.java"
click node_order_model "https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/model/Order.java"
click node_product_dto "https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/dto/ProductRequest.java"
click node_user_dto "https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/dto/UserResponse.java"
click node_cart_dto "https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/dto/CartItemRequest.java"
click node_order_dto "https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/dto/OrderResponse.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_product_api,node_user_api,node_cart_api,node_order_api,node_client toneBlue
class node_product_service,node_user_service,node_cart_service,node_order_service toneAmber
class node_product_repo,node_user_repo,node_cart_repo,node_order_repo,node_product_model,node_user_model,node_cart_model,node_order_model toneMint
class node_product_dto,node_user_dto,node_cart_dto,node_order_dto toneRose
```

## Components

### API

- [Product endpoints](https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/controller/ProductController.java): `src/main/java/com/app/ecom/controller/ProductController.java`
- [User endpoints](https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/controller/UserController.java): `src/main/java/com/app/ecom/controller/UserController.java`
- [Cart endpoints](https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/controller/CartController.java): `src/main/java/com/app/ecom/controller/CartController.java`
- [Order endpoints](https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/controller/OrderController.java): `src/main/java/com/app/ecom/controller/OrderController.java`

### Domain services

- [Catalog service](https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/service/ProductService.java): `src/main/java/com/app/ecom/service/ProductService.java`
- [User service](https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/service/UserService.java): `src/main/java/com/app/ecom/service/UserService.java`
- [Cart service](https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/service/CartService.java): `src/main/java/com/app/ecom/service/CartService.java`
- [Order service](https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/service/OrderService.java): `src/main/java/com/app/ecom/service/OrderService.java`

### Persistence

- [Product records](https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/repository/ProductRepository.java): `src/main/java/com/app/ecom/repository/ProductRepository.java`
- [User records](https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/repository/UserRepository.java): `src/main/java/com/app/ecom/repository/UserRepository.java`
- [Cart records](https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/repository/CartItemRepository.java): `src/main/java/com/app/ecom/repository/CartItemRepository.java`
- [Order records](https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/repository/OrderRepository.java): `src/main/java/com/app/ecom/repository/OrderRepository.java`
- [Product entity](https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/model/Product.java): `src/main/java/com/app/ecom/model/Product.java`
- [User and address](https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/model/User.java): `src/main/java/com/app/ecom/model/User.java`
- [Cart item](https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/model/CartItem.java): `src/main/java/com/app/ecom/model/CartItem.java`
- [Order and items](https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/model/Order.java): `src/main/java/com/app/ecom/model/Order.java`

### API contracts

- [Product contracts](https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/dto/ProductRequest.java): `src/main/java/com/app/ecom/dto/ProductRequest.java`
- [User contracts](https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/dto/UserResponse.java): `src/main/java/com/app/ecom/dto/UserResponse.java`
- [Cart request](https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/dto/CartItemRequest.java): `src/main/java/com/app/ecom/dto/CartItemRequest.java`
- [Order response](https://github.com/shrikar411/ecom-backned/blob/main/src/main/java/com/app/ecom/dto/OrderResponse.java): `src/main/java/com/app/ecom/dto/OrderResponse.java`

### Other components

- **API client**

## Connections

- API client → Product endpoints: requests
- API client → User endpoints: requests
- API client → Cart endpoints: requests
- API client → Order endpoints: requests
- Product endpoints → Catalog service: delegates (evidence: `src/main/java/com/app/ecom/controller/ProductController.java`)
- User endpoints → User service: delegates (evidence: `src/main/java/com/app/ecom/controller/UserController.java`)
- Cart endpoints → Cart service: delegates (evidence: `src/main/java/com/app/ecom/controller/CartController.java`)
- Order endpoints → Order service: delegates (evidence: `src/main/java/com/app/ecom/controller/OrderController.java`)
- Catalog service → Product records: queries and saves (evidence: `src/main/java/com/app/ecom/service/ProductService.java`)
- User service → User records: queries and saves (evidence: `src/main/java/com/app/ecom/service/UserService.java`)
- Cart service → Product records: looks up products (evidence: `src/main/java/com/app/ecom/service/CartService.java`)
- Cart service → User records: looks up users (evidence: `src/main/java/com/app/ecom/service/CartService.java`)
- Cart service → Cart records: reads and writes (evidence: `src/main/java/com/app/ecom/service/CartService.java`)
- Order service → Cart service: loads and clears (evidence: `src/main/java/com/app/ecom/service/OrderService.java`)
- Order service → User records: looks up user (evidence: `src/main/java/com/app/ecom/service/OrderService.java`)
- Order service → Order records: saves order (evidence: `src/main/java/com/app/ecom/service/OrderService.java`)
- Catalog service → Product contracts: maps requests (evidence: `src/main/java/com/app/ecom/service/ProductService.java`)
- User service → User contracts: maps requests (evidence: `src/main/java/com/app/ecom/service/UserService.java`)
- Cart endpoints → Cart request: accepts (evidence: `src/main/java/com/app/ecom/controller/CartController.java`)
- Order service → Order response: builds response (evidence: `src/main/java/com/app/ecom/service/OrderService.java`)
