# vichea-collab/food-delivery-app architecture

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

- Interactive diagram: https://gitdiagram.com/vichea-collab/food-delivery-app
- Repository: https://github.com/vichea-collab/food-delivery-app

## Overview

##### Project type and purpose
- This is a full-stack MERN (MongoDB, Express.js, React, Node.js) food-delivery application called QuickEats with three separately deployed frontends (User Panel, Admin Panel, and API server) and one database.

##### File structure
- Top-level folders:
– backend: Express.js REST API, controllers, routes, models, middleware, uploads, configuration.
– frontend: React/Vite user-facing site (browsing menu, cart, orders, payments).
– admin: React/Vite admin dashboard (product CRUD, order management).
- Patterns: MVC on the server (models/controllers/routes), Context API on clients for state, JWT auth middleware, Stripe integration, Multer file uploads.

##### README for additional insights
- Authentication: JWT + Bcrypt + RBAC
- Payments: Stripe
- File Upload: Multer
- Deployment: Render, MongoDB Atlas
- Environment variables define URLs connecting frontends ↔ backend

##### Main components & their interactions
a. Components
– User Frontend (React App)
– Admin Frontend (React App)
– Backend API (Node.js + Express)
- Route layer (cartRoute, foodRoute, orderRoute, userRoute)
- Controller layer (cartController, foodController, orderController, userController)
- Model layer (MongoDB schemas via Mongoose)
- Auth middleware (JWT, RBAC)
- File upload (Multer)
- Hashing utility (bcrypt)
– Database (MongoDB Atlas)
– External services: Stripe API, optional email service (if implemented)
b. Relationships
– Both frontends send HTTP requests (REST) to the Backend API over HTTPS.
– Backend uses Mongoose to read/write MongoDB.
– Backend calls Stripe for payment processing.
– Backend stores uploaded images via Multer (local/uploads or cloud).
– Backend issues JWTs on login; clients store token and include in Authorization header.
c. Architectural patterns & principles
– Separation of concerns: UI vs API vs data store
– MVC pattern on server side
– Context API for state management on clients
– Token-based authentication and role-based access control
– Middleware pipeline in Express
d. Key technologies
– React + Vite for fast client build (admin + user)
– Node.js + Express for API
– MongoDB + Mongoose for persistence
– JWT, Bcrypt, RBAC for security
– Stripe for payments
– Multer for image uploads

