# suvankar621/e-commerce-mern-stack architecture

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

- Interactive diagram: https://gitdiagram.com/suvankar621/e-commerce-mern-stack
- Repository: https://github.com/suvankar621/e-commerce-mern-stack

## Overview

##### Project type and purpose
- This is a full-stack MERN (MongoDB, Express, React, Node.js) e-commerce web application.
- Purpose: allow users to browse products, manage a cart, place orders, process payments via Stripe, handle user authentication, and manage product data (including images via Cloudinary).

##### File structure
- Top-level directories:
- backend/ – Node.js/Express API, MVC pattern
- frontend/ – React single-page app with Redux for state management
- backend:
- server.js and app.js bootstrap the Express server
- config/database.js — MongoDB connection
- controllers/*Controller.js — business logic per resource (user, product, order, payment)
- models/*.js — Mongoose schemas (User, Product, Order)
- routes/*Route.js — REST endpoints
- middleware/ — auth checks, error handling, async wrapper
- utils/ — token generation, email sender, API features (filter, pagination), error handler
- Procfile — deploy on Heroku
- frontend:
- public/ — static HTML, manifest
- src/ — React code
– index.js & App.js mount the app
– actions/ & reducers/ — Redux actions and reducers for user, product, cart, order
– component/ — organized by feature (Admin, Cart, Home, Order, Product, User, layout, routing)
– store.js — Redux store configuration
– constants/ — action type definitions

##### Extract insights from README
- Deploy requires environment variables for DB_URI, JWT, Stripe keys, SMTP, Cloudinary.
- Instructions to install dependencies for backend and frontend.

a. Main components
1. Client (React SPA in browser)
2. API Server (Node.js/Express)
3. Database (MongoDB Atlas or self-hosted)
4. External services:
- Stripe (payment gateway)
- Cloudinary (image storage)
- SMTP provider (email notifications)
b. Relationships and interactions
- Browser ↔ HTTP(S) API calls → Express routes
- Express controllers ↔ Mongoose models → MongoDB
- PaymentController ↔ Stripe API
- sendEmail utility ↔ SMTP service
- Product uploads ↔ Cloudinary API
c. Architectural patterns and design principles
- MVC on backend: separation of concerns among routes, controllers, models
- Centralized error handling and async wrapper (catchAsyncErrors)
- JWT-based authentication (stateless, stored in cookies)
- Redux for front-end state management (actions, reducers, store)
- ProtectedRoute component for guarding routes in React
d. Key technologies and frameworks
- Backend: Node.js, Express, Mongoose, JWT, Stripe SDK, Nodemailer
- Frontend: React, Redux, Redux Thunk (or similar middleware), React Router
- Deployment: Heroku (Procfile), environment variables

##### Diagramming recommendations
- Use clear labels for each component (e.g., “React SPA”, “Express API”, “MongoDB”)
- Client/UI (blue)
- Application server (green)
- External services (purple)

##### Detailed breakdown
- Routes layer (UserRoute, ProductRoute, OrderRoute, PaymentRoute)
- Controllers (userController, productController…)
- Services/Utils (jwtToken, sendEmail, apifeatures, errorHandler)
- Models (userModel, productModel, orderModel)
- External services: Stripe gateway, Cloudinary storage, SMTP mail server

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Frontend Layer"
        direction TB
        ReactSPA["React SPA"]:::frontend
        Store["Redux Store"]:::frontend
        Actions["Redux Actions"]:::frontend
        Reducers["Redux Reducers"]:::frontend
        ProtectedRoute["ProtectedRoute Component"]:::frontend
    end

    subgraph "Backend Layer"
        direction TB
        Server["server.js & app.js"]:::backend
        DBConfig["MongoDB Config"]:::backend
        subgraph "Routes" 
            direction TB
            UserRoute["UserRoute"]:::backend
            ProductRoute["ProductRoute"]:::backend
            OrderRoute["OrderRoute"]:::backend
            PaymentRoute["PaymentRoute"]:::backend
        end
        subgraph "Controllers"
            direction TB
            UserController["userController"]:::backend
            ProductController["productController"]:::backend
            OrderController["orderController"]:::backend
            PaymentController["paymentController"]:::backend
        end
        subgraph "Models"
            direction TB
            UserModel["userModel"]:::backend
            ProductModel["productModel"]:::backend
            OrderModel["orderModel"]:::backend
        end
        subgraph "Middleware & Utils"
            direction TB
            subgraph "Middleware"
                Auth["auth"]:::backend
                ErrorMiddleware["error"]:::backend
                AsyncWrapper["catchAsyncErrors"]:::backend
            end
            subgraph "Utils"
                JWT["jwtToken"]:::backend
                EmailUtil["sendEmail"]:::backend
                APIFeatures["apifeatures"]:::backend
                ErrorHandler["errorHandler"]:::backend
            end
        end
    end

    MongoDB[(MongoDB)]:::database
    Stripe[(Stripe API)]:::external
    Cloudinary[(Cloudinary API)]:::external
    SMTP[(SMTP Service)]:::external
    ProcfileNode["Procfile"]:::backend

    ReactSPA -->|"dispatch actions"| Actions
    Actions -->|"use reducers"| Reducers
    Reducers -->|"store state"| Store
    Store -->|"provide state"| ReactSPA
    ReactSPA -->|uses| ProtectedRoute

    ReactSPA -->|"HTTP(S) requests"| UserRoute
    ReactSPA -->|"HTTP(S) requests"| ProductRoute
    ReactSPA -->|"HTTP(S) requests"| OrderRoute
    ReactSPA -->|"HTTP(S) requests"| PaymentRoute

    Server -->|bootstraps| UserRoute
    Server -->|bootstraps| ProductRoute
    Server -->|bootstraps| OrderRoute
    Server -->|bootstraps| PaymentRoute
    Server -->|config| DBConfig

    UserRoute -->|"calls"| UserController
    ProductRoute -->|"calls"| ProductController
    OrderRoute -->|"calls"| OrderController
    PaymentRoute -->|"calls"| PaymentController

    UserController -->|"uses model"| UserModel
    ProductController -->|"uses model"| ProductModel
    OrderController -->|"uses model"| OrderModel
    PaymentController -->|"uses model"| OrderModel

    UserController --> JWT
    UserController --> EmailUtil
    UserController --> APIFeatures
    UserController --> ErrorHandler

    ProductController --> Cloudinary
    ProductController --> APIFeatures
    ProductController --> ErrorHandler

    OrderController --> APIFeatures
    OrderController --> ErrorHandler

    PaymentController --> Stripe
    PaymentController --> ErrorHandler

    JWT -->|generate tokens| UserController
    EmailUtil --> SMTP
    APIFeatures --> UserController
    APIFeatures --> ProductController
    APIFeatures --> OrderController

    Auth --> UserRoute
    ErrorMiddleware --> UserRoute
    AsyncWrapper --> UserRoute

    Auth --> ProductRoute
    ErrorMiddleware --> ProductRoute
    AsyncWrapper --> ProductRoute

    Auth --> OrderRoute
    ErrorMiddleware --> OrderRoute
    AsyncWrapper --> OrderRoute

    Auth --> PaymentRoute
    ErrorMiddleware --> PaymentRoute
    AsyncWrapper --> PaymentRoute

    UserModel --> MongoDB
    ProductModel --> MongoDB
    OrderModel --> MongoDB
    DBConfig --> MongoDB

    ProcfileNode --- Server

    classDef frontend fill:#cce5ff,stroke:#004085;
    classDef backend fill:#d4edda,stroke:#155724;
    classDef database fill:#fff3cd,stroke:#856404;
    classDef external fill:#d6d8f9,stroke:#383d7a;

    click ReactSPA "https://github.com/suvankar621/e-commerce-mern-stack/tree/main/frontend/src"
    click Store "https://github.com/suvankar621/e-commerce-mern-stack/blob/main/frontend/src/store.js"
    click Actions "https://github.com/suvankar621/e-commerce-mern-stack/tree/main/frontend/src/actions"
    click Reducers "https://github.com/suvankar621/e-commerce-mern-stack/tree/main/frontend/src/reducers"
    click ProtectedRoute "https://github.com/suvankar621/e-commerce-mern-stack/blob/main/frontend/src/component/Route/ProtectedRoute.js"
    click Server "https://github.com/suvankar621/e-commerce-mern-stack/blob/main/backend/server.js"
    click Server "https://github.com/suvankar621/e-commerce-mern-stack/blob/main/backend/app.js"
    click DBConfig "https://github.com/suvankar621/e-commerce-mern-stack/blob/main/backend/config/database.js"
    click UserRoute "https://github.com/suvankar621/e-commerce-mern-stack/blob/main/backend/routes/userRoute.js"
    click ProductRoute "https://github.com/suvankar621/e-commerce-mern-stack/blob/main/backend/routes/productRoute.js"
    click OrderRoute "https://github.com/suvankar621/e-commerce-mern-stack/blob/main/backend/routes/orderRoute.js"
    click PaymentRoute "https://github.com/suvankar621/e-commerce-mern-stack/blob/main/backend/routes/paymentRoute.js"
    click UserController "https://github.com/suvankar621/e-commerce-mern-stack/blob/main/backend/controllers/userController.js"
    click ProductController "https://github.com/suvankar621/e-commerce-mern-stack/blob/main/backend/controllers/productController.js"
    click OrderController "https://github.com/suvankar621/e-commerce-mern-stack/blob/main/backend/controllers/orderController.js"
    click PaymentController "https://github.com/suvankar621/e-commerce-mern-stack/blob/main/backend/controllers/paymentController.js"
    click UserModel "https://github.com/suvankar621/e-commerce-mern-stack/blob/main/backend/models/userModel.js"
    click ProductModel "https://github.com/suvankar621/e-commerce-mern-stack/blob/main/backend/models/productModel.js"
    click OrderModel "https://github.com/suvankar621/e-commerce-mern-stack/blob/main/backend/models/orderModel.js"
    click Auth "https://github.com/suvankar621/e-commerce-mern-stack/blob/main/backend/middleware/auth.js"
    click ErrorMiddleware "https://github.com/suvankar621/e-commerce-mern-stack/blob/main/backend/middleware/error.js"
    click AsyncWrapper "https://github.com/suvankar621/e-commerce-mern-stack/blob/main/backend/middleware/catchAsyncErrors.js"
    click JWT "https://github.com/suvankar621/e-commerce-mern-stack/blob/main/backend/utils/jwtToken.js"
    click EmailUtil "https://github.com/suvankar621/e-commerce-mern-stack/blob/main/backend/utils/sendEmail.js"
    click APIFeatures "https://github.com/suvankar621/e-commerce-mern-stack/blob/main/backend/utils/apifeatures.js"
    click ErrorHandler "https://github.com/suvankar621/e-commerce-mern-stack/blob/main/backend/utils/errorhander.js"
    click ProcfileNode "https://github.com/suvankar621/e-commerce-mern-stack/tree/main/Procfile"
```
