# phegondev/ecommerce-springboot architecture

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

- Interactive diagram: https://gitdiagram.com/phegondev/ecommerce-springboot
- Repository: https://github.com/phegondev/ecommerce-springboot

## Overview

##### Project type and purpose
- This is a full-stack e-commerce platform offering two alternative frontends (Angular and React) that consume a common Spring Boot REST API backend.
- The README confirms it’s an “Ecommerce Platform,” and the file tree shows “angular/”, “react/” and “backend/” modules.

##### File structure
- Top-level directories:
- angular/ — Angular SPA (app/, services, routing, components for products, cart, admin, etc.)
- react/ — React SPA (components/, context/, pages/, services/)
- backend/ — Spring Boot service (controller, service, repository, entity, security)
- The root folder also has mvnw, pom.xml, indicating a Maven multi-module project.
- backend/src/main/java/...
- controller/: REST Controllers
- dto/, entity/, mapper/: data mapping
- repository/: JPA Repos
- service/ + impl/: business logic
- security/: JWT filter, user details, CORS config
- Tests mirror the main code structure under backend/src/test.
- No direct DB schema folder—DB config lives in application.properties.
- There is an AWS S3 service for media storage (backend/service/AwsS3Service.java).

##### README for additional insights
- The README only shows a screenshot, but the instruction “checkout the branch corresponding to the technology” implies both frontends are intended to be interchangeable clients to the same API.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Client Layer"
        Angular["Angular Client"]:::frontend
        React["React Client"]:::frontend
    end

    subgraph "REST API Layer"
        Controllers["Controller Layer\n(Auth, Products, Orders, Users)"]:::backend
        AuthController["Authentication Controller"]:::backend
    end

    subgraph "Business Logic Layer"
        ServicesIface["Service Interfaces"]:::backend
        ServicesImpl["Service Implementations"]:::backend
        AwsS3["AWS S3 Integration Service"]:::backend
    end

    subgraph "Data Access Layer"
        Repos["Repository Layer"]:::backend
        Entities["Entity Models"]:::backend
        DTOs["DTOs"]:::backend
        Mapper["Entity-DTO Mapper"]:::backend
    end

    subgraph "Security Module"
        JwtFilter["JwtAuthFilter"]:::security
        JwtUtils["JwtUtils"]:::security
        SecConfig["SecurityConfig"]:::security
        CorsConfig["CorsConfig"]:::security
    end

    DB[(Relational Database)]:::database
    S3[(AWS S3 Storage)]:::external

    Angular -->|"HTTP Requests"| Controllers
    React -->|"HTTP Requests"| Controllers

    Controllers -->|calls| ServicesIface
    AuthController -->|login/signup| ServicesIface

    ServicesIface -->|implemented by| ServicesImpl
    ServicesImpl -->|CRUD operations| Repos
    ServicesImpl -->|file upload/download| AwsS3

    Repos -->|JPA interactions| DB
    AwsS3 -->|storage| S3

    Controllers -->|secured by| JwtFilter
    JwtFilter --> JwtUtils
    JwtFilter --> SecConfig
    JwtFilter --> CorsConfig

    click Angular "https://github.com/phegondev/ecommerce-springboot/tree/master/angular/src/app"
    click React "https://github.com/phegondev/ecommerce-springboot/tree/master/react/src/component"
    click Controllers "https://github.com/phegondev/ecommerce-springboot/tree/master/backend/src/main/java/com/phegondev/Phegon/Eccormerce/controller"
    click AuthController "https://github.com/phegondev/ecommerce-springboot/blob/master/backend/src/main/java/com/phegondev/Phegon/Eccormerce/controller/AuthController.java"
    click ServicesIface "https://github.com/phegondev/ecommerce-springboot/tree/master/backend/src/main/java/com/phegondev/Phegon/Eccormerce/service/interf"
    click ServicesImpl "https://github.com/phegondev/ecommerce-springboot/tree/master/backend/src/main/java/com/phegondev/Phegon/Eccormerce/service/impl"
    click AwsS3 "https://github.com/phegondev/ecommerce-springboot/blob/master/backend/src/main/java/com/phegondev/Phegon/Eccormerce/service/AwsS3Service.java"
    click Repos "https://github.com/phegondev/ecommerce-springboot/tree/master/backend/src/main/java/com/phegondev/Phegon/Eccormerce/repository"
    click Entities "https://github.com/phegondev/ecommerce-springboot/tree/master/backend/src/main/java/com/phegondev/Phegon/Eccormerce/entity"
    click DTOs "https://github.com/phegondev/ecommerce-springboot/tree/master/backend/src/main/java/com/phegondev/Phegon/Eccormerce/dto"
    click Mapper "https://github.com/phegondev/ecommerce-springboot/blob/master/backend/src/main/java/com/phegondev/Phegon/Eccormerce/mapper/EntityDtoMapper.java"
    click JwtFilter "https://github.com/phegondev/ecommerce-springboot/blob/master/backend/src/main/java/com/phegondev/Phegon/Eccormerce/security/JwtAuthFilter.java"
    click JwtUtils "https://github.com/phegondev/ecommerce-springboot/blob/master/backend/src/main/java/com/phegondev/Phegon/Eccormerce/security/JwtUtils.java"
    click SecConfig "https://github.com/phegondev/ecommerce-springboot/blob/master/backend/src/main/java/com/phegondev/Phegon/Eccormerce/security/SecurityConfig.java"
    click CorsConfig "https://github.com/phegondev/ecommerce-springboot/blob/master/backend/src/main/java/com/phegondev/Phegon/Eccormerce/security/CorsConfig.java"

    classDef frontend fill:#D6EAF8,stroke:#1B4F72,color:#1B2631
    classDef backend fill:#D5F5E3,stroke:#145A32,color:#0B5345
    classDef database fill:#FCF3CF,stroke:#B7950B,color:#784212
    classDef external fill:#F5EEF8,stroke:#8E44AD,color:#4A235A
    classDef security fill:#FADBD8,stroke:#C0392B,color:#641E16
```
