How mkmathepe/shishapos works
The Chill Pipe POS is a browser-based point-of-sale and lounge-management application. Staff sign in, record pipe and refill sales, and track delivery; managers and admins also manage stock, expenses, shift reviews, and business performance, with admin-only settings and staff permissions. The React app is the principal workflow orchestrator, while database helpers and domain models provide a useful internal layer. The graph combines README-documented capabilities with shown imports and calls; several feature details and their internal connections are unsampled, so those relationships are omitted.
Main entry points: App.jsx POS application · db.js POS data access · StockTaking.jsx Stock management · supabase.js Supabase client
Components 24
App runtime
- POS application
src/App.jsx - Authentication
src/auth.js - Supabase client
src/supabase.js - Supabase data service
- Staff and permissions
supabase/functions/manage-pos-user/index.ts
Sales operations
- Order entry and delivery
src/App.jsx - Sale persistence
src/salePersistence.js - POS data access
src/db.js - Offline order queue
src/offlineOrders.js - Selling data cache
src/sellingCache.js
Inventory operations
- Stock management
src/StockTaking.jsx - Stock count model
src/stockTakingModel.js - Stock item photos
src/StockItemPhoto.jsx
Finance and review
- Expense management
src/ExpensesList.jsx - Receipt selection
src/ReceiptPicker.jsx - Shift review
src/ShiftReview.jsx - Shift review calculations
src/shiftReviewModel.js - Shift review data access
src/shiftReviewDb.js
Management insights
- Management overview
src/ManagementOverview.jsx - Sales performance
src/SalesPerformance.jsx - Performance calculations
src/overviewModel.js - Monthly reporting
src/MonthlyWeeks.jsx - Profit growth
src/ProfitGrowth.jsx
Other components
- Staff user
Connections 29
- Staff user → POS application: uses
README.md - POS application → Authentication: signs in
src/App.jsx - POS application → Order entry and delivery: orchestrates
README.md - POS application → Stock management: renders
src/App.jsx - POS application → Expense management: renders
src/App.jsx - POS application → Offline order queue: syncs queued sales
src/App.jsx - POS application → Selling data cache: caches selling data
src/App.jsx - POS application → POS data access: fetches stock
src/App.jsx - Order entry and delivery → POS data access: records orders
src/App.jsx - POS data access → Sale persistence: builds sale payload
src/db.js - POS data access → Supabase client: writes and reads
src/db.js - Supabase client → Supabase data service: connects to
src/supabase.js - POS data access → Selling data cache: caches stock
src/db.js - Offline order queue → Supabase data service: syncs when online
- Stock management → Stock count model: builds count data
src/StockTaking.jsx - Stock management → Stock item photos: renders photos
src/StockTaking.jsx - Stock management → Supabase client: records stocktakes
src/StockTaking.jsx - Expense management → Receipt selection: collects receipts
- POS application → Receipt selection: renders
src/App.jsx - Shift review → Shift review calculations: calculates review
src/ShiftReview.jsx - Shift review → Shift review data access: loads and saves
src/ShiftReview.jsx - Shift review data access → Supabase client: reads and writes
src/shiftReviewDb.js - Management overview → Sales performance: presents performance
src/ManagementOverview.jsx - Management overview → Monthly reporting: shows monthly periods
src/ManagementOverview.jsx - Sales performance → Performance calculations: calculates metrics
src/SalesPerformance.jsx - Sales performance → Profit growth: shows growth
src/SalesPerformance.jsx - Monthly reporting → Performance calculations: uses period data
src/MonthlyWeeks.jsx - Management overview → POS data access: loads management data
src/ManagementOverview.jsx - POS application → Staff and permissions: manages staff