# saksham2882/mern-food-app architecture

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

- Interactive diagram: https://gitdiagram.com/saksham2882/mern-food-app
- Repository: https://github.com/saksham2882/mern-food-app

## Overview

##### Project Type and Purpose
- This is a full-stack MERN (MongoDB, Express, React, Node.js) food-ordering application.
- Users browse menus, manage carts, apply coupons, checkout with Stripe, and track orders.
- The backend (Node.js/Express/MongoDB) serves REST APIs; the frontend (React/Vite) consumes them.

##### High-Level Architecture Overview
- Main Components:
a. Frontend Client (React app)
b. API Server (Express/Node.js)
c. Database (MongoDB via Mongoose)
d. File Storage (local uploads folder for images)
e. External Service (Stripe payment gateway)
- Interaction Flow:
- User clicks in the React UI → Axios calls backend REST endpoints
- Backend authenticates (JWT via auth middleware) → Queries/updates MongoDB
- On payment, backend calls Stripe API → Confirms payment → Updates order status
- Frontend receives responses → Updates UI / StoreContext / React Router routes

##### Architectural Patterns & Design Principles
- Frontend: Component-based UI + React Router for page navigation + Context API for global state.
- Backend: MVC-style separation
- Models: Mongoose schemas (`userModels.js`, `FoodModels.js`, `orderModel.js`)
- Controllers: Business logic (`UserController.js`, `FoodControllers.js`, etc.)
- Routes: Route definitions (`userRoutes.js`, `FoodRoute.js`, etc.)
- Middleware: JWT auth (`auth.js`) and request preprocessing
- RESTful API design with clear resource endpoints (`/api/user`, `/api/food`, `/api/cart`, `/api/order`).
- Secure authentication using bcrypt (password hashing) + jsonwebtoken (JWT).
- File uploads handled by Multer, stored under `/backend/uploads`.

- Sub-components: Pages (Home, Cart, PlaceOrder, MyOrders, Verify), Reusable components (Navbar, Footer, FoodItem), Context (`StoreContext.jsx`)
- Technology: React, Axios, React Router, Context API, CSS, Vite
- Sub-components:
– Server (`server.js`)
– Config (`db.js` for MongoDB connection)
– Routes → Controllers → Models
– Middleware (auth)
– File Uploads (Multer → `/uploads`)
- Technology: Node.js, Express, Mongoose, dotenv, cors
- MongoDB Atlas or local instance
- Collections: users, foods, carts, orders
- External Services
- Stripe API (payment processing)
- Optional: Email/Notification service (if added)
- Deployment
- Frontend: Vercel (via `vercel.json`)
- Backend: Node host (Heroku, DigitalOcean, etc.)

