# team-collabrate/kumbakonam architecture

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

- Interactive diagram: https://gitdiagram.com/team-collabrate/kumbakonam
- Repository: https://github.com/team-collabrate/kumbakonam

## Overview

Kumbakonam POS is a cafe point-of-sale system with distinct worker checkout/receipt printing, owner operations dashboard, and sales reporting apps sharing authentication and Firebase-backed business services. The main workflow is staff selecting menu items, building a cart, submitting an order (including credit handling), and optionally printing a receipt; owners and reports users inspect the resulting sales, expenses, menu and customer balances. Edges rely on source-index references, excerpts, or documented workflow. Several substantial screens and report capabilities are represented from the tree/index; unsampled internal calls are not asserted.

Main entry points: [`worker-app/src/pages/WorkerHome.tsx`](https://github.com/team-collabrate/kumbakonam/blob/main/worker-app/src/pages/WorkerHome.tsx) (Worker POS), [`shared/src/firebase/config.ts`](https://github.com/team-collabrate/kumbakonam/blob/main/shared/src/firebase/config.ts) (Firebase), [`worker-app/src/hooks/useOrderSubmit.ts`](https://github.com/team-collabrate/kumbakonam/blob/main/worker-app/src/hooks/useOrderSubmit.ts) (Order Submit), [`owner-app/src/pages/OwnerHome.tsx`](https://github.com/team-collabrate/kumbakonam/blob/main/owner-app/src/pages/OwnerHome.tsx) (Owner App)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_checkout["Worker Checkout"]
  node_worker["Worker POS<br/>[WorkerHome.tsx]"]
  node_menu["Menu Browse<br/>[useMenu.ts]"]
  node_cart["Cart<br/>[useCart.ts]"]
  node_order_submit["Order Submit<br/>[useOrderSubmit.ts]"]
  node_worker_name["Shift Name"]
end

subgraph group_owner["Owner Operations"]
  node_owner_home["Owner App<br/>[OwnerHome.tsx]"]
  node_dashboard["Dashboard"]
  node_owner_reports["Owner Reports<br/>[ReportsScreen.tsx]"]
  node_owner_menu["Menu Management<br/>[MenuScreen.tsx]"]
  node_date_range["Date Ranges<br/>[dateRange.ts]"]
end

subgraph group_reports["Sales Reporting"]
  node_reports_app["Reports App"]
  node_sales_section["Sales Report<br/>[SalesSection.tsx]"]
  node_expenses_section["Expense Report"]
  node_loan_section["Loan Report<br/>[LoanSection.tsx]"]
  node_item_sales["Item Sales Logic<br/>[itemSalesReport.ts]"]
  node_loan_logic["Loan Logic<br/>[loanReport.ts]"]
  node_day_labels["Day Labels<br/>[dayLabels.ts]"]
end

subgraph group_shared["Shared Services"]
  node_customers["Customer Credit"]
  node_orders["Order Records<br/>[orders.service.ts]"]
  node_expenses["Expenses"]
  node_menu_service["Menu Service<br/>[menu.service.ts]"]
  node_daily_summary["Daily Summaries"]
  node_firebase[("Firebase<br/>[config.ts]")]
  node_auth["PIN Sessions<br/>[session.tsx]"]
end

subgraph group_printing["Receipt Printing"]
  node_printing_hook["Printer Control<br/>[usePrinter.ts]"]
  node_receipt["Receipt Data<br/>[receipt.ts]"]
  node_receipt_canvas["Receipt Rendering<br/>[receiptCanvas.ts]"]
  node_bluetooth["Bluetooth Output"]
  node_classic_bluetooth["Classic Printer"]
end

node_staff(("Counter Staff"))
node_owner_user(("Owner"))
node_report_user(("Report User"))

node_staff -->|"uses"| node_worker
node_worker -->|"loads"| node_menu
node_worker -->|"uses"| node_cart
node_worker -->|"selects"| node_worker_name
node_worker -->|"submits via"| node_order_submit
node_order_submit -->|"reads"| node_cart
node_order_submit -->|"creates order"| node_orders
node_order_submit -->|"adjusts balance"| node_customers
node_worker -->|"finds credit customer"| node_customers
node_worker -->|"controls printing"| node_printing_hook
node_worker -->|"renders retry bill"| node_receipt_canvas
node_printing_hook -->|"prints via"| node_bluetooth
node_printing_hook -->|"prints via"| node_classic_bluetooth
node_receipt_canvas -->|"uses receipt data"| node_receipt
node_owner_user -->|"uses"| node_owner_home
node_owner_home -->|"shows"| node_dashboard
node_owner_home -->|"shows"| node_owner_reports
node_owner_home -->|"shows"| node_owner_menu
node_dashboard -.->|"uses"| node_date_range
node_owner_reports -.->|"uses"| node_date_range
node_report_user -->|"uses"| node_reports_app
node_reports_app -->|"shows"| node_sales_section
node_reports_app -->|"shows"| node_expenses_section
node_reports_app -->|"shows"| node_loan_section
node_loan_section -->|"uses"| node_loan_logic
node_loan_section -->|"uses"| node_item_sales
node_item_sales -->|"uses"| node_day_labels
node_loan_logic -->|"uses"| node_day_labels
node_orders -->|"reads/writes"| node_firebase
node_customers -->|"reads/writes"| node_firebase
node_expenses -.->|"reads/writes"| node_firebase
node_menu_service -.->|"reads/writes"| node_firebase
node_daily_summary -.->|"reads/writes"| node_firebase
node_auth -->|"initializes session"| node_firebase
node_owner_reports -.->|"reads sales"| node_orders
node_dashboard -.->|"reads order data"| node_orders
node_owner_menu -.->|"manages menu"| node_menu_service
node_expenses_section -.->|"reports expenses"| node_expenses

click node_worker "https://github.com/team-collabrate/kumbakonam/blob/main/worker-app/src/pages/WorkerHome.tsx"
click node_menu "https://github.com/team-collabrate/kumbakonam/blob/main/worker-app/src/hooks/useMenu.ts"
click node_cart "https://github.com/team-collabrate/kumbakonam/blob/main/worker-app/src/hooks/useCart.ts"
click node_order_submit "https://github.com/team-collabrate/kumbakonam/blob/main/worker-app/src/hooks/useOrderSubmit.ts"
click node_worker_name "https://github.com/team-collabrate/kumbakonam/blob/main/worker-app/src/hooks/useActiveWorkerName.ts"
click node_customers "https://github.com/team-collabrate/kumbakonam/blob/main/shared/src/services/customers.service.ts"
click node_orders "https://github.com/team-collabrate/kumbakonam/blob/main/shared/src/services/orders.service.ts"
click node_expenses "https://github.com/team-collabrate/kumbakonam/blob/main/shared/src/services/expenses.service.ts"
click node_menu_service "https://github.com/team-collabrate/kumbakonam/blob/main/shared/src/services/menu.service.ts"
click node_daily_summary "https://github.com/team-collabrate/kumbakonam/blob/main/shared/src/services/dailySummary.service.ts"
click node_firebase "https://github.com/team-collabrate/kumbakonam/blob/main/shared/src/firebase/config.ts"
click node_auth "https://github.com/team-collabrate/kumbakonam/blob/main/shared/src/auth/session.tsx"
click node_owner_home "https://github.com/team-collabrate/kumbakonam/blob/main/owner-app/src/pages/OwnerHome.tsx"
click node_dashboard "https://github.com/team-collabrate/kumbakonam/blob/main/owner-app/src/pages/DashboardScreen.tsx"
click node_owner_reports "https://github.com/team-collabrate/kumbakonam/blob/main/owner-app/src/pages/ReportsScreen.tsx"
click node_owner_menu "https://github.com/team-collabrate/kumbakonam/blob/main/owner-app/src/pages/MenuScreen.tsx"
click node_date_range "https://github.com/team-collabrate/kumbakonam/blob/main/owner-app/src/utils/dateRange.ts"
click node_reports_app "https://github.com/team-collabrate/kumbakonam/blob/main/reports-app/src/pages/ItemSalesReport.tsx"
click node_sales_section "https://github.com/team-collabrate/kumbakonam/blob/main/reports-app/src/components/SalesSection.tsx"
click node_expenses_section "https://github.com/team-collabrate/kumbakonam/blob/main/reports-app/src/components/ExpensesSection.tsx"
click node_loan_section "https://github.com/team-collabrate/kumbakonam/blob/main/reports-app/src/components/LoanSection.tsx"
click node_item_sales "https://github.com/team-collabrate/kumbakonam/blob/main/reports-app/src/utils/itemSalesReport.ts"
click node_loan_logic "https://github.com/team-collabrate/kumbakonam/blob/main/reports-app/src/utils/loanReport.ts"
click node_day_labels "https://github.com/team-collabrate/kumbakonam/blob/main/reports-app/src/utils/dayLabels.ts"
click node_printing_hook "https://github.com/team-collabrate/kumbakonam/blob/main/worker-app/src/hooks/usePrinter.ts"
click node_receipt "https://github.com/team-collabrate/kumbakonam/blob/main/worker-app/src/printing/receipt.ts"
click node_receipt_canvas "https://github.com/team-collabrate/kumbakonam/blob/main/worker-app/src/printing/receiptCanvas.ts"
click node_bluetooth "https://github.com/team-collabrate/kumbakonam/blob/main/worker-app/src/printing/webBluetoothPrinter.ts"
click node_classic_bluetooth "https://github.com/team-collabrate/kumbakonam/blob/main/worker-app/src/printing/classicBluetoothPrinter.ts"

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_worker,node_menu,node_cart,node_order_submit,node_worker_name,node_report_user toneBlue
class node_owner_home,node_dashboard,node_owner_reports,node_owner_menu,node_date_range toneAmber
class node_reports_app,node_sales_section,node_expenses_section,node_loan_section,node_item_sales,node_loan_logic,node_day_labels toneMint
class node_customers,node_orders,node_expenses,node_menu_service,node_daily_summary,node_firebase,node_auth toneRose
class node_printing_hook,node_receipt,node_receipt_canvas,node_bluetooth,node_classic_bluetooth,node_staff,node_owner_user toneIndigo
```

## Components

### Worker Checkout

- [Worker POS](https://github.com/team-collabrate/kumbakonam/blob/main/worker-app/src/pages/WorkerHome.tsx): `worker-app/src/pages/WorkerHome.tsx`
- [Menu Browse](https://github.com/team-collabrate/kumbakonam/blob/main/worker-app/src/hooks/useMenu.ts): `worker-app/src/hooks/useMenu.ts`
- [Cart](https://github.com/team-collabrate/kumbakonam/blob/main/worker-app/src/hooks/useCart.ts): `worker-app/src/hooks/useCart.ts`
- [Order Submit](https://github.com/team-collabrate/kumbakonam/blob/main/worker-app/src/hooks/useOrderSubmit.ts): `worker-app/src/hooks/useOrderSubmit.ts`
- [Shift Name](https://github.com/team-collabrate/kumbakonam/blob/main/worker-app/src/hooks/useActiveWorkerName.ts): `worker-app/src/hooks/useActiveWorkerName.ts`

### Owner Operations

- [Owner App](https://github.com/team-collabrate/kumbakonam/blob/main/owner-app/src/pages/OwnerHome.tsx): `owner-app/src/pages/OwnerHome.tsx`
- [Dashboard](https://github.com/team-collabrate/kumbakonam/blob/main/owner-app/src/pages/DashboardScreen.tsx): `owner-app/src/pages/DashboardScreen.tsx`
- [Owner Reports](https://github.com/team-collabrate/kumbakonam/blob/main/owner-app/src/pages/ReportsScreen.tsx): `owner-app/src/pages/ReportsScreen.tsx`
- [Menu Management](https://github.com/team-collabrate/kumbakonam/blob/main/owner-app/src/pages/MenuScreen.tsx): `owner-app/src/pages/MenuScreen.tsx`
- [Date Ranges](https://github.com/team-collabrate/kumbakonam/blob/main/owner-app/src/utils/dateRange.ts): `owner-app/src/utils/dateRange.ts`

### Sales Reporting

- [Reports App](https://github.com/team-collabrate/kumbakonam/blob/main/reports-app/src/pages/ItemSalesReport.tsx): `reports-app/src/pages/ItemSalesReport.tsx`
- [Sales Report](https://github.com/team-collabrate/kumbakonam/blob/main/reports-app/src/components/SalesSection.tsx): `reports-app/src/components/SalesSection.tsx`
- [Expense Report](https://github.com/team-collabrate/kumbakonam/blob/main/reports-app/src/components/ExpensesSection.tsx): `reports-app/src/components/ExpensesSection.tsx`
- [Loan Report](https://github.com/team-collabrate/kumbakonam/blob/main/reports-app/src/components/LoanSection.tsx): `reports-app/src/components/LoanSection.tsx`
- [Item Sales Logic](https://github.com/team-collabrate/kumbakonam/blob/main/reports-app/src/utils/itemSalesReport.ts): `reports-app/src/utils/itemSalesReport.ts`
- [Loan Logic](https://github.com/team-collabrate/kumbakonam/blob/main/reports-app/src/utils/loanReport.ts): `reports-app/src/utils/loanReport.ts`
- [Day Labels](https://github.com/team-collabrate/kumbakonam/blob/main/reports-app/src/utils/dayLabels.ts): `reports-app/src/utils/dayLabels.ts`

### Shared Services

- [Customer Credit](https://github.com/team-collabrate/kumbakonam/blob/main/shared/src/services/customers.service.ts): `shared/src/services/customers.service.ts`
- [Order Records](https://github.com/team-collabrate/kumbakonam/blob/main/shared/src/services/orders.service.ts): `shared/src/services/orders.service.ts`
- [Expenses](https://github.com/team-collabrate/kumbakonam/blob/main/shared/src/services/expenses.service.ts): `shared/src/services/expenses.service.ts`
- [Menu Service](https://github.com/team-collabrate/kumbakonam/blob/main/shared/src/services/menu.service.ts): `shared/src/services/menu.service.ts`
- [Daily Summaries](https://github.com/team-collabrate/kumbakonam/blob/main/shared/src/services/dailySummary.service.ts): `shared/src/services/dailySummary.service.ts`
- [Firebase](https://github.com/team-collabrate/kumbakonam/blob/main/shared/src/firebase/config.ts): `shared/src/firebase/config.ts`
- [PIN Sessions](https://github.com/team-collabrate/kumbakonam/blob/main/shared/src/auth/session.tsx): `shared/src/auth/session.tsx`

### Receipt Printing

- [Printer Control](https://github.com/team-collabrate/kumbakonam/blob/main/worker-app/src/hooks/usePrinter.ts): `worker-app/src/hooks/usePrinter.ts`
- [Receipt Data](https://github.com/team-collabrate/kumbakonam/blob/main/worker-app/src/printing/receipt.ts): `worker-app/src/printing/receipt.ts`
- [Receipt Rendering](https://github.com/team-collabrate/kumbakonam/blob/main/worker-app/src/printing/receiptCanvas.ts): `worker-app/src/printing/receiptCanvas.ts`
- [Bluetooth Output](https://github.com/team-collabrate/kumbakonam/blob/main/worker-app/src/printing/webBluetoothPrinter.ts): `worker-app/src/printing/webBluetoothPrinter.ts`
- [Classic Printer](https://github.com/team-collabrate/kumbakonam/blob/main/worker-app/src/printing/classicBluetoothPrinter.ts): `worker-app/src/printing/classicBluetoothPrinter.ts`

### Other components

- **Counter Staff**
- **Owner**
- **Report User**

## Connections

- Counter Staff → Worker POS: uses
- Worker POS → Menu Browse: loads (evidence: `worker-app/src/pages/WorkerHome.tsx`)
- Worker POS → Cart: uses (evidence: `worker-app/src/pages/WorkerHome.tsx`)
- Worker POS → Shift Name: selects (evidence: `worker-app/src/pages/WorkerHome.tsx`)
- Worker POS → Order Submit: submits via (evidence: `worker-app/src/pages/WorkerHome.tsx`)
- Order Submit → Cart: reads (evidence: `worker-app/src/hooks/useOrderSubmit.ts`)
- Order Submit → Order Records: creates order (evidence: `worker-app/src/hooks/useOrderSubmit.ts`)
- Order Submit → Customer Credit: adjusts balance (evidence: `worker-app/src/hooks/useOrderSubmit.ts`)
- Worker POS → Customer Credit: finds credit customer (evidence: `worker-app/src/pages/WorkerHome.tsx`)
- Worker POS → Printer Control: controls printing (evidence: `worker-app/src/pages/WorkerHome.tsx`)
- Worker POS → Receipt Rendering: renders retry bill (evidence: `worker-app/src/pages/WorkerHome.tsx`)
- Printer Control → Bluetooth Output: prints via (evidence: `worker-app/src/hooks/usePrinter.ts`)
- Printer Control → Classic Printer: prints via (evidence: `worker-app/src/hooks/usePrinter.ts`)
- Receipt Rendering → Receipt Data: uses receipt data (evidence: `worker-app/src/printing/receiptCanvas.ts`)
- Owner → Owner App: uses
- Owner App → Dashboard: shows (evidence: `owner-app/src/pages/OwnerHome.tsx`)
- Owner App → Owner Reports: shows (evidence: `owner-app/src/pages/OwnerHome.tsx`)
- Owner App → Menu Management: shows (evidence: `owner-app/src/pages/OwnerHome.tsx`)
- Dashboard → Date Ranges: uses
- Owner Reports → Date Ranges: uses
- Report User → Reports App: uses
- Reports App → Sales Report: shows (evidence: `reports-app/src/pages/ItemSalesReport.tsx`)
- Reports App → Expense Report: shows (evidence: `reports-app/src/pages/ItemSalesReport.tsx`)
- Reports App → Loan Report: shows (evidence: `reports-app/src/pages/ItemSalesReport.tsx`)
- Loan Report → Loan Logic: uses (evidence: `reports-app/src/components/LoanSection.tsx`)
- Loan Report → Item Sales Logic: uses (evidence: `reports-app/src/components/LoanSection.tsx`)
- Item Sales Logic → Day Labels: uses (evidence: `reports-app/src/utils/itemSalesReport.ts`)
- Loan Logic → Day Labels: uses (evidence: `reports-app/src/utils/loanReport.ts`)
- Order Records → Firebase: reads/writes (evidence: `shared/src/services/orders.service.ts`)
- Customer Credit → Firebase: reads/writes (evidence: `shared/src/services/customers.service.ts`)
- Expenses → Firebase: reads/writes
- Menu Service → Firebase: reads/writes
- Daily Summaries → Firebase: reads/writes
- PIN Sessions → Firebase: initializes session (evidence: `shared/src/auth/session.tsx`)
- Owner Reports → Order Records: reads sales
- Dashboard → Order Records: reads order data
- Menu Management → Menu Service: manages menu
- Expense Report → Expenses: reports expenses
