# jaygajera17/e-commerce-project-springboot architecture

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

- Interactive diagram: https://gitdiagram.com/jaygajera17/e-commerce-project-springboot
- Repository: https://github.com/jaygajera17/e-commerce-project-springboot

## Overview

This is a server-rendered Spring Boot e-commerce application for customer and administrator workflows. Customers browse products, register or sign in, and manage profiles; administrators maintain products and categories and inspect customers. Controllers call service-layer business operations, which use Hibernate-backed DAOs to persist domain entities in MySQL; JSP views render controller results. Spring Security enforces separate admin and user roles and loads credentials through userService. The README also documents cart-related code, represented as a distinct capability; sampled sources do not establish a controller-to-cart workflow. Wiring for unsampled modules is therefore omitted.

Main entry points: [`src/main/java/com/jtspringproject/JtSpringProject/controller/AdminController.java`](https://github.com/jaygajera17/e-commerce-project-springboot/blob/master/src/main/java/com/jtspringproject/JtSpringProject/controller/AdminController.java) (Admin workflows), [`src/main/java/com/jtspringproject/JtSpringProject/configuration/SecurityConfiguration.java`](https://github.com/jaygajera17/e-commerce-project-springboot/blob/master/src/main/java/com/jtspringproject/JtSpringProject/configuration/SecurityConfiguration.java) (Security chains), [`src/main/java/com/jtspringproject/JtSpringProject/controller/UserController.java`](https://github.com/jaygajera17/e-commerce-project-springboot/blob/master/src/main/java/com/jtspringproject/JtSpringProject/controller/UserController.java) (User workflows), [`src/main/java/com/jtspringproject/JtSpringProject/services/userService.java`](https://github.com/jaygajera17/e-commerce-project-springboot/blob/master/src/main/java/com/jtspringproject/JtSpringProject/services/userService.java) (User service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web workflows"]
  node_app["Spring Boot app"]
  node_usercontroller["User workflows"]
  node_admincontroller["Admin workflows"]
  node_errorcontroller["Access error page"]
  node_jsp["JSP views"]
end

subgraph group_security["Access control"]
  node_securityconfig["Security chains"]
  node_passwordconfig["Password encoder"]
end

subgraph group_domain["Commerce services"]
  node_userservice["User service<br/>[userService.java]"]
  node_productservice["Product service"]
  node_categoryservice["Category service"]
  node_cartservice["Cart service<br/>[cartService.java]"]
end

subgraph group_persistence["Persistence"]
  node_userdao["User DAO<br/>[userDao.java]"]
  node_productdao["Product DAO<br/>[productDao.java]"]
  node_categorydao["Category DAO<br/>[categoryDao.java]"]
  node_cartdao["Cart DAO<br/>[cartDao.java]"]
  node_cartproductdao["Cart item DAO"]
  node_models["Commerce entities"]
  node_hibernate["Hibernate setup"]
  node_mysql[("MySQL database")]
end

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

node_customer -->|"submits requests"| node_usercontroller
node_admin -->|"submits requests"| node_admincontroller
node_app -->|"configures access"| node_securityconfig
node_securityconfig -->|"authorizes routes"| node_usercontroller
node_securityconfig -->|"authorizes routes"| node_admincontroller
node_securityconfig -->|"routes denied access"| node_errorcontroller
node_securityconfig -->|"loads user details"| node_userservice
node_userservice -->|"encodes passwords"| node_passwordconfig
node_usercontroller -->|"manages accounts"| node_userservice
node_usercontroller -->|"loads products"| node_productservice
node_admincontroller -->|"lists and updates users"| node_userservice
node_admincontroller -->|"manages products"| node_productservice
node_admincontroller -->|"manages categories"| node_categoryservice
node_usercontroller -->|"renders pages"| node_jsp
node_admincontroller -->|"renders pages"| node_jsp
node_errorcontroller -->|"renders denial page"| node_jsp
node_userservice -->|"reads and saves users"| node_userdao
node_productservice -->|"manages products"| node_productdao
node_categoryservice -->|"manages categories"| node_categorydao
node_cartservice -->|"manages carts"| node_cartdao
node_userdao -->|"persists users"| node_models
node_productdao -->|"persists products"| node_models
node_categorydao -->|"persists categories"| node_models
node_cartdao -->|"persists carts"| node_models
node_cartproductdao -->|"persists cart items"| node_models
node_hibernate -->|"configures database access"| node_mysql
node_userdao -->|"reads and writes"| node_mysql
node_productdao -->|"reads and writes"| node_mysql
node_categorydao -->|"reads and writes"| node_mysql
node_cartdao -->|"reads and writes"| node_mysql
node_cartproductdao -->|"reads and writes"| node_mysql

click node_app "https://github.com/jaygajera17/e-commerce-project-springboot/blob/master/src/main/java/com/jtspringproject/JtSpringProject/JtSpringProjectApplication.java"
click node_usercontroller "https://github.com/jaygajera17/e-commerce-project-springboot/blob/master/src/main/java/com/jtspringproject/JtSpringProject/controller/UserController.java"
click node_admincontroller "https://github.com/jaygajera17/e-commerce-project-springboot/blob/master/src/main/java/com/jtspringproject/JtSpringProject/controller/AdminController.java"
click node_errorcontroller "https://github.com/jaygajera17/e-commerce-project-springboot/blob/master/src/main/java/com/jtspringproject/JtSpringProject/controller/ErrorController.java"
click node_jsp "https://github.com/jaygajera17/e-commerce-project-springboot/tree/master/src/main/webapp/views"
click node_securityconfig "https://github.com/jaygajera17/e-commerce-project-springboot/blob/master/src/main/java/com/jtspringproject/JtSpringProject/configuration/SecurityConfiguration.java"
click node_passwordconfig "https://github.com/jaygajera17/e-commerce-project-springboot/blob/master/src/main/java/com/jtspringproject/JtSpringProject/configuration/PasswordEncoderConfig.java"
click node_userservice "https://github.com/jaygajera17/e-commerce-project-springboot/blob/master/src/main/java/com/jtspringproject/JtSpringProject/services/userService.java"
click node_productservice "https://github.com/jaygajera17/e-commerce-project-springboot/blob/master/src/main/java/com/jtspringproject/JtSpringProject/services/productService.java"
click node_categoryservice "https://github.com/jaygajera17/e-commerce-project-springboot/blob/master/src/main/java/com/jtspringproject/JtSpringProject/services/categoryService.java"
click node_cartservice "https://github.com/jaygajera17/e-commerce-project-springboot/blob/master/src/main/java/com/jtspringproject/JtSpringProject/services/cartService.java"
click node_userdao "https://github.com/jaygajera17/e-commerce-project-springboot/blob/master/src/main/java/com/jtspringproject/JtSpringProject/dao/userDao.java"
click node_productdao "https://github.com/jaygajera17/e-commerce-project-springboot/blob/master/src/main/java/com/jtspringproject/JtSpringProject/dao/productDao.java"
click node_categorydao "https://github.com/jaygajera17/e-commerce-project-springboot/blob/master/src/main/java/com/jtspringproject/JtSpringProject/dao/categoryDao.java"
click node_cartdao "https://github.com/jaygajera17/e-commerce-project-springboot/blob/master/src/main/java/com/jtspringproject/JtSpringProject/dao/cartDao.java"
click node_cartproductdao "https://github.com/jaygajera17/e-commerce-project-springboot/blob/master/src/main/java/com/jtspringproject/JtSpringProject/dao/cartProductDao.java"
click node_models "https://github.com/jaygajera17/e-commerce-project-springboot/tree/master/src/main/java/com/jtspringproject/JtSpringProject/models"
click node_hibernate "https://github.com/jaygajera17/e-commerce-project-springboot/blob/master/src/main/java/com/jtspringproject/JtSpringProject/HibernateConfiguration.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_app,node_usercontroller,node_admincontroller,node_errorcontroller,node_jsp toneBlue
class node_securityconfig,node_passwordconfig toneAmber
class node_userservice,node_productservice,node_categoryservice,node_cartservice toneMint
class node_userdao,node_productdao,node_categorydao,node_cartdao,node_cartproductdao,node_models,node_hibernate,node_mysql toneRose
class node_customer,node_admin toneIndigo
```

## Components

### Web workflows

- [Spring Boot app](https://github.com/jaygajera17/e-commerce-project-springboot/blob/master/src/main/java/com/jtspringproject/JtSpringProject/JtSpringProjectApplication.java): `src/main/java/com/jtspringproject/JtSpringProject/JtSpringProjectApplication.java`
- [User workflows](https://github.com/jaygajera17/e-commerce-project-springboot/blob/master/src/main/java/com/jtspringproject/JtSpringProject/controller/UserController.java): `src/main/java/com/jtspringproject/JtSpringProject/controller/UserController.java`
- [Admin workflows](https://github.com/jaygajera17/e-commerce-project-springboot/blob/master/src/main/java/com/jtspringproject/JtSpringProject/controller/AdminController.java): `src/main/java/com/jtspringproject/JtSpringProject/controller/AdminController.java`
- [Access error page](https://github.com/jaygajera17/e-commerce-project-springboot/blob/master/src/main/java/com/jtspringproject/JtSpringProject/controller/ErrorController.java): `src/main/java/com/jtspringproject/JtSpringProject/controller/ErrorController.java`
- [JSP views](https://github.com/jaygajera17/e-commerce-project-springboot/tree/master/src/main/webapp/views): `src/main/webapp/views`

### Access control

- [Security chains](https://github.com/jaygajera17/e-commerce-project-springboot/blob/master/src/main/java/com/jtspringproject/JtSpringProject/configuration/SecurityConfiguration.java): `src/main/java/com/jtspringproject/JtSpringProject/configuration/SecurityConfiguration.java`
- [Password encoder](https://github.com/jaygajera17/e-commerce-project-springboot/blob/master/src/main/java/com/jtspringproject/JtSpringProject/configuration/PasswordEncoderConfig.java): `src/main/java/com/jtspringproject/JtSpringProject/configuration/PasswordEncoderConfig.java`

### Commerce services

- [User service](https://github.com/jaygajera17/e-commerce-project-springboot/blob/master/src/main/java/com/jtspringproject/JtSpringProject/services/userService.java): `src/main/java/com/jtspringproject/JtSpringProject/services/userService.java`
- [Product service](https://github.com/jaygajera17/e-commerce-project-springboot/blob/master/src/main/java/com/jtspringproject/JtSpringProject/services/productService.java): `src/main/java/com/jtspringproject/JtSpringProject/services/productService.java`
- [Category service](https://github.com/jaygajera17/e-commerce-project-springboot/blob/master/src/main/java/com/jtspringproject/JtSpringProject/services/categoryService.java): `src/main/java/com/jtspringproject/JtSpringProject/services/categoryService.java`
- [Cart service](https://github.com/jaygajera17/e-commerce-project-springboot/blob/master/src/main/java/com/jtspringproject/JtSpringProject/services/cartService.java): `src/main/java/com/jtspringproject/JtSpringProject/services/cartService.java`

### Persistence

- [User DAO](https://github.com/jaygajera17/e-commerce-project-springboot/blob/master/src/main/java/com/jtspringproject/JtSpringProject/dao/userDao.java): `src/main/java/com/jtspringproject/JtSpringProject/dao/userDao.java`
- [Product DAO](https://github.com/jaygajera17/e-commerce-project-springboot/blob/master/src/main/java/com/jtspringproject/JtSpringProject/dao/productDao.java): `src/main/java/com/jtspringproject/JtSpringProject/dao/productDao.java`
- [Category DAO](https://github.com/jaygajera17/e-commerce-project-springboot/blob/master/src/main/java/com/jtspringproject/JtSpringProject/dao/categoryDao.java): `src/main/java/com/jtspringproject/JtSpringProject/dao/categoryDao.java`
- [Cart DAO](https://github.com/jaygajera17/e-commerce-project-springboot/blob/master/src/main/java/com/jtspringproject/JtSpringProject/dao/cartDao.java): `src/main/java/com/jtspringproject/JtSpringProject/dao/cartDao.java`
- [Cart item DAO](https://github.com/jaygajera17/e-commerce-project-springboot/blob/master/src/main/java/com/jtspringproject/JtSpringProject/dao/cartProductDao.java): `src/main/java/com/jtspringproject/JtSpringProject/dao/cartProductDao.java`
- [Commerce entities](https://github.com/jaygajera17/e-commerce-project-springboot/tree/master/src/main/java/com/jtspringproject/JtSpringProject/models): `src/main/java/com/jtspringproject/JtSpringProject/models`
- [Hibernate setup](https://github.com/jaygajera17/e-commerce-project-springboot/blob/master/src/main/java/com/jtspringproject/JtSpringProject/HibernateConfiguration.java): `src/main/java/com/jtspringproject/JtSpringProject/HibernateConfiguration.java`
- **MySQL database**

### Other components

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

## Connections

- Customer → User workflows: submits requests
- Administrator → Admin workflows: submits requests
- Spring Boot app → Security chains: configures access
- Security chains → User workflows: authorizes routes
- Security chains → Admin workflows: authorizes routes
- Security chains → Access error page: routes denied access
- Security chains → User service: loads user details
- User service → Password encoder: encodes passwords
- User workflows → User service: manages accounts
- User workflows → Product service: loads products
- Admin workflows → User service: lists and updates users
- Admin workflows → Product service: manages products
- Admin workflows → Category service: manages categories
- User workflows → JSP views: renders pages
- Admin workflows → JSP views: renders pages
- Access error page → JSP views: renders denial page
- User service → User DAO: reads and saves users
- Product service → Product DAO: manages products
- Category service → Category DAO: manages categories
- Cart service → Cart DAO: manages carts
- User DAO → Commerce entities: persists users
- Product DAO → Commerce entities: persists products
- Category DAO → Commerce entities: persists categories
- Cart DAO → Commerce entities: persists carts
- Cart item DAO → Commerce entities: persists cart items
- Hibernate setup → MySQL database: configures database access
- User DAO → MySQL database: reads and writes
- Product DAO → MySQL database: reads and writes
- Category DAO → MySQL database: reads and writes
- Cart DAO → MySQL database: reads and writes
- Cart item DAO → MySQL database: reads and writes
