# vaibhav-1786/food_delivery architecture

> Architecture diagram of the GitHub repository vaibhav-1786/food_delivery, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vaibhav-1786/food_delivery
- Repository: https://github.com/vaibhav-1786/food_delivery

## Overview

Quickbite is a three-portal food-delivery platform: customers discover food, build carts, check out, and track orders; restaurants manage menus and fulfillment; admins oversee platform operations. The React app calls a Flask API, whose domain routes use business services and SQLAlchemy models. The README documents a broad set of additional capabilities, represented here as domain subsystems where individual implementations were not sampled. Edges are limited to relationships shown in excerpts, the source index, or README; unverified integrations and unsampled call paths are omitted.

Main entry points: [`backend/app.py`](https://github.com/vaibhav-1786/food_delivery/blob/main/backend/app.py) (Flask application), [`backend/models/models.py`](https://github.com/vaibhav-1786/food_delivery/blob/main/backend/models/models.py) (Domain records), [`backend/services`](https://github.com/vaibhav-1786/food_delivery/tree/main/backend/services) (Domain services), [`backend/routes/order_routes.py`](https://github.com/vaibhav-1786/food_delivery/blob/main/backend/routes/order_routes.py) (Checkout and orders)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web portals"]
  node_web_app["Portal pages"]
  node_web_contexts["Session contexts"]
  node_web_router["Route composition<br/>[App.jsx]"]
end

subgraph group_api["API and access"]
  node_api_client["API endpoints<br/>[endpoints.js]"]
  node_api_server["Flask application<br/>[app.py]"]
  node_auth_routes["Authentication<br/>[auth_routes.py]"]
  node_access_control["Role and permissions<br/>[auth_middleware.py]"]
end

subgraph group_commerce["Ordering"]
  node_food_routes["Food discovery<br/>[food_routes.py]"]
  node_cart_routes["Cart<br/>[cart_routes.py]"]
  node_order_routes["Checkout and orders<br/>[order_routes.py]"]
  node_pricing["Deal pricing<br/>[pricing_service.py]"]
  node_payments["Payments<br/>[payment_routes.py]"]
  node_restaurant_ops["Restaurant operations"]
end

subgraph group_engagement["Customer features"]
  node_customer_features["Customer programs"]
  node_group_orders["Group ordering"]
end

subgraph group_platform["Platform operations"]
  node_admin_features["Admin operations"]
  node_business_services["Domain services"]
  node_data_models[("Domain records<br/>[models.py]")]
end

node_customer(("Customer"))
node_restaurant_user(("Restaurant user"))
node_admin_user(("Admin"))
node_mysql[("MySQL")]
node_razorpay["Razorpay"]
node_ai_provider["OpenRouter AI"]

node_customer -->|"uses"| node_web_app
node_restaurant_user -->|"uses"| node_web_app
node_admin_user -->|"uses"| node_web_app
node_web_app -->|"routes through"| node_web_router
node_web_router -->|"provides contexts"| node_web_contexts
node_web_app -.->|"requests endpoints"| node_api_client
node_api_client -.->|"HTTP requests"| node_api_server
node_api_server -->|"registers"| node_auth_routes
node_api_server -->|"registers"| node_food_routes
node_api_server -->|"registers"| node_cart_routes
node_api_server -->|"registers"| node_order_routes
node_api_server -->|"registers"| node_payments
node_api_server -->|"registers"| node_restaurant_ops
node_auth_routes -.->|"enforces access"| node_access_control
node_food_routes -->|"queries"| node_data_models
node_food_routes -->|"gets prices"| node_pricing
node_cart_routes -.->|"uses records"| node_data_models
node_order_routes -->|"creates orders"| node_data_models
node_order_routes -->|"calculates prices"| node_pricing
node_order_routes -->|"uses domain logic"| node_business_services
node_order_routes -.->|"starts payment"| node_payments
node_payments -.->|"verifies payment"| node_razorpay
node_restaurant_ops -->|"uses records"| node_data_models
node_restaurant_ops -->|"uses domain logic"| node_business_services
node_group_orders -->|"creates orders"| node_data_models
node_group_orders -->|"uses services"| node_business_services
node_customer_features -.->|"domain capabilities"| node_business_services
node_admin_features -.->|"domain capabilities"| node_business_services
node_business_services -.->|"persists domain data"| node_data_models
node_data_models -.->|"stored in"| node_mysql
node_api_server -.->|"AI integration"| node_ai_provider

click node_web_app "https://github.com/vaibhav-1786/food_delivery/tree/main/frontend/src/pages"
click node_web_contexts "https://github.com/vaibhav-1786/food_delivery/tree/main/frontend/src/hooks"
click node_web_router "https://github.com/vaibhav-1786/food_delivery/blob/main/frontend/src/App.jsx"
click node_api_client "https://github.com/vaibhav-1786/food_delivery/blob/main/frontend/src/services/endpoints.js"
click node_api_server "https://github.com/vaibhav-1786/food_delivery/blob/main/backend/app.py"
click node_auth_routes "https://github.com/vaibhav-1786/food_delivery/blob/main/backend/routes/auth_routes.py"
click node_access_control "https://github.com/vaibhav-1786/food_delivery/blob/main/backend/middleware/auth_middleware.py"
click node_food_routes "https://github.com/vaibhav-1786/food_delivery/blob/main/backend/routes/food_routes.py"
click node_cart_routes "https://github.com/vaibhav-1786/food_delivery/blob/main/backend/routes/cart_routes.py"
click node_order_routes "https://github.com/vaibhav-1786/food_delivery/blob/main/backend/routes/order_routes.py"
click node_pricing "https://github.com/vaibhav-1786/food_delivery/blob/main/backend/services/pricing_service.py"
click node_payments "https://github.com/vaibhav-1786/food_delivery/blob/main/backend/routes/payment_routes.py"
click node_restaurant_ops "https://github.com/vaibhav-1786/food_delivery/blob/main/backend/routes/restaurant_routes.py"
click node_customer_features "https://github.com/vaibhav-1786/food_delivery/tree/main/backend/routes"
click node_group_orders "https://github.com/vaibhav-1786/food_delivery/blob/main/backend/routes/group_order_routes.py"
click node_admin_features "https://github.com/vaibhav-1786/food_delivery/tree/main/backend/routes"
click node_business_services "https://github.com/vaibhav-1786/food_delivery/tree/main/backend/services"
click node_data_models "https://github.com/vaibhav-1786/food_delivery/blob/main/backend/models/models.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_web_app,node_web_contexts,node_web_router,node_restaurant_user toneBlue
class node_api_client,node_api_server,node_auth_routes,node_access_control,node_mysql toneAmber
class node_food_routes,node_cart_routes,node_order_routes,node_pricing,node_payments,node_restaurant_ops,node_ai_provider toneMint
class node_customer_features,node_group_orders toneRose
class node_admin_features,node_business_services,node_data_models,node_customer,node_admin_user,node_razorpay toneIndigo
```

## Components

### Web portals

- [Portal pages](https://github.com/vaibhav-1786/food_delivery/tree/main/frontend/src/pages): `frontend/src/pages`
- [Session contexts](https://github.com/vaibhav-1786/food_delivery/tree/main/frontend/src/hooks): `frontend/src/hooks`
- [Route composition](https://github.com/vaibhav-1786/food_delivery/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`

### API and access

- [API endpoints](https://github.com/vaibhav-1786/food_delivery/blob/main/frontend/src/services/endpoints.js): `frontend/src/services/endpoints.js`
- [Flask application](https://github.com/vaibhav-1786/food_delivery/blob/main/backend/app.py): `backend/app.py`
- [Authentication](https://github.com/vaibhav-1786/food_delivery/blob/main/backend/routes/auth_routes.py): `backend/routes/auth_routes.py`
- [Role and permissions](https://github.com/vaibhav-1786/food_delivery/blob/main/backend/middleware/auth_middleware.py): `backend/middleware/auth_middleware.py`

### Ordering

- [Food discovery](https://github.com/vaibhav-1786/food_delivery/blob/main/backend/routes/food_routes.py): `backend/routes/food_routes.py`
- [Cart](https://github.com/vaibhav-1786/food_delivery/blob/main/backend/routes/cart_routes.py): `backend/routes/cart_routes.py`
- [Checkout and orders](https://github.com/vaibhav-1786/food_delivery/blob/main/backend/routes/order_routes.py): `backend/routes/order_routes.py`
- [Deal pricing](https://github.com/vaibhav-1786/food_delivery/blob/main/backend/services/pricing_service.py): `backend/services/pricing_service.py`
- [Payments](https://github.com/vaibhav-1786/food_delivery/blob/main/backend/routes/payment_routes.py): `backend/routes/payment_routes.py`
- [Restaurant operations](https://github.com/vaibhav-1786/food_delivery/blob/main/backend/routes/restaurant_routes.py): `backend/routes/restaurant_routes.py`

### Customer features

- [Customer programs](https://github.com/vaibhav-1786/food_delivery/tree/main/backend/routes): `backend/routes`
- [Group ordering](https://github.com/vaibhav-1786/food_delivery/blob/main/backend/routes/group_order_routes.py): `backend/routes/group_order_routes.py`

### Platform operations

- [Admin operations](https://github.com/vaibhav-1786/food_delivery/tree/main/backend/routes): `backend/routes`
- [Domain services](https://github.com/vaibhav-1786/food_delivery/tree/main/backend/services): `backend/services`
- [Domain records](https://github.com/vaibhav-1786/food_delivery/blob/main/backend/models/models.py): `backend/models/models.py`

### Other components

- **Customer**
- **Restaurant user**
- **Admin**
- **MySQL**
- **Razorpay**
- **OpenRouter AI**

## Connections

- Customer → Portal pages: uses (evidence: `README.md`)
- Restaurant user → Portal pages: uses (evidence: `README.md`)
- Admin → Portal pages: uses (evidence: `README.md`)
- Portal pages → Route composition: routes through (evidence: `frontend/src/App.jsx`)
- Route composition → Session contexts: provides contexts (evidence: `frontend/src/App.jsx`)
- Portal pages → API endpoints: requests endpoints (evidence: `frontend/src/pages/admin/AdminAuthority.jsx`)
- API endpoints → Flask application: HTTP requests
- Flask application → Authentication: registers (evidence: `backend/app.py`)
- Flask application → Food discovery: registers (evidence: `backend/app.py`)
- Flask application → Cart: registers (evidence: `backend/app.py`)
- Flask application → Checkout and orders: registers (evidence: `backend/app.py`)
- Flask application → Payments: registers (evidence: `backend/app.py`)
- Flask application → Restaurant operations: registers (evidence: `backend/app.py`)
- Authentication → Role and permissions: enforces access
- Food discovery → Domain records: queries (evidence: `backend/routes/food_routes.py`)
- Food discovery → Deal pricing: gets prices (evidence: `backend/routes/food_routes.py`)
- Cart → Domain records: uses records
- Checkout and orders → Domain records: creates orders (evidence: `backend/routes/order_routes.py`)
- Checkout and orders → Deal pricing: calculates prices (evidence: `backend/routes/order_routes.py`)
- Checkout and orders → Domain services: uses domain logic (evidence: `backend/routes/order_routes.py`)
- Checkout and orders → Payments: starts payment
- Payments → Razorpay: verifies payment (evidence: `README.md`)
- Restaurant operations → Domain records: uses records (evidence: `backend/routes/restaurant_routes.py`)
- Restaurant operations → Domain services: uses domain logic (evidence: `backend/routes/restaurant_routes.py`)
- Group ordering → Domain records: creates orders (evidence: `backend/routes/group_order_routes.py`)
- Group ordering → Domain services: uses services (evidence: `backend/routes/group_order_routes.py`)
- Customer programs → Domain services: domain capabilities (evidence: `README.md`)
- Admin operations → Domain services: domain capabilities (evidence: `README.md`)
- Domain services → Domain records: persists domain data (evidence: `backend/services/review_service.py`)
- Domain records → MySQL: stored in (evidence: `README.md`)
- Flask application → OpenRouter AI: AI integration (evidence: `README.md`)
