# vaibhavkale123/e-commerce_app architecture

> Architecture diagram of the GitHub repository vaibhavkale123/e-commerce_app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-25). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vaibhavkale123/e-commerce_app
- Repository: https://github.com/vaibhavkale123/e-commerce_app

## Overview

##### Project type and purpose
- This is a full-stack e-commerce web application.
- Backend: Spring Boot REST API (“Backend/online-shopping”).
- Frontend: React.js single-page application (“Frontend/online-shopping”).
- Database: MySQL for persisting users, products, orders, etc.

##### File structure
- Top-level directories:
- Backend/online-shopping – standard Maven project with controllers, services, DAOs, models, DTOs, utilities and application entry point.
- Frontend/online-shopping – React app with pages/, productComponent/, userComponent/, public/ and src/.
- Backend layering follows typical Spring Boot MVC:
- Controllers (REST endpoints)
- Service interfaces & implementations
- DAO layer (data access)
- Model/entities (JPA)
- DTOs (request/response objects)
- Frontend organizes UI by pages (routes) and reusable components for products and users.

##### README for additional insights
- Technologies: Spring Boot, React.js, MySQL.
- Features: admin product/category management, user registration & ordering, delivery assignment.
- Workflow: React UI → HTTP calls to Spring Boot REST → MySQL.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% React Client
    subgraph "React Client (SPA)"
        style ReactClient fill:#bbdefb,stroke:#1e88e5
        ReactClient["Browser / React App"]:::frontend
        subgraph "Core"
            App["App.js"]:::frontend
            Index["index.js"]:::frontend
        end
        subgraph "Pages"
            Pages["src/pages/"]:::frontend
        end
        subgraph "Product Components"
            ProdComp["src/productComponent/"]:::frontend
        end
        subgraph "User Components"
            UserComp["src/userComponent/"]:::frontend
        end
    end

    %% Backend Application
    subgraph "Spring Boot API"
        style Backend fill:#c8e6c9,stroke:#388e3c
        subgraph "Controllers"
            CartCtrl["CartController"]:::controller
            CatCtrl["CategoryController"]:::controller
            OrdCtrl["OrderController"]:::controller
            ProdCtrl["ProductController"]:::controller
            UserCtrl["UserController"]:::controller
        end
        subgraph "Services"
            ProdSvc["ProductService"]:::service
            ProdSvcImpl["ProductServiceImpl"]:::service
        end
        subgraph "DAOs/Repositories"
            AddrDao["AddressDao"]:::dao
            CartDao["CartDao"]:::dao
            CatDao["CategoryDao"]:::dao
            OrdDao["OrderDao"]:::dao
            ProdDao["ProductDao"]:::dao
            UserDao["UserDao"]:::dao
        end
        subgraph "DTOs"
            DTOs["DTOs"]:::dto
        end
        subgraph "Models/Entities"
            Models["Entities"]:::model
        end
        subgraph "Utilities & Storage"
            Util["StorageService"]:::util
        end
        Entry["OnlineShoppingApplication"]:::util
    end

    %% Database
    MySQL[(MySQL)]:::db

    %% Relationships
    ReactClient -->|User interacts| App
    App -->|renders pages| Pages
    App -->|uses components| ProdComp
    App -->|uses components| UserComp
    App -->|AJAX calls| ProdCtrl
    App -->|AJAX calls| UserCtrl
    App -->|AJAX calls| CartCtrl
    App -->|AJAX calls| CatCtrl
    App -->|AJAX calls| OrdCtrl

    %% Controller to Service
    ProdCtrl -->|calls| ProdSvc
    ProdCtrl -->|calls| ProdSvcImpl
    UserCtrl -->|calls| ProdSvcImpl
    CartCtrl -->|calls| ProdSvcImpl
    CatCtrl -->|calls| ProdSvcImpl
    OrdCtrl -->|calls| ProdSvcImpl

    %% Service to DAO
    ProdSvcImpl -->|uses| ProdDao
    ProdSvcImpl -->|uses| UserDao
    ProdSvcImpl -->|uses| CartDao
    ProdSvcImpl -->|uses| CatDao
    ProdSvcImpl -->|uses| OrdDao
    ProdSvcImpl -->|uses| AddrDao

    %% DAO to DB
    AddrDao -->|SQL| MySQL
    CartDao -->|SQL| MySQL
    CatDao -->|SQL| MySQL
    OrdDao -->|SQL| MySQL
    ProdDao -->|SQL| MySQL
    UserDao -->|SQL| MySQL

    %% Controllers to Storage
    ProdCtrl -->|file ops| Util

    %% Entry point
    Entry -->|initializes| CartCtrl
    Entry -->|initializes| CatCtrl
    Entry -->|initializes| OrdCtrl
    Entry -->|initializes| ProdCtrl
    Entry -->|initializes| UserCtrl

    %% Click Events - Frontend
    click App "https://github.com/vaibhavkale123/e-commerce_app/blob/main/Frontend/online-shopping/src/App.js"
    click Index "https://github.com/vaibhavkale123/e-commerce_app/blob/main/Frontend/online-shopping/src/index.js"
    click Pages "https://github.com/vaibhavkale123/e-commerce_app/tree/main/Frontend/online-shopping/src/pages/"
    click ProdComp "https://github.com/vaibhavkale123/e-commerce_app/tree/main/Frontend/online-shopping/src/productComponent/"
    click UserComp "https://github.com/vaibhavkale123/e-commerce_app/tree/main/Frontend/online-shopping/src/userComponent/"

    %% Click Events - Controllers
    click CartCtrl "https://github.com/vaibhavkale123/e-commerce_app/blob/main/Backend/online-shopping/src/main/java/com/onlineshopping/controller/CartController.java"
    click CatCtrl "https://github.com/vaibhavkale123/e-commerce_app/blob/main/Backend/online-shopping/src/main/java/com/onlineshopping/controller/CategoryController.java"
    click OrdCtrl "https://github.com/vaibhavkale123/e-commerce_app/blob/main/Backend/online-shopping/src/main/java/com/onlineshopping/controller/OrderController.java"
    click ProdCtrl "https://github.com/vaibhavkale123/e-commerce_app/blob/main/Backend/online-shopping/src/main/java/com/onlineshopping/controller/ProductController.java"
    click UserCtrl "https://github.com/vaibhavkale123/e-commerce_app/blob/main/Backend/online-shopping/src/main/java/com/onlineshopping/controller/UserController.java"

    %% Click Events - Services
    click ProdSvc "https://github.com/vaibhavkale123/e-commerce_app/blob/main/Backend/online-shopping/src/main/java/com/onlineshopping/service/ProductService.java"
    click ProdSvcImpl "https://github.com/vaibhavkale123/e-commerce_app/blob/main/Backend/online-shopping/src/main/java/com/onlineshopping/service/ProductServiceImpl.java"

    %% Click Events - DAOs
    click AddrDao "https://github.com/vaibhavkale123/e-commerce_app/blob/main/Backend/online-shopping/src/main/java/com/onlineshopping/dao/AddressDao.java"
    click CartDao "https://github.com/vaibhavkale123/e-commerce_app/blob/main/Backend/online-shopping/src/main/java/com/onlineshopping/dao/CartDao.java"
    click CatDao "https://github.com/vaibhavkale123/e-commerce_app/blob/main/Backend/online-shopping/src/main/java/com/onlineshopping/dao/CategoryDao.java"
    click OrdDao "https://github.com/vaibhavkale123/e-commerce_app/blob/main/Backend/online-shopping/src/main/java/com/onlineshopping/dao/OrderDao.java"
    click ProdDao "https://github.com/vaibhavkale123/e-commerce_app/blob/main/Backend/online-shopping/src/main/java/com/onlineshopping/dao/ProductDao.java"
    click UserDao "https://github.com/vaibhavkale123/e-commerce_app/blob/main/Backend/online-shopping/src/main/java/com/onlineshopping/dao/UserDao.java"

    %% Click Events - DTOs & Models & Util & Entry
    click DTOs "https://github.com/vaibhavkale123/e-commerce_app/tree/main/Backend/online-shopping/src/main/java/com/onlineshopping/dto/"
    click Models "https://github.com/vaibhavkale123/e-commerce_app/tree/main/Backend/online-shopping/src/main/java/com/onlineshopping/model/"
    click Util "https://github.com/vaibhavkale123/e-commerce_app/blob/main/Backend/online-shopping/src/main/java/com/onlineshopping/utility/StorageService.java"
    click Entry "https://github.com/vaibhavkale123/e-commerce_app/blob/main/Backend/online-shopping/src/main/java/com/onlineshopping/OnlineShoppingApplication.java"

    classDef frontend fill:#bbdefb,stroke:#1e88e5
    classDef controller fill:#66bb6a,stroke:#2e7d32
    classDef service fill:#81c784,stroke:#388e3c
    classDef dao fill:#a5d6a7,stroke:#2e7d32
    classDef dto fill:#ffecb3,stroke:#fbc02d
    classDef model fill:#ffe082,stroke:#f9a825
    classDef util fill:#ffcc80,stroke:#ef6c00
    classDef db fill:#ffab91,stroke:#d84315
```