##### Detail Level
- Data flow from UI to DB and back is crystal clear.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Frontend Layer
    subgraph "Frontend (React App)" 
        direction TB
        FE_Entry["main.jsx"]:::frontend
        FE_App["App.jsx"]:::frontend
        FE_Context["StoreContext.jsx"]:::frontend
        subgraph "Pages" 
            direction TB
            FE_Home["Home.jsx"]:::frontend
            FE_Cart["Cart.jsx"]:::frontend
            FE_PlaceOrder["PlaceOrder.jsx"]:::frontend
            FE_MyOrders["MyOrders.jsx"]:::frontend
            FE_Verify["Verify.jsx"]:::frontend
        end
        subgraph "UI Components"
            direction TB
            FE_Navbar["Navbar.jsx"]:::frontend
            FE_Footer["Footer.jsx"]:::frontend
            FE_FoodItem["FoodItem.jsx"]:::frontend
            FE_FoodDisplay["FoodDisplay.jsx"]:::frontend
            FE_ExploreMenu["ExploreMenu.jsx"]:::frontend
            FE_Features["Features.jsx"]:::frontend
            FE_Contact["Contact.jsx"]:::frontend
            FE_LoginPopup["LoginPopup.jsx"]:::frontend
        end
        subgraph "Config & Deployment"
            direction TB
            FE_Vite["vite.config.js"]:::frontend
            FE_Vercel["vercel.json"]:::frontend
            FE_HTML["index.html"]:::frontend
        end
    end

    %% Backend Layer
    subgraph "Backend (Express API Server)"
        direction TB
        BE_Entry["server.js"]:::backend
        BE_Config["db.js"]:::backend
        BE_Middleware["auth.js"]:::backend
        subgraph "Routes"
            direction TB
            BE_UserRoute["userRoutes.js"]:::backend
            BE_FoodRoute["FoodRoute.js"]:::backend
            BE_CartRoute["cartRoutes.js"]:::backend
            BE_OrderRoute["orderRoute.js"]:::backend
        end
        subgraph "Controllers"
            direction TB
            BE_UserCtrl["UserController.js"]:::backend
            BE_FoodCtrl["FoodControllers.js"]:::backend
            BE_CartCtrl["cartController.js"]:::backend
            BE_OrderCtrl["orderController.js"]:::backend
        end
        subgraph "Models"
            direction TB
            BE_UserModel["userModels.js"]:::backend
            BE_FoodModel["FoodModels.js"]:::backend
            BE_OrderModel["orderModel.js"]:::backend
        end
        BE_Uploads["uploads/"]:::backend
        BE_Package["package.json"]:::backend
    end

    %% Database
    subgraph "Database (MongoDB)"
        direction TB
        DB_Instance["MongoDB"]:::database
    end

    %% External Services
    subgraph "External Services"
        direction TB
        EXT_Stripe["Stripe API"]:::external
    end

    %% Connections
    FE_Entry -->|"renders"| FE_App
    FE_App -->|"provides context"| FE_Context
    FE_App -->|"routes to pages"| FE_Home
    FE_App --> FE_Cart
    FE_App --> FE_PlaceOrder
    FE_App --> FE_MyOrders
    FE_App --> FE_Verify
    FE_App --> FE_Navbar
    FE_App --> FE_Footer

    FE_Home -->|"fetchFoodItems() via Axios"| BE_UserRoute
    FE_Cart -->|"GET/POST /api/cart"| BE_CartRoute
    FE_PlaceOrder -->|"POST /api/order"| BE_OrderRoute
    FE_PlaceOrder -->|"file upload"| BE_Uploads
    FE_MyOrders -->|"GET /api/order"| BE_OrderRoute
    FE_Verify -->|"POST /api/order/verify"| BE_OrderRoute

    BE_Entry --> BE_Config
    BE_Entry --> BE_Middleware
    BE_Entry --> BE_UserRoute
    BE_Entry --> BE_FoodRoute
    BE_Entry --> BE_CartRoute
    BE_Entry --> BE_OrderRoute

    BE_UserRoute --> BE_UserCtrl
    BE_FoodRoute --> BE_FoodCtrl
    BE_CartRoute --> BE_CartCtrl
    BE_OrderRoute --> BE_OrderCtrl

    BE_UserCtrl --> BE_UserModel
    BE_FoodCtrl --> BE_FoodModel
    BE_CartCtrl --> BE_FoodModel
    BE_CartCtrl --> BE_UserModel
    BE_OrderCtrl --> BE_OrderModel

    BE_Config --> DB_Instance
    BE_UserModel --> DB_Instance
    BE_FoodModel --> DB_Instance
    BE_OrderModel --> DB_Instance

    BE_OrderCtrl -->|"create checkout session"| EXT_Stripe
    EXT_Stripe -->|"webhook callback"| BE_OrderRoute

    %% Click Events
    click FE_Entry "https://github.com/saksham2882/mern-food-app/blob/main/frontend/src/main.jsx"
    click FE_App "https://github.com/saksham2882/mern-food-app/blob/main/frontend/src/App.jsx"
    click FE_Context "https://github.com/saksham2882/mern-food-app/blob/main/frontend/src/context/StoreContext.jsx"
    click FE_Home "https://github.com/saksham2882/mern-food-app/blob/main/frontend/src/pages/Home/Home.jsx"
    click FE_Cart "https://github.com/saksham2882/mern-food-app/blob/main/frontend/src/pages/Cart/Cart.jsx"
    click FE_PlaceOrder "https://github.com/saksham2882/mern-food-app/blob/main/frontend/src/pages/PlaceOrder/PlaceOrder.jsx"
    click FE_MyOrders "https://github.com/saksham2882/mern-food-app/blob/main/frontend/src/pages/MyOrders/MyOrders.jsx"
    click FE_Verify "https://github.com/saksham2882/mern-food-app/blob/main/frontend/src/pages/Verify/Verify.jsx"
    click FE_Navbar "https://github.com/saksham2882/mern-food-app/blob/main/frontend/src/components/Navbar/Navbar.jsx"
    click FE_Footer "https://github.com/saksham2882/mern-food-app/blob/main/frontend/src/components/Footer/Footer.jsx"
    click FE_FoodItem "https://github.com/saksham2882/mern-food-app/blob/main/frontend/src/components/FoodItem/FoodItem.jsx"
    click FE_FoodDisplay "https://github.com/saksham2882/mern-food-app/blob/main/frontend/src/components/FoodDisplay/FoodDisplay.jsx"
    click FE_ExploreMenu "https://github.com/saksham2882/mern-food-app/blob/main/frontend/src/components/ExploreMenu/ExploreMenu.jsx"
    click FE_Features "https://github.com/saksham2882/mern-food-app/blob/main/frontend/src/components/Features/Features.jsx"
    click FE_Contact "https://github.com/saksham2882/mern-food-app/blob/main/frontend/src/components/Contact/Contact.jsx"
    click FE_LoginPopup "https://github.com/saksham2882/mern-food-app/blob/main/frontend/src/components/LoginPopup/LoginPopup.jsx"
    click FE_Vite "https://github.com/saksham2882/mern-food-app/blob/main/frontend/vite.config.js"
    click FE_Vercel "https://github.com/saksham2882/mern-food-app/blob/main/frontend/vercel.json"
    click FE_HTML "https://github.com/saksham2882/mern-food-app/blob/main/frontend/index.html"
    click BE_Entry "https://github.com/saksham2882/mern-food-app/blob/main/backend/server.js"
    click BE_Config "https://github.com/saksham2882/mern-food-app/blob/main/backend/config/db.js"
    click BE_Middleware "https://github.com/saksham2882/mern-food-app/blob/main/backend/middleware/auth.js"
    click BE_UserModel "https://github.com/saksham2882/mern-food-app/blob/main/backend/models/userModels.js"
    click BE_FoodModel "https://github.com/saksham2882/mern-food-app/blob/main/backend/models/FoodModels.js"
    click BE_OrderModel "https://github.com/saksham2882/mern-food-app/blob/main/backend/models/orderModel.js"
    click BE_UserCtrl "https://github.com/saksham2882/mern-food-app/blob/main/backend/controllers/UserController.js"
    click BE_FoodCtrl "https://github.com/saksham2882/mern-food-app/blob/main/backend/controllers/FoodControllers.js"
    click BE_CartCtrl "https://github.com/saksham2882/mern-food-app/blob/main/backend/controllers/cartController.js"
    click BE_OrderCtrl "https://github.com/saksham2882/mern-food-app/blob/main/backend/controllers/orderController.js"
    click BE_UserRoute "https://github.com/saksham2882/mern-food-app/blob/main/backend/routes/userRoutes.js"
    click BE_FoodRoute "https://github.com/saksham2882/mern-food-app/blob/main/backend/routes/FoodRoute.js"
    click BE_CartRoute "https://github.com/saksham2882/mern-food-app/blob/main/backend/routes/cartRoutes.js"
    click BE_OrderRoute "https://github.com/saksham2882/mern-food-app/blob/main/backend/routes/orderRoute.js"
    click BE_Uploads "https://github.com/saksham2882/mern-food-app/tree/main/backend/uploads/"
    click BE_Package "https://github.com/saksham2882/mern-food-app/blob/main/backend/package.json"

    %% Styles
    classDef frontend fill:#ADD8E6,stroke:#0366d6,color:#000
    classDef backend fill:#98FB98,stroke:#228B22,color:#000
    classDef database fill:#FFA500,stroke:#CC8400,color:#000
    classDef external fill:#DDA0DD,stroke:#800080,color:#000
```
