# mariaisabellafrancisco11037/cafekiosk architecture

> Architecture diagram of the GitHub repository mariaisabellafrancisco11037/cafekiosk, 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/mariaisabellafrancisco11037/cafekiosk
- Repository: https://github.com/mariaisabellafrancisco11037/cafekiosk

## Overview

CafeKiosk is a cafe point-of-sale and self-service kiosk product with staff, manager, cafe-admin, and system-admin operations. A customer or cashier submits an order through the kiosk/POS experience; the backend order controller normalizes and stores it, handles inventory effects, and emits order updates. Other major branches cover authentication and account administration, catalog/menu availability, inventory and recipes, promotions, purchasing/suppliers, reporting, audit, and kiosk access. The source index and excerpts support selected relationships; unsampled capabilities are represented at their exact route or frontend directory, with uncertain links omitted.

Main entry points: [`CafeKiosk-Backend/server.js`](https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/server.js) (HTTP / socket server), [`CafeKiosk-Backend/controllers/orderController.js`](https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/controllers/orderController.js) (Order processing), [`CafeKiosk-Backend/config/dbPool.js`](https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/config/dbPool.js) (MySQL database), [`CafeKiosk-Backend/routes/auth.js`](https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/routes/auth.js) (Authentication routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_front["Kiosk And Staff UI"]
  node_kioskui["Kiosk ordering"]
  node_posui["POS terminal"]
  node_managerui["Manager tools"]
  node_adminui["Cafe admin"]
  node_sysui["System admin<br/>[dashboard.php]"]
  node_orderui["Order queue / monitor<br/>[order-queue.php]"]
end

subgraph group_orders["Orders And Fulfillment"]
  node_staffdash["Staff dashboard"]
  node_ordercontroller["Order processing<br/>[orderController.js]"]
  node_normalizer["Order normalization<br/>[orderNormalizer.js]"]
  node_orderstore["Order persistence<br/>[orderStore.js]"]
  node_queue["Order queue state<br/>[orderQueue.js]"]
end

subgraph group_catalog["Cafe Operations"]
  node_catalogroutes["Catalog and menu<br/>[catalog.js]"]
  node_availability["Menu availability"]
  node_inventory["Recipe inventory"]
  node_inventoryroutes["Inventory operations<br/>[inventory.js]"]
  node_promotions["Promotion rules<br/>[promotionEngine.js]"]
  node_purchasing["Purchasing and suppliers<br/>[purchase.js]"]
end

subgraph group_identity["Identity And Oversight"]
  node_authroutes["Authentication routes<br/>[auth.js]"]
  node_authctrl["Authentication logic<br/>[authController.js]"]
  node_authmw["Session authorization<br/>[authMiddleware.js]"]
  node_sessions["Login sessions"]
  node_systemadmin["System administration<br/>[systemAdmin.js]"]
  node_audit["Audit history<br/>[auditLogStore.js]"]
end

subgraph group_core["Backend Runtime"]
  node_server["HTTP / socket server<br/>[server.js]"]
  node_kioskaccess["Kiosk access links"]
  node_database[("MySQL database<br/>[dbPool.js]")]
end

node_customer(("Kiosk customer"))
node_cashier(("Cashier / staff"))

node_server -->|"mounts routes"| node_authroutes
node_authroutes -->|"dispatches"| node_authctrl
node_authroutes -->|"guards routes"| node_authmw
node_authctrl -->|"creates sessions"| node_sessions
node_authctrl -->|"records activity"| node_audit
node_authmw -->|"checks accounts"| node_database
node_sessions -->|"persists sessions"| node_database
node_server -->|"mounts routes"| node_systemadmin
node_systemadmin -->|"manages kiosk access"| node_kioskaccess
node_systemadmin -->|"records actions"| node_audit
node_audit -->|"reads / writes"| node_database
node_customer -.->|"browses and orders"| node_kioskui
node_cashier -.->|"enters orders"| node_posui
node_kioskui -.->|"submits orders"| node_server
node_posui -.->|"submits orders"| node_server
node_server -.->|"routes orders"| node_ordercontroller
node_ordercontroller -->|"normalizes"| node_normalizer
node_ordercontroller -->|"reads / writes orders"| node_orderstore
node_ordercontroller -->|"reserves / reconciles stock"| node_inventory
node_ordercontroller -->|"validates kiosk"| node_kioskaccess
node_ordercontroller -.->|"updates queue"| node_queue
node_ordercontroller -->|"emits updates"| node_server
node_orderstore -.->|"persists orders"| node_database
node_inventory -->|"persists stock"| node_database
node_kioskaccess -->|"stores kiosk links"| node_database
node_server -.->|"mounts routes"| node_catalogroutes
node_server -.->|"mounts routes"| node_inventoryroutes
node_server -.->|"mounts dashboard"| node_staffdash
node_staffdash -->|"queries dashboard data"| node_database
node_inventoryroutes -.->|"exposes availability"| node_availability
node_orderui -.->|"monitors orders"| node_server
node_adminui -.->|"uses operations APIs"| node_server
node_managerui -.->|"uses staff APIs"| node_server
node_sysui -.->|"uses admin APIs"| node_server
node_catalogroutes -.->|"applies promotions"| node_promotions
node_purchasing -.->|"updates ingredients"| node_inventory

click node_kioskui "https://github.com/mariaisabellafrancisco11037/cafekiosk/tree/main/CafeKiosk-Frontend/Kiosk"
click node_posui "https://github.com/mariaisabellafrancisco11037/cafekiosk/tree/main/CafeKiosk-Frontend/pos"
click node_managerui "https://github.com/mariaisabellafrancisco11037/cafekiosk/tree/main/CafeKiosk-Frontend/Manager"
click node_adminui "https://github.com/mariaisabellafrancisco11037/cafekiosk/tree/main/CafeKiosk-Frontend/Admin"
click node_sysui "https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Frontend/SystemAdmin/dashboard.php"
click node_server "https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/server.js"
click node_authroutes "https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/routes/auth.js"
click node_authctrl "https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/controllers/authController.js"
click node_authmw "https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/middleware/authMiddleware.js"
click node_sessions "https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/services/authSessionService.js"
click node_systemadmin "https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/routes/systemAdmin.js"
click node_audit "https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/services/auditLogStore.js"
click node_catalogroutes "https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/routes/catalog.js"
click node_availability "https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/controllers/menuAvailabilityController.js"
click node_inventory "https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/services/recipeInventoryStore.js"
click node_inventoryroutes "https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/routes/inventory.js"
click node_promotions "https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/services/promotionEngine.js"
click node_purchasing "https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/routes/purchase.js"
click node_staffdash "https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/controllers/staffDashboardController.js"
click node_orderui "https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Frontend/Manager/order-queue.php"
click node_ordercontroller "https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/controllers/orderController.js"
click node_normalizer "https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/utils/orderNormalizer.js"
click node_orderstore "https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/services/orderStore.js"
click node_queue "https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/data/orderQueue.js"
click node_kioskaccess "https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/services/kioskAccessStore.js"
click node_database "https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/config/dbPool.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_kioskui,node_posui,node_managerui,node_adminui,node_sysui,node_orderui toneBlue
class node_staffdash,node_ordercontroller,node_normalizer,node_orderstore,node_queue toneAmber
class node_catalogroutes,node_availability,node_inventory,node_inventoryroutes,node_promotions,node_purchasing toneMint
class node_authroutes,node_authctrl,node_authmw,node_sessions,node_systemadmin,node_audit toneRose
class node_server,node_kioskaccess,node_database,node_customer,node_cashier toneIndigo
```

## Components

### Kiosk And Staff UI

- [Kiosk ordering](https://github.com/mariaisabellafrancisco11037/cafekiosk/tree/main/CafeKiosk-Frontend/Kiosk): `CafeKiosk-Frontend/Kiosk`
- [POS terminal](https://github.com/mariaisabellafrancisco11037/cafekiosk/tree/main/CafeKiosk-Frontend/pos): `CafeKiosk-Frontend/pos`
- [Manager tools](https://github.com/mariaisabellafrancisco11037/cafekiosk/tree/main/CafeKiosk-Frontend/Manager): `CafeKiosk-Frontend/Manager`
- [Cafe admin](https://github.com/mariaisabellafrancisco11037/cafekiosk/tree/main/CafeKiosk-Frontend/Admin): `CafeKiosk-Frontend/Admin`
- [System admin](https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Frontend/SystemAdmin/dashboard.php): `CafeKiosk-Frontend/SystemAdmin/dashboard.php`
- [Order queue / monitor](https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Frontend/Manager/order-queue.php): `CafeKiosk-Frontend/Manager/order-queue.php`

### Orders And Fulfillment

- [Staff dashboard](https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/controllers/staffDashboardController.js): `CafeKiosk-Backend/controllers/staffDashboardController.js`
- [Order processing](https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/controllers/orderController.js): `CafeKiosk-Backend/controllers/orderController.js`
- [Order normalization](https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/utils/orderNormalizer.js): `CafeKiosk-Backend/utils/orderNormalizer.js`
- [Order persistence](https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/services/orderStore.js): `CafeKiosk-Backend/services/orderStore.js`
- [Order queue state](https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/data/orderQueue.js): `CafeKiosk-Backend/data/orderQueue.js`

### Cafe Operations

- [Catalog and menu](https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/routes/catalog.js): `CafeKiosk-Backend/routes/catalog.js`
- [Menu availability](https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/controllers/menuAvailabilityController.js): `CafeKiosk-Backend/controllers/menuAvailabilityController.js`
- [Recipe inventory](https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/services/recipeInventoryStore.js): `CafeKiosk-Backend/services/recipeInventoryStore.js`
- [Inventory operations](https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/routes/inventory.js): `CafeKiosk-Backend/routes/inventory.js`
- [Promotion rules](https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/services/promotionEngine.js): `CafeKiosk-Backend/services/promotionEngine.js`
- [Purchasing and suppliers](https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/routes/purchase.js): `CafeKiosk-Backend/routes/purchase.js`

### Identity And Oversight

- [Authentication routes](https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/routes/auth.js): `CafeKiosk-Backend/routes/auth.js`
- [Authentication logic](https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/controllers/authController.js): `CafeKiosk-Backend/controllers/authController.js`
- [Session authorization](https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/middleware/authMiddleware.js): `CafeKiosk-Backend/middleware/authMiddleware.js`
- [Login sessions](https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/services/authSessionService.js): `CafeKiosk-Backend/services/authSessionService.js`
- [System administration](https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/routes/systemAdmin.js): `CafeKiosk-Backend/routes/systemAdmin.js`
- [Audit history](https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/services/auditLogStore.js): `CafeKiosk-Backend/services/auditLogStore.js`

### Backend Runtime

- [HTTP / socket server](https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/server.js): `CafeKiosk-Backend/server.js`
- [Kiosk access links](https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/services/kioskAccessStore.js): `CafeKiosk-Backend/services/kioskAccessStore.js`
- [MySQL database](https://github.com/mariaisabellafrancisco11037/cafekiosk/blob/main/CafeKiosk-Backend/config/dbPool.js): `CafeKiosk-Backend/config/dbPool.js`

### Other components

- **Kiosk customer**
- **Cashier / staff**

## Connections

- HTTP / socket server → Authentication routes: mounts routes (evidence: `CafeKiosk-Backend/server.js`)
- Authentication routes → Authentication logic: dispatches (evidence: `CafeKiosk-Backend/routes/auth.js`)
- Authentication routes → Session authorization: guards routes (evidence: `CafeKiosk-Backend/routes/auth.js`)
- Authentication logic → Login sessions: creates sessions (evidence: `CafeKiosk-Backend/controllers/authController.js`)
- Authentication logic → Audit history: records activity (evidence: `CafeKiosk-Backend/controllers/authController.js`)
- Session authorization → MySQL database: checks accounts (evidence: `CafeKiosk-Backend/middleware/authMiddleware.js`)
- Login sessions → MySQL database: persists sessions (evidence: `CafeKiosk-Backend/services/authSessionService.js`)
- HTTP / socket server → System administration: mounts routes (evidence: `CafeKiosk-Backend/server.js`)
- System administration → Kiosk access links: manages kiosk access (evidence: `CafeKiosk-Backend/routes/systemAdmin.js`)
- System administration → Audit history: records actions (evidence: `CafeKiosk-Backend/routes/systemAdmin.js`)
- Audit history → MySQL database: reads / writes (evidence: `CafeKiosk-Backend/services/auditLogStore.js`)
- Kiosk customer → Kiosk ordering: browses and orders
- Cashier / staff → POS terminal: enters orders
- Kiosk ordering → HTTP / socket server: submits orders
- POS terminal → HTTP / socket server: submits orders
- HTTP / socket server → Order processing: routes orders
- Order processing → Order normalization: normalizes (evidence: `CafeKiosk-Backend/controllers/orderController.js`)
- Order processing → Order persistence: reads / writes orders (evidence: `CafeKiosk-Backend/controllers/orderController.js`)
- Order processing → Recipe inventory: reserves / reconciles stock (evidence: `CafeKiosk-Backend/controllers/orderController.js`)
- Order processing → Kiosk access links: validates kiosk (evidence: `CafeKiosk-Backend/controllers/orderController.js`)
- Order processing → Order queue state: updates queue
- Order processing → HTTP / socket server: emits updates (evidence: `CafeKiosk-Backend/controllers/orderController.js`)
- Order persistence → MySQL database: persists orders
- Recipe inventory → MySQL database: persists stock (evidence: `CafeKiosk-Backend/services/recipeInventoryStore.js`)
- Kiosk access links → MySQL database: stores kiosk links (evidence: `CafeKiosk-Backend/services/kioskAccessStore.js`)
- HTTP / socket server → Catalog and menu: mounts routes (evidence: `CafeKiosk-Backend/server.js`)
- HTTP / socket server → Inventory operations: mounts routes (evidence: `CafeKiosk-Backend/server.js`)
- HTTP / socket server → Staff dashboard: mounts dashboard
- Staff dashboard → MySQL database: queries dashboard data (evidence: `CafeKiosk-Backend/controllers/staffDashboardController.js`)
- Inventory operations → Menu availability: exposes availability
- Order queue / monitor → HTTP / socket server: monitors orders
- Cafe admin → HTTP / socket server: uses operations APIs
- Manager tools → HTTP / socket server: uses staff APIs
- System admin → HTTP / socket server: uses admin APIs
- Catalog and menu → Promotion rules: applies promotions
- Purchasing and suppliers → Recipe inventory: updates ingredients
