# lekhrocks/ecommerce_be architecture

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

- Interactive diagram: https://gitdiagram.com/lekhrocks/ecommerce_be
- Repository: https://github.com/lekhrocks/ecommerce_be

## Overview

##### Project type and purpose
- This is a monolithic Spring Boot–based RESTful backend for an e-commerce application.
- Purpose: provide user authentication, product/catalog management, cart and wishlist handling, checkout (Stripe integration), and order processing via HTTP APIs.

##### File structure
- Top-level: standard Maven project (`pom.xml`, `mvnw`, `.mvn`, etc.).
- src/main/java/com/demo/ecommerce:
- config – application‐wide configuration (CORS, Swagger docs, message strings)
- controllers – REST controllers exposing API endpoints
- dto – data‐transfer objects (requests/responses) organized by feature (users, cart, checkout, product)
- model – JPA entities (User, Product, Cart, Order, etc.)
- repository – Spring Data JPA repositories
- service – business‐logic services
- exceptions – custom exceptions and a global exception handler
- common – shared response wrapper (ApiResponse)
- src/main/resources/application.properties holds DB, Stripe keys, Swagger settings, etc.

##### Detailed callouts
- Authentication flow: show SignUp/SignIn → AuthenticationService → TokenRepository → DB
- Cart flow: AddToCartDto → CartController → CartService → CartRepository
- Checkout flow: CheckoutItemDto → OrderService → Stripe → OrderRepository
- Exception handling: illustrate ExceptionControllerAdvice intercepting thrown exceptions

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Clients
    Client["Web/Mobile Clients"]:::external

    %% API Layer
    subgraph "API Layer"
        direction TB
        CartController["CartController"]:::controller
        CategoryController["CategoryController"]:::controller
        OrderController["OrderController"]:::controller
        ProductController["ProductController"]:::controller
        UserController["UserController"]:::controller
        WishListController["WishListController"]:::controller
    end

    %% Service Layer
    subgraph "Business Layer"
        direction TB
        AuthenticationService["AuthenticationService"]:::service
        UserService["UserService"]:::service
        ProductService["ProductService"]:::service
        CategoryService["CategoryService"]:::service
        CartService["CartService"]:::service
        WishListService["WishListService"]:::service
        OrderService["OrderService"]:::service
    end

    %% Data Access Layer
    subgraph "Data Access Layer"
        direction TB
        UserRepository["UserRepository"]:::repository
        TokenRepository["TokenRepository"]:::repository
        ProductRepository["ProductRepository"]:::repository
        CategoryRepository["CategoryRepository"]:::repository
        CartRepository["CartRepository"]:::repository
        WishListRepository["WishListRepository"]:::repository
        OrderRepository["OrderRepository"]:::repository
        OrderItemsRepository["OrderItemsRepository"]:::repository
    end

    %% Database
    Database[(Relational DB)]:::database

    %% External Services
    Stripe["Stripe Service"]:::externalService

    %% Configuration & Exception
    subgraph "Config & Cross-cutting"
        direction TB
        SwaggerConfig["SwaggerConfig"]:::config
        WebConfig["WebConfig (CORS)"]:::config
        MessageStrings["MessageStrings"]:::config
        ExceptionControllerAdvice["ExceptionControllerAdvice"]:::exception
        ApiResponse["ApiResponse"]:::common
    end

    %% Entry Point
    EcommerceApplication["EcommerceApplication"]:::entry

    %% Connections
    Client -->|HTTP Request| CartController
    Client -->|HTTP Request| CategoryController
    Client -->|HTTP Request| OrderController
    Client -->|HTTP Request| ProductController
    Client -->|HTTP Request| UserController
    Client -->|HTTP Request| WishListController

    CartController -->|calls| CartService
    CategoryController -->|calls| CategoryService
    OrderController -->|calls| OrderService
    ProductController -->|calls| ProductService
    UserController -->|calls| UserService
    WishListController -->|calls| WishListService

    AuthenticationService -->|uses| TokenRepository
    UserService -->|uses| UserRepository
    ProductService -->|uses| ProductRepository
    CategoryService -->|uses| CategoryRepository
    CartService -->|uses| CartRepository
    WishListService -->|uses| WishListRepository
    OrderService -->|uses| OrderRepository
    OrderService -->|uses| OrderItemsRepository

    CartService -->|reads/writes| Database
    CategoryService -->|reads/writes| Database
    OrderService -->|reads/writes| Database
    ProductService -->|reads/writes| Database
    UserService -->|reads/writes| Database
    WishListService -->|reads/writes| Database

    OrderService -->|HTTP Call| Stripe

    %% Cross-cutting connections
    SwaggerConfig -.->|configures| CartController
    WebConfig -.->|configures| CartController
    ExceptionControllerAdvice -.->|handles exceptions| CartController
    ApiResponse -->|wraps| CartController

    %% Entry Point
    EcommerceApplication -->|bootstraps| SwaggerConfig
    EcommerceApplication -->|bootstraps| WebConfig
    EcommerceApplication -->|bootstraps| ExceptionControllerAdvice

    %% Click Events
    click CartController "https://github.com/lekhrocks/ecommerce_be/blob/master/src/main/java/com/demo/ecommerce/controllers/CartController.java"
    click CategoryController "https://github.com/lekhrocks/ecommerce_be/blob/master/src/main/java/com/demo/ecommerce/controllers/CategoryController.java"
    click OrderController "https://github.com/lekhrocks/ecommerce_be/blob/master/src/main/java/com/demo/ecommerce/controllers/OrderController.java"
    click ProductController "https://github.com/lekhrocks/ecommerce_be/blob/master/src/main/java/com/demo/ecommerce/controllers/ProductController.java"
    click UserController "https://github.com/lekhrocks/ecommerce_be/blob/master/src/main/java/com/demo/ecommerce/controllers/UserController.java"
    click WishListController "https://github.com/lekhrocks/ecommerce_be/blob/master/src/main/java/com/demo/ecommerce/controllers/WishListController.java"

    click AuthenticationService "https://github.com/lekhrocks/ecommerce_be/blob/master/src/main/java/com/demo/ecommerce/service/AuthenticationService.java"
    click UserService "https://github.com/lekhrocks/ecommerce_be/blob/master/src/main/java/com/demo/ecommerce/service/UserService.java"
    click ProductService "https://github.com/lekhrocks/ecommerce_be/blob/master/src/main/java/com/demo/ecommerce/service/ProductService.java"
    click CategoryService "https://github.com/lekhrocks/ecommerce_be/blob/master/src/main/java/com/demo/ecommerce/service/CategoryService.java"
    click CartService "https://github.com/lekhrocks/ecommerce_be/blob/master/src/main/java/com/demo/ecommerce/service/CartService.java"
    click WishListService "https://github.com/lekhrocks/ecommerce_be/blob/master/src/main/java/com/demo/ecommerce/service/WishListService.java"
    click OrderService "https://github.com/lekhrocks/ecommerce_be/blob/master/src/main/java/com/demo/ecommerce/service/OrderService.java"

    click UserRepository "https://github.com/lekhrocks/ecommerce_be/blob/master/src/main/java/com/demo/ecommerce/repository/UserRepository.java"
    click TokenRepository "https://github.com/lekhrocks/ecommerce_be/blob/master/src/main/java/com/demo/ecommerce/repository/TokenRepository.java"
    click ProductRepository "https://github.com/lekhrocks/ecommerce_be/blob/master/src/main/java/com/demo/ecommerce/repository/ProductRepository.java"
    click CategoryRepository "https://github.com/lekhrocks/ecommerce_be/blob/master/src/main/java/com/demo/ecommerce/repository/CategoryRepository.java"
    click CartRepository "https://github.com/lekhrocks/ecommerce_be/blob/master/src/main/java/com/demo/ecommerce/repository/CartRepository.java"
    click WishListRepository "https://github.com/lekhrocks/ecommerce_be/blob/master/src/main/java/com/demo/ecommerce/repository/WishListRepository.java"
    click OrderRepository "https://github.com/lekhrocks/ecommerce_be/blob/master/src/main/java/com/demo/ecommerce/repository/OrderRepository.java"
    click OrderItemsRepository "https://github.com/lekhrocks/ecommerce_be/blob/master/src/main/java/com/demo/ecommerce/repository/OrderItemsRepository.java"

    click EcommerceApplication "https://github.com/lekhrocks/ecommerce_be/blob/master/src/main/java/com/demo/ecommerce/EcommerceApplication.java"
    click SwaggerConfig "https://github.com/lekhrocks/ecommerce_be/blob/master/src/main/java/com/demo/ecommerce/config/SwaggerConfig.java"
    click WebConfig "https://github.com/lekhrocks/ecommerce_be/blob/master/src/main/java/com/demo/ecommerce/config/WebConfig.java"
    click MessageStrings "https://github.com/lekhrocks/ecommerce_be/blob/master/src/main/java/com/demo/ecommerce/config/MessageStrings.java"
    click ExceptionControllerAdvice "https://github.com/lekhrocks/ecommerce_be/blob/master/src/main/java/com/demo/ecommerce/exceptions/ExceptionControllerAdvice.java"
    click ApiResponse "https://github.com/lekhrocks/ecommerce_be/blob/master/src/main/java/com/demo/ecommerce/common/ApiResponse.java"

    %% Styles
    classDef controller fill:#D6EAF8,stroke:#3498DB,color:#154360
    classDef service fill:#EBF5FB,stroke:#5DADE2,color:#1B4F72
    classDef repository fill:#D5F5E3,stroke:#27AE60,color:#145A32
    classDef database fill:#FAD7A0,stroke:#E67E22,color:#873600
    classDef externalService fill:#D5F5F6,stroke:#48C9B0,color:#1F3A93
    classDef external fill:#E8DAEF,stroke:#8E44AD,color:#4A235A
    classDef config fill:#FDEDEC,stroke:#E74C3C,color:#78281F
    classDef exception fill:#F9E79F,stroke:#F1C40F,color:#7D6608
    classDef common fill:#FEF5E7,stroke:#F39C12,color:#7E5109
    classDef entry fill:#D6DBDF,stroke:#5D6D7E,color:#1C2833
```
