# bhavendan/ecommerce-app architecture

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

- Interactive diagram: https://gitdiagram.com/bhavendan/ecommerce-app
- Repository: https://github.com/bhavendan/ecommerce-app

## Overview

This is a Spring Boot REST e-commerce backend. Customers authenticate, browse products and categories, manage a cart, and place or review orders; administrators manage products, categories, and users. The README documents these capabilities, JWT/Spring Security authorization, MySQL, and OpenAPI. No source excerpts were provided, so internal controller-to-service and persistence calls are shown only as unverified dashed links; the graph does not assert their exact implementation flow.

Main entry points: [`src/main/java/org/example/ecommerceapp/controller/AuthController.java`](https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/controller/AuthController.java) (Authentication API), [`src/main/java/org/example/ecommerceapp/serviceIMPL/ProductServiceImpl.java`](https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/serviceIMPL/ProductServiceImpl.java) (Product Management), [`src/main/java/org/example/ecommerceapp/serviceIMPL/CategoryServiceImpl.java`](https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/serviceIMPL/CategoryServiceImpl.java) (Category Management), [`src/main/java/org/example/ecommerceapp/serviceIMPL/UserServiceImpl.java`](https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/serviceIMPL/UserServiceImpl.java) (User Management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_auth_api["Authentication API"]
  node_product_api["Product API"]
  node_category_api["Category API"]
  node_cart_api["Cart API"]
  node_order_api["Order API"]
  node_admin_product_api["Admin Product API"]
  node_admin_category_api["Admin Category API"]
  node_user_api["User Management API"]
  node_home_api["Home API"]
  node_exceptions["Global Error Handling"]
end

subgraph group_commerce["Commerce Services"]
  node_product_service["Product Management"]
  node_category_service["Category Management"]
  node_cart_service["Cart Operations"]
  node_order_service["Order Processing"]
end

subgraph group_identity["Identity &amp; Security"]
  node_user_service["User Management"]
  node_jwt_service["JWT Issuance<br/>[JWTService.java]"]
  node_user_details["User Details Lookup"]
  node_security["Security Policy"]
  node_jwt_filter["JWT Filter"]
end

subgraph group_data["Persistence &amp; API Docs"]
  node_mysql[("MySQL")]
  node_openapi["OpenAPI Documentation<br/>[OpenApiConfig.java]"]
end

node_customer(("Customer"))
node_admin(("Administrator"))

node_customer -->|"registers / logs in"| node_auth_api
node_customer -->|"browses / searches"| node_product_api
node_customer -->|"views categories"| node_category_api
node_customer -->|"manages cart"| node_cart_api
node_customer -->|"places / reviews"| node_order_api
node_admin -->|"manages products"| node_admin_product_api
node_admin -->|"manages categories"| node_admin_category_api
node_admin -->|"manages users"| node_user_api
node_auth_api -.->|"delegates"| node_user_service
node_auth_api -.->|"issues tokens"| node_jwt_service
node_security -.->|"configures"| node_jwt_filter
node_jwt_filter -.->|"loads identity"| node_user_details
node_product_api -.->|"delegates"| node_product_service
node_admin_product_api -.->|"delegates"| node_product_service
node_category_api -.->|"delegates"| node_category_service
node_admin_category_api -.->|"delegates"| node_category_service
node_cart_api -.->|"delegates"| node_cart_service
node_order_api -.->|"delegates"| node_order_service
node_user_api -.->|"delegates"| node_user_service
node_product_service -.->|"persists data"| node_mysql
node_category_service -.->|"persists data"| node_mysql
node_cart_service -.->|"persists data"| node_mysql
node_order_service -.->|"persists data"| node_mysql
node_user_service -.->|"persists data"| node_mysql

click node_auth_api "https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/controller/AuthController.java"
click node_product_api "https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/controller/ProductController.java"
click node_category_api "https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/controller/CategoryController.java"
click node_cart_api "https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/controller/CartController.java"
click node_order_api "https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/controller/OrderController.java"
click node_admin_product_api "https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/controller/AdminProductController.java"
click node_admin_category_api "https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/controller/AdminCategoryController.java"
click node_user_api "https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/controller/UserController.java"
click node_home_api "https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/controller/HomeController.java"
click node_product_service "https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/serviceIMPL/ProductServiceImpl.java"
click node_category_service "https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/serviceIMPL/CategoryServiceImpl.java"
click node_cart_service "https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/serviceIMPL/CartServiceImpl.java"
click node_order_service "https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/serviceIMPL/OrderServiceImpl.java"
click node_user_service "https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/serviceIMPL/UserServiceImpl.java"
click node_jwt_service "https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/serviceIMPL/JWTService.java"
click node_user_details "https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/serviceIMPL/CustomUserDetailsService.java"
click node_security "https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/config/SecurityConfig.java"
click node_jwt_filter "https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/dto/JwtAuthenticationFilter.java"
click node_openapi "https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/config/OpenApiConfig.java"
click node_exceptions "https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/exception/GlobalExceptionHandler.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_auth_api,node_product_api,node_category_api,node_cart_api,node_order_api,node_admin_product_api,node_admin_category_api,node_user_api,node_home_api,node_exceptions toneBlue
class node_product_service,node_category_service,node_cart_service,node_order_service toneAmber
class node_user_service,node_jwt_service,node_user_details,node_security,node_jwt_filter toneMint
class node_mysql,node_openapi toneRose
class node_customer,node_admin toneIndigo
```

## Components

### REST API

- [Authentication API](https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/controller/AuthController.java): `src/main/java/org/example/ecommerceapp/controller/AuthController.java`
- [Product API](https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/controller/ProductController.java): `src/main/java/org/example/ecommerceapp/controller/ProductController.java`
- [Category API](https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/controller/CategoryController.java): `src/main/java/org/example/ecommerceapp/controller/CategoryController.java`
- [Cart API](https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/controller/CartController.java): `src/main/java/org/example/ecommerceapp/controller/CartController.java`
- [Order API](https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/controller/OrderController.java): `src/main/java/org/example/ecommerceapp/controller/OrderController.java`
- [Admin Product API](https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/controller/AdminProductController.java): `src/main/java/org/example/ecommerceapp/controller/AdminProductController.java`
- [Admin Category API](https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/controller/AdminCategoryController.java): `src/main/java/org/example/ecommerceapp/controller/AdminCategoryController.java`
- [User Management API](https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/controller/UserController.java): `src/main/java/org/example/ecommerceapp/controller/UserController.java`
- [Home API](https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/controller/HomeController.java): `src/main/java/org/example/ecommerceapp/controller/HomeController.java`
- [Global Error Handling](https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/exception/GlobalExceptionHandler.java): `src/main/java/org/example/ecommerceapp/exception/GlobalExceptionHandler.java`

### Commerce Services

- [Product Management](https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/serviceIMPL/ProductServiceImpl.java): `src/main/java/org/example/ecommerceapp/serviceIMPL/ProductServiceImpl.java`
- [Category Management](https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/serviceIMPL/CategoryServiceImpl.java): `src/main/java/org/example/ecommerceapp/serviceIMPL/CategoryServiceImpl.java`
- [Cart Operations](https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/serviceIMPL/CartServiceImpl.java): `src/main/java/org/example/ecommerceapp/serviceIMPL/CartServiceImpl.java`
- [Order Processing](https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/serviceIMPL/OrderServiceImpl.java): `src/main/java/org/example/ecommerceapp/serviceIMPL/OrderServiceImpl.java`

### Identity & Security

- [User Management](https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/serviceIMPL/UserServiceImpl.java): `src/main/java/org/example/ecommerceapp/serviceIMPL/UserServiceImpl.java`
- [JWT Issuance](https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/serviceIMPL/JWTService.java): `src/main/java/org/example/ecommerceapp/serviceIMPL/JWTService.java`
- [User Details Lookup](https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/serviceIMPL/CustomUserDetailsService.java): `src/main/java/org/example/ecommerceapp/serviceIMPL/CustomUserDetailsService.java`
- [Security Policy](https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/config/SecurityConfig.java): `src/main/java/org/example/ecommerceapp/config/SecurityConfig.java`
- [JWT Filter](https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/dto/JwtAuthenticationFilter.java): `src/main/java/org/example/ecommerceapp/dto/JwtAuthenticationFilter.java`

### Persistence & API Docs

- **MySQL**
- [OpenAPI Documentation](https://github.com/bhavendan/ecommerce-app/blob/main/src/main/java/org/example/ecommerceapp/config/OpenApiConfig.java): `src/main/java/org/example/ecommerceapp/config/OpenApiConfig.java`

### Other components

- **Customer**
- **Administrator**

## Connections

- Customer → Authentication API: registers / logs in (evidence: `README.md`)
- Customer → Product API: browses / searches (evidence: `README.md`)
- Customer → Category API: views categories (evidence: `README.md`)
- Customer → Cart API: manages cart (evidence: `README.md`)
- Customer → Order API: places / reviews (evidence: `README.md`)
- Administrator → Admin Product API: manages products (evidence: `README.md`)
- Administrator → Admin Category API: manages categories (evidence: `README.md`)
- Administrator → User Management API: manages users (evidence: `README.md`)
- Authentication API → User Management: delegates
- Authentication API → JWT Issuance: issues tokens
- Security Policy → JWT Filter: configures
- JWT Filter → User Details Lookup: loads identity
- Product API → Product Management: delegates
- Admin Product API → Product Management: delegates
- Category API → Category Management: delegates
- Admin Category API → Category Management: delegates
- Cart API → Cart Operations: delegates
- Order API → Order Processing: delegates
- User Management API → User Management: delegates
- Product Management → MySQL: persists data
- Category Management → MySQL: persists data
- Cart Operations → MySQL: persists data
- Order Processing → MySQL: persists data
- User Management → MySQL: persists data
