# winifycode/kttstore-react architecture

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

- Interactive diagram: https://gitdiagram.com/winifycode/kttstore-react
- Repository: https://github.com/winifycode/kttstore-react

## Overview

##### Main Components
a. Frontend (React/Vite)
– Entry: main.jsx → App.jsx
– React Router layer (pages/…)
– Shared Components (components/…)
– Contexts (AdminThemeContext, CustomerThemeContext)
– Services (axios instance in utils/axios.js)
– Styles (TailwindCSS + CSS files)
b. Backend (Node.js/Express)
– Entry: server.js
– Routing layer (routes/*.route.js)
– Controller layer (controllers/*Controller.js)
– Data layer (models/*.js using Mongoose)
– Middlewares (auth.middleware, ImagesCloudinary_Controller)
– Utility modules (server/utils/payos.js, server/data/trainingData.js)
c. Database
– MongoDB (hosted via connection string in .env)
– Collections: Users, Products, Orders, Cart, Category, Coupon, Notification, etc.
d. External Services
– Cloudinary (image uploads)
– PayOS (payment gateway)
– Nodemailer (email via SMTP/OAuth)
– OAuth 2.0 (social login)
– AI chat (optional integration via AIController + trainingData)

##### Relationships & Data Flow
– Frontend → HTTP/REST calls → Backend Routes
– Backend Routes → invoke Controllers → interact with Mongoose Models → read/write MongoDB
– Controllers → call External Service modules (Cloudinary, PayOS, Nodemailer) as needed
– Responses percolate back up: Models → Controllers → Routes → Frontend
– Frontend state updates via Contexts/Redux and re-renders UI

##### Architectural Patterns
– Frontend: Component-based architecture with a clear separation of pages, layouts, contexts, and shared UI controls
– Backend: Classic MVC (Express Routes → Controllers → Models)
– Authentication: JWT tokens handled in auth.middleware and stored in front-end (e.g., localStorage)
– File uploads: Direct to Cloudinary via middleware
– Payment: Backend gateway integration (PayOSController)
– Email: EmailController + subscription.route

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Client Side
    subgraph "Client (React/Vite)"
        direction TB
        subgraph Entry_Client
            direction TB
            Main["main.jsx"]:::frontend
            App["App.jsx"]:::frontend
        end
        subgraph "Router & Pages"
            direction TB
            Pages["pages/"]:::frontend
        end
        subgraph Components_Client
            direction TB
            Components["components/"]:::frontend
            AIChat["AIChat.jsx"]:::frontend
        end
        subgraph Contexts_Client
            direction TB
            AdminCtx["AdminThemeContext.jsx"]:::frontend
            CustCtx["CustomerThemeContext.jsx"]:::frontend
        end
        subgraph Services_Client
            direction TB
            AxiosSvc["axios.js"]:::frontend
        end
        subgraph Styles_Client
            direction TB
            IndexCSS["index.css"]:::frontend
            AppCSS["App.css"]:::frontend
        end
        subgraph Configs_Client
            direction TB
            TailwindCfg["tailwind.config.js"]:::frontend
            ViteCfg["vite.config.js"]:::frontend
        end
    end

    %% Server Side
    subgraph "Server (Node.js/Express)"
        direction TB
        ServerEntry["server.js"]:::backend
        subgraph Routes_Server
            direction TB
            ExpressRoutes["routes/"]:::backend
            EmailRoute["email.route.js"]:::backend
            SubRoute["subscription.route.js"]:::backend
        end
        subgraph Controllers_Server
            direction TB
            CtrlFolder["controllers/"]:::backend
            EmailCtl["EmailController.js"]:::backend
            SubCtl["SubscriptionController.js"]:::backend
            AIController["AIController.js"]:::backend
            PayOSCtl["PayOSController.js"]:::backend
        end
        subgraph Middlewares_Server
            direction TB
            AuthMW["auth.middleware.js"]:::backend
            ImgMW["ImagesCloudinary_Controller.js"]:::backend
        end
        Models["models/"]:::backend
        subgraph Utils_Server
            direction TB
            PayosUtil["payos.js"]:::backend
            TrainingData["trainingData.js"]:::backend
        end
    end

    %% Database and External
    DB["MongoDB"]:::database
    subgraph "External Services"
        direction TB
        Cloudinary["Cloudinary"]:::external
        PayOS["PayOS"]:::external
        EmailSvc["Nodemailer"]:::external
        OAuth2["OAuth2"]:::external
    end

    %% Connections - Client
    Main --> App
    App --> Pages
    App --> Components
    Components --> AIChat
    App --> AdminCtx
    App --> CustCtx
    App --> AxiosSvc
    App --> IndexCSS
    App --> AppCSS
    App --> TailwindCfg
    App --> ViteCfg
    AIChat --> AxiosSvc

    %% Client to Server
    AxiosSvc -->|"HTTP/REST"| ExpressRoutes

    %% Server Internal Flow
    ExpressRoutes --> CtrlFolder
    EmailRoute --> EmailCtl
    SubRoute --> SubCtl
    CtrlFolder --> AIController
    CtrlFolder --> PayOSCtl
    CtrlFolder --> EmailCtl
    CtrlFolder --> SubCtl
    ExpressRoutes --> AuthMW
    ExpressRoutes --> ImgMW
    CtrlFolder --> Models
    Models --> DB
    AIController --> TrainingData
    PayOSCtl --> PayosUtil

    %% Controllers to External
    EmailCtl --> EmailSvc
    SubCtl --> EmailSvc
    ImgMW --> Cloudinary
    PayOSCtl --> PayOS
    AuthMW --> OAuth2

    %% Clients Styles & Configs (no further connections)

    %% Click Events - Client
    click Main "https://github.com/winifycode/kttstore-react/blob/main/client/src/main.jsx"
    click App "https://github.com/winifycode/kttstore-react/blob/main/client/src/App.jsx"
    click Pages "https://github.com/winifycode/kttstore-react/tree/main/client/src/pages/"
    click Components "https://github.com/winifycode/kttstore-react/tree/main/client/src/components/"
    click AIChat "https://github.com/winifycode/kttstore-react/blob/main/client/src/components/AI/AIChat.jsx"
    click AdminCtx "https://github.com/winifycode/kttstore-react/blob/main/client/src/contexts/AdminThemeContext.jsx"
    click CustCtx "https://github.com/winifycode/kttstore-react/blob/main/client/src/contexts/CustomerThemeContext.jsx"
    click AxiosSvc "https://github.com/winifycode/kttstore-react/blob/main/client/src/utils/axios.js"
    click IndexCSS "https://github.com/winifycode/kttstore-react/blob/main/client/src/index.css"
    click AppCSS "https://github.com/winifycode/kttstore-react/blob/main/client/src/App.css"
    click TailwindCfg "https://github.com/winifycode/kttstore-react/blob/main/client/tailwind.config.js"
    click ViteCfg "https://github.com/winifycode/kttstore-react/blob/main/client/vite.config.js"

    %% Click Events - Server
    click ServerEntry "https://github.com/winifycode/kttstore-react/blob/main/server/server.js"
    click ExpressRoutes "https://github.com/winifycode/kttstore-react/tree/main/server/routes/"
    click EmailRoute "https://github.com/winifycode/kttstore-react/blob/main/server/mail/email.route.js"
    click SubRoute "https://github.com/winifycode/kttstore-react/blob/main/server/mail/subscription.route.js"
    click CtrlFolder "https://github.com/winifycode/kttstore-react/tree/main/server/controllers/"
    click EmailCtl "https://github.com/winifycode/kttstore-react/blob/main/server/mail/EmailController.js"
    click SubCtl "https://github.com/winifycode/kttstore-react/blob/main/server/mail/SubscriptionController.js"
    click AIController "https://github.com/winifycode/kttstore-react/blob/main/server/controllers/AIController.js"
    click PayOSCtl "https://github.com/winifycode/kttstore-react/blob/main/server/controllers/PayOSController.js"
    click AuthMW "https://github.com/winifycode/kttstore-react/blob/main/server/middlewares/auth.middleware.js"
    click ImgMW "https://github.com/winifycode/kttstore-react/blob/main/server/middlewares/ImagesCloudinary_Controller.js"
    click Models "https://github.com/winifycode/kttstore-react/tree/main/server/models/"
    click PayosUtil "https://github.com/winifycode/kttstore-react/blob/main/server/utils/payos.js"
    click TrainingData "https://github.com/winifycode/kttstore-react/blob/main/server/data/trainingData.js"

    %% Styles
    classDef frontend fill:#E0F7FA,stroke:#006064,color:#004D40
    classDef backend fill:#E8F5E9,stroke:#1B5E20,color:#2E7D32
    classDef database fill:#EDE7F6,stroke:#512DA8,color:#311B92
    classDef external fill:#FFF3E0,stroke:#EF6C00,color:#E65100
```
