# phan-manh-dung/ecommerce architecture

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

- Interactive diagram: https://gitdiagram.com/phan-manh-dung/ecommerce
- Repository: https://github.com/phan-manh-dung/ecommerce

## Overview

##### Project type and purpose
- This is a client-side Single Page Application (SPA) built with Create React App.
- It implements an e-commerce front-end: product browsing, shopping cart, checkout, user profiles, admin dashboards.
- It uses React for UI, Redux for global state, React Router for navigation, CSS modules/SCSS for styling, and a thin service layer (REST + Firebase) to communicate with back-end APIs.

##### File structure
- Top-level: public (static HTML/assets), src (all app code), plus config files (.babelrc, webpack overrides, etc.).
- src sub-folders:
- assets – images, GIFs
- component – reusable UI components (cards, buttons, drawers, etc.)
- pages – page-level containers matched to routes
- redux – store.js, reducers, “slices” under redux/slide
- service – ApiPublic.js, OrderService.js, ProductService.js, UserService.js (REST calls)
- routes – React Router setup
- firebase.js – Firebase initialization for auth or real-time features
- hooks – custom React hooks (useMutation, useDebounce, useResponsive, etc.)
- This structure reveals a layered architecture:
UI Components → Pages → Route Router → State Store → Service/API Layer → External Services

##### README for additional insights
- Build/test/deploy scripts confirm standard React SPA.

