# bipulkumar62/fooddelivery-system architecture

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

- Interactive diagram: https://gitdiagram.com/bipulkumar62/fooddelivery-system
- Repository: https://github.com/bipulkumar62/fooddelivery-system

## Overview

This is a single-restaurant food-ordering and operations system. Customers browse the menu, request a delivery quote, and place Cash-on-Delivery orders; administrators manage orders, riders, menu availability, restaurant settings, and revenue. The backend is the only application runtime represented in detail by the supplied sources; the tree exposes an Android host entry point but not the Flutter client features. Several routes and services are unsampled, so those capabilities are retained where README evidence supports them, without asserting unshown call relationships.

Main entry points: [`backend/src/services/order.service.ts`](https://github.com/bipulkumar62/fooddelivery-system/blob/main/backend/src/services/order.service.ts) (Order workflow), [`backend/src/routes/admin.routes.ts`](https://github.com/bipulkumar62/fooddelivery-system/blob/main/backend/src/routes/admin.routes.ts) (Admin routes), [`backend/src/repositories/order.repository.ts`](https://github.com/bipulkumar62/fooddelivery-system/blob/main/backend/src/repositories/order.repository.ts) (Order and menu queries), [`backend/src/services/tracking.instance.ts`](https://github.com/bipulkumar62/fooddelivery-system/blob/main/backend/src/services/tracking.instance.ts) (Tracking service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API runtime"]
  node_api_app["HTTP API<br/>[app.ts]"]
  node_order_routes["Order routes<br/>[orders.routes.ts]"]
  node_admin_routes["Admin routes<br/>[admin.routes.ts]"]
end

subgraph group_orders["Ordering and delivery"]
  node_order_handlers["Order handlers"]
  node_order_logic["Order workflow<br/>[order.service.ts]"]
  node_delivery_calc["Delivery quotes"]
  node_order_repo["Order and menu queries"]
  node_order_store[("Orders<br/>[Order.ts]")]
end

subgraph group_operations["Restaurant operations"]
  node_menu_store[("Menu items<br/>[Menu.ts]")]
  node_admin_handlers["Admin handlers"]
  node_menu_logic["Menu management<br/>[menu.service.ts]"]
  node_settings_handlers["Settings handlers"]
  node_settings_logic["Restaurant settings"]
  node_revenue_handlers["Revenue reporting"]
  node_auth_logic["Admin and rider login<br/>[auth.service.ts]"]
end

subgraph group_tracking["Live tracking"]
  node_tracking_handlers["Tracking handlers"]
  node_tracking_runtime["Tracking service"]
  node_tracking_events["Tracking events<br/>[trackingEvents.ts]"]
  node_socket_server["Socket server<br/>[server.ts]"]
end

node_customer(("Customer"))
node_admin(("Administrator"))
node_rider(("Rider"))
node_mongo[("MongoDB")]
node_maps["Google Maps"]

node_customer -.->|"uses"| node_api_app
node_admin -->|"manages"| node_admin_routes
node_rider -.->|"sends locations"| node_socket_server
node_api_app -->|"mounts routes"| node_order_routes
node_order_routes -->|"routes requests"| node_order_handlers
node_order_handlers -->|"calls"| node_order_logic
node_order_logic -->|"calculates distance"| node_delivery_calc
node_order_logic -->|"reads and writes"| node_order_repo
node_order_repo -->|"queries"| node_order_store
node_order_repo -->|"queries"| node_menu_store
node_order_logic -->|"checks settings"| node_settings_logic
node_admin_routes -->|"routes requests"| node_admin_handlers
node_admin_handlers -->|"manages orders"| node_order_logic
node_admin_handlers -->|"manages menu"| node_menu_logic
node_menu_logic -->|"reads and writes"| node_menu_store
node_admin_routes -->|"routes requests"| node_settings_handlers
node_settings_handlers -->|"calls"| node_settings_logic
node_settings_logic -.->|"persists settings"| node_mongo
node_admin_routes -->|"routes requests"| node_revenue_handlers
node_admin -.->|"authenticates"| node_auth_logic
node_order_logic -->|"uses tracking"| node_tracking_runtime
node_tracking_handlers -->|"uses"| node_tracking_runtime
node_socket_server -->|"requests snapshots"| node_tracking_runtime
node_tracking_runtime -->|"uses events"| node_tracking_events
node_socket_server -->|"verifies order"| node_order_repo
node_admin -.->|"opens coordinates"| node_maps

click node_api_app "https://github.com/bipulkumar62/fooddelivery-system/blob/main/backend/src/app.ts"
click node_order_routes "https://github.com/bipulkumar62/fooddelivery-system/blob/main/backend/src/routes/orders.routes.ts"
click node_admin_routes "https://github.com/bipulkumar62/fooddelivery-system/blob/main/backend/src/routes/admin.routes.ts"
click node_order_handlers "https://github.com/bipulkumar62/fooddelivery-system/blob/main/backend/src/controllers/orders.controller.ts"
click node_order_logic "https://github.com/bipulkumar62/fooddelivery-system/blob/main/backend/src/services/order.service.ts"
click node_delivery_calc "https://github.com/bipulkumar62/fooddelivery-system/blob/main/backend/src/utils/deliveryCalculator.ts"
click node_order_repo "https://github.com/bipulkumar62/fooddelivery-system/blob/main/backend/src/repositories/order.repository.ts"
click node_order_store "https://github.com/bipulkumar62/fooddelivery-system/blob/main/backend/src/models/Order.ts"
click node_menu_store "https://github.com/bipulkumar62/fooddelivery-system/blob/main/backend/src/models/Menu.ts"
click node_admin_handlers "https://github.com/bipulkumar62/fooddelivery-system/blob/main/backend/src/controllers/admin.controller.ts"
click node_menu_logic "https://github.com/bipulkumar62/fooddelivery-system/blob/main/backend/src/services/menu.service.ts"
click node_settings_handlers "https://github.com/bipulkumar62/fooddelivery-system/blob/main/backend/src/controllers/restaurantSettings.controller.ts"
click node_settings_logic "https://github.com/bipulkumar62/fooddelivery-system/blob/main/backend/src/services/restaurantSettings.service.ts"
click node_revenue_handlers "https://github.com/bipulkumar62/fooddelivery-system/blob/main/backend/src/controllers/revenue.controller.ts"
click node_auth_logic "https://github.com/bipulkumar62/fooddelivery-system/blob/main/backend/src/services/auth.service.ts"
click node_tracking_handlers "https://github.com/bipulkumar62/fooddelivery-system/blob/main/backend/src/controllers/tracking.controller.ts"
click node_tracking_runtime "https://github.com/bipulkumar62/fooddelivery-system/blob/main/backend/src/services/tracking.instance.ts"
click node_tracking_events "https://github.com/bipulkumar62/fooddelivery-system/blob/main/backend/src/services/trackingEvents.ts"
click node_socket_server "https://github.com/bipulkumar62/fooddelivery-system/blob/main/backend/src/server.ts"

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_api_app,node_order_routes,node_admin_routes toneBlue
class node_order_handlers,node_order_logic,node_delivery_calc,node_order_repo,node_order_store,node_mongo toneAmber
class node_menu_store,node_admin_handlers,node_menu_logic,node_settings_handlers,node_settings_logic,node_revenue_handlers,node_auth_logic toneMint
class node_tracking_handlers,node_tracking_runtime,node_tracking_events,node_socket_server toneRose
class node_customer,node_admin,node_rider,node_maps toneIndigo
```

## Components

### API runtime

- [HTTP API](https://github.com/bipulkumar62/fooddelivery-system/blob/main/backend/src/app.ts): `backend/src/app.ts`
- [Order routes](https://github.com/bipulkumar62/fooddelivery-system/blob/main/backend/src/routes/orders.routes.ts): `backend/src/routes/orders.routes.ts`
- [Admin routes](https://github.com/bipulkumar62/fooddelivery-system/blob/main/backend/src/routes/admin.routes.ts): `backend/src/routes/admin.routes.ts`

### Ordering and delivery

- [Order handlers](https://github.com/bipulkumar62/fooddelivery-system/blob/main/backend/src/controllers/orders.controller.ts): `backend/src/controllers/orders.controller.ts`
- [Order workflow](https://github.com/bipulkumar62/fooddelivery-system/blob/main/backend/src/services/order.service.ts): `backend/src/services/order.service.ts`
- [Delivery quotes](https://github.com/bipulkumar62/fooddelivery-system/blob/main/backend/src/utils/deliveryCalculator.ts): `backend/src/utils/deliveryCalculator.ts`
- [Order and menu queries](https://github.com/bipulkumar62/fooddelivery-system/blob/main/backend/src/repositories/order.repository.ts): `backend/src/repositories/order.repository.ts`
- [Orders](https://github.com/bipulkumar62/fooddelivery-system/blob/main/backend/src/models/Order.ts): `backend/src/models/Order.ts`

### Restaurant operations

- [Menu items](https://github.com/bipulkumar62/fooddelivery-system/blob/main/backend/src/models/Menu.ts): `backend/src/models/Menu.ts`
- [Admin handlers](https://github.com/bipulkumar62/fooddelivery-system/blob/main/backend/src/controllers/admin.controller.ts): `backend/src/controllers/admin.controller.ts`
- [Menu management](https://github.com/bipulkumar62/fooddelivery-system/blob/main/backend/src/services/menu.service.ts): `backend/src/services/menu.service.ts`
- [Settings handlers](https://github.com/bipulkumar62/fooddelivery-system/blob/main/backend/src/controllers/restaurantSettings.controller.ts): `backend/src/controllers/restaurantSettings.controller.ts`
- [Restaurant settings](https://github.com/bipulkumar62/fooddelivery-system/blob/main/backend/src/services/restaurantSettings.service.ts): `backend/src/services/restaurantSettings.service.ts`
- [Revenue reporting](https://github.com/bipulkumar62/fooddelivery-system/blob/main/backend/src/controllers/revenue.controller.ts): `backend/src/controllers/revenue.controller.ts`
- [Admin and rider login](https://github.com/bipulkumar62/fooddelivery-system/blob/main/backend/src/services/auth.service.ts): `backend/src/services/auth.service.ts`

### Live tracking

- [Tracking handlers](https://github.com/bipulkumar62/fooddelivery-system/blob/main/backend/src/controllers/tracking.controller.ts): `backend/src/controllers/tracking.controller.ts`
- [Tracking service](https://github.com/bipulkumar62/fooddelivery-system/blob/main/backend/src/services/tracking.instance.ts): `backend/src/services/tracking.instance.ts`
- [Tracking events](https://github.com/bipulkumar62/fooddelivery-system/blob/main/backend/src/services/trackingEvents.ts): `backend/src/services/trackingEvents.ts`
- [Socket server](https://github.com/bipulkumar62/fooddelivery-system/blob/main/backend/src/server.ts): `backend/src/server.ts`

### Other components

- **Customer**
- **Administrator**
- **Rider**
- **MongoDB**
- **Google Maps**

## Connections

- Customer → HTTP API: uses
- Administrator → Admin routes: manages (evidence: `backend/src/routes/admin.routes.ts`)
- Rider → Socket server: sends locations
- HTTP API → Order routes: mounts routes (evidence: `backend/src/app.ts`)
- Order routes → Order handlers: routes requests (evidence: `backend/src/routes/orders.routes.ts`)
- Order handlers → Order workflow: calls (evidence: `backend/src/controllers/orders.controller.ts`)
- Order workflow → Delivery quotes: calculates distance (evidence: `backend/src/services/order.service.ts`)
- Order workflow → Order and menu queries: reads and writes (evidence: `backend/src/services/order.service.ts`)
- Order and menu queries → Orders: queries (evidence: `backend/src/repositories/order.repository.ts`)
- Order and menu queries → Menu items: queries (evidence: `backend/src/repositories/order.repository.ts`)
- Order workflow → Restaurant settings: checks settings (evidence: `backend/src/services/order.service.ts`)
- Admin routes → Admin handlers: routes requests (evidence: `backend/src/routes/admin.routes.ts`)
- Admin handlers → Order workflow: manages orders (evidence: `backend/src/controllers/admin.controller.ts`)
- Admin handlers → Menu management: manages menu (evidence: `backend/src/controllers/admin.controller.ts`)
- Menu management → Menu items: reads and writes (evidence: `backend/src/services/menu.service.ts`)
- Admin routes → Settings handlers: routes requests (evidence: `backend/src/routes/admin.routes.ts`)
- Settings handlers → Restaurant settings: calls (evidence: `backend/src/controllers/restaurantSettings.controller.ts`)
- Restaurant settings → MongoDB: persists settings
- Admin routes → Revenue reporting: routes requests (evidence: `backend/src/routes/admin.routes.ts`)
- Administrator → Admin and rider login: authenticates
- Order workflow → Tracking service: uses tracking (evidence: `backend/src/services/order.service.ts`)
- Tracking handlers → Tracking service: uses (evidence: `backend/src/controllers/tracking.controller.ts`)
- Socket server → Tracking service: requests snapshots (evidence: `backend/src/server.ts`)
- Tracking service → Tracking events: uses events (evidence: `backend/src/services/tracking.instance.ts`)
- Socket server → Order and menu queries: verifies order (evidence: `backend/src/server.ts`)
- Administrator → Google Maps: opens coordinates
