# harsh8104/food-delivery-mern-stack architecture

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

- Interactive diagram: https://gitdiagram.com/harsh8104/food-delivery-mern-stack
- Repository: https://github.com/harsh8104/food-delivery-mern-stack

## Overview

##### Project type and purpose
- This is a full-stack food-delivery web application named **Food-Delivery-Quick-Byte**.
- It comprises two React/Vite frontends (“latest” for end-users, “admin/latest” for administrators) and a Node.js/Express backend.
- The backend exposes RESTful APIs, persists data (users, orders, cart items, etc.) to a database, handles authentication, file uploads, and sends emails.

##### File structure
- Top-level:
- admin/latest/… → Admin React app (components, pages, Vite config).
- latest/… → End-user React app (components, pages, context, Vite config).
- backend/… → Express server (index.js, routes/, controllers/, models/, middlewares/, util/, config/).
- Patterns:
- Frontends use component-based architecture (React) with pages, context for global state.
- Backend follows MVC-style separation: Routes → Controllers → Models.
- Uses environment variables (.env) for configuration, uploads folder for static assets.

##### Key README insights
- Frontend stack: React, React Router, MUI, Axios, Toastify, Vite.
- Backend stack: Node.js, Express, likely MongoDB via config/db.js.
- Provides live demos for user, admin, and API endpoints.

