# lucky7xx/pankart_backend architecture

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

- Interactive diagram: https://gitdiagram.com/lucky7xx/pankart_backend
- Repository: https://github.com/lucky7xx/pankart_backend

## Overview

##### Project type and purpose
- This is a monolithic, full-stack style backend API for an e-commerce platform (“Pankart”).
- It handles user authentication, product CRUD, order management, and payment via Stripe.
- Built with Node.js/Express and backed by MongoDB.

##### File structure
- Top-level entry point: server.js
- models/ holds Mongoose schemas (User, Product, Order) → data layer
- routes/ defines Express routes (auth, products, orders, stripe) → API layer
- server/config/db.js → database connection
- server/controllers/ → business logic handlers for each domain
- server/middleware/ → cross-cutting concerns (auth checks, error handling)
- Deployment config: nodemon.json, vercel.json

##### README for additional insights
- Confirms feature set: JWT auth, role checks, payment workflow.
- Technology stack: Express, MongoDB/Mongoose, JWT, Stripe, bcrypt, dotenv, CORS.
- Mentions centralized error middleware, health check endpoint, environment variables.

##### Elements
- Data storage (MongoDB) in another
- External services (Stripe) in a third

## Diagram (Mermaid)

```mermaid
flowchart TD
    Client["Client\n(Browser/Mobile)"]:::external

    subgraph "Express API"
        direction TB
        ExpressServer["API Gateway\n(server.js)"]:::api

        subgraph "Configuration"
            DBConfig["Database Config\n(server/config/db.js)"]:::api
            Env["Environment Variables\n(.env)"]:::api
        end

        subgraph "Middleware"
            AuthMW["Auth Middleware\n(server/middleware/auth.js)"]:::api
            ErrorMW["Error-Handling Middleware\n(server/middleware/error.js)"]:::api
        end

        subgraph "Routes"
            AuthRoutes["Authentication Routes\n(routes/authRoutes.js)"]:::api
            ProductRoutes["Product Routes\n(routes/productRoutes.js)"]:::api
            OrderRoutes["Order Routes\n(routes/orderRoutes.js)"]:::api
            StripeRoutes["Stripe Routes\n(routes/stripeRoutes.js)"]:::api
        end

        subgraph "Controllers"
            AuthController["Authentication Controller\n(server/controllers/authController.js)"]:::api
            ProductController["Product Controller\n(server/controllers/productController.js)"]:::api
            OrderController["Order Controller\n(server/controllers/orderController.js)"]:::api
            StripeController["Stripe Controller\n(server/controllers/stripeController.js)"]:::api
        end
    end

    subgraph "Data Layer"
        direction TB
        subgraph "Models"
            UserModel["User Model\n(models/User.js)"]:::data
            ProductModel["Product Model\n(models/Product.js)"]:::data
            OrderModel["Order Model\n(models/Order.js)"]:::data
        end
        MongoDB["MongoDB Database"]:::data
    end

    StripeAPI["Stripe API"]:::external

    Client -->|"HTTP Request"| ExpressServer
    ExpressServer -->|"loads config"| DBConfig
    ExpressServer -->|"loads env"| Env
    ExpressServer -->|"applies"| AuthMW
    ExpressServer -->|"applies"| ErrorMW
    ExpressServer -->|"routes to"| AuthRoutes
    ExpressServer -->|"routes to"| ProductRoutes
    ExpressServer -->|"routes to"| OrderRoutes
    ExpressServer -->|"routes to"| StripeRoutes

    AuthRoutes -->|"calls"| AuthController
    ProductRoutes -->|"calls"| ProductController
    OrderRoutes -->|"calls"| OrderController
    StripeRoutes -->|"calls"| StripeController

    AuthController -->|"operates on"| UserModel
    ProductController -->|"operates on"| ProductModel
    OrderController -->|"operates on"| OrderModel
    StripeController -->|"requests payment"| StripeAPI
    StripeController -->|"records order"| OrderModel

    UserModel -->|"queries"| MongoDB
    ProductModel -->|"queries"| MongoDB
    OrderModel -->|"queries"| MongoDB

    classDef api fill:#D6EAF8,stroke:#1B4F72,stroke-width:2px;
    classDef data fill:#D5F5E3,stroke:#1D8348,stroke-width:2px;
    classDef external fill:#FCF3CF,stroke:#B7950B,stroke-width:2px;

    click ExpressServer "https://github.com/lucky7xx/pankart_backend/blob/main/server.js"
    click DBConfig "https://github.com/lucky7xx/pankart_backend/blob/main/server/config/db.js"
    click UserModel "https://github.com/lucky7xx/pankart_backend/blob/main/models/User.js"
    click ProductModel "https://github.com/lucky7xx/pankart_backend/blob/main/models/Product.js"
    click OrderModel "https://github.com/lucky7xx/pankart_backend/blob/main/models/Order.js"
    click AuthRoutes "https://github.com/lucky7xx/pankart_backend/blob/main/routes/authRoutes.js"
    click ProductRoutes "https://github.com/lucky7xx/pankart_backend/blob/main/routes/productRoutes.js"
    click OrderRoutes "https://github.com/lucky7xx/pankart_backend/blob/main/routes/orderRoutes.js"
    click StripeRoutes "https://github.com/lucky7xx/pankart_backend/blob/main/routes/stripeRoutes.js"
    click AuthController "https://github.com/lucky7xx/pankart_backend/blob/main/server/controllers/authController.js"
    click ProductController "https://github.com/lucky7xx/pankart_backend/blob/main/server/controllers/productController.js"
    click OrderController "https://github.com/lucky7xx/pankart_backend/blob/main/server/controllers/orderController.js"
    click StripeController "https://github.com/lucky7xx/pankart_backend/blob/main/server/controllers/stripeController.js"
    click AuthMW "https://github.com/lucky7xx/pankart_backend/blob/main/server/middleware/auth.js"
    click ErrorMW "https://github.com/lucky7xx/pankart_backend/blob/main/server/middleware/error.js"
    click Nodemon "https://github.com/lucky7xx/pankart_backend/blob/main/nodemon.json"
    click Vercel "https://github.com/lucky7xx/pankart_backend/blob/main/vercel.json"
    click Package "https://github.com/lucky7xx/pankart_backend/blob/main/package.json"
    click Lock "https://github.com/lucky7xx/pankart_backend/blob/main/package-lock.json"
```
