# rahmaaref/yallaorder architecture

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

- Interactive diagram: https://gitdiagram.com/rahmaaref/yallaorder
- Repository: https://github.com/rahmaaref/yallaorder

## Overview

YallaOrder is a Flask food-ordering platform with browser pages and JSON APIs. Customers browse restaurants and menus, manage a cart, and place individual or group orders; group orders associate items with participants for bill splitting. Restaurant operators manage menus and order status, while partner applications support restaurant onboarding. The graph includes the sampled API, routing, and SQLite layers. Some page-to-API wiring and unsampled route behavior are not shown, so uncertain connections are omitted.

Main entry points: [`front/Js/api.js`](https://github.com/rahmaaref/yallaorder/blob/main/front/Js/api.js) (Browser API), [`app.py`](https://github.com/rahmaaref/yallaorder/blob/main/app.py) (Flask App), [`database.py`](https://github.com/rahmaaref/yallaorder/blob/main/database.py) (SQLite Access), [`routes/restaurant_routes.py`](https://github.com/rahmaaref/yallaorder/blob/main/routes/restaurant_routes.py) (Restaurant Listings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Customer Web"]
  node_web["Ordering Pages"]
  node_api["Browser API<br/>[api.js]"]
  node_flask["Flask App<br/>[app.py]"]
end

subgraph group_catalog["Restaurant Catalog"]
  node_restaurants["Restaurant Listings"]
  node_menus["Menu Management<br/>[menu_routes.py]"]
  node_restaurant_menu["Approved Menu Search"]
end

subgraph group_orders["Ordering"]
  node_cart["Cart<br/>[cart_routes.py]"]
  node_orders_api["Individual Orders<br/>[order_routes.py]"]
  node_group_orders["Group Orders"]
  node_users["User Accounts<br/>[user_routes.py]"]
end

subgraph group_partners["Restaurant Operations"]
  node_partners["Partner Applications<br/>[partner_routes.py]"]
  node_restaurant_ops["Restaurant Order Ops"]
end

subgraph group_data["Persistence"]
  node_db_access["SQLite Access<br/>[database.py]"]
  node_sqlite[("Order Platform Data<br/>[yallaorder.db]")]
end

node_customer(("Customer"))

node_flask -->|"serves files"| node_web
node_flask -->|"registers"| node_users
node_flask -->|"registers"| node_restaurants
node_flask -->|"registers"| node_menus
node_flask -->|"registers"| node_orders_api
node_flask -->|"registers"| node_group_orders
node_flask -->|"registers"| node_partners
node_flask -->|"registers"| node_restaurant_ops
node_flask -->|"registers"| node_cart
node_api -->|"requests"| node_users
node_api -->|"requests"| node_restaurants
node_api -->|"requests"| node_menus
node_api -->|"requests"| node_orders_api
node_api -->|"requests"| node_group_orders
node_restaurants -->|"queries"| node_db_access
node_menus -->|"queries"| node_db_access
node_restaurant_menu -->|"queries"| node_db_access
node_orders_api -->|"queries"| node_db_access
node_group_orders -->|"queries"| node_db_access
node_users -->|"queries"| node_db_access
node_partners -->|"queries"| node_db_access
node_restaurant_ops -->|"queries"| node_db_access
node_cart -->|"reads and writes"| node_sqlite
node_db_access -->|"opens"| node_sqlite
node_customer -.->|"uses"| node_web
node_api -.->|"cart requests"| node_cart
node_api -.->|"menu search"| node_restaurant_menu
node_api -.->|"partner requests"| node_partners
node_api -.->|"operator requests"| node_restaurant_ops

click node_web "https://github.com/rahmaaref/yallaorder/tree/main/front"
click node_api "https://github.com/rahmaaref/yallaorder/blob/main/front/Js/api.js"
click node_flask "https://github.com/rahmaaref/yallaorder/blob/main/app.py"
click node_restaurants "https://github.com/rahmaaref/yallaorder/blob/main/routes/restaurant_routes.py"
click node_menus "https://github.com/rahmaaref/yallaorder/blob/main/routes/menu_routes.py"
click node_restaurant_menu "https://github.com/rahmaaref/yallaorder/blob/main/routes/restaurant_menu_routes.py"
click node_cart "https://github.com/rahmaaref/yallaorder/blob/main/routes/cart_routes.py"
click node_orders_api "https://github.com/rahmaaref/yallaorder/blob/main/routes/order_routes.py"
click node_group_orders "https://github.com/rahmaaref/yallaorder/blob/main/routes/group_order_routes.py"
click node_users "https://github.com/rahmaaref/yallaorder/blob/main/routes/user_routes.py"
click node_partners "https://github.com/rahmaaref/yallaorder/blob/main/routes/partner_routes.py"
click node_restaurant_ops "https://github.com/rahmaaref/yallaorder/blob/main/routes/restaurant_routes.py"
click node_db_access "https://github.com/rahmaaref/yallaorder/blob/main/database.py"
click node_sqlite "https://github.com/rahmaaref/yallaorder/blob/main/yallaorder.db"

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,node_api,node_flask toneBlue
class node_restaurants,node_menus,node_restaurant_menu toneAmber
class node_cart,node_orders_api,node_group_orders,node_users toneMint
class node_partners,node_restaurant_ops toneRose
class node_db_access,node_sqlite,node_customer toneIndigo
```

## Components

### Customer Web

- [Ordering Pages](https://github.com/rahmaaref/yallaorder/tree/main/front): `front`
- [Browser API](https://github.com/rahmaaref/yallaorder/blob/main/front/Js/api.js): `front/Js/api.js`
- [Flask App](https://github.com/rahmaaref/yallaorder/blob/main/app.py): `app.py`

### Restaurant Catalog

- [Restaurant Listings](https://github.com/rahmaaref/yallaorder/blob/main/routes/restaurant_routes.py): `routes/restaurant_routes.py`
- [Menu Management](https://github.com/rahmaaref/yallaorder/blob/main/routes/menu_routes.py): `routes/menu_routes.py`
- [Approved Menu Search](https://github.com/rahmaaref/yallaorder/blob/main/routes/restaurant_menu_routes.py): `routes/restaurant_menu_routes.py`

### Ordering

- [Cart](https://github.com/rahmaaref/yallaorder/blob/main/routes/cart_routes.py): `routes/cart_routes.py`
- [Individual Orders](https://github.com/rahmaaref/yallaorder/blob/main/routes/order_routes.py): `routes/order_routes.py`
- [Group Orders](https://github.com/rahmaaref/yallaorder/blob/main/routes/group_order_routes.py): `routes/group_order_routes.py`
- [User Accounts](https://github.com/rahmaaref/yallaorder/blob/main/routes/user_routes.py): `routes/user_routes.py`

### Restaurant Operations

- [Partner Applications](https://github.com/rahmaaref/yallaorder/blob/main/routes/partner_routes.py): `routes/partner_routes.py`
- [Restaurant Order Ops](https://github.com/rahmaaref/yallaorder/blob/main/routes/restaurant_routes.py): `routes/restaurant_routes.py`

### Persistence

- [SQLite Access](https://github.com/rahmaaref/yallaorder/blob/main/database.py): `database.py`
- [Order Platform Data](https://github.com/rahmaaref/yallaorder/blob/main/yallaorder.db): `yallaorder.db`

### Other components

- **Customer**

## Connections

- Flask App → Ordering Pages: serves files (evidence: `app.py`)
- Flask App → User Accounts: registers (evidence: `app.py`)
- Flask App → Restaurant Listings: registers (evidence: `app.py`)
- Flask App → Menu Management: registers (evidence: `app.py`)
- Flask App → Individual Orders: registers (evidence: `app.py`)
- Flask App → Group Orders: registers (evidence: `app.py`)
- Flask App → Partner Applications: registers (evidence: `app.py`)
- Flask App → Restaurant Order Ops: registers (evidence: `app.py`)
- Flask App → Cart: registers (evidence: `app.py`)
- Browser API → User Accounts: requests (evidence: `front/Js/api.js`)
- Browser API → Restaurant Listings: requests (evidence: `front/Js/api.js`)
- Browser API → Menu Management: requests (evidence: `front/Js/api.js`)
- Browser API → Individual Orders: requests (evidence: `front/Js/api.js`)
- Browser API → Group Orders: requests (evidence: `front/Js/api.js`)
- Restaurant Listings → SQLite Access: queries (evidence: `routes/restaurant_routes.py`)
- Menu Management → SQLite Access: queries (evidence: `routes/menu_routes.py`)
- Approved Menu Search → SQLite Access: queries (evidence: `routes/restaurant_menu_routes.py`)
- Individual Orders → SQLite Access: queries (evidence: `routes/order_routes.py`)
- Group Orders → SQLite Access: queries (evidence: `routes/group_order_routes.py`)
- User Accounts → SQLite Access: queries (evidence: `routes/user_routes.py`)
- Partner Applications → SQLite Access: queries (evidence: `routes/partner_routes.py`)
- Restaurant Order Ops → SQLite Access: queries (evidence: `routes/restaurant_routes.py`)
- Cart → Order Platform Data: reads and writes (evidence: `routes/cart_routes.py`)
- SQLite Access → Order Platform Data: opens (evidence: `database.py`)
- Customer → Ordering Pages: uses
- Browser API → Cart: cart requests
- Browser API → Approved Menu Search: menu search
- Browser API → Partner Applications: partner requests
- Browser API → Restaurant Order Ops: operator requests
