# upin-0583/backendhoatuoiuit architecture

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

- Interactive diagram: https://gitdiagram.com/upin-0583/backendhoatuoiuit
- Repository: https://github.com/upin-0583/backendhoatuoiuit

## Overview

##### Project type and purpose
- This is a Spring Boot–based backend RESTful API for an e-commerce flower‐ordering system (“HoaTuoiUIT”).
- It exposes endpoints for products, categories, customers, carts, orders, payments, promotions, reviews, file uploads, and user authentication (JWT).

##### File structure
- Top‐level:
- pom.xml / Maven wrapper (.mvn, mvnw) – build and dependency management
- src/main/java/com/example/backendhoatuoiuit – code organized by layer
- src/main/resources/application.properties – configuration
- uploads – physical file storage for uploads
- src/test – automated tests
- Layered organization under `src/main/java`:
- config – AppConfig, WebConfig (CORS, view resolvers), DataInitializer (DB seeding)
- controller – REST controllers per resource
- dto – request/response payload objects
- entity – JPA entities modeling tables
- repository – Spring Data JPA interfaces
- service – business logic services
- mapper – MapStruct (or manual) mappers entity↔DTO
- security – JWT filter, token provider, UserDetailsService, SecurityConfig
- exception – global exception handler, custom exceptions

