How team-collabrate/kumbakonam works
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: WorkerHome.tsx Worker POS · config.ts Firebase · useOrderSubmit.ts Order Submit · OwnerHome.tsx Owner App
Components 32
Worker Checkout
- Worker POS
worker-app/src/pages/WorkerHome.tsx - Menu Browse
worker-app/src/hooks/useMenu.ts - Cart
worker-app/src/hooks/useCart.ts - Order Submit
worker-app/src/hooks/useOrderSubmit.ts - Shift Name
worker-app/src/hooks/useActiveWorkerName.ts
Owner Operations
- Owner App
owner-app/src/pages/OwnerHome.tsx - Dashboard
owner-app/src/pages/DashboardScreen.tsx - Owner Reports
owner-app/src/pages/ReportsScreen.tsx - Menu Management
owner-app/src/pages/MenuScreen.tsx - Date Ranges
owner-app/src/utils/dateRange.ts
Sales Reporting
- Reports App
reports-app/src/pages/ItemSalesReport.tsx - Sales Report
reports-app/src/components/SalesSection.tsx - Expense Report
reports-app/src/components/ExpensesSection.tsx - Loan Report
reports-app/src/components/LoanSection.tsx - Item Sales Logic
reports-app/src/utils/itemSalesReport.ts - Loan Logic
reports-app/src/utils/loanReport.ts - Day Labels
reports-app/src/utils/dayLabels.ts
Shared Services
- Customer Credit
shared/src/services/customers.service.ts - Order Records
shared/src/services/orders.service.ts - Expenses
shared/src/services/expenses.service.ts - Menu Service
shared/src/services/menu.service.ts - Daily Summaries
shared/src/services/dailySummary.service.ts - Firebase
shared/src/firebase/config.ts - PIN Sessions
shared/src/auth/session.tsx
Receipt Printing
- Printer Control
worker-app/src/hooks/usePrinter.ts - Receipt Data
worker-app/src/printing/receipt.ts - Receipt Rendering
worker-app/src/printing/receiptCanvas.ts - Bluetooth Output
worker-app/src/printing/webBluetoothPrinter.ts - Classic Printer
worker-app/src/printing/classicBluetoothPrinter.ts
Other components
- Counter Staff
- Owner
- Report User
Connections 38
- Counter Staff → Worker POS: uses
- Worker POS → Menu Browse: loads
worker-app/src/pages/WorkerHome.tsx - Worker POS → Cart: uses
worker-app/src/pages/WorkerHome.tsx - Worker POS → Shift Name: selects
worker-app/src/pages/WorkerHome.tsx - Worker POS → Order Submit: submits via
worker-app/src/pages/WorkerHome.tsx - Order Submit → Cart: reads
worker-app/src/hooks/useOrderSubmit.ts - Order Submit → Order Records: creates order
worker-app/src/hooks/useOrderSubmit.ts - Order Submit → Customer Credit: adjusts balance
worker-app/src/hooks/useOrderSubmit.ts - Worker POS → Customer Credit: finds credit customer
worker-app/src/pages/WorkerHome.tsx - Worker POS → Printer Control: controls printing
worker-app/src/pages/WorkerHome.tsx - Worker POS → Receipt Rendering: renders retry bill
worker-app/src/pages/WorkerHome.tsx - Printer Control → Bluetooth Output: prints via
worker-app/src/hooks/usePrinter.ts - Printer Control → Classic Printer: prints via
worker-app/src/hooks/usePrinter.ts - Receipt Rendering → Receipt Data: uses receipt data
worker-app/src/printing/receiptCanvas.ts - Owner → Owner App: uses
- Owner App → Dashboard: shows
owner-app/src/pages/OwnerHome.tsx - Owner App → Owner Reports: shows
owner-app/src/pages/OwnerHome.tsx - Owner App → Menu Management: shows
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
reports-app/src/pages/ItemSalesReport.tsx - Reports App → Expense Report: shows
reports-app/src/pages/ItemSalesReport.tsx - Reports App → Loan Report: shows
reports-app/src/pages/ItemSalesReport.tsx - Loan Report → Loan Logic: uses
reports-app/src/components/LoanSection.tsx - Loan Report → Item Sales Logic: uses
reports-app/src/components/LoanSection.tsx - Item Sales Logic → Day Labels: uses
reports-app/src/utils/itemSalesReport.ts - Loan Logic → Day Labels: uses
reports-app/src/utils/loanReport.ts - Order Records → Firebase: reads/writes
shared/src/services/orders.service.ts - Customer Credit → Firebase: reads/writes
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
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