# vignesh20050706-max/cafemanagementsystemz architecture

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

- Interactive diagram: https://gitdiagram.com/vignesh20050706-max/cafemanagementsystemz
- Repository: https://github.com/vignesh20050706-max/cafemanagementsystemz

## Overview

This is a multi-cafe ordering and café-operations web application. Customers choose a café and order type, browse a menu, check out, pay, and track orders; café admins manage menus, tables, order status, and café availability, while super admins manage cafés. Flask routes are the principal web entry points, with services handling order, payment, invoice, notification, and café operations over SQLAlchemy-backed models. The README is empty, so the capability map relies on the file tree and shown excerpts; links to unsampled service behavior are included only where route references support them.

Main entry points: [`routes/customer_routes.py`](https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/routes/customer_routes.py) (Customer ordering), [`routes/admin_routes.py`](https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/routes/admin_routes.py) (Café administration), [`services/order_service.py`](https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/services/order_service.py) (Order lifecycle), [`app.py`](https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/app.py) (Flask application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web workflows"]
  node_app["Flask application<br/>[app.py]"]
  node_customer_routes["Customer ordering<br/>[customer_routes.py]"]
  node_config["Application settings<br/>[config.py]"]
end

subgraph group_ops["Café operations"]
  node_admin_routes["Café administration<br/>[admin_routes.py]"]
  node_super_routes["Cafe management"]
end

subgraph group_services["Domain services"]
  node_order_service["Order lifecycle<br/>[order_service.py]"]
  node_payment_service["Payment handling<br/>[payment_service.py]"]
  node_invoice_service["Invoice generation<br/>[invoice_service.py]"]
  node_notification_service["Notifications"]
  node_cafe_service["Cafe utilities<br/>[cafe_service.py]"]
  node_qr_service["QR generation<br/>[qr_service.py]"]
  node_order_events["Order events<br/>[order_events.py]"]
end

subgraph group_data["Domain data"]
  node_db[("SQLAlchemy database<br/>[database.py]")]
  node_cafe_model["Cafe records<br/>[cafe.py]"]
  node_status_model["Cafe availability<br/>[cafe_status.py]"]
  node_menu_model["Menu records<br/>[menu.py]"]
  node_order_model["Order records<br/>[order.py]"]
  node_payment_model["Payment records<br/>[payment.py]"]
  node_customer_model["Customer records<br/>[customer.py]"]
  node_admin_model["Admin records<br/>[admin.py]"]
  node_table_model["Table records<br/>[table.py]"]
  node_notification_model["Notification records<br/>[notification.py]"]
end

node_customer(("Customer"))
node_admin(("Café admin"))
node_superadmin(("Super admin"))
node_razorpay["Razorpay"]

node_customer -->|"places order"| node_customer_routes
node_admin -->|"manages café"| node_admin_routes
node_superadmin -->|"manages cafés"| node_super_routes
node_app -->|"registers routes"| node_customer_routes
node_app -->|"registers routes"| node_admin_routes
node_app -->|"registers routes"| node_super_routes
node_app -->|"loads settings"| node_config
node_app -->|"initializes database"| node_db
node_customer_routes -->|"creates orders"| node_order_service
node_customer_routes -->|"verifies payment"| node_payment_service
node_customer_routes -->|"uses invoices"| node_invoice_service
node_customer_routes -->|"uses notifications"| node_notification_service
node_customer_routes -->|"gets café"| node_cafe_service
node_customer_routes -->|"uses QR service"| node_qr_service
node_admin_routes -->|"updates orders"| node_order_service
node_admin_routes -->|"handles payment"| node_payment_service
node_admin_routes -->|"uses invoices"| node_invoice_service
node_admin_routes -->|"uses notifications"| node_notification_service
node_admin_routes -->|"uses QR service"| node_qr_service
node_admin_routes -->|"uses order events"| node_order_events
node_super_routes -->|"uses café service"| node_cafe_service
node_customer_routes -->|"reads menu"| node_menu_model
node_customer_routes -->|"creates customer"| node_customer_model
node_customer_routes -->|"creates order"| node_order_model
node_customer_routes -->|"reads payment"| node_payment_model
node_customer_routes -->|"checks table"| node_table_model
node_customer_routes -->|"checks availability"| node_status_model
node_admin_routes -->|"queries orders"| node_order_model
node_admin_routes -->|"manages menu"| node_menu_model
node_admin_routes -->|"manages tables"| node_table_model
node_admin_routes -->|"sets availability"| node_status_model
node_admin_routes -->|"loads admin"| node_admin_model
node_super_routes -->|"manages cafés"| node_cafe_model
node_super_routes -->|"sets availability"| node_status_model
node_order_service -->|"finds customer"| node_customer_model
node_order_service -->|"loads menu items"| node_menu_model
node_order_service -->|"creates order"| node_order_model
node_order_service -->|"creates payment record"| node_payment_model
node_payment_service -->|"records payment"| node_payment_model
node_payment_service -->|"updates order"| node_order_model
node_payment_service -.->|"calls gateway"| node_razorpay
node_notification_service -->|"stores notifications"| node_notification_model
node_cafe_service -->|"uses café records"| node_cafe_model
node_cafe_model -->|"persists records"| node_db
node_status_model -->|"persists status"| node_db
node_menu_model -->|"persists menu"| node_db
node_order_model -->|"persists orders"| node_db
node_payment_model -->|"persists payments"| node_db

click node_app "https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/app.py"
click node_customer_routes "https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/routes/customer_routes.py"
click node_admin_routes "https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/routes/admin_routes.py"
click node_super_routes "https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/routes/super_admin_routes.py"
click node_order_service "https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/services/order_service.py"
click node_payment_service "https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/services/payment_service.py"
click node_invoice_service "https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/services/invoice_service.py"
click node_notification_service "https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/services/notification_service.py"
click node_cafe_service "https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/services/cafe_service.py"
click node_qr_service "https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/services/qr_service.py"
click node_order_events "https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/services/order_events.py"
click node_config "https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/config.py"
click node_db "https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/database/database.py"
click node_cafe_model "https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/models/cafe.py"
click node_status_model "https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/models/cafe_status.py"
click node_menu_model "https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/models/menu.py"
click node_order_model "https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/models/order.py"
click node_payment_model "https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/models/payment.py"
click node_customer_model "https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/models/customer.py"
click node_admin_model "https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/models/admin.py"
click node_table_model "https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/models/table.py"
click node_notification_model "https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/models/notification.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_app,node_customer_routes,node_config toneBlue
class node_admin_routes,node_super_routes toneAmber
class node_order_service,node_payment_service,node_invoice_service,node_notification_service,node_cafe_service,node_qr_service,node_order_events toneMint
class node_db,node_cafe_model,node_status_model,node_menu_model,node_order_model,node_payment_model,node_customer_model,node_admin_model,node_table_model,node_notification_model toneRose
class node_customer,node_admin,node_superadmin,node_razorpay toneIndigo
```

## Components

### Web workflows

- [Flask application](https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/app.py): `app.py`
- [Customer ordering](https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/routes/customer_routes.py): `routes/customer_routes.py`
- [Application settings](https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/config.py): `config.py`

### Café operations

- [Café administration](https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/routes/admin_routes.py): `routes/admin_routes.py`
- [Cafe management](https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/routes/super_admin_routes.py): `routes/super_admin_routes.py`

### Domain services

- [Order lifecycle](https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/services/order_service.py): `services/order_service.py`
- [Payment handling](https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/services/payment_service.py): `services/payment_service.py`
- [Invoice generation](https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/services/invoice_service.py): `services/invoice_service.py`
- [Notifications](https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/services/notification_service.py): `services/notification_service.py`
- [Cafe utilities](https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/services/cafe_service.py): `services/cafe_service.py`
- [QR generation](https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/services/qr_service.py): `services/qr_service.py`
- [Order events](https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/services/order_events.py): `services/order_events.py`

### Domain data

- [SQLAlchemy database](https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/database/database.py): `database/database.py`
- [Cafe records](https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/models/cafe.py): `models/cafe.py`
- [Cafe availability](https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/models/cafe_status.py): `models/cafe_status.py`
- [Menu records](https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/models/menu.py): `models/menu.py`
- [Order records](https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/models/order.py): `models/order.py`
- [Payment records](https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/models/payment.py): `models/payment.py`
- [Customer records](https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/models/customer.py): `models/customer.py`
- [Admin records](https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/models/admin.py): `models/admin.py`
- [Table records](https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/models/table.py): `models/table.py`
- [Notification records](https://github.com/vignesh20050706-max/cafemanagementsystemz/blob/main/models/notification.py): `models/notification.py`

### Other components

- **Customer**
- **Café admin**
- **Super admin**
- **Razorpay**

## Connections

- Customer → Customer ordering: places order (evidence: `routes/customer_routes.py`)
- Café admin → Café administration: manages café (evidence: `routes/admin_routes.py`)
- Super admin → Cafe management: manages cafés (evidence: `routes/super_admin_routes.py`)
- Flask application → Customer ordering: registers routes (evidence: `app.py`)
- Flask application → Café administration: registers routes (evidence: `app.py`)
- Flask application → Cafe management: registers routes (evidence: `app.py`)
- Flask application → Application settings: loads settings (evidence: `app.py`)
- Flask application → SQLAlchemy database: initializes database (evidence: `app.py`)
- Customer ordering → Order lifecycle: creates orders (evidence: `routes/customer_routes.py`)
- Customer ordering → Payment handling: verifies payment (evidence: `routes/customer_routes.py`)
- Customer ordering → Invoice generation: uses invoices (evidence: `routes/customer_routes.py`)
- Customer ordering → Notifications: uses notifications (evidence: `routes/customer_routes.py`)
- Customer ordering → Cafe utilities: gets café (evidence: `routes/customer_routes.py`)
- Customer ordering → QR generation: uses QR service (evidence: `routes/customer_routes.py`)
- Café administration → Order lifecycle: updates orders (evidence: `routes/admin_routes.py`)
- Café administration → Payment handling: handles payment (evidence: `routes/admin_routes.py`)
- Café administration → Invoice generation: uses invoices (evidence: `routes/admin_routes.py`)
- Café administration → Notifications: uses notifications (evidence: `routes/admin_routes.py`)
- Café administration → QR generation: uses QR service (evidence: `routes/admin_routes.py`)
- Café administration → Order events: uses order events (evidence: `routes/admin_routes.py`)
- Cafe management → Cafe utilities: uses café service (evidence: `routes/super_admin_routes.py`)
- Customer ordering → Menu records: reads menu (evidence: `routes/customer_routes.py`)
- Customer ordering → Customer records: creates customer (evidence: `routes/customer_routes.py`)
- Customer ordering → Order records: creates order (evidence: `routes/customer_routes.py`)
- Customer ordering → Payment records: reads payment (evidence: `routes/customer_routes.py`)
- Customer ordering → Table records: checks table (evidence: `routes/customer_routes.py`)
- Customer ordering → Cafe availability: checks availability (evidence: `routes/customer_routes.py`)
- Café administration → Order records: queries orders (evidence: `routes/admin_routes.py`)
- Café administration → Menu records: manages menu (evidence: `routes/admin_routes.py`)
- Café administration → Table records: manages tables (evidence: `routes/admin_routes.py`)
- Café administration → Cafe availability: sets availability (evidence: `routes/admin_routes.py`)
- Café administration → Admin records: loads admin (evidence: `routes/admin_routes.py`)
- Cafe management → Cafe records: manages cafés (evidence: `routes/super_admin_routes.py`)
- Cafe management → Cafe availability: sets availability (evidence: `routes/super_admin_routes.py`)
- Order lifecycle → Customer records: finds customer (evidence: `services/order_service.py`)
- Order lifecycle → Menu records: loads menu items (evidence: `services/order_service.py`)
- Order lifecycle → Order records: creates order (evidence: `services/order_service.py`)
- Order lifecycle → Payment records: creates payment record (evidence: `services/order_service.py`)
- Payment handling → Payment records: records payment (evidence: `services/payment_service.py`)
- Payment handling → Order records: updates order (evidence: `services/payment_service.py`)
- Payment handling → Razorpay: calls gateway (evidence: `services/payment_service.py`)
- Notifications → Notification records: stores notifications (evidence: `services/notification_service.py`)
- Cafe utilities → Cafe records: uses café records (evidence: `services/cafe_service.py`)
- Cafe records → SQLAlchemy database: persists records (evidence: `models/cafe.py`)
- Cafe availability → SQLAlchemy database: persists status (evidence: `models/cafe_status.py`)
- Menu records → SQLAlchemy database: persists menu (evidence: `models/menu.py`)
- Order records → SQLAlchemy database: persists orders (evidence: `models/order.py`)
- Payment records → SQLAlchemy database: persists payments (evidence: `models/payment.py`)
