# saurabh7431/trendmart architecture

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

- Interactive diagram: https://gitdiagram.com/saurabh7431/trendmart
- Repository: https://github.com/saurabh7431/trendmart

## Overview

##### Project type and purpose
- TrendMart is a monolithic full-stack e-commerce web application built on Node.js and Express.js.
- It uses MVC (Model-View-Controller) architecture, with EJS templates for server-side rendering and Tailwind CSS for styling.
- Key features: user authentication (both admin and regular users), product management, shopping cart, order processing, image uploads, and payment integration (Razorpay).

##### File structure
- Top-level:
- app.js – Express app setup, middleware registration, route mounting.
- config/ – environment configuration (DB connections, Multer, API keys).
- controllers/ – business logic (auth, product, cart, order).
- routes/ – Express routers for each resource (home, cart, user, owner/admin, products).
- models/ – Mongoose schemas (User, Owner, Product, Order).
- middleware/ – auth guards (isLoggedIn, isAdminLoggedIn).
- views/ – EJS templates (UI pages, partials).
- public/ – static assets (images, CSS).
- uploads/ – user-uploaded images.
- utils/ – helper functions (JWT token generation).
- config/mongoose-connection.js – establishes MongoDB connection.
- vercel.json – deployment config.
- postcss.config.js & tailwind.config.js – CSS build.

##### Main components
a. Client (Browser)
b. Express.js Server (monolithic)
- Route Handlers
- Middleware Layer
- Controllers (auth, product, cart, order)
- Utility Layer (JWT generation, file upload config)
- View Engine (EJS templates)
- Static file server (public folder)
c. Database (MongoDB via Mongoose)
d. File Storage (local uploads folder, managed by Multer)
e. External Payment Service (Razorpay)

##### Relationships and interactions
- Client → Server: HTTP(S) requests for pages, API calls, form submissions
- Server Middleware → Controllers → Database (CRUD via Mongoose)
- Controllers → View Engine: render EJS with dynamic data
- Controllers → Static Assets: serve CSS/JS/images from “public”
- Controllers → File Storage: Multer handles image uploads to “uploads/”
- Controllers → External Payment Service: initiate payment, receive callbacks

##### Architectural patterns & design principles
- MVC pattern: clear separation of Models (models/), Views (views/), Controllers (controllers/)
- Layered architecture: routing → middleware → business logic → data access
- Single codebase monolith: all modules packaged in one deployment unit
- Environment-based config in config/ (12-factor style)

##### Technologies & frameworks
- Node.js, Express.js (web framework)
- MongoDB with Mongoose (ODM)
- EJS (template engine)
- Tailwind CSS & PostCSS (styling)
- Multer (multipart form‐data uploads)
- JWT (authentication tokens via utils/)
- Razorpay (payment gateway integration)
- Vercel (hosting, as per vercel.json)

## Diagram (Mermaid)

```mermaid
flowchart TB
    Client["Browser"]:::client

    subgraph "Express.js Server"
        APP["app.js"]:::server

        subgraph "Routing Layer"
            HR["homeRouter.js"]:::routing
            CR["cartRouter.js"]:::routing
            PR["productRouter.js"]:::routing
            UR["userRouter.js"]:::routing
            OR["ownerRouter.js"]:::routing
            IR["index.js"]:::routing
        end

        subgraph "Middleware Layer"
            ML1["isLoggedIn.js"]:::middleware
            ML2["isAdminLoggedIn.js"]:::middleware
            ML3["userLoggedin.js"]:::middleware
        end

        subgraph "Controller Layer"
            AC["authControllers.js"]:::controller
            AA["authAdminControllers.js"]:::controller
        end

        subgraph "View & Static Layer"
            VL1["views/"]:::view
            VL2["public/"]:::view
        end

        subgraph "Utility & Config Layer"
            UL1["generateToken.js"]:::util
            UL2["generateAdminToken.js"]:::util
            UL3["multer-config.js"]:::util
            UL4["keys.js"]:::util
            UL5["mongoose-connection.js"]:::util
        end
    end

    DB["MongoDB"]:::db
    FS["uploads/"]:::storage
    RP["Razorpay"]:::external

    Client -->|"HTTP Request"| IR
    IR -->|"use Middleware"| ML1
    IR --> ML2
    IR --> ML3
    ML1 -->|"call Controller"| AC
    AC -->|"CRUD via Mongoose"| DB
    AC -->|"Render EJS"| VL1
    AC -->|"Serve Static"| VL2
    AC -->|"Upload Image"| FS
    AC -->|"Initiate Payment"| RP

    classDef client fill:#ECEFF1,stroke:#90A4AE
    classDef server fill:#E1F5FE,stroke:#81D4FA
    classDef routing fill:#B3E5FC,stroke:#4FC3F7
    classDef middleware fill:#81D4FA,stroke:#0288D1
    classDef controller fill:#03A9F4,stroke:#0277BD
    classDef view fill:#C8E6C9,stroke:#388E3C
    classDef util fill:#FFF9C4,stroke:#FDD835
    classDef db fill:#C8E6C9,stroke:#2E7D32
    classDef storage fill:#FFF59D,stroke:#F9A825
    classDef external fill:#E1BEE7,stroke:#8E24AA

    click APP "https://github.com/saurabh7431/trendmart/blob/main/app.js"
    click HR "https://github.com/saurabh7431/trendmart/blob/main/routes/homeRouter.js"
    click CR "https://github.com/saurabh7431/trendmart/blob/main/routes/cartRouter.js"
    click PR "https://github.com/saurabh7431/trendmart/blob/main/routes/productRouter.js"
    click UR "https://github.com/saurabh7431/trendmart/blob/main/routes/userRouter.js"
    click OR "https://github.com/saurabh7431/trendmart/blob/main/routes/ownerRouter.js"
    click IR "https://github.com/saurabh7431/trendmart/blob/main/routes/index.js"
    click ML1 "https://github.com/saurabh7431/trendmart/blob/main/midileware/isLoggedIn.js"
    click ML2 "https://github.com/saurabh7431/trendmart/blob/main/midileware/isAdminLoggedIn.js"
    click ML3 "https://github.com/saurabh7431/trendmart/blob/main/midileware/userLoggedin.js"
    click AC "https://github.com/saurabh7431/trendmart/blob/main/controllers/authControllers.js"
    click AA "https://github.com/saurabh7431/trendmart/blob/main/controllers/authAdminControllers.js"
    click VL1 "https://github.com/saurabh7431/trendmart/tree/main/views/"
    click VL2 "https://github.com/saurabh7431/trendmart/tree/main/public/"
    click UL1 "https://github.com/saurabh7431/trendmart/blob/main/utils/generateToken.js"
    click UL2 "https://github.com/saurabh7431/trendmart/blob/main/utils/generateAdminToken.js"
    click UL3 "https://github.com/saurabh7431/trendmart/blob/main/config/multer-config.js"
    click UL4 "https://github.com/saurabh7431/trendmart/blob/main/config/keys.js"
    click UL5 "https://github.com/saurabh7431/trendmart/blob/main/config/mongoose-connection.js"
    click FS "https://github.com/saurabh7431/trendmart/tree/main/uploads/"
```
