# vinothkrishnan077/e-commerce architecture

> Architecture diagram of the GitHub repository vinothkrishnan077/e-commerce, 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/vinothkrishnan077/e-commerce
- Repository: https://github.com/vinothkrishnan077/e-commerce

## Overview

This is a Spring Boot e-commerce API for product browsing and management and user registration, login, and administration. The main flow is an API client calling a controller, which delegates to a service; services apply business rules and use repositories for persistence. Product features include search, pricing and delivery rules, vendor association, and image upload. User services handle role checks and password hashing. The excerpts establish controller-to-service and service-to-repository calls; database and framework wiring beyond those excerpts is not asserted.

Main entry points: [`src/main/java/com/assessment/ecommerce/service/ProductService.java`](https://github.com/vinothkrishnan077/e-commerce/blob/main/src/main/java/com/assessment/ecommerce/service/ProductService.java) (Product service), [`src/main/java/com/assessment/ecommerce/service/UserService.java`](https://github.com/vinothkrishnan077/e-commerce/blob/main/src/main/java/com/assessment/ecommerce/service/UserService.java) (User service), [`src/main/java/com/assessment/ecommerce/controller/ProductController.java`](https://github.com/vinothkrishnan077/e-commerce/blob/main/src/main/java/com/assessment/ecommerce/controller/ProductController.java) (Product API), [`src/main/java/com/assessment/ecommerce/controller/UserController.java`](https://github.com/vinothkrishnan077/e-commerce/blob/main/src/main/java/com/assessment/ecommerce/controller/UserController.java) (User API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API layer"]
  node_product_api["Product API"]
  node_user_api["User API"]
end

subgraph group_domain["Business services"]
  node_product_service["Product service"]
  node_user_service["User service<br/>[UserService.java]"]
end

subgraph group_persistence["Domain and persistence"]
  node_product_repo["Product repository"]
  node_user_repo["User repository"]
  node_product_model["Product entity<br/>[Product.java]"]
  node_user_model["User entity<br/>[User.java]"]
  node_mysql[("MySQL database")]
end

subgraph group_platform["Security and errors"]
  node_security["Web security"]
  node_exception_handler["Exception handler"]
  node_app["Application entry"]
end

node_client(("API client"))

node_client -->|"calls product endpoints"| node_product_api
node_client -->|"calls user endpoints"| node_user_api
node_product_api -->|"delegates"| node_product_service
node_user_api -->|"delegates"| node_user_service
node_product_service -->|"queries and saves"| node_product_repo
node_product_service -->|"looks up vendor"| node_user_repo
node_user_service -->|"queries and saves"| node_user_repo
node_user_service -.->|"uses password encoder"| node_security
node_product_model -->|"references vendor"| node_user_model
node_product_repo -.->|"persists products"| node_mysql
node_user_repo -.->|"persists users"| node_mysql
node_client -.->|"requests filtered"| node_security
node_app -.->|"starts application"| node_product_api
node_app -.->|"starts application"| node_user_api

click node_product_api "https://github.com/vinothkrishnan077/e-commerce/blob/main/src/main/java/com/assessment/ecommerce/controller/ProductController.java"
click node_user_api "https://github.com/vinothkrishnan077/e-commerce/blob/main/src/main/java/com/assessment/ecommerce/controller/UserController.java"
click node_product_service "https://github.com/vinothkrishnan077/e-commerce/blob/main/src/main/java/com/assessment/ecommerce/service/ProductService.java"
click node_user_service "https://github.com/vinothkrishnan077/e-commerce/blob/main/src/main/java/com/assessment/ecommerce/service/UserService.java"
click node_product_repo "https://github.com/vinothkrishnan077/e-commerce/blob/main/src/main/java/com/assessment/ecommerce/repository/ProductRepository.java"
click node_user_repo "https://github.com/vinothkrishnan077/e-commerce/blob/main/src/main/java/com/assessment/ecommerce/repository/UserRepository.java"
click node_product_model "https://github.com/vinothkrishnan077/e-commerce/blob/main/src/main/java/com/assessment/ecommerce/model/Product.java"
click node_user_model "https://github.com/vinothkrishnan077/e-commerce/blob/main/src/main/java/com/assessment/ecommerce/model/User.java"
click node_security "https://github.com/vinothkrishnan077/e-commerce/blob/main/src/main/java/com/assessment/ecommerce/security/WebsecurityConfig.java"
click node_exception_handler "https://github.com/vinothkrishnan077/e-commerce/blob/main/src/main/java/com/assessment/ecommerce/exception/GlobalExceptionHandler.java"
click node_app "https://github.com/vinothkrishnan077/e-commerce/blob/main/src/main/java/com/assessment/ecommerce/EcommerceApplication.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_client toneBlue
class node_product_service,node_user_service toneAmber
class node_product_repo,node_user_repo,node_product_model,node_user_model,node_mysql toneMint
class node_security,node_exception_handler,node_app toneRose
```

## Components

### API layer

- [Product API](https://github.com/vinothkrishnan077/e-commerce/blob/main/src/main/java/com/assessment/ecommerce/controller/ProductController.java): `src/main/java/com/assessment/ecommerce/controller/ProductController.java`
- [User API](https://github.com/vinothkrishnan077/e-commerce/blob/main/src/main/java/com/assessment/ecommerce/controller/UserController.java): `src/main/java/com/assessment/ecommerce/controller/UserController.java`

### Business services

- [Product service](https://github.com/vinothkrishnan077/e-commerce/blob/main/src/main/java/com/assessment/ecommerce/service/ProductService.java): `src/main/java/com/assessment/ecommerce/service/ProductService.java`
- [User service](https://github.com/vinothkrishnan077/e-commerce/blob/main/src/main/java/com/assessment/ecommerce/service/UserService.java): `src/main/java/com/assessment/ecommerce/service/UserService.java`

### Domain and persistence

- [Product repository](https://github.com/vinothkrishnan077/e-commerce/blob/main/src/main/java/com/assessment/ecommerce/repository/ProductRepository.java): `src/main/java/com/assessment/ecommerce/repository/ProductRepository.java`
- [User repository](https://github.com/vinothkrishnan077/e-commerce/blob/main/src/main/java/com/assessment/ecommerce/repository/UserRepository.java): `src/main/java/com/assessment/ecommerce/repository/UserRepository.java`
- [Product entity](https://github.com/vinothkrishnan077/e-commerce/blob/main/src/main/java/com/assessment/ecommerce/model/Product.java): `src/main/java/com/assessment/ecommerce/model/Product.java`
- [User entity](https://github.com/vinothkrishnan077/e-commerce/blob/main/src/main/java/com/assessment/ecommerce/model/User.java): `src/main/java/com/assessment/ecommerce/model/User.java`
- **MySQL database**

### Security and errors

- [Web security](https://github.com/vinothkrishnan077/e-commerce/blob/main/src/main/java/com/assessment/ecommerce/security/WebsecurityConfig.java): `src/main/java/com/assessment/ecommerce/security/WebsecurityConfig.java`
- [Exception handler](https://github.com/vinothkrishnan077/e-commerce/blob/main/src/main/java/com/assessment/ecommerce/exception/GlobalExceptionHandler.java): `src/main/java/com/assessment/ecommerce/exception/GlobalExceptionHandler.java`
- [Application entry](https://github.com/vinothkrishnan077/e-commerce/blob/main/src/main/java/com/assessment/ecommerce/EcommerceApplication.java): `src/main/java/com/assessment/ecommerce/EcommerceApplication.java`

### Other components

- **API client**

## Connections

- API client → Product API: calls product endpoints (evidence: `src/main/java/com/assessment/ecommerce/controller/ProductController.java`)
- API client → User API: calls user endpoints (evidence: `src/main/java/com/assessment/ecommerce/controller/UserController.java`)
- Product API → Product service: delegates (evidence: `src/main/java/com/assessment/ecommerce/controller/ProductController.java`)
- User API → User service: delegates (evidence: `src/main/java/com/assessment/ecommerce/controller/UserController.java`)
- Product service → Product repository: queries and saves (evidence: `src/main/java/com/assessment/ecommerce/service/ProductService.java`)
- Product service → User repository: looks up vendor (evidence: `src/main/java/com/assessment/ecommerce/service/ProductService.java`)
- User service → User repository: queries and saves (evidence: `src/main/java/com/assessment/ecommerce/service/UserService.java`)
- User service → Web security: uses password encoder
- Product entity → User entity: references vendor (evidence: `src/main/java/com/assessment/ecommerce/model/Product.java`)
- Product repository → MySQL database: persists products
- User repository → MySQL database: persists users
- API client → Web security: requests filtered
- Application entry → Product API: starts application
- Application entry → User API: starts application
