How pplcallmesk-15/grocery-pos-desktop works
This is an offline-first grocery POS and inventory desktop application. The main workflow is a cashier scanning products into a cart, completing a bill with cash or dynamic UPI payment, and retaining sales and stock data locally. The application also covers purchasing, customer accounts, returns, branch and staff operations, reporting, and recovery. The graph reflects the documented capabilities and the sampled import wiring; several view-to-storage interactions are inferred only where the source index names the dependency, so those edges are dashed.
Main entry points: App.tsx App controller · sqliteStorage.ts Local data store · POSBillingView.tsx POS billing · SmartReorderView.tsx Smart reordering
Components 22
Application Shell
- React renderer
src/main.tsx - App controller
src/App.tsx - Navigation
src/components/Sidebar.tsx - Dashboard
src/components/DashboardView.tsx
Sales and Payments
- POS billing
src/components/POSBillingView.tsx - Camera scanner
src/components/CameraScannerModal.tsx - Invoice and receipt
src/components/InvoiceModal.tsx - UPI payment UI
src/components/UPIPaymentModal.tsx - UPI QR service
src/services/paymentService.ts
Inventory and Operations
- Product management
src/components/ProductManagementView.tsx - Incoming stock
src/components/IncomingStockView.tsx - Purchase orders
src/components/PurchaseOrderView.tsx - Supplier management
src/components/SupplierManagementView.tsx - Smart reordering
src/components/SmartReorderView.tsx - Branch management
src/components/BranchManagementView.tsx
Records and Recovery
- Customer ledger
src/components/CustomerManagementView.tsx - Returns and exchanges
src/components/ReturnsExchangesView.tsx - Reports
src/components/ReportsView.tsx - Backup and restore
src/components/BackupRestoreView.tsx - Local data store
src/db/sqliteStorage.ts
Other components
- Store staff
- Gemini AI
Connections 32
- Store staff → React renderer: uses
README.md - React renderer → App controller: renders
src/main.tsx - App controller → Navigation: renders
src/App.tsx - App controller → Dashboard: selects view
src/App.tsx - App controller → POS billing: selects view
src/App.tsx - App controller → Local data store: loads and updates
src/App.tsx - POS billing → Camera scanner: opens
README.md - POS billing → UPI payment UI: opens
src/components/POSBillingView.tsx - POS billing → UPI QR service: generates payment QR
src/components/POSBillingView.tsx - UPI payment UI → UPI QR service: generates QR
src/components/UPIPaymentModal.tsx - POS billing → Local data store: reads and writes
src/components/POSBillingView.tsx - POS billing → Invoice and receipt: prints bill
README.md - App controller → Product management: selects view
src/App.tsx - App controller → Incoming stock: selects view
src/App.tsx - App controller → Purchase orders: selects view
src/App.tsx - App controller → Supplier management: selects view
src/App.tsx - App controller → Smart reordering: selects view
src/App.tsx - App controller → Branch management: selects view
src/App.tsx - App controller → Customer ledger: selects view
src/App.tsx - App controller → Returns and exchanges: selects view
src/App.tsx - App controller → Reports: selects view
src/App.tsx - App controller → Backup and restore: selects view
src/App.tsx - Product management → Local data store: uses data store
src/components/ProductManagementView.tsx - Incoming stock → Local data store: uses data store
src/components/IncomingStockView.tsx - Purchase orders → Local data store: uses data store
src/components/PurchaseOrderView.tsx - Supplier management → Local data store: uses data store
src/components/SupplierManagementView.tsx - Smart reordering → Local data store: uses data store
src/components/SmartReorderView.tsx - Branch management → Local data store: uses data store
src/components/BranchManagementView.tsx - Customer ledger → Local data store: uses data store
src/components/CustomerManagementView.tsx - Returns and exchanges → Local data store: uses data store
src/components/ReturnsExchangesView.tsx - Backup and restore → Local data store: backs up and restores
README.md - Smart reordering → Gemini AI: analyzes demand
README.md