# mystrident/velacafe architecture

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

- Interactive diagram: https://gitdiagram.com/mystrident/velacafe
- Repository: https://github.com/mystrident/velacafe

## Overview

VELAA Cafe is a cafe ordering and operations app. Customers browse the live menu, reserve stock during Razorpay checkout, and can view orders and submit feedback; admins manage menu, orders, and feedback. The backend separates route dispatch, authentication, domain controllers, and persistent records, with Socket.IO updates and web-push notifications. The README is empty, so capabilities are inferred from the source tree and available excerpts; unsampled connections are omitted where evidence is insufficient.

Main entry points: [`frontend/src/App.jsx`](https://github.com/mystrident/velacafe/blob/main/frontend/src/App.jsx) (App routes), [`server/server.js`](https://github.com/mystrident/velacafe/blob/main/server/server.js) (HTTP and sockets), [`server/controllers/paymentController.js`](https://github.com/mystrident/velacafe/blob/main/server/controllers/paymentController.js) (Payment controller), [`frontend/src/api/axios.js`](https://github.com/mystrident/velacafe/blob/main/frontend/src/api/axios.js) (API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Customer storefront"]
  node_app["App routes<br/>[App.jsx]"]
  node_home["Menu and checkout<br/>[Home.jsx]"]
  node_customer_orders["My orders<br/>[MyOrders.jsx]"]
  node_customer_feedback["My feedback<br/>[MyFeedback.jsx]"]
  node_sso["Sastranet sign-in<br/>[SastranetSso.jsx]"]
  node_frontend_api["API client<br/>[axios.js]"]
end

subgraph group_admin["Admin operations"]
  node_admin_ui["Menu management<br/>[Admin.jsx]"]
  node_admin_orders["Order operations<br/>[Orders.jsx]"]
  node_admin_history["Order history<br/>[PreviousOrders.jsx]"]
  node_admin_feedback["Feedback operations<br/>[Feedbacks.jsx]"]
  node_admin_login["Admin login<br/>[Login.jsx]"]
end

subgraph group_backend["Backend domain"]
  node_api_server["HTTP and sockets<br/>[server.js]"]
  node_item_routes["Menu routes<br/>[itemRoutes.js]"]
  node_order_routes["Order routes<br/>[orderRoutes.js]"]
  node_feedback_routes["Feedback routes<br/>[feedbackRoutes.js]"]
  node_payment_routes["Payment routes<br/>[paymentRoutes.js]"]
  node_auth_routes["Admin auth routes<br/>[authRoutes.js]"]
  node_user_auth_routes["Customer auth routes<br/>[userAuthRoutes.js]"]
  node_items["Menu controller<br/>[itemController.js]"]
  node_orders["Order controller<br/>[orderController.js]"]
  node_feedback["Feedback controller"]
  node_payment["Payment controller"]
  node_admin_auth["Admin authentication<br/>[authController.js]"]
  node_customer_auth["Customer authentication"]
  node_admin_guard["Admin guard<br/>[authMiddleware.js]"]
  node_customer_guard["Customer guard"]
  node_validators["Request validation<br/>[validators.js]"]
end

subgraph group_platform["State and integrations"]
  node_catalog_store[("Menu records<br/>[Item.js]")]
  node_order_store[("Order records<br/>[Order.js]")]
  node_pending_store[("Payment reservations<br/>[PendingPayment.js]")]
  node_user_store[("Customer records<br/>[User.js]")]
  node_admin_store[("Admin records<br/>[Admin.js]")]
end

node_customer(("Customer"))
node_admin_actor(("Admin"))

node_customer -->|"opens"| node_app
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_customer_orders
node_app -->|"routes to"| node_customer_feedback
node_app -->|"routes to"| node_sso
node_admin_actor -->|"opens"| node_app
node_app -->|"routes to"| node_admin_ui
node_app -->|"routes to"| node_admin_orders
node_app -->|"routes to"| node_admin_history
node_app -->|"routes to"| node_admin_feedback
node_app -->|"routes to"| node_admin_login
node_home -->|"requests data"| node_frontend_api
node_admin_ui -->|"requests data"| node_frontend_api
node_admin_orders -->|"requests data"| node_frontend_api
node_admin_feedback -->|"requests data"| node_frontend_api
node_admin_login -->|"requests login"| node_frontend_api
node_frontend_api -.->|"calls API"| node_api_server
node_api_server -->|"mounts"| node_item_routes
node_api_server -->|"mounts"| node_order_routes
node_api_server -->|"mounts"| node_feedback_routes
node_api_server -->|"mounts"| node_payment_routes
node_api_server -->|"mounts"| node_auth_routes
node_api_server -->|"mounts"| node_user_auth_routes
node_item_routes -->|"dispatches"| node_items
node_order_routes -->|"dispatches"| node_orders
node_feedback_routes -->|"dispatches"| node_feedback
node_payment_routes -->|"dispatches"| node_payment
node_auth_routes -->|"dispatches"| node_admin_auth
node_user_auth_routes -->|"dispatches"| node_customer_auth
node_item_routes -->|"protects writes"| node_admin_guard
node_order_routes -->|"protects admin routes"| node_admin_guard
node_order_routes -->|"protects customer routes"| node_customer_guard
node_feedback_routes -->|"protects admin routes"| node_admin_guard
node_feedback_routes -->|"protects customer routes"| node_customer_guard
node_payment_routes -->|"protects payments"| node_customer_guard
node_item_routes -->|"validates input"| node_validators
node_order_routes -->|"validates input"| node_validators
node_payment_routes -->|"validates input"| node_validators
node_items -->|"reads and writes"| node_catalog_store
node_orders -->|"reads and writes"| node_order_store
node_feedback -->|"reads customer"| node_user_store
node_admin_guard -->|"checks admin"| node_admin_store
node_customer_guard -->|"checks customer"| node_user_store
node_payment -->|"reserves stock"| node_catalog_store
node_payment -->|"records reservation"| node_pending_store
node_payment -->|"loads customer"| node_user_store
node_payment -->|"creates order"| node_order_store
node_payment -.->|"notifies admins"| node_admin_store

click node_app "https://github.com/mystrident/velacafe/blob/main/frontend/src/App.jsx"
click node_home "https://github.com/mystrident/velacafe/blob/main/frontend/src/customer/Home.jsx"
click node_customer_orders "https://github.com/mystrident/velacafe/blob/main/frontend/src/customer/MyOrders.jsx"
click node_customer_feedback "https://github.com/mystrident/velacafe/blob/main/frontend/src/customer/MyFeedback.jsx"
click node_sso "https://github.com/mystrident/velacafe/blob/main/frontend/src/customer/SastranetSso.jsx"
click node_frontend_api "https://github.com/mystrident/velacafe/blob/main/frontend/src/api/axios.js"
click node_admin_ui "https://github.com/mystrident/velacafe/blob/main/frontend/src/admin/Admin.jsx"
click node_admin_orders "https://github.com/mystrident/velacafe/blob/main/frontend/src/admin/Orders.jsx"
click node_admin_history "https://github.com/mystrident/velacafe/blob/main/frontend/src/admin/PreviousOrders.jsx"
click node_admin_feedback "https://github.com/mystrident/velacafe/blob/main/frontend/src/admin/Feedbacks.jsx"
click node_admin_login "https://github.com/mystrident/velacafe/blob/main/frontend/src/admin/Login.jsx"
click node_api_server "https://github.com/mystrident/velacafe/blob/main/server/server.js"
click node_item_routes "https://github.com/mystrident/velacafe/blob/main/server/routes/itemRoutes.js"
click node_order_routes "https://github.com/mystrident/velacafe/blob/main/server/routes/orderRoutes.js"
click node_feedback_routes "https://github.com/mystrident/velacafe/blob/main/server/routes/feedbackRoutes.js"
click node_payment_routes "https://github.com/mystrident/velacafe/blob/main/server/routes/paymentRoutes.js"
click node_auth_routes "https://github.com/mystrident/velacafe/blob/main/server/routes/authRoutes.js"
click node_user_auth_routes "https://github.com/mystrident/velacafe/blob/main/server/routes/userAuthRoutes.js"
click node_items "https://github.com/mystrident/velacafe/blob/main/server/controllers/itemController.js"
click node_orders "https://github.com/mystrident/velacafe/blob/main/server/controllers/orderController.js"
click node_feedback "https://github.com/mystrident/velacafe/blob/main/server/controllers/feedbackController.js"
click node_payment "https://github.com/mystrident/velacafe/blob/main/server/controllers/paymentController.js"
click node_admin_auth "https://github.com/mystrident/velacafe/blob/main/server/controllers/authController.js"
click node_customer_auth "https://github.com/mystrident/velacafe/blob/main/server/controllers/userAuthController.js"
click node_admin_guard "https://github.com/mystrident/velacafe/blob/main/server/middleware/authMiddleware.js"
click node_customer_guard "https://github.com/mystrident/velacafe/blob/main/server/middleware/customerAuthMiddleware.js"
click node_validators "https://github.com/mystrident/velacafe/blob/main/server/middleware/validators.js"
click node_catalog_store "https://github.com/mystrident/velacafe/blob/main/server/models/Item.js"
click node_order_store "https://github.com/mystrident/velacafe/blob/main/server/models/Order.js"
click node_pending_store "https://github.com/mystrident/velacafe/blob/main/server/models/PendingPayment.js"
click node_user_store "https://github.com/mystrident/velacafe/blob/main/server/models/User.js"
click node_admin_store "https://github.com/mystrident/velacafe/blob/main/server/models/Admin.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_app,node_home,node_customer_orders,node_customer_feedback,node_sso,node_frontend_api toneBlue
class node_admin_ui,node_admin_orders,node_admin_history,node_admin_feedback,node_admin_login toneAmber
class node_api_server,node_item_routes,node_order_routes,node_feedback_routes,node_payment_routes,node_auth_routes,node_user_auth_routes,node_items,node_orders,node_feedback,node_payment,node_admin_auth,node_customer_auth,node_admin_guard,node_customer_guard,node_validators toneMint
class node_catalog_store,node_order_store,node_pending_store,node_user_store,node_admin_store toneRose
class node_customer,node_admin_actor toneIndigo
```

## Components

### Customer storefront

- [App routes](https://github.com/mystrident/velacafe/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Menu and checkout](https://github.com/mystrident/velacafe/blob/main/frontend/src/customer/Home.jsx): `frontend/src/customer/Home.jsx`
- [My orders](https://github.com/mystrident/velacafe/blob/main/frontend/src/customer/MyOrders.jsx): `frontend/src/customer/MyOrders.jsx`
- [My feedback](https://github.com/mystrident/velacafe/blob/main/frontend/src/customer/MyFeedback.jsx): `frontend/src/customer/MyFeedback.jsx`
- [Sastranet sign-in](https://github.com/mystrident/velacafe/blob/main/frontend/src/customer/SastranetSso.jsx): `frontend/src/customer/SastranetSso.jsx`
- [API client](https://github.com/mystrident/velacafe/blob/main/frontend/src/api/axios.js): `frontend/src/api/axios.js`

### Admin operations

- [Menu management](https://github.com/mystrident/velacafe/blob/main/frontend/src/admin/Admin.jsx): `frontend/src/admin/Admin.jsx`
- [Order operations](https://github.com/mystrident/velacafe/blob/main/frontend/src/admin/Orders.jsx): `frontend/src/admin/Orders.jsx`
- [Order history](https://github.com/mystrident/velacafe/blob/main/frontend/src/admin/PreviousOrders.jsx): `frontend/src/admin/PreviousOrders.jsx`
- [Feedback operations](https://github.com/mystrident/velacafe/blob/main/frontend/src/admin/Feedbacks.jsx): `frontend/src/admin/Feedbacks.jsx`
- [Admin login](https://github.com/mystrident/velacafe/blob/main/frontend/src/admin/Login.jsx): `frontend/src/admin/Login.jsx`

### Backend domain

- [HTTP and sockets](https://github.com/mystrident/velacafe/blob/main/server/server.js): `server/server.js`
- [Menu routes](https://github.com/mystrident/velacafe/blob/main/server/routes/itemRoutes.js): `server/routes/itemRoutes.js`
- [Order routes](https://github.com/mystrident/velacafe/blob/main/server/routes/orderRoutes.js): `server/routes/orderRoutes.js`
- [Feedback routes](https://github.com/mystrident/velacafe/blob/main/server/routes/feedbackRoutes.js): `server/routes/feedbackRoutes.js`
- [Payment routes](https://github.com/mystrident/velacafe/blob/main/server/routes/paymentRoutes.js): `server/routes/paymentRoutes.js`
- [Admin auth routes](https://github.com/mystrident/velacafe/blob/main/server/routes/authRoutes.js): `server/routes/authRoutes.js`
- [Customer auth routes](https://github.com/mystrident/velacafe/blob/main/server/routes/userAuthRoutes.js): `server/routes/userAuthRoutes.js`
- [Menu controller](https://github.com/mystrident/velacafe/blob/main/server/controllers/itemController.js): `server/controllers/itemController.js`
- [Order controller](https://github.com/mystrident/velacafe/blob/main/server/controllers/orderController.js): `server/controllers/orderController.js`
- [Feedback controller](https://github.com/mystrident/velacafe/blob/main/server/controllers/feedbackController.js): `server/controllers/feedbackController.js`
- [Payment controller](https://github.com/mystrident/velacafe/blob/main/server/controllers/paymentController.js): `server/controllers/paymentController.js`
- [Admin authentication](https://github.com/mystrident/velacafe/blob/main/server/controllers/authController.js): `server/controllers/authController.js`
- [Customer authentication](https://github.com/mystrident/velacafe/blob/main/server/controllers/userAuthController.js): `server/controllers/userAuthController.js`
- [Admin guard](https://github.com/mystrident/velacafe/blob/main/server/middleware/authMiddleware.js): `server/middleware/authMiddleware.js`
- [Customer guard](https://github.com/mystrident/velacafe/blob/main/server/middleware/customerAuthMiddleware.js): `server/middleware/customerAuthMiddleware.js`
- [Request validation](https://github.com/mystrident/velacafe/blob/main/server/middleware/validators.js): `server/middleware/validators.js`

### State and integrations

- [Menu records](https://github.com/mystrident/velacafe/blob/main/server/models/Item.js): `server/models/Item.js`
- [Order records](https://github.com/mystrident/velacafe/blob/main/server/models/Order.js): `server/models/Order.js`
- [Payment reservations](https://github.com/mystrident/velacafe/blob/main/server/models/PendingPayment.js): `server/models/PendingPayment.js`
- [Customer records](https://github.com/mystrident/velacafe/blob/main/server/models/User.js): `server/models/User.js`
- [Admin records](https://github.com/mystrident/velacafe/blob/main/server/models/Admin.js): `server/models/Admin.js`

### Other components

- **Customer**
- **Admin**

## Connections

- Customer → App routes: opens (evidence: `frontend/src/App.jsx`)
- App routes → Menu and checkout: routes to (evidence: `frontend/src/App.jsx`)
- App routes → My orders: routes to (evidence: `frontend/src/App.jsx`)
- App routes → My feedback: routes to (evidence: `frontend/src/App.jsx`)
- App routes → Sastranet sign-in: routes to (evidence: `frontend/src/App.jsx`)
- Admin → App routes: opens (evidence: `frontend/src/App.jsx`)
- App routes → Menu management: routes to (evidence: `frontend/src/App.jsx`)
- App routes → Order operations: routes to (evidence: `frontend/src/App.jsx`)
- App routes → Order history: routes to (evidence: `frontend/src/App.jsx`)
- App routes → Feedback operations: routes to (evidence: `frontend/src/App.jsx`)
- App routes → Admin login: routes to (evidence: `frontend/src/App.jsx`)
- Menu and checkout → API client: requests data (evidence: `frontend/src/customer/Home.jsx`)
- Menu management → API client: requests data (evidence: `frontend/src/admin/Admin.jsx`)
- Order operations → API client: requests data (evidence: `frontend/src/admin/Orders.jsx`)
- Feedback operations → API client: requests data (evidence: `frontend/src/admin/Feedbacks.jsx`)
- Admin login → API client: requests login (evidence: `frontend/src/admin/Login.jsx`)
- API client → HTTP and sockets: calls API
- HTTP and sockets → Menu routes: mounts (evidence: `server/server.js`)
- HTTP and sockets → Order routes: mounts (evidence: `server/server.js`)
- HTTP and sockets → Feedback routes: mounts (evidence: `server/server.js`)
- HTTP and sockets → Payment routes: mounts (evidence: `server/server.js`)
- HTTP and sockets → Admin auth routes: mounts (evidence: `server/server.js`)
- HTTP and sockets → Customer auth routes: mounts (evidence: `server/server.js`)
- Menu routes → Menu controller: dispatches (evidence: `server/routes/itemRoutes.js`)
- Order routes → Order controller: dispatches (evidence: `server/routes/orderRoutes.js`)
- Feedback routes → Feedback controller: dispatches (evidence: `server/routes/feedbackRoutes.js`)
- Payment routes → Payment controller: dispatches (evidence: `server/routes/paymentRoutes.js`)
- Admin auth routes → Admin authentication: dispatches (evidence: `server/routes/authRoutes.js`)
- Customer auth routes → Customer authentication: dispatches (evidence: `server/routes/userAuthRoutes.js`)
- Menu routes → Admin guard: protects writes (evidence: `server/routes/itemRoutes.js`)
- Order routes → Admin guard: protects admin routes (evidence: `server/routes/orderRoutes.js`)
- Order routes → Customer guard: protects customer routes (evidence: `server/routes/orderRoutes.js`)
- Feedback routes → Admin guard: protects admin routes (evidence: `server/routes/feedbackRoutes.js`)
- Feedback routes → Customer guard: protects customer routes (evidence: `server/routes/feedbackRoutes.js`)
- Payment routes → Customer guard: protects payments (evidence: `server/routes/paymentRoutes.js`)
- Menu routes → Request validation: validates input (evidence: `server/routes/itemRoutes.js`)
- Order routes → Request validation: validates input (evidence: `server/routes/orderRoutes.js`)
- Payment routes → Request validation: validates input (evidence: `server/routes/paymentRoutes.js`)
- Menu controller → Menu records: reads and writes (evidence: `server/controllers/itemController.js`)
- Order controller → Order records: reads and writes (evidence: `server/controllers/orderController.js`)
- Feedback controller → Customer records: reads customer (evidence: `server/controllers/feedbackController.js`)
- Admin guard → Admin records: checks admin (evidence: `server/middleware/authMiddleware.js`)
- Customer guard → Customer records: checks customer (evidence: `server/middleware/customerAuthMiddleware.js`)
- Payment controller → Menu records: reserves stock (evidence: `server/controllers/paymentController.js`)
- Payment controller → Payment reservations: records reservation (evidence: `server/controllers/paymentController.js`)
- Payment controller → Customer records: loads customer (evidence: `server/controllers/paymentController.js`)
- Payment controller → Order records: creates order (evidence: `server/controllers/paymentController.js`)
- Payment controller → Admin records: notifies admins
