# pratikbhopi/ecommerce_project_kurtastore architecture

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

- Interactive diagram: https://gitdiagram.com/pratikbhopi/ecommerce_project_kurtastore
- Repository: https://github.com/pratikbhopi/ecommerce_project_kurtastore

## Overview

##### Project type and purpose
- This is a full-stack e-commerce web application named “Karma Threads,” with three primary frontends (customer client, admin panel) and a Node/Express backend that exposes REST APIs.
- Purpose: allow customers to browse and purchase kurtas, and allow admins to manage products, users, and orders.

##### File structure
- Top level:
- Server/ ─ Node.js + Express backend
- client/ ─ React customer-facing SPA
- admin/ ─ React admin-facing SPA
- Server side:
- controllers/ (AdminControls, Products, Users, Payments)
- services/ (mailer)
- models/ (database connection, adminDB)
- routes/ (AdminRoutes, UserRoutes)
- server.js (entry point)
- Frontends each include Vite config, Tailwind CSS, environment config, src/components, src/pages.
- Configuration: .env variables for MongoDB Atlas, JWT, Cloudinary, Razorpay, VITE_SERVER_URL.

##### README for additional insights
- Tech stack: React, Node.js/Express, MongoDB Atlas, Cloudinary, Razorpay.
- Features: user auth, product browsing, cart/checkout, order history, admin panel, secure payments.

##### Elements
- Clear labels on every block (e.g., “Express API Server,” “MongoDB Atlas,” “Cloudinary”)
- Blue for frontends
- Green for backend/application layer
- Orange for data stores
- Purple for external third-party services

## Diagram (Mermaid)

```mermaid
graph TB
    %% Presentation Layer
    subgraph "Presentation" 
        direction TB
        Client["Customer UI<br/>(Client SPA)"]:::frontend
        Admin["Admin UI<br/>(Admin SPA)"]:::frontend
    end

    %% Application Layer
    subgraph "Application" 
        direction TB
        API["Express API Server"]:::backend

        subgraph "Routes"
            direction TB
            AR["Admin Routes"]:::backend
            UR["User Routes"]:::backend
        end

        subgraph "Controllers"
            direction TB
            AC["Admin Controls"]:::backend
            UC["User Credentials"]:::backend
            ADC["Admin Credentials"]:::backend
            PC["Products Controller"]:::backend
            PayC["Payment Controller"]:::backend
        end

        Mail["Mail Service"]:::external
    end

    %% Data & External Services
    subgraph "Data & External Services"
        direction TB
        subgraph "Database Layer"
            direction TB
            DBConn["MongoDB Connection"]:::database
            AdminDB["Admin DB Schema"]:::database
        end
        Cloud["Cloudinary CDN"]:::external
        RP["Razorpay Gateway"]:::external
    end

    %% Connections
    Client -->|"HTTPS/JSON"| API
    Admin -->|"HTTPS/JSON"| API

    API -->|"/admin/*"| AR
    API -->|"/user/*"| UR

    AR --> AC
    UR --> UC
    AR --> ADC
    AR --> PC
    UR --> PC
    API --> PayC
    API --> Mail

    API --> DBConn
    API --> AdminDB
    API --> Cloud
    API --> RP

    %% Click Events
    click Client "https://github.com/pratikbhopi/ecommerce_project_kurtastore/tree/main/client/"
    click Admin "https://github.com/pratikbhopi/ecommerce_project_kurtastore/tree/main/admin/"
    click API "https://github.com/pratikbhopi/ecommerce_project_kurtastore/blob/main/Server/server.js"
    click AC "https://github.com/pratikbhopi/ecommerce_project_kurtastore/blob/main/Server/controllers/AdminControls.js"
    click UC "https://github.com/pratikbhopi/ecommerce_project_kurtastore/blob/main/Server/controllers/UserCredentials.js"
    click ADC "https://github.com/pratikbhopi/ecommerce_project_kurtastore/blob/main/Server/controllers/AdminCredentials.js"
    click PC "https://github.com/pratikbhopi/ecommerce_project_kurtastore/blob/main/Server/controllers/Products.js"
    click PayC "https://github.com/pratikbhopi/ecommerce_project_kurtastore/blob/main/Server/controllers/PaymentController.js"
    click AR "https://github.com/pratikbhopi/ecommerce_project_kurtastore/blob/main/Server/routes/AdminRoutes.js"
    click UR "https://github.com/pratikbhopi/ecommerce_project_kurtastore/blob/main/Server/routes/UserRoutes.js"
    click Mail "https://github.com/pratikbhopi/ecommerce_project_kurtastore/blob/main/Server/services/mailer.js"
    click DBConn "https://github.com/pratikbhopi/ecommerce_project_kurtastore/blob/main/Server/models/database.js"
    click AdminDB "https://github.com/pratikbhopi/ecommerce_project_kurtastore/blob/main/Server/models/adminDB.js"

    %% Styles
    classDef frontend fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef backend fill:#90EE90,stroke:#333,stroke-width:1px
    classDef database fill:#FFD580,stroke:#333,stroke-width:1px
    classDef external fill:#D8BFD8,stroke:#333,stroke-width:1px
```
