# 25ag1a6767-cyber/collegebites architecture

> Architecture diagram of the GitHub repository 25ag1a6767-cyber/collegebites, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/25ag1a6767-cyber/collegebites
- Repository: https://github.com/25ag1a6767-cyber/collegebites

## Overview

CollegeBites is a multi-location college-canteen ordering and operations platform with web and mobile clients backed by a FastAPI service. Customers browse menus, place orders, pay online or at a counter, and receive pickup tokens; staff prepare, display, and verify orders for handover. The README documents the end-to-end stages and capabilities, while sampled backend routes show selected service delegation. Several frontend and backend subsystems are present in the tree but were not sampled, so their internal links are omitted where direct evidence is unavailable.

Main entry points: [`backend/app/core/database.py`](https://github.com/25ag1a6767-cyber/collegebites/blob/main/backend/app/core/database.py) (Relational Database), [`backend/app/services/order_service.py`](https://github.com/25ag1a6767-cyber/collegebites/blob/main/backend/app/services/order_service.py) (Order Processing), [`backend/app/api/orders/routes.py`](https://github.com/25ag1a6767-cyber/collegebites/blob/main/backend/app/api/orders/routes.py) (Order Routes), [`backend/app/services/payment_service.py`](https://github.com/25ag1a6767-cyber/collegebites/blob/main/backend/app/services/payment_service.py) (Payment Service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["Customer Clients"]
  node_web["Web App<br/>[App.tsx]"]
  node_mobile["Mobile App<br/>[index.tsx]"]
  node_webapi["Web API Client<br/>[client.ts]"]
  node_mobileapi["Mobile API Client<br/>[client.ts]"]
end

subgraph group_commerce["Ordering and Payment"]
  node_menu["Menu Management<br/>[menu_service.py]"]
  node_menu_routes["Menu Routes<br/>[routes.py]"]
  node_order["Order Processing<br/>[order_service.py]"]
  node_order_routes["Order Routes<br/>[routes.py]"]
  node_payment_routes["Payment Routes<br/>[routes.py]"]
  node_payment["Payment Service<br/>[payment_service.py]"]
  node_gateway["Payment Gateways<br/>[stripe_client.py]"]
  node_token["Pickup Token and QR<br/>[token_service.py]"]
  node_receipt["Receipt Printing<br/>[receipt_service.py]"]
end

subgraph group_operations["Canteen Operations"]
  node_kitchen["Kitchen Display<br/>[kitchen_service.py]"]
  node_board["Live Token Board<br/>[queue_service.py]"]
  node_pickup["Pickup Verification<br/>[pickup_service.py]"]
  node_inventory["Inventory Management"]
  node_admin["Administration<br/>[routes.py]"]
  node_realtime["Realtime Updates"]
  node_notifications["Notifications"]
  node_reports["Reports<br/>[report_service.py]"]
end

subgraph group_platform["Backend Platform"]
  node_database[("Relational Database<br/>[database.py]")]
  node_permissions["Authentication and Permissions<br/>[permissions.py]"]
end

node_customer(("Customer or Guest"))

node_customer -->|"uses"| node_web
node_customer -->|"uses"| node_mobile
node_web -.->|"requests"| node_webapi
node_mobile -.->|"requests"| node_mobileapi
node_webapi -.->|"sends requests"| node_order_routes
node_mobileapi -.->|"sends requests"| node_order_routes
node_menu_routes -->|"delegates to"| node_menu
node_menu -.->|"reads and writes"| node_database
node_order_routes -->|"delegates to"| node_order
node_order -.->|"reads and writes"| node_database
node_order_routes -.->|"initiates payment"| node_payment_routes
node_payment_routes -->|"delegates to"| node_payment
node_payment -.->|"verifies payment"| node_gateway
node_gateway -->|"processes payment"| node_payment
node_payment -->|"issues token"| node_token
node_token -->|"includes in receipt"| node_receipt
node_order -->|"routes order"| node_kitchen
node_kitchen -->|"publishes token"| node_board
node_board -->|"presents for handover"| node_pickup
node_pickup -->|"completes order"| node_order
node_inventory -.->|"reads and writes"| node_database
node_admin -->|"checks health"| node_database
node_realtime -.->|"updates live"| node_board
node_notifications -.->|"notifies"| node_customer
node_reports -.->|"provides reports"| node_admin
node_permissions -->|"loads roles"| node_database
node_menu_routes -.->|"checks access"| node_permissions
node_payment_routes -.->|"checks access"| node_permissions

click node_web "https://github.com/25ag1a6767-cyber/collegebites/blob/main/frontend/src/App.tsx"
click node_mobile "https://github.com/25ag1a6767-cyber/collegebites/blob/main/mobile/app/index.tsx"
click node_webapi "https://github.com/25ag1a6767-cyber/collegebites/blob/main/frontend/src/api/client.ts"
click node_mobileapi "https://github.com/25ag1a6767-cyber/collegebites/blob/main/mobile/src/api/client.ts"
click node_menu "https://github.com/25ag1a6767-cyber/collegebites/blob/main/backend/app/services/menu_service.py"
click node_menu_routes "https://github.com/25ag1a6767-cyber/collegebites/blob/main/backend/app/api/menus/routes.py"
click node_order "https://github.com/25ag1a6767-cyber/collegebites/blob/main/backend/app/services/order_service.py"
click node_order_routes "https://github.com/25ag1a6767-cyber/collegebites/blob/main/backend/app/api/orders/routes.py"
click node_payment_routes "https://github.com/25ag1a6767-cyber/collegebites/blob/main/backend/app/api/payments/routes.py"
click node_payment "https://github.com/25ag1a6767-cyber/collegebites/blob/main/backend/app/services/payment_service.py"
click node_gateway "https://github.com/25ag1a6767-cyber/collegebites/blob/main/backend/app/integrations/stripe_client.py"
click node_token "https://github.com/25ag1a6767-cyber/collegebites/blob/main/backend/app/services/token_service.py"
click node_receipt "https://github.com/25ag1a6767-cyber/collegebites/blob/main/backend/app/services/receipt_service.py"
click node_kitchen "https://github.com/25ag1a6767-cyber/collegebites/blob/main/backend/app/services/kitchen_service.py"
click node_board "https://github.com/25ag1a6767-cyber/collegebites/blob/main/backend/app/services/queue_service.py"
click node_pickup "https://github.com/25ag1a6767-cyber/collegebites/blob/main/backend/app/services/pickup_service.py"
click node_inventory "https://github.com/25ag1a6767-cyber/collegebites/blob/main/backend/app/services/inventory_service.py"
click node_admin "https://github.com/25ag1a6767-cyber/collegebites/blob/main/backend/app/api/admin/routes.py"
click node_realtime "https://github.com/25ag1a6767-cyber/collegebites/blob/main/backend/app/services/realtime_service.py"
click node_database "https://github.com/25ag1a6767-cyber/collegebites/blob/main/backend/app/core/database.py"
click node_permissions "https://github.com/25ag1a6767-cyber/collegebites/blob/main/backend/app/core/permissions.py"
click node_notifications "https://github.com/25ag1a6767-cyber/collegebites/blob/main/backend/app/services/notification_service.py"
click node_reports "https://github.com/25ag1a6767-cyber/collegebites/blob/main/backend/app/services/report_service.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,node_mobile,node_webapi,node_mobileapi toneBlue
class node_menu,node_menu_routes,node_order,node_order_routes,node_payment_routes,node_payment,node_gateway,node_token,node_receipt toneAmber
class node_kitchen,node_board,node_pickup,node_inventory,node_admin,node_realtime,node_notifications,node_reports toneMint
class node_database,node_permissions toneRose
class node_customer toneIndigo
```

## Components

### Customer Clients

- [Web App](https://github.com/25ag1a6767-cyber/collegebites/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Mobile App](https://github.com/25ag1a6767-cyber/collegebites/blob/main/mobile/app/index.tsx): `mobile/app/index.tsx`
- [Web API Client](https://github.com/25ag1a6767-cyber/collegebites/blob/main/frontend/src/api/client.ts): `frontend/src/api/client.ts`
- [Mobile API Client](https://github.com/25ag1a6767-cyber/collegebites/blob/main/mobile/src/api/client.ts): `mobile/src/api/client.ts`

### Ordering and Payment

- [Menu Management](https://github.com/25ag1a6767-cyber/collegebites/blob/main/backend/app/services/menu_service.py): `backend/app/services/menu_service.py`
- [Menu Routes](https://github.com/25ag1a6767-cyber/collegebites/blob/main/backend/app/api/menus/routes.py): `backend/app/api/menus/routes.py`
- [Order Processing](https://github.com/25ag1a6767-cyber/collegebites/blob/main/backend/app/services/order_service.py): `backend/app/services/order_service.py`
- [Order Routes](https://github.com/25ag1a6767-cyber/collegebites/blob/main/backend/app/api/orders/routes.py): `backend/app/api/orders/routes.py`
- [Payment Routes](https://github.com/25ag1a6767-cyber/collegebites/blob/main/backend/app/api/payments/routes.py): `backend/app/api/payments/routes.py`
- [Payment Service](https://github.com/25ag1a6767-cyber/collegebites/blob/main/backend/app/services/payment_service.py): `backend/app/services/payment_service.py`
- [Payment Gateways](https://github.com/25ag1a6767-cyber/collegebites/blob/main/backend/app/integrations/stripe_client.py): `backend/app/integrations/stripe_client.py`
- [Pickup Token and QR](https://github.com/25ag1a6767-cyber/collegebites/blob/main/backend/app/services/token_service.py): `backend/app/services/token_service.py`
- [Receipt Printing](https://github.com/25ag1a6767-cyber/collegebites/blob/main/backend/app/services/receipt_service.py): `backend/app/services/receipt_service.py`

### Canteen Operations

- [Kitchen Display](https://github.com/25ag1a6767-cyber/collegebites/blob/main/backend/app/services/kitchen_service.py): `backend/app/services/kitchen_service.py`
- [Live Token Board](https://github.com/25ag1a6767-cyber/collegebites/blob/main/backend/app/services/queue_service.py): `backend/app/services/queue_service.py`
- [Pickup Verification](https://github.com/25ag1a6767-cyber/collegebites/blob/main/backend/app/services/pickup_service.py): `backend/app/services/pickup_service.py`
- [Inventory Management](https://github.com/25ag1a6767-cyber/collegebites/blob/main/backend/app/services/inventory_service.py): `backend/app/services/inventory_service.py`
- [Administration](https://github.com/25ag1a6767-cyber/collegebites/blob/main/backend/app/api/admin/routes.py): `backend/app/api/admin/routes.py`
- [Realtime Updates](https://github.com/25ag1a6767-cyber/collegebites/blob/main/backend/app/services/realtime_service.py): `backend/app/services/realtime_service.py`
- [Notifications](https://github.com/25ag1a6767-cyber/collegebites/blob/main/backend/app/services/notification_service.py): `backend/app/services/notification_service.py`
- [Reports](https://github.com/25ag1a6767-cyber/collegebites/blob/main/backend/app/services/report_service.py): `backend/app/services/report_service.py`

### Backend Platform

- [Relational Database](https://github.com/25ag1a6767-cyber/collegebites/blob/main/backend/app/core/database.py): `backend/app/core/database.py`
- [Authentication and Permissions](https://github.com/25ag1a6767-cyber/collegebites/blob/main/backend/app/core/permissions.py): `backend/app/core/permissions.py`

### Other components

- **Customer or Guest**

## Connections

- Customer or Guest → Web App: uses
- Customer or Guest → Mobile App: uses
- Web App → Web API Client: requests
- Mobile App → Mobile API Client: requests (evidence: `mobile/app/index.tsx`)
- Web API Client → Order Routes: sends requests
- Mobile API Client → Order Routes: sends requests
- Menu Routes → Menu Management: delegates to (evidence: `backend/app/api/menus/routes.py`)
- Menu Management → Relational Database: reads and writes
- Order Routes → Order Processing: delegates to
- Order Processing → Relational Database: reads and writes
- Order Routes → Payment Routes: initiates payment
- Payment Routes → Payment Service: delegates to (evidence: `backend/app/api/payments/routes.py`)
- Payment Service → Payment Gateways: verifies payment
- Payment Gateways → Payment Service: processes payment
- Payment Service → Pickup Token and QR: issues token
- Pickup Token and QR → Receipt Printing: includes in receipt
- Order Processing → Kitchen Display: routes order
- Kitchen Display → Live Token Board: publishes token
- Live Token Board → Pickup Verification: presents for handover
- Pickup Verification → Order Processing: completes order
- Inventory Management → Relational Database: reads and writes
- Administration → Relational Database: checks health (evidence: `backend/app/api/admin/routes.py`)
- Realtime Updates → Live Token Board: updates live
- Notifications → Customer or Guest: notifies
- Reports → Administration: provides reports
- Authentication and Permissions → Relational Database: loads roles (evidence: `backend/app/core/permissions.py`)
- Menu Routes → Authentication and Permissions: checks access (evidence: `backend/app/api/menus/routes.py`)
- Payment Routes → Authentication and Permissions: checks access (evidence: `backend/app/api/payments/routes.py`)