##### Detailed capture of essential architecture
- Middleware layer intercepting requests (auth, Multer).
- Environment variables connecting clients ↔ backend base URL.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Clients
    subgraph "Clients"
        direction TB
        UserFE["User Frontend\n(React/Vite, Context API)"]:::frontend
        AdminFE["Admin Frontend\n(React/Vite, Context API)"]:::frontend
    end

    %% Backend API
    subgraph "Backend API\n(Node.js, Express)"
        direction TB
        ServerEntry["server.js"]:::backendEntry
        DBConfig["db.js"]:::backendConfig
        Env[".env & .env.example"]:::backendConfig
        Seeder["seedAdmin.js"]:::backendConfig

        subgraph "Routes"
            direction TB
            FoodRoute["Food Routes"]:::backend
            OrderRoute["Order Routes"]:::backend
            CartRoute["Cart Routes"]:::backend
            UserRoute["User Routes"]:::backend
        end

        subgraph "Controllers"
            direction TB
            FoodCtrl["Food Controller"]:::backend
            OrderCtrl["Order Controller"]:::backend
            CartCtrl["Cart Controller"]:::backend
            UserCtrl["User Controller"]:::backend
        end

        subgraph "Models"
            direction TB
            FoodModel["Food Model"]:::backend
            OrderModel["Order Model"]:::backend
            UserModel["User Model"]:::backend
        end

        subgraph "Middleware & Utils"
            direction TB
            AuthMw["Auth Middleware\n(JWT, RBAC)"]:::backend
            HashUtil["Password Hashing Utility\n(Bcrypt)"]:::backend
            FileUpload["File Uploads\n(Multer)"]:::backend
        end
    end

    %% External Systems
    Mongo["MongoDB Atlas"]:::database
    Stripe["Stripe API"]:::external
    UploadsDir["uploads\n(Local Storage)"]:::backend

    %% Connections
    UserFE -->|"HTTP REST\n(GET /foods,\nPOST /orders,\nAuthorization)"| ServerEntry
    AdminFE -->|"HTTP REST\n(CRUD,\nOrder Mgmt,\nAuthorization)"| ServerEntry

    ServerEntry --> AuthMw
    ServerEntry --> FileUpload
    ServerEntry --> DBConfig
    ServerEntry --> Seeder

    DBConfig --> Mongo

    FoodRoute --> FoodCtrl
    OrderRoute --> OrderCtrl
    CartRoute --> CartCtrl
    UserRoute --> UserCtrl

    FoodCtrl --> FoodModel
    OrderCtrl --> OrderModel
    CartCtrl --> FoodModel
    CartCtrl --> OrderModel
    UserCtrl --> UserModel

    AuthMw --> UserModel
    HashUtil --> UserCtrl
    FileUpload --> UploadsDir
    OrderCtrl --> Stripe

    %% Click Events
    click UserFE "https://github.com/vichea-collab/food-delivery-app/tree/main/frontend/src"
    click AdminFE "https://github.com/vichea-collab/food-delivery-app/tree/main/admin/src"
    click ServerEntry "https://github.com/vichea-collab/food-delivery-app/blob/main/backend/server.js"
    click DBConfig "https://github.com/vichea-collab/food-delivery-app/blob/main/backend/config/db.js"
    click Env "https://github.com/vichea-collab/food-delivery-app/blob/main/backend/.env.example"
    click Seeder "https://github.com/vichea-collab/food-delivery-app/blob/main/backend/seedAdmin.js"
    click FoodRoute "https://github.com/vichea-collab/food-delivery-app/blob/main/backend/routes/foodRoute.js"
    click OrderRoute "https://github.com/vichea-collab/food-delivery-app/blob/main/backend/routes/orderRoute.js"
    click CartRoute "https://github.com/vichea-collab/food-delivery-app/blob/main/backend/routes/cartRoute.js"
    click UserRoute "https://github.com/vichea-collab/food-delivery-app/blob/main/backend/routes/userRoute.js"
    click FoodCtrl "https://github.com/vichea-collab/food-delivery-app/blob/main/backend/controllers/foodController.js"
    click OrderCtrl "https://github.com/vichea-collab/food-delivery-app/blob/main/backend/controllers/orderController.js"
    click CartCtrl "https://github.com/vichea-collab/food-delivery-app/blob/main/backend/controllers/cartController.js"
    click UserCtrl "https://github.com/vichea-collab/food-delivery-app/blob/main/backend/controllers/userController.js"
    click FoodModel "https://github.com/vichea-collab/food-delivery-app/blob/main/backend/models/foodModel.js"
    click OrderModel "https://github.com/vichea-collab/food-delivery-app/blob/main/backend/models/orderModel.js"
    click UserModel "https://github.com/vichea-collab/food-delivery-app/blob/main/backend/models/userModel.js"
    click AuthMw "https://github.com/vichea-collab/food-delivery-app/blob/main/backend/middleware/auth.js"
    click HashUtil "https://github.com/vichea-collab/food-delivery-app/blob/main/backend/hash.js"
    click FileUpload "https://github.com/vichea-collab/food-delivery-app/tree/main/backend/uploads"

    %% Styles
    classDef frontend fill:#D0E8FF,stroke:#0366D6;
    classDef backend fill:#E6F4EA,stroke:#22863A;
    classDef backendEntry fill:#E6F4EA,stroke:#22863A;
    classDef backendConfig fill:#E6F4EA,stroke:#22863A;
    classDef database fill:#FFF5D1,stroke:#DBAB09;
    classDef external fill:#FBEAFF,stroke:#A626A4;
```
