# naman-saxena1/bookztron-e-commerce_book_store architecture

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

- Interactive diagram: https://gitdiagram.com/naman-saxena1/bookztron-e-commerce_book_store
- Repository: https://github.com/naman-saxena1/bookztron-e-commerce_book_store

## Overview

##### Project type and purpose
- From the README (“Full Stack E-Commerce Project using MERN”) and the file tree (a React “src” folder, “public” & “build” directories, plus a note about a Node/Express/MongoDB backend deployed separately), this is a full-stack online bookstore.
- The front end is a React single‐page application (SPA) using Context API for state management. The backend (not in this repo) is a RESTful API built with Node.js/Express and MongoDB, deployed on Vercel. The front end itself is deployed on Netlify.

##### File structure
- Top-level:
- public/ & build/ → static assets and production bundle for the React app
- src/ → application source code
- package.json / package-lock.json → npm configuration
- Inside src/:
- Components/ → reusable UI components (cards, navbar, sidebar, toast, etc.)
- Context/ → React Contexts for cart, wishlist, user auth, products, filters, toast
- Pages/ → route targets (Home, Shop, ProductPage, Cart, Wishlist, Orders, Authentication)
- UtilityFunctions/loadRazorpayScript.js → dynamic payment SDK loader
- index.js, App.js → entry point and router setup

##### README for additional insights
- Technologies: React, Context API, CSS, JavaScript on the client; Node, Express, MongoDB on the server
- Features: authentication, product listing, sorting & filtering, wishlist & cart management, coupon, Razorpay integration, orders
- Shows the user flows and API interactions required (e.g., signup/login, adding to cart, checkout/razorpay, fetching orders)

a. Main components:
- Front end (React SPA)
- Back end (Node/Express REST API)
- Database (MongoDB Atlas)
- External services: Razorpay for payments, Authentication (if OAuth providers used), CDN/Netlify hosting, Vercel hosting
b. Relationships/interactions:
- Browser → React SPA (served via CDN/Netlify)
- SPA → REST API (over HTTPS):
- Auth endpoints (signup/login/logout)
- Product catalog endpoints (list, filter, details)
- Cart & wishlist endpoints (CRUD)
- Order endpoints (create order, get orders)
- Payment endpoints (create payment order, verify payment)
- REST API → MongoDB (CRUD operations)
- SPA ↔ Razorpay JavaScript SDK (loaded at checkout)
c. Architectural patterns/design principles:
- Client-server separation (SPA and REST API)
- React Context API for global state management (cart, wishlist, user, UI states)
- Component modularity (molecules & pages)
- Externalization of configuration & assets (public folder, environment variables on Vercel/Netlify)
d. Technologies/frameworks to label:
- React, React Router, Context API
- Node.js, Express.js, Mongoose
- MongoDB Atlas (or self-hosted)
- Razorpay SDK
- Netlify / Vercel

