# omkar-pix09/canteenorder architecture

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

- Interactive diagram: https://gitdiagram.com/omkar-pix09/canteenorder
- Repository: https://github.com/omkar-pix09/canteenorder

## Overview

CanteenOrder is a college canteen pre-order application: diners browse a menu, manage a cart and place orders; staff process orders in a kitchen view and users receive status updates. The Flask app also covers accounts, wallet and points, ratings, subscriptions, group carts, recommendations, and administration. A separate Java HTTP service provides report, token, and subscription endpoints. The README is empty and templates were not sampled, so those UI relationships and any Flask-to-Java integration are not asserted.

Main entry points: [`CanteenOrder/CanteenOrder/app.py`](https://github.com/omkar-pix09/canteenorder/blob/main/CanteenOrder/CanteenOrder/app.py) (Flask routes), [`CanteenOrder/CanteenOrder/java/src/main/java/com/canteen/CanteenReportService.java`](https://github.com/omkar-pix09/canteenorder/blob/main/CanteenOrder/CanteenOrder/java/src/main/java/com/canteen/CanteenReportService.java) (Java HTTP service), [`CanteenOrder/CanteenOrder/templates`](https://github.com/omkar-pix09/canteenorder/tree/main/CanteenOrder/CanteenOrder/templates) (Ordering pages), [`CanteenOrder/CanteenOrder/static/js/utils.js`](https://github.com/omkar-pix09/canteenorder/blob/main/CanteenOrder/CanteenOrder/static/js/utils.js) (Cart and API utilities)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Ordering application"]
  node_flask["Flask routes<br/>[app.py]"]
  node_menu["Menu and suggestions<br/>[app.py]"]
  node_orders["Order lifecycle<br/>[app.py]"]
  node_accounts["Accounts and wallet<br/>[app.py]"]
  node_engagement["Ratings and group carts<br/>[app.py]"]
  node_subscriptions["Tiffin subscriptions<br/>[app.py]"]
  node_state["In-memory application state<br/>[app.py]"]
  node_realtime["Socket.IO updates<br/>[app.py]"]
end

subgraph group_service["Reporting service"]
  node_java["Java HTTP service"]
  node_report["Sales reports"]
  node_tokens["Token generation"]
  node_java_sub["Java subscriptions"]
end

subgraph group_client["Browser experience"]
  node_browser["Ordering pages"]
  node_cartutil["Cart and API utilities<br/>[utils.js]"]
end

node_diner(("Diner"))
node_staff(("Kitchen staff"))
node_webuser(("Web user"))
node_ops(("Service caller"))

node_diner -.->|"uses"| node_browser
node_browser -.->|"requests routes"| node_flask
node_cartutil -.->|"fetches API"| node_flask
node_flask -->|"serves menu"| node_menu
node_flask -->|"handles orders"| node_orders
node_flask -->|"handles account APIs"| node_accounts
node_flask -->|"handles engagement APIs"| node_engagement
node_flask -->|"creates subscriptions"| node_subscriptions
node_menu -->|"reads menu and history"| node_state
node_orders -->|"updates order data"| node_state
node_accounts -->|"updates user data"| node_state
node_engagement -->|"stores group carts"| node_state
node_subscriptions -->|"stores subscriptions"| node_state
node_orders -->|"emits order updates"| node_realtime
node_realtime -->|"notifies kitchen"| node_staff
node_realtime -->|"broadcasts status"| node_diner
node_webuser -.->|"calls HTTP service"| node_java
node_ops -.->|"calls HTTP service"| node_java
node_java -->|"routes report requests"| node_report
node_java -->|"routes token requests"| node_tokens
node_java -->|"routes subscribe requests"| node_java_sub

click node_flask "https://github.com/omkar-pix09/canteenorder/blob/main/CanteenOrder/CanteenOrder/app.py"
click node_menu "https://github.com/omkar-pix09/canteenorder/blob/main/CanteenOrder/CanteenOrder/app.py"
click node_orders "https://github.com/omkar-pix09/canteenorder/blob/main/CanteenOrder/CanteenOrder/app.py"
click node_accounts "https://github.com/omkar-pix09/canteenorder/blob/main/CanteenOrder/CanteenOrder/app.py"
click node_engagement "https://github.com/omkar-pix09/canteenorder/blob/main/CanteenOrder/CanteenOrder/app.py"
click node_subscriptions "https://github.com/omkar-pix09/canteenorder/blob/main/CanteenOrder/CanteenOrder/app.py"
click node_state "https://github.com/omkar-pix09/canteenorder/blob/main/CanteenOrder/CanteenOrder/app.py"
click node_realtime "https://github.com/omkar-pix09/canteenorder/blob/main/CanteenOrder/CanteenOrder/app.py"
click node_java "https://github.com/omkar-pix09/canteenorder/blob/main/CanteenOrder/CanteenOrder/java/src/main/java/com/canteen/CanteenReportService.java"
click node_report "https://github.com/omkar-pix09/canteenorder/blob/main/CanteenOrder/CanteenOrder/java/src/main/java/com/canteen/CanteenReportService.java"
click node_tokens "https://github.com/omkar-pix09/canteenorder/blob/main/CanteenOrder/CanteenOrder/java/src/main/java/com/canteen/CanteenReportService.java"
click node_java_sub "https://github.com/omkar-pix09/canteenorder/blob/main/CanteenOrder/CanteenOrder/java/src/main/java/com/canteen/CanteenReportService.java"
click node_browser "https://github.com/omkar-pix09/canteenorder/tree/main/CanteenOrder/CanteenOrder/templates"
click node_cartutil "https://github.com/omkar-pix09/canteenorder/blob/main/CanteenOrder/CanteenOrder/static/js/utils.js"

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_flask,node_menu,node_orders,node_accounts,node_engagement,node_subscriptions,node_state,node_realtime,node_webuser toneBlue
class node_java,node_report,node_tokens,node_java_sub toneAmber
class node_browser,node_cartutil toneMint
class node_diner,node_staff,node_ops toneIndigo
```

## Components

### Ordering application

- [Flask routes](https://github.com/omkar-pix09/canteenorder/blob/main/CanteenOrder/CanteenOrder/app.py): `CanteenOrder/CanteenOrder/app.py`
- [Menu and suggestions](https://github.com/omkar-pix09/canteenorder/blob/main/CanteenOrder/CanteenOrder/app.py): `CanteenOrder/CanteenOrder/app.py`
- [Order lifecycle](https://github.com/omkar-pix09/canteenorder/blob/main/CanteenOrder/CanteenOrder/app.py): `CanteenOrder/CanteenOrder/app.py`
- [Accounts and wallet](https://github.com/omkar-pix09/canteenorder/blob/main/CanteenOrder/CanteenOrder/app.py): `CanteenOrder/CanteenOrder/app.py`
- [Ratings and group carts](https://github.com/omkar-pix09/canteenorder/blob/main/CanteenOrder/CanteenOrder/app.py): `CanteenOrder/CanteenOrder/app.py`
- [Tiffin subscriptions](https://github.com/omkar-pix09/canteenorder/blob/main/CanteenOrder/CanteenOrder/app.py): `CanteenOrder/CanteenOrder/app.py`
- [In-memory application state](https://github.com/omkar-pix09/canteenorder/blob/main/CanteenOrder/CanteenOrder/app.py): `CanteenOrder/CanteenOrder/app.py`
- [Socket.IO updates](https://github.com/omkar-pix09/canteenorder/blob/main/CanteenOrder/CanteenOrder/app.py): `CanteenOrder/CanteenOrder/app.py`

### Reporting service

- [Java HTTP service](https://github.com/omkar-pix09/canteenorder/blob/main/CanteenOrder/CanteenOrder/java/src/main/java/com/canteen/CanteenReportService.java): `CanteenOrder/CanteenOrder/java/src/main/java/com/canteen/CanteenReportService.java`
- [Sales reports](https://github.com/omkar-pix09/canteenorder/blob/main/CanteenOrder/CanteenOrder/java/src/main/java/com/canteen/CanteenReportService.java): `CanteenOrder/CanteenOrder/java/src/main/java/com/canteen/CanteenReportService.java`
- [Token generation](https://github.com/omkar-pix09/canteenorder/blob/main/CanteenOrder/CanteenOrder/java/src/main/java/com/canteen/CanteenReportService.java): `CanteenOrder/CanteenOrder/java/src/main/java/com/canteen/CanteenReportService.java`
- [Java subscriptions](https://github.com/omkar-pix09/canteenorder/blob/main/CanteenOrder/CanteenOrder/java/src/main/java/com/canteen/CanteenReportService.java): `CanteenOrder/CanteenOrder/java/src/main/java/com/canteen/CanteenReportService.java`

### Browser experience

- [Ordering pages](https://github.com/omkar-pix09/canteenorder/tree/main/CanteenOrder/CanteenOrder/templates): `CanteenOrder/CanteenOrder/templates`
- [Cart and API utilities](https://github.com/omkar-pix09/canteenorder/blob/main/CanteenOrder/CanteenOrder/static/js/utils.js): `CanteenOrder/CanteenOrder/static/js/utils.js`

### Other components

- **Diner**
- **Kitchen staff**
- **Web user**
- **Service caller**

## Connections

- Diner → Ordering pages: uses
- Ordering pages → Flask routes: requests routes
- Cart and API utilities → Flask routes: fetches API
- Flask routes → Menu and suggestions: serves menu (evidence: `CanteenOrder/CanteenOrder/app.py`)
- Flask routes → Order lifecycle: handles orders (evidence: `CanteenOrder/CanteenOrder/app.py`)
- Flask routes → Accounts and wallet: handles account APIs (evidence: `CanteenOrder/CanteenOrder/app.py`)
- Flask routes → Ratings and group carts: handles engagement APIs (evidence: `CanteenOrder/CanteenOrder/app.py`)
- Flask routes → Tiffin subscriptions: creates subscriptions (evidence: `CanteenOrder/CanteenOrder/app.py`)
- Menu and suggestions → In-memory application state: reads menu and history (evidence: `CanteenOrder/CanteenOrder/app.py`)
- Order lifecycle → In-memory application state: updates order data (evidence: `CanteenOrder/CanteenOrder/app.py`)
- Accounts and wallet → In-memory application state: updates user data (evidence: `CanteenOrder/CanteenOrder/app.py`)
- Ratings and group carts → In-memory application state: stores group carts (evidence: `CanteenOrder/CanteenOrder/app.py`)
- Tiffin subscriptions → In-memory application state: stores subscriptions (evidence: `CanteenOrder/CanteenOrder/app.py`)
- Order lifecycle → Socket.IO updates: emits order updates (evidence: `CanteenOrder/CanteenOrder/app.py`)
- Socket.IO updates → Kitchen staff: notifies kitchen (evidence: `CanteenOrder/CanteenOrder/app.py`)
- Socket.IO updates → Diner: broadcasts status (evidence: `CanteenOrder/CanteenOrder/app.py`)
- Web user → Java HTTP service: calls HTTP service
- Service caller → Java HTTP service: calls HTTP service
- Java HTTP service → Sales reports: routes report requests (evidence: `CanteenOrder/CanteenOrder/java/src/main/java/com/canteen/CanteenReportService.java`)
- Java HTTP service → Token generation: routes token requests (evidence: `CanteenOrder/CanteenOrder/java/src/main/java/com/canteen/CanteenReportService.java`)
- Java HTTP service → Java subscriptions: routes subscribe requests (evidence: `CanteenOrder/CanteenOrder/java/src/main/java/com/canteen/CanteenReportService.java`)