##### Key architectural insights from README
- Postman collection for testing APIs
- No frontend in repo – implies full‐stack with separate UI consuming these APIs

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Application Entry and Configuration
    App["BackendhoatuoiuitApplication"]:::external
    subgraph "Configuration Layer"
        direction TB
        AppConfig["AppConfig"]:::web
        WebConfig["WebConfig (CORS & View Resolvers)"]:::web
        DataInit["DataInitializer"]:::web
    end
    App -->|starts| AppConfig
    App -->|starts| WebConfig
    App -->|starts| DataInit

    %% Client
    Client["External Client (Web/Mobile/Postman)"]:::external

    %% API/Web Layer
    subgraph "API/Web Layer (Controllers)" 
        direction TB
        ProdCtrl["ProductController"]:::web
        OrderCtrl["OrderController"]:::web
        FileCtrl["FileUploadController"]:::web
        AuthCtrl["AuthController"]:::web
        CartCtrl["CartController"]:::web
        CustCtrl["CustomerController"]:::web
        PromoCtrl["PromotionController"]:::web
        ReviewCtrl["ReviewController"]:::web
    end

    %% Security Layer
    subgraph "Security Layer" 
        direction TB
        JwtFilter["JwtAuthenticationFilter"]:::security
        JwtProvider["JwtTokenProvider"]:::security
        SecurityCfg["SecurityConfig"]:::security
        UserDetails["CustomUserDetailsService"]:::security
    end

    %% Business Logic Layer
    subgraph "Business Logic Layer (Services)"
        direction TB
        ProdSvc["ProductService"]:::biz
        OrderSvc["OrderService"]:::biz
        FileSvc["FileStorageService"]:::biz
        AuthSvc["AuthService"]:::biz
        CartSvc["CartService"]:::biz
        CustSvc["CustomerService"]:::biz
        PromoSvc["PromotionService"]:::biz
        ReviewSvc["ReviewService"]:::biz
    end

    %% Data Access Layer
    subgraph "Data Access Layer (Repositories)"
        direction TB
        ProdRepo["ProductRepository"]:::data
        OrderRepo["OrderRepository"]:::data
        CartRepo["CartRepository"]:::data
        CustRepo["CustomerRepository"]:::data
        PromoRepo["PromotionRepository"]:::data
        ReviewRepo["ReviewRepository"]:::data
    end

    %% Domain Model and DTOs
    subgraph "Domain Model & DTOs"
        direction TB
        Entities["JPA Entities"]:::data
        DTOs["DTOs"]:::data
        Mappers["Mapper Layer"]:::data
    end

    %% Exception Handling
    Exception["GlobalExceptionHandler & CustomException"]:::security

    %% Database and File System
    DB["Relational Database (MySQL/PostgreSQL)"]:::data
    FS["File System (uploads/)"]:::external
    SQL["hoatuoiuit.sql"]:::external

    %% Flows
    Client -->|HTTP Requests| ProdCtrl
    Client -->|HTTP Requests| OrderCtrl
    Client -->|HTTP Requests| FileCtrl
    Client -->|HTTP Requests| AuthCtrl
    Client -->|HTTP Requests| CartCtrl
    Client -->|HTTP Requests| CustCtrl
    Client -->|HTTP Requests| PromoCtrl
    Client -->|HTTP Requests| ReviewCtrl

    FileCtrl -->|upload/download| FileSvc
    FileSvc -->|store files| FS

    %% Authentication Flow
    AuthCtrl -->|login/jwt| JwtProvider
    AuthCtrl -->|uses| AuthSvc
    ProdCtrl -->|secured by| JwtFilter
    OrderCtrl -->|secured by| JwtFilter
    CartCtrl -->|secured by| JwtFilter
    CustCtrl -->|secured by| JwtFilter
    PromoCtrl -->|secured by| JwtFilter
    ReviewCtrl -->|secured by| JwtFilter

    JwtFilter -->|validates token| JwtProvider
    JwtFilter -->|loads user| UserDetails
    SecurityCfg -->|configures| JwtFilter

    %% Controller to Service
    ProdCtrl -->|calls| ProdSvc
    OrderCtrl -->|calls| OrderSvc
    CartCtrl -->|calls| CartSvc
    CustCtrl -->|calls| CustSvc
    PromoCtrl -->|calls| PromoSvc
    ReviewCtrl -->|calls| ReviewSvc

    %% Service to Repository
    ProdSvc -->|uses| ProdRepo
    OrderSvc -->|uses| OrderRepo
    CartSvc -->|uses| CartRepo
    CustSvc -->|uses| CustRepo
    PromoSvc -->|uses| PromoRepo
    ReviewSvc -->|uses| ReviewRepo

    %% Repository to DB
    ProdRepo -->|CRUD| DB
    OrderRepo -->|CRUD| DB
    CartRepo -->|CRUD| DB
    CustRepo -->|CRUD| DB
    PromoRepo -->|CRUD| DB
    ReviewRepo -->|CRUD| DB

    %% DTO and Entity Mapping
    Mappers -->|convert| Entities
    Mappers -->|convert| DTOs
    DTOs -->|used by| ProdCtrl
    DTOs -->|used by| OrderCtrl

    %% Exception Handling
    ProdCtrl -->|throws| Exception
    OrderCtrl -->|throws| Exception
    CartCtrl -->|throws| Exception

    %% Data Initialization
    DataInit -->|seeds| DB

    %% SQL reference
    SQL -->|schema| DB

    %% Click Events
    click App "https://github.com/upin-0583/backendhoatuoiuit/blob/master/src/main/java/com/example/backendhoatuoiuit/BackendhoatuoiuitApplication.java"
    click AppConfig "https://github.com/upin-0583/backendhoatuoiuit/blob/master/src/main/java/com/example/backendhoatuoiuit/config/AppConfig.java"
    click WebConfig "https://github.com/upin-0583/backendhoatuoiuit/blob/master/src/main/java/com/example/backendhoatuoiuit/config/WebConfig.java"
    click DataInit "https://github.com/upin-0583/backendhoatuoiuit/blob/master/src/main/java/com/example/backendhoatuoiuit/config/DataInitializer.java"
    click ProdCtrl "https://github.com/upin-0583/backendhoatuoiuit/blob/master/src/main/java/com/example/backendhoatuoiuit/controller/ProductController.java"
    click OrderCtrl "https://github.com/upin-0583/backendhoatuoiuit/blob/master/src/main/java/com/example/backendhoatuoiuit/controller/OrderController.java"
    click FileCtrl "https://github.com/upin-0583/backendhoatuoiuit/blob/master/src/main/java/com/example/backendhoatuoiuit/controller/FileUploadController.java"
    click AuthCtrl "https://github.com/upin-0583/backendhoatuoiuit/tree/master/src/main/java/com/example/backendhoatuoiuit/controller"
    click CartCtrl "https://github.com/upin-0583/backendhoatuoiuit/blob/master/src/main/java/com/example/backendhoatuoiuit/controller/CartController.java"
    click CustCtrl "https://github.com/upin-0583/backendhoatuoiuit/blob/master/src/main/java/com/example/backendhoatuoiuit/controller/CustomerController.java"
    click PromoCtrl "https://github.com/upin-0583/backendhoatuoiuit/blob/master/src/main/java/com/example/backendhoatuoiuit/controller/PromotionController.java"
    click ReviewCtrl "https://github.com/upin-0583/backendhoatuoiuit/blob/master/src/main/java/com/example/backendhoatuoiuit/controller/ReviewController.java"
    click JwtFilter "https://github.com/upin-0583/backendhoatuoiuit/blob/master/src/main/java/com/example/backendhoatuoiuit/security/JwtAuthenticationFilter.java"
    click JwtProvider "https://github.com/upin-0583/backendhoatuoiuit/blob/master/src/main/java/com/example/backendhoatuoiuit/security/JwtTokenProvider.java"
    click SecurityCfg "https://github.com/upin-0583/backendhoatuoiuit/blob/master/src/main/java/com/example/backendhoatuoiuit/security/SecurityConfig.java"
    click UserDetails "https://github.com/upin-0583/backendhoatuoiuit/blob/master/src/main/java/com/example/backendhoatuoiuit/security/CustomUserDetailsService.java"
    click ProdSvc "https://github.com/upin-0583/backendhoatuoiuit/blob/master/src/main/java/com/example/backendhoatuoiuit/service/ProductService.java"
    click OrderSvc "https://github.com/upin-0583/backendhoatuoiuit/blob/master/src/main/java/com/example/backendhoatuoiuit/service/OrderService.java"
    click FileSvc "https://github.com/upin-0583/backendhoatuoiuit/blob/master/src/main/java/com/example/backendhoatuoiuit/service/FileStorageService.java"
    click CartSvc "https://github.com/upin-0583/backendhoatuoiuit/blob/master/src/main/java/com/example/backendhoatuoiuit/service/CartService.java"
    click CustSvc "https://github.com/upin-0583/backendhoatuoiuit/blob/master/src/main/java/com/example/backendhoatuoiuit/service/CustomerService.java"
    click PromoSvc "https://github.com/upin-0583/backendhoatuoiuit/blob/master/src/main/java/com/example/backendhoatuoiuit/service/PromotionService.java"
    click ReviewSvc "https://github.com/upin-0583/backendhoatuoiuit/blob/master/src/main/java/com/example/backendhoatuoiuit/service/ReviewService.java"
    click ProdRepo "https://github.com/upin-0583/backendhoatuoiuit/blob/master/src/main/java/com/example/backendhoatuoiuit/repository/ProductRepository.java"
    click OrderRepo "https://github.com/upin-0583/backendhoatuoiuit/blob/master/src/main/java/com/example/backendhoatuoiuit/repository/OrderRepository.java"
    click CartRepo "https://github.com/upin-0583/backendhoatuoiuit/blob/master/src/main/java/com/example/backendhoatuoiuit/repository/CartRepository.java"
    click CustRepo "https://github.com/upin-0583/backendhoatuoiuit/blob/master/src/main/java/com/example/backendhoatuoiuit/repository/CustomerRepository.java"
    click PromoRepo "https://github.com/upin-0583/backendhoatuoiuit/blob/master/src/main/java/com/example/backendhoatuoiuit/repository/PromotionRepository.java"
    click ReviewRepo "https://github.com/upin-0583/backendhoatuoiuit/blob/master/src/main/java/com/example/backendhoatuoiuit/repository/ReviewRepository.java"
    click Entities "https://github.com/upin-0583/backendhoatuoiuit/tree/master/src/main/java/com/example/backendhoatuoiuit/entity"
    click DTOs "https://github.com/upin-0583/backendhoatuoiuit/tree/master/src/main/java/com/example/backendhoatuoiuit/dto"
    click Mappers "https://github.com/upin-0583/backendhoatuoiuit/tree/master/src/main/java/com/example/backendhoatuoiuit/mapper"
    click Exception "https://github.com/upin-0583/backendhoatuoiuit/tree/master/src/main/java/com/example/backendhoatuoiuit/exception"
    click SQL "https://github.com/upin-0583/backendhoatuoiuit/blob/master/hoatuoiuit.sql"
    click FS "https://github.com/upin-0583/backendhoatuoiuit/tree/master/uploads/"

    %% Styles
    classDef external fill:#fff3cd,stroke:#333,stroke-width:1px
    classDef web fill:#cce5ff,stroke:#333,stroke-width:1px
    classDef security fill:#e6e6e6,stroke:#333,stroke-width:1px
    classDef biz fill:#d4edda,stroke:#333,stroke-width:1px
    classDef data fill:#ffe5b4,stroke:#333,stroke-width:1px
```
