# roy7077/e-commerce-website architecture

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

- Interactive diagram: https://gitdiagram.com/roy7077/e-commerce-website
- Repository: https://github.com/roy7077/e-commerce-website

## Overview

##### Project Type and Purpose
- Full-stack e-commerce web application using the MERN stack.
- Key features: user authentication, product search, cart/orders, payment processing (Razorpay), refunds.

##### File Structure
- Top-level:
- client/ – React.js front end
- server/ – Node.js + Express.js back end
- client/src/Components – individual React UI components (NavBar, Cart, ProductCard, etc.)
- client/src/utils – Redux Toolkit slices (Cartslice.js) and store setup
- server/Config – MongoDB and Razorpay config
- server/Controllers – business logic for Authz, Ecommerce, Razorpay
- server/Middlewares – authentication middleware
- server/Models – Mongoose schemas (User, Cart, Payment, OrderedProducts)
- server/Routes – Express routes (paymentRoutes.js)
- server/index.js – entry point tying everything together

##### README for Insights
- Tech stack and external dependencies (MongoDB, JWT, Razorpay)
- API endpoints grouped by domain (Auth, Cart, Payment, Orders)

##### Main Components & Their Relationships
A. Client Browser
- React App (client/src)
- UI Components
- Redux Store (Cartslice)
B. API Server
- Express.js App (server/index.js)
- Routes (/api/v1/…)
- Controllers (Authz, Ecommerce, Razorpay)
- Middleware (Authz)
- Config (databases.js, razorpay.js)
C. Data Layer
- MongoDB (Users, Carts, Payments, OrderedProducts)
D. External Service
- Razorpay API

Interactions:
1. User → React UI → Redux store/state → HTTP requests to API
2. Express Routes → Authz Middleware (JWT) → Controllers
3. Controllers ↔ Mongoose Models → MongoDB
4. Payment flows: Controller ↔ Razorpay API
5. Controller returns data → Express Response → React UI updates

##### Architectural Patterns & Design Principles
- “Container” separation: UI vs API vs Database vs External Service
- MVC-style on the backend:
- Routes = Controllers’ entrypoints
- Controllers = Business logic
- Models = Data layer
- Frontend component hierarchy + Redux for state management
- JWT-based authentication middleware protecting routes
- Separation of configuration (database credentials, Razorpay keys) via Config files and environment variables (.env)

##### Elements
- Labels for each container/component (e.g., “React App”, “Express API”, “MongoDB”, “Razorpay”).
- Blue for client components
- Green for server components
- Orange for database
- Purple for external services

- Routes layer calls → Authz Middleware → AuthzController or EcommerceController or RazorpayController
- Controllers invoke → Mongoose Models → perform DB operations
- RazorpayController uses → Razorpay config (key id/secret) → External API

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "Client (Browser)"
        direction TB
        ReactApp["React App"]:::client
        subgraph "UI Components"
            direction TB
            UIComponents["UI Components"]:::client
        end
        subgraph "Redux Store"
            direction TB
            ReduxStore["Store.js"]:::client
            CartSlice["Cartslice.js"]:::client
        end
    end

    subgraph "Express API Server"
        direction TB
        Entry["index.js"]:::server
        subgraph "Config"
            direction TB
            DBConfig["databases.js"]:::server
            RazorConfig["razorpay.js"]:::server
        end
        subgraph "Middlewares"
            direction TB
            AuthMiddleware["Authz.js"]:::server
        end
        subgraph "Routes"
            direction TB
            PaymentRoutes["paymentRoutes.js"]:::server
        end
        subgraph "Controllers"
            direction TB
            AuthController["Authz.js"]:::server
            EcommerceController["Ecommerce.js"]:::server
            RazorpayController["Razorpay.js"]:::server
        end
        subgraph "Models"
            direction TB
            User["User.js"]:::server
            CartModel["Cart.js"]:::server
            PaymentModel["Payment.js"]:::server
            OrderedProductsModel["OrderedProducts.js"]:::server
        end
    end

    DB["MongoDB"]:::db
    RazorpayAPI["Razorpay API"]:::external

    ReactApp --> UIComponents
    ReactApp --> ReduxStore
    ReactApp -->|"REST API"| Entry

    Entry --> DBConfig
    Entry --> RazorConfig
    Entry --> PaymentRoutes

    PaymentRoutes --> AuthMiddleware
    AuthMiddleware --> AuthController
    AuthMiddleware --> EcommerceController
    AuthMiddleware --> RazorpayController

    AuthController --> User
    EcommerceController --> CartModel
    EcommerceController --> OrderedProductsModel
    RazorpayController --> PaymentModel

    DBConfig --> DB
    User --> DB
    CartModel --> DB
    PaymentModel --> DB
    OrderedProductsModel --> DB

    RazorConfig --> RazorpayController
    RazorpayController --> RazorpayAPI

    classDef client fill:#D0E8FF,stroke:#0288D1,stroke-width:1px
    classDef server fill:#E8F5E9,stroke:#388E3C,stroke-width:1px
    classDef db fill:#FFF3E0,stroke:#FB8C00,stroke-width:1px
    classDef external fill:#E1BEE7,stroke:#8E24AA,stroke-width:1px

    click ReactApp "https://github.com/roy7077/e-commerce-website/tree/main/client/src"
    click UIComponents "https://github.com/roy7077/e-commerce-website/tree/main/client/src/Components"
    click ReduxStore "https://github.com/roy7077/e-commerce-website/blob/main/client/src/utils/Store.js"
    click CartSlice "https://github.com/roy7077/e-commerce-website/blob/main/client/src/utils/Cartslice.js"
    click Entry "https://github.com/roy7077/e-commerce-website/blob/main/server/index.js"
    click DBConfig "https://github.com/roy7077/e-commerce-website/blob/main/server/Config/databases.js"
    click RazorConfig "https://github.com/roy7077/e-commerce-website/blob/main/server/Config/razorpay.js"
    click AuthMiddleware "https://github.com/roy7077/e-commerce-website/blob/main/server/Middlewares/Authz.js"
    click AuthController "https://github.com/roy7077/e-commerce-website/blob/main/server/Controllers/Authz.js"
    click EcommerceController "https://github.com/roy7077/e-commerce-website/blob/main/server/Controllers/Ecommerce.js"
    click RazorpayController "https://github.com/roy7077/e-commerce-website/blob/main/server/Controllers/Razorpay.js"
    click PaymentRoutes "https://github.com/roy7077/e-commerce-website/blob/main/server/Routes/paymentRoutes.js"
    click User "https://github.com/roy7077/e-commerce-website/blob/main/server/Models/User.js"
    click CartModel "https://github.com/roy7077/e-commerce-website/blob/main/server/Models/Cart.js"
    click PaymentModel "https://github.com/roy7077/e-commerce-website/blob/main/server/Models/Payment.js"
    click OrderedProductsModel "https://github.com/roy7077/e-commerce-website/blob/main/server/Models/OrderedProducts.js"
```