- Use clear, consistent labels (e.g., “React SPA”, “Express API”, “MongoDB”)
- Front end (blue),
- Back end (green),
- Database (orange),
- External services (purple)
- Rectangles for services/modules,
- Clouds for external systems

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Client Tier
    subgraph "Client Tier (React SPA)"
        ReactSPA["React SPA"]:::frontend
        subgraph "Entry Point & Router"
            Index["index.js"]:::frontend
            App["App.js"]:::frontend
        end
        subgraph "Context Providers"
            CartCtx["Cart Context"]:::frontend
            WishlistCtx["Wishlist Context"]:::frontend
            UserCtx["User Auth Context"]:::frontend
            ProductCtx["Product Context"]:::frontend
            GenreCtx["Genre Context"]:::frontend
            ArrivalCtx["New Arrivals Context"]:::frontend
            OrdersCtx["Orders Context"]:::frontend
            SearchCtx["Search Bar Context"]:::frontend
            ToastCtx["Toast Context"]:::frontend
        end
        subgraph "UI Components"
            ComponentsDir["Components"]:::frontend
        end
        subgraph "Pages"
            PagesDir["Pages"]:::frontend
        end
        Utility["loadRazorpayScript.js"]:::frontend
        Assets["Assets"]:::frontend
    end

    %% Server Tier
    subgraph "Server Tier (Express API)"
        AuthCtrl["Auth Controller"]:::backend
        ProdCtrl["Product Controller"]:::backend
        CartCtrl["Cart Controller"]:::backend
        OrderCtrl["Order Controller"]:::backend
        PaymentCtrl["Payment Controller"]:::backend
    end

    %% Data Tier
    DB["MongoDB Atlas"]:::db

    %% External Services
    subgraph "External Services"
        Razorpay["Razorpay SDK"]:::ext
        CDN["CDN / Netlify / Vercel"]:::ext
    end

    %% User Browser
    Browser["Browser"]:::ext

    %% Connections
    Browser -->|"loads SPA"| ReactSPA
    CDN -->|serves SPA| ReactSPA

    ReactSPA -->|"uses Entry Point"| Index
    ReactSPA -->|"uses Router"| App
    ReactSPA -->|"uses Contexts"| CartCtx & WishlistCtx & UserCtx & ProductCtx & GenreCtx & ArrivalCtx & OrdersCtx & SearchCtx & ToastCtx
    ReactSPA -->|"renders Components"| ComponentsDir
    ReactSPA -->|"routes to Pages"| PagesDir
    ReactSPA -->|"loads Utility"| Utility
    ReactSPA -->|"loads Assets"| Assets

    ReactSPA -->|"POST /api/auth/*"| AuthCtrl
    ReactSPA -->|"GET /api/products*"| ProdCtrl
    ReactSPA -->|"CRUD /api/cart*"| CartCtrl
    ReactSPA -->|"CRUD /api/orders*"| OrderCtrl
    ReactSPA -->|"POST /api/payment*"| PaymentCtrl

    AuthCtrl -->|"CRUD"| DB
    ProdCtrl -->|"CRUD"| DB
    CartCtrl -->|"CRUD"| DB
    OrderCtrl -->|"CRUD"| DB
    PaymentCtrl -->|"CRUD"| DB
    PaymentCtrl -->|"verifies with"| Razorpay

    %% Click Events
    click ReactSPA "https://github.com/naman-saxena1/bookztron-e-commerce_book_store/tree/development/src/"
    click Index "https://github.com/naman-saxena1/bookztron-e-commerce_book_store/blob/development/src/index.js"
    click App "https://github.com/naman-saxena1/bookztron-e-commerce_book_store/blob/development/src/App.js"
    click CartCtx "https://github.com/naman-saxena1/bookztron-e-commerce_book_store/blob/development/src/Context/cart-context.js"
    click WishlistCtx "https://github.com/naman-saxena1/bookztron-e-commerce_book_store/blob/development/src/Context/wishlist-context.js"
    click UserCtx "https://github.com/naman-saxena1/bookztron-e-commerce_book_store/blob/development/src/Context/user-login-context.js"
    click ProductCtx "https://github.com/naman-saxena1/bookztron-e-commerce_book_store/blob/development/src/Context/product-context.js"
    click GenreCtx "https://github.com/naman-saxena1/bookztron-e-commerce_book_store/blob/development/src/Context/genre-context.js"
    click ArrivalCtx "https://github.com/naman-saxena1/bookztron-e-commerce_book_store/blob/development/src/Context/new-arrival-context.js"
    click OrdersCtx "https://github.com/naman-saxena1/bookztron-e-commerce_book_store/blob/development/src/Context/orders-context.js"
    click SearchCtx "https://github.com/naman-saxena1/bookztron-e-commerce_book_store/blob/development/src/Context/search-bar-context.js"
    click ToastCtx "https://github.com/naman-saxena1/bookztron-e-commerce_book_store/blob/development/src/Context/toast-context.js"
    click ComponentsDir "https://github.com/naman-saxena1/bookztron-e-commerce_book_store/tree/development/src/Components/"
    click PagesDir "https://github.com/naman-saxena1/bookztron-e-commerce_book_store/tree/development/src/Pages/"
    click Utility "https://github.com/naman-saxena1/bookztron-e-commerce_book_store/blob/development/src/UtilityFunctions/loadRazorpayScript.js"
    click Assets "https://github.com/naman-saxena1/bookztron-e-commerce_book_store/tree/development/src/Assets/Icons"

    %% Styles
    classDef frontend fill:#D0E8FF,stroke:#0366d6,stroke-width:1px
    classDef backend fill:#D0FFD0,stroke:#2e8b57,stroke-width:1px
    classDef db fill:#FFE0B2,stroke:#e65100,stroke-width:1px
    classDef ext fill:#E1BEE7,stroke:#6a1b9a,stroke-width:1px
```