a. Main components:
- User Web Client (“latest” React app)
- Admin Web Client (“admin/latest” React app)
- Backend API Server (Express)
- Database (MongoDB or similar)
- File Storage (uploads directory or cloud storage)
- External Email Service (SMTP or third-party)
b. Relationships & interactions:
- Clients ↔ Backend: HTTP(S) requests via Axios to REST endpoints (/users, /food, /cart, /order, /contact).
- Backend ↔ DB: CRUD operations on User, Food, Order, ContactUs, Cart collections.
- Backend ↔ File Storage: upload & serve images/assets via /uploads.
- Backend ↔ Email Service: send confirmation/notifications via util/MailsSender.
c. Architectural patterns:
- MVC in backend: Routes → Controllers → Models
- Component-based UI in frontend with Context for state management
- Separation of concerns: two distinct frontends for user/admin
d. Technologies & frameworks:
- Frontends: React, Vite, React Router, MUI/NextUI, Axios, Toastify
- Backend: Node.js, Express, Mongoose (assumed), dotenv, nodemailer (assumed)
- Database: MongoDB (assumed from config/db.js)
- Hosting: Vite build output served statically (e.g., Render, Netlify)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Web Clients
    subgraph "Web Clients"
        direction TB
        subgraph "User Web Client"
            direction TB
            MainUser["main.jsx"]:::frontend
            AppUser["App.jsx"]:::frontend
            ViteUser["vite.config.js"]:::frontend
            ComponentsUser["components/"]:::frontend
            PagesUser["pages/"]:::frontend
            ContextUser["StoreContext.jsx"]:::frontend
        end
        subgraph "Admin Web Client"
            direction TB
            MainAdmin["main.jsx"]:::frontend
            AppAdmin["App.jsx"]:::frontend
            ViteAdmin["vite.config.js"]:::frontend
            ComponentsAdmin["Components/"]:::frontend
            PagesAdmin["pages/"]:::frontend
        end
    end

    %% API Server
    subgraph "API Server"
        direction TB
        APIServer["Express API Server"]:::server
        BackendIndex["index.js"]:::code
        BackendPkg["package.json"]:::code
        DBConfig["db.js"]:::code
        subgraph "Routes"
            direction TB
            RouteUser["User.js"]:::code
            RouteFood["Food.js"]:::code
            RouteCart["Cart.js"]:::code
            RouteOrder["Order.js"]:::code
            RouteContact["Contact.js"]:::code
        end
        subgraph "Controllers"
            direction TB
            ControllerUser["User.js"]:::code
            ControllerFood["Food.js"]:::code
            ControllerCart["Cart.js"]:::code
            ControllerOrder["Order.js"]:::code
            ControllerContact["ContactUs.js"]:::code
        end
        subgraph "Models"
            direction TB
            ModelUser["User.js"]:::code
            ModelFood["Food.js"]:::code
            ModelOrder["Order.js"]:::code
            ModelContact["ContactUs.js"]:::code
        end
        AuthMiddleware["Auth.js"]:::code
        Uploads["uploads/"]:::persistence
        MailUtil["MailsSender.js"]:::code
    end

    %% Persistence & External
    DB["MongoDB"]:::persistence
    FileStorage["File Storage"]:::persistence
    EmailService["Email Service"]:::external

    %% Connections
    MainUser -->|uses| APIServer
    MainAdmin -->|uses| APIServer
    APIServer -->|reads/writes| DB
    APIServer -->|upload/download| FileStorage
    APIServer -->|send mails| EmailService
    APIServer --> BackendIndex
    APIServer --> BackendPkg
    BackendIndex --> DBConfig
    APIServer --> RouteUser
    APIServer --> RouteFood
    APIServer --> RouteCart
    APIServer --> RouteOrder
    APIServer --> RouteContact
    RouteUser --> ControllerUser
    RouteFood --> ControllerFood
    RouteCart --> ControllerCart
    RouteOrder --> ControllerOrder
    RouteContact --> ControllerContact
    ControllerUser --> ModelUser
    ControllerFood --> ModelFood
    ControllerCart --> ModelOrder
    ControllerOrder --> ModelOrder
    ControllerContact --> ModelContact
    APIServer --> AuthMiddleware
    APIServer --> MailUtil
    APIServer --> Uploads

    %% Click Events
    click MainUser "https://github.com/harsh8104/food-delivery-mern-stack/blob/main/latest/src/main.jsx"
    click AppUser "https://github.com/harsh8104/food-delivery-mern-stack/blob/main/latest/src/App.jsx"
    click ViteUser "https://github.com/harsh8104/food-delivery-mern-stack/blob/main/latest/vite.config.js"
    click ComponentsUser "https://github.com/harsh8104/food-delivery-mern-stack/tree/main/latest/src/components/"
    click PagesUser "https://github.com/harsh8104/food-delivery-mern-stack/tree/main/latest/src/pages/"
    click ContextUser "https://github.com/harsh8104/food-delivery-mern-stack/blob/main/latest/src/context/StoreContext.jsx"
    click MainAdmin "https://github.com/harsh8104/food-delivery-mern-stack/blob/main/admin/latest/src/main.jsx"
    click AppAdmin "https://github.com/harsh8104/food-delivery-mern-stack/blob/main/admin/latest/src/App.jsx"
    click ViteAdmin "https://github.com/harsh8104/food-delivery-mern-stack/blob/main/admin/latest/vite.config.js"
    click ComponentsAdmin "https://github.com/harsh8104/food-delivery-mern-stack/tree/main/admin/latest/src/Components/"
    click PagesAdmin "https://github.com/harsh8104/food-delivery-mern-stack/tree/main/admin/latest/src/pages/"
    click BackendIndex "https://github.com/harsh8104/food-delivery-mern-stack/blob/main/backend/index.js"
    click BackendPkg "https://github.com/harsh8104/food-delivery-mern-stack/blob/main/backend/package.json"
    click DBConfig "https://github.com/harsh8104/food-delivery-mern-stack/blob/main/backend/config/db.js"
    click RouteUser "https://github.com/harsh8104/food-delivery-mern-stack/blob/main/backend/routes/User.js"
    click RouteFood "https://github.com/harsh8104/food-delivery-mern-stack/blob/main/backend/routes/Food.js"
    click RouteCart "https://github.com/harsh8104/food-delivery-mern-stack/blob/main/backend/routes/Cart.js"
    click RouteOrder "https://github.com/harsh8104/food-delivery-mern-stack/blob/main/backend/routes/Order.js"
    click RouteContact "https://github.com/harsh8104/food-delivery-mern-stack/blob/main/backend/routes/Contact.js"
    click ControllerUser "https://github.com/harsh8104/food-delivery-mern-stack/blob/main/backend/controllers/User.js"
    click ControllerFood "https://github.com/harsh8104/food-delivery-mern-stack/blob/main/backend/controllers/Food.js"
    click ControllerCart "https://github.com/harsh8104/food-delivery-mern-stack/blob/main/backend/controllers/Cart.js"
    click ControllerOrder "https://github.com/harsh8104/food-delivery-mern-stack/blob/main/backend/controllers/Order.js"
    click ControllerContact "https://github.com/harsh8104/food-delivery-mern-stack/blob/main/backend/controllers/ContactUs.js"
    click ModelUser "https://github.com/harsh8104/food-delivery-mern-stack/blob/main/backend/models/User.js"
    click ModelFood "https://github.com/harsh8104/food-delivery-mern-stack/blob/main/backend/models/Food.js"
    click ModelOrder "https://github.com/harsh8104/food-delivery-mern-stack/blob/main/backend/models/Order.js"
    click ModelContact "https://github.com/harsh8104/food-delivery-mern-stack/blob/main/backend/models/ContactUs.js"
    click AuthMiddleware "https://github.com/harsh8104/food-delivery-mern-stack/blob/main/backend/middlewares/Auth.js"
    click Uploads "https://github.com/harsh8104/food-delivery-mern-stack/tree/main/backend/uploads/"
    click MailUtil "https://github.com/harsh8104/food-delivery-mern-stack/blob/main/backend/util/MailsSender.js"

    %% Styles
    classDef frontend fill:#ADD8E6,stroke:#000,color:#000
    classDef server fill:#90EE90,stroke:#000,color:#000
    classDef persistence fill:#FFA500,stroke:#000,color:#000
    classDef external fill:#DDA0DD,stroke:#000,color:#000
    classDef code fill:#F0F8FF,stroke:#000,color:#000
```
