# manoharan12105-beep/springbootecommerce architecture

> Architecture diagram of the GitHub repository manoharan12105-beep/springbootecommerce, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/manoharan12105-beep/springbootecommerce
- Repository: https://github.com/manoharan12105-beep/springbootecommerce

## Overview

This is a Spring Boot e-commerce backend for managing and browsing products, categories, and customers, with JWT-based sign-in and product-image uploads. The main flow is an HTTP request through a controller to a service, which applies domain rules and uses repositories to persist or retrieve data. Product browsing also supports pagination, sorting, category filtering, and keyword search. The tree supports the major subsystems, but the README is empty and several implementations and configuration files were not sampled, so uncertain internal wiring is omitted.

Main entry points: [`src/main/java/me/mano/SpringBootECommerce/repository`](https://github.com/manoharan12105-beep/springbootecommerce/tree/main/src/main/java/me/mano/SpringBootECommerce/repository) (Data Repositories), [`src/main/java/me/mano/SpringBootECommerce/service/ProductServiceImp.java`](https://github.com/manoharan12105-beep/springbootecommerce/blob/main/src/main/java/me/mano/SpringBootECommerce/service/ProductServiceImp.java) (Product Service), [`src/main/java/me/mano/SpringBootECommerce/controller/TestController.java`](https://github.com/manoharan12105-beep/springbootecommerce/blob/main/src/main/java/me/mano/SpringBootECommerce/controller/TestController.java) (Sign-in API), [`src/main/java/me/mano/SpringBootECommerce/config/SecurityConfig.java`](https://github.com/manoharan12105-beep/springbootecommerce/blob/main/src/main/java/me/mano/SpringBootECommerce/config/SecurityConfig.java) (Security Config)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Catalog Management"]
  node_product_api["Product API"]
  node_product_service["Product Service"]
  node_category_api["Category API"]
  node_category_service["Category Service"]
end

subgraph group_customers["Customer Management"]
  node_customer_api["Customer API"]
  node_customer_service["Customer Service"]
end

subgraph group_security["Authentication"]
  node_test_api["Sign-in API"]
  node_security_config["Security Config"]
  node_token_filter["JWT Filter"]
  node_jwt_utils["JWT Utilities<br/>[JwtUtils.java]"]
  node_auth_entry["Auth Error Handler"]
end

subgraph group_persistence["Persistence and Files"]
  node_repositories["Data Repositories"]
  node_domain_entities["Domain Entities"]
  node_database[("Relational Database")]
  node_file_service["Image File Service"]
end

node_shopper(("API Client"))
node_auth_manager["Authentication Manager"]

node_shopper -->|"sends requests"| node_product_api
node_shopper -->|"sends requests"| node_category_api
node_shopper -->|"sends requests"| node_customer_api
node_shopper -->|"signs in"| node_test_api
node_product_api -->|"calls"| node_product_service
node_product_service -->|"reads and writes"| node_repositories
node_product_service -->|"uploads image"| node_file_service
node_category_api -->|"calls"| node_category_service
node_category_service -->|"reads and writes"| node_repositories
node_customer_api -->|"calls"| node_customer_service
node_customer_service -->|"reads and writes"| node_repositories
node_repositories -->|"maps records"| node_domain_entities
node_repositories -->|"queries"| node_database
node_test_api -->|"authenticates credentials"| node_auth_manager
node_test_api -->|"creates token"| node_jwt_utils
node_security_config -->|"dispatches requests"| node_token_filter
node_token_filter -->|"validates token"| node_jwt_utils
node_security_config -->|"configures failures"| node_auth_entry

click node_product_api "https://github.com/manoharan12105-beep/springbootecommerce/blob/main/src/main/java/me/mano/SpringBootECommerce/controller/ProductController.java"
click node_product_service "https://github.com/manoharan12105-beep/springbootecommerce/blob/main/src/main/java/me/mano/SpringBootECommerce/service/ProductServiceImp.java"
click node_category_api "https://github.com/manoharan12105-beep/springbootecommerce/blob/main/src/main/java/me/mano/SpringBootECommerce/controller/CategoryController.java"
click node_category_service "https://github.com/manoharan12105-beep/springbootecommerce/blob/main/src/main/java/me/mano/SpringBootECommerce/service/CategoryServiceImp.java"
click node_customer_api "https://github.com/manoharan12105-beep/springbootecommerce/blob/main/src/main/java/me/mano/SpringBootECommerce/controller/CustomerController.java"
click node_customer_service "https://github.com/manoharan12105-beep/springbootecommerce/blob/main/src/main/java/me/mano/SpringBootECommerce/service/CustomerServiceImpl.java"
click node_test_api "https://github.com/manoharan12105-beep/springbootecommerce/blob/main/src/main/java/me/mano/SpringBootECommerce/controller/TestController.java"
click node_security_config "https://github.com/manoharan12105-beep/springbootecommerce/blob/main/src/main/java/me/mano/SpringBootECommerce/config/SecurityConfig.java"
click node_token_filter "https://github.com/manoharan12105-beep/springbootecommerce/blob/main/src/main/java/me/mano/SpringBootECommerce/security/AuthTokenFilter.java"
click node_jwt_utils "https://github.com/manoharan12105-beep/springbootecommerce/blob/main/src/main/java/me/mano/SpringBootECommerce/security/JwtUtils.java"
click node_auth_entry "https://github.com/manoharan12105-beep/springbootecommerce/blob/main/src/main/java/me/mano/SpringBootECommerce/security/AuthEntryPointJwt.java"
click node_repositories "https://github.com/manoharan12105-beep/springbootecommerce/tree/main/src/main/java/me/mano/SpringBootECommerce/repository"
click node_domain_entities "https://github.com/manoharan12105-beep/springbootecommerce/tree/main/src/main/java/me/mano/SpringBootECommerce/entity"
click node_file_service "https://github.com/manoharan12105-beep/springbootecommerce/blob/main/src/main/java/me/mano/SpringBootECommerce/service/FileServiceImpl.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_product_service,node_category_api,node_category_service,node_shopper toneBlue
class node_customer_api,node_customer_service toneAmber
class node_test_api,node_security_config,node_token_filter,node_jwt_utils,node_auth_entry toneMint
class node_repositories,node_domain_entities,node_database,node_file_service toneRose
class node_auth_manager toneIndigo
```

## Components

### Catalog Management

- [Product API](https://github.com/manoharan12105-beep/springbootecommerce/blob/main/src/main/java/me/mano/SpringBootECommerce/controller/ProductController.java): `src/main/java/me/mano/SpringBootECommerce/controller/ProductController.java`
- [Product Service](https://github.com/manoharan12105-beep/springbootecommerce/blob/main/src/main/java/me/mano/SpringBootECommerce/service/ProductServiceImp.java): `src/main/java/me/mano/SpringBootECommerce/service/ProductServiceImp.java`
- [Category API](https://github.com/manoharan12105-beep/springbootecommerce/blob/main/src/main/java/me/mano/SpringBootECommerce/controller/CategoryController.java): `src/main/java/me/mano/SpringBootECommerce/controller/CategoryController.java`
- [Category Service](https://github.com/manoharan12105-beep/springbootecommerce/blob/main/src/main/java/me/mano/SpringBootECommerce/service/CategoryServiceImp.java): `src/main/java/me/mano/SpringBootECommerce/service/CategoryServiceImp.java`

### Customer Management

- [Customer API](https://github.com/manoharan12105-beep/springbootecommerce/blob/main/src/main/java/me/mano/SpringBootECommerce/controller/CustomerController.java): `src/main/java/me/mano/SpringBootECommerce/controller/CustomerController.java`
- [Customer Service](https://github.com/manoharan12105-beep/springbootecommerce/blob/main/src/main/java/me/mano/SpringBootECommerce/service/CustomerServiceImpl.java): `src/main/java/me/mano/SpringBootECommerce/service/CustomerServiceImpl.java`

### Authentication

- [Sign-in API](https://github.com/manoharan12105-beep/springbootecommerce/blob/main/src/main/java/me/mano/SpringBootECommerce/controller/TestController.java): `src/main/java/me/mano/SpringBootECommerce/controller/TestController.java`
- [Security Config](https://github.com/manoharan12105-beep/springbootecommerce/blob/main/src/main/java/me/mano/SpringBootECommerce/config/SecurityConfig.java): `src/main/java/me/mano/SpringBootECommerce/config/SecurityConfig.java`
- [JWT Filter](https://github.com/manoharan12105-beep/springbootecommerce/blob/main/src/main/java/me/mano/SpringBootECommerce/security/AuthTokenFilter.java): `src/main/java/me/mano/SpringBootECommerce/security/AuthTokenFilter.java`
- [JWT Utilities](https://github.com/manoharan12105-beep/springbootecommerce/blob/main/src/main/java/me/mano/SpringBootECommerce/security/JwtUtils.java): `src/main/java/me/mano/SpringBootECommerce/security/JwtUtils.java`
- [Auth Error Handler](https://github.com/manoharan12105-beep/springbootecommerce/blob/main/src/main/java/me/mano/SpringBootECommerce/security/AuthEntryPointJwt.java): `src/main/java/me/mano/SpringBootECommerce/security/AuthEntryPointJwt.java`

### Persistence and Files

- [Data Repositories](https://github.com/manoharan12105-beep/springbootecommerce/tree/main/src/main/java/me/mano/SpringBootECommerce/repository): `src/main/java/me/mano/SpringBootECommerce/repository`
- [Domain Entities](https://github.com/manoharan12105-beep/springbootecommerce/tree/main/src/main/java/me/mano/SpringBootECommerce/entity): `src/main/java/me/mano/SpringBootECommerce/entity`
- **Relational Database**
- [Image File Service](https://github.com/manoharan12105-beep/springbootecommerce/blob/main/src/main/java/me/mano/SpringBootECommerce/service/FileServiceImpl.java): `src/main/java/me/mano/SpringBootECommerce/service/FileServiceImpl.java`

### Other components

- **API Client**
- **Authentication Manager**

## Connections

- API Client → Product API: sends requests
- API Client → Category API: sends requests
- API Client → Customer API: sends requests
- API Client → Sign-in API: signs in
- Product API → Product Service: calls
- Product Service → Data Repositories: reads and writes
- Product Service → Image File Service: uploads image
- Category API → Category Service: calls
- Category Service → Data Repositories: reads and writes
- Customer API → Customer Service: calls
- Customer Service → Data Repositories: reads and writes
- Data Repositories → Domain Entities: maps records
- Data Repositories → Relational Database: queries
- Sign-in API → Authentication Manager: authenticates credentials
- Sign-in API → JWT Utilities: creates token
- Security Config → JWT Filter: dispatches requests
- JWT Filter → JWT Utilities: validates token
- Security Config → Auth Error Handler: configures failures