# jynxxor/food-del architecture

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

- Interactive diagram: https://gitdiagram.com/jynxxor/food-del
- Repository: https://github.com/jynxxor/food-del

## Overview

##### Project Type and Purpose
- This is a full-stack MERN (MongoDB, Express, React, Node.js) online food ordering platform.
- It comprises three main applications:
- frontend (customer-facing React app)
- admin (React dashboard for restaurant management)
- backend (Node/Express REST API with MongoDB)

##### File Structure
- Top-level directories:
- /frontend – customer React app (pages, components, context)
- /admin – admin React app (pages, components)
- /backend – Express server (routes, controllers, models, middleware, config)
- Patterns and frameworks:
- React component tree in both frontend and admin
- Express MVC pattern (routes → controllers → models)
- Mongoose ODM for MongoDB
- JWT auth middleware
- Stripe integration in backend
- Config & deployment:
- dotenv for environment variables (MongoDB URL, JWT_SECRET, STRIPE_SECRET_KEY)
- Vite for frontend build, npm scripts to start each service

##### Key Architectural Insights from README
- Separate “customer” and “admin” frontends talking via RESTful API
- Role-based access control (users vs. admins) enforced by JWT and middleware
- External services: MongoDB Atlas and Stripe payment API
- Future real-time enhancements (WebSockets) planned

a. Main Components
1. Customer Frontend (React App)
2. Admin Dashboard (React App)
3. Backend Server (Node.js + Express)
4. MongoDB Database (Atlas)
5. Stripe Payment Service
6. Authentication Service (JWT logic inside backend)
b. Relationships & Data Flows
- Customer/Admin UIs ←→ HTTP(S) REST API → MongoDB
- API → Stripe for payment processing
- UI sends credentials → API → returns JWT → UI stores in context/localStorage
- All CRUD operations (menu, cart, orders, users) flow through API controllers/models
c. Architectural Patterns & Principles
- MVC on backend: Routes → Controllers → Models
- Component-based architecture on frontends (React)
- Single SPA per app (separate frontend & admin apps)
- RESTful services, stateless JWT auth
d. Key Technologies & Libraries
- React (Vite), Context API for state (frontend)
- React (Vite) for admin dashboard
- Node.js, Express.js for API
- Mongoose for MongoDB models
- jsonwebtoken for JWT auth
- stripe SDK for payments

##### Detail
- Major endpoints: /food, /cart, /order, /user.
- Role checks in auth middleware between routes and controllers.

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "Frontend Layer"
        subgraph "Customer App"
            CApp["Customer React App"]:::frontend
            Context["StoreContext (Context)"]:::frontend
            CPages["Pages Directory"]:::frontend
            CComponents["Components Directory"]:::frontend
            ViteFront["Vite Config"]:::frontend
        end
        subgraph "Admin App"
            AApp["Admin React App"]:::frontend
            APages["Pages Directory"]:::frontend
            AComponents["Components Directory"]:::frontend
            ViteAdmin["Vite Config"]:::frontend
        end
    end

    subgraph "Backend Layer"
        subgraph "Express Server"
            Server["Server Entry Point"]:::backend
            ConfigDB["DB Config"]:::backend
            AuthMW["JWT Auth Middleware"]:::backend
            subgraph "Routes"
                FoodRoute["/food Route"]:::backend
                CartRoute["/cart Route"]:::backend
                OrderRoute["/order Route"]:::backend
                UserRoute["/user Route"]:::backend
            end
            subgraph "Controllers"
                FoodCtrl["Food Controller"]:::backend
                CartCtrl["Cart Controller"]:::backend
                OrderCtrl["Order Controller"]:::backend
                UserCtrl["User Controller"]:::backend
            end
            subgraph "Models"
                FoodModel["Food Model"]:::backend
                OrderModel["Order Model"]:::backend
                UserModel["User Model"]:::backend
            end
        end
    end

    subgraph "Data & External Services"
        MongoDB["MongoDB Atlas"]:::external
        Stripe["Stripe Service"]:::external
    end

    CApp -->|"HTTPS REST (JWT)"| Server
    AApp -->|"HTTPS REST (JWT)"| Server
    Server --> ConfigDB
    ConfigDB -->|"Mongoose"| MongoDB
    Server -->|"Stripe SDK"| Stripe
    Server --> AuthMW
    AuthMW --> FoodRoute
    AuthMW --> CartRoute
    AuthMW --> OrderRoute
    AuthMW --> UserRoute
    FoodRoute --> FoodCtrl
    CartRoute --> CartCtrl
    OrderRoute --> OrderCtrl
    UserRoute --> UserCtrl
    FoodCtrl --> FoodModel
    OrderCtrl --> OrderModel
    UserCtrl --> UserModel

    click CApp "https://github.com/jynxxor/food-del/tree/master/frontend/"
    click Context "https://github.com/jynxxor/food-del/blob/master/frontend/src/context/StoreContext.jsx"
    click CPages "https://github.com/jynxxor/food-del/tree/master/frontend/src/pages/"
    click CComponents "https://github.com/jynxxor/food-del/tree/master/frontend/src/components/"
    click ViteFront "https://github.com/jynxxor/food-del/blob/master/frontend/vite.config.js"
    click AApp "https://github.com/jynxxor/food-del/tree/master/admin/"
    click APages "https://github.com/jynxxor/food-del/tree/master/admin/src/pages/"
    click AComponents "https://github.com/jynxxor/food-del/tree/master/admin/src/components/"
    click ViteAdmin "https://github.com/jynxxor/food-del/blob/master/admin/vite.config.js"
    click Server "https://github.com/jynxxor/food-del/blob/master/backend/server.js"
    click ConfigDB "https://github.com/jynxxor/food-del/blob/master/backend/config/db.js"
    click AuthMW "https://github.com/jynxxor/food-del/blob/master/backend/middleware/auth.js"
    click FoodRoute "https://github.com/jynxxor/food-del/blob/master/backend/routes/foodRoute.js"
    click CartRoute "https://github.com/jynxxor/food-del/blob/master/backend/routes/cartRoute.js"
    click OrderRoute "https://github.com/jynxxor/food-del/blob/master/backend/routes/orderRoute.js"
    click UserRoute "https://github.com/jynxxor/food-del/blob/master/backend/routes/userRoute.js"
    click FoodCtrl "https://github.com/jynxxor/food-del/blob/master/backend/controllers/foodController.js"
    click CartCtrl "https://github.com/jynxxor/food-del/blob/master/backend/controllers/cartController.js"
    click OrderCtrl "https://github.com/jynxxor/food-del/blob/master/backend/controllers/orderController.js"
    click UserCtrl "https://github.com/jynxxor/food-del/blob/master/backend/controllers/userController.js"
    click FoodModel "https://github.com/jynxxor/food-del/blob/master/backend/models/foodModel.js"
    click OrderModel "https://github.com/jynxxor/food-del/blob/master/backend/models/orderModel.js"
    click UserModel "https://github.com/jynxxor/food-del/blob/master/backend/models/userModel.js"

    classDef frontend fill:#e0f7fa,stroke:#006064,color:#006064
    classDef backend fill:#e8f5e9,stroke:#1b5e20,color:#1b5e20
    classDef external fill:#eceff1,stroke:#607d8b,color:#37474f
```