##### Final advice
- Be exhaustive: decompose into as many logical components/layers as make sense.
- Every architectural element: client, router, hooks, store, service, external API, auth.
- Use consistent visual styling so a reader can trace “User clicks → Service call → DB fetch → UI update.”
1. High-level system context (SPA ↔ API ↔ Firebase ↔ CDN)
2. Detailed in-app architecture (Components → Redux → Services).
- Review with devs to confirm you’ve included all key modules (e.g. custom hooks, CSS modules, analytics).

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Client Side"
        Browser((Browser)):::external
        Browser --> Index
        Index["src/index.js"]:::entry
        click Index "https://github.com/phan-manh-dung/ecommerce/blob/main/src/index.js"
        Index --> App
        App["React App (SPA) - src/App.js"]:::ui
        click App "https://github.com/phan-manh-dung/ecommerce/blob/main/src/App.js"
        subgraph "Router & Pages"
            Router["React Router - src/routes/index.js"]:::ui
            click Router "https://github.com/phan-manh-dung/ecommerce/blob/main/src/routes/index.js"
            Pages["UI Pages - src/pages"]:::ui
            click Pages "https://github.com/phan-manh-dung/ecommerce/tree/main/src/pages"
            Components["UI Components - src/component"]:::ui
            click Components "https://github.com/phan-manh-dung/ecommerce/tree/main/src/component"
        end
        subgraph "Custom Hooks"
            Hook1["useMutationHook"]:::ui
            click Hook1 "https://github.com/phan-manh-dung/ecommerce/blob/main/src/hook/useMutationHook.js"
            Hook2["useResponsive"]:::ui
            click Hook2 "https://github.com/phan-manh-dung/ecommerce/blob/main/src/hook/useResponsive.js"
            Hook3["useDebounce"]:::ui
            click Hook3 "https://github.com/phan-manh-dung/ecommerce/blob/main/src/hooks/useDebounce.js"
            Hook4["useWindowSize"]:::ui
            click Hook4 "https://github.com/phan-manh-dung/ecommerce/blob/main/src/hook/useWindowSize.js"
        end
        App --> Router
        Router --> Pages
        Pages --> Components
        App --> Hook1
        App --> Hook2
        App --> Hook3
        App --> Hook4
    end

    subgraph "State Layer"
        Store["Redux Store - src/redux/store.js"]:::state
        click Store "https://github.com/phan-manh-dung/ecommerce/blob/main/src/redux/store.js"
        RootReducer["RootReducer - src/redux/reducers/rootReducer.js"]:::state
        click RootReducer "https://github.com/phan-manh-dung/ecommerce/blob/main/src/redux/reducers/rootReducer.js"
        subgraph "Slices"
            Cart["Cart Slice"]:::state
            click Cart "https://github.com/phan-manh-dung/ecommerce/blob/main/src/redux/slide/cartSlide.js"
            Order["Order Slice"]:::state
            click Order "https://github.com/phan-manh-dung/ecommerce/blob/main/src/redux/slide/orderSlide.js"
            Product["Product Slice"]:::state
            click Product "https://github.com/phan-manh-dung/ecommerce/blob/main/src/redux/slide/productSlide.js"
            User["User Slice"]:::state
            click User "https://github.com/phan-manh-dung/ecommerce/blob/main/src/redux/slide/userSlide.js"
        end
        App --> Store
        Store --> RootReducer
        RootReducer --> Cart
        RootReducer --> Order
        RootReducer --> Product
        RootReducer --> User
    end

    subgraph "Service Layer"
        ApiPublic["ApiPublic"]:::service
        click ApiPublic "https://github.com/phan-manh-dung/ecommerce/blob/main/src/service/ApisPublic.js"
        OrderService["OrderService"]:::service
        click OrderService "https://github.com/phan-manh-dung/ecommerce/blob/main/src/service/OrderService.js"
        ProductService["ProductService"]:::service
        click ProductService "https://github.com/phan-manh-dung/ecommerce/blob/main/src/service/ProductService.js"
        UserService["UserService"]:::service
        click UserService "https://github.com/phan-manh-dung/ecommerce/blob/main/src/service/UserService.js"
        FirebaseInit["Firebase Init"]:::service
        click FirebaseInit "https://github.com/phan-manh-dung/ecommerce/blob/main/src/firebase.js"
    end

    subgraph "External Systems"
        API["External REST API"]:::external
        Firebase["Firebase (Auth/Realtime)"]:::external
        CDN["CDN/Storage"]:::external
    end

    subgraph "Assets & Styles"
        Assets["Assets (src/assets)"]:::assets
        click Assets "https://github.com/phan-manh-dung/ecommerce/tree/main/src/assets"
        GlobalStyle["GlobalStyle.css"]:::assets
        click GlobalStyle "https://github.com/phan-manh-dung/ecommerce/blob/main/src/GlobalStyle.css"
    end

    subgraph "Analytics & Tests"
        Analytics["reportWebVitals.js"]:::utility
        click Analytics "https://github.com/phan-manh-dung/ecommerce/blob/main/src/reportWebVitals.js"
        TestSetup["setupTests.js"]:::utility
        click TestSetup "https://github.com/phan-manh-dung/ecommerce/blob/main/src/setupTests.js"
        AppTest["App.test.js"]:::utility
        click AppTest "https://github.com/phan-manh-dung/ecommerce/blob/main/src/App.test.js"
    end

    Pages -->|"dispatch actions"| Store
    Hook1 -->|"calls service"| ApiPublic
    Hook2 -->|"calls service"| ApiPublic
    Hook3 -->|"calls service"| ApiPublic
    Hook4 -->|"calls service"| ApiPublic
    Cart -->|"uses ApiPublic"| ApiPublic
    Order -->|"uses OrderService"| OrderService
    Product -->|"uses ProductService"| ProductService
    User -->|"uses UserService"| UserService
    ApiPublic -->|"HTTP calls"| API
    OrderService -->|"HTTP calls"| API
    ProductService -->|"HTTP calls"| API
    UserService -->|"HTTP calls"| API
    FirebaseInit -->|"SDK calls"| Firebase
    Assets --> Browser
    GlobalStyle --> Browser
    App --> Analytics
    Index --> TestSetup
    Index --> AppTest

    classDef ui fill:#cce5ff,stroke:#0062cc,color:#004085
    classDef state fill:#d4edda,stroke:#155724,color:#155724
    classDef service fill:#fff3cd,stroke:#856404,color:#856404
    classDef external fill:#f8d7da,stroke:#721c24,color:#721c24
    classDef assets fill:#e2e3e5,stroke:#6c757d,color:#383d41
    classDef utility fill:#d1ecf1,stroke:#0c5460,color:#0c5460
```
