How rashid-rg/restaurant-pos works
GastroFlow is restaurant operations software: a staff POS and administration workspace, a customer ordering app, a driver delivery app, and a shared Express API. The main customer journey runs from restaurant/menu discovery through cart checkout to order tracking; staff handle sales, kitchen, inventory, and delivery operations, while drivers update assigned deliveries and submit proof. The graph includes documented SaaS, billing, and inventory capabilities. Several backend routes and frontend views were not sampled, so their inclusion and links rely on the README and source index rather than inspection of their implementation.
Main entry points: server.js Express API · src/App.jsx Staff Workspace · src/App.jsx Customer App · CartCheckoutView.jsx Order Checkout
Components 24
Customer Ordering
- Customer App
apps/customer-web/src/App.jsx - Restaurant Discovery
apps/customer-web/src/views/RestaurantsView.jsx - Menu Browsing
apps/customer-web/src/views/MenuView.jsx - Cart State
apps/customer-web/src/context/CartContext.jsx - Order Checkout
apps/customer-web/src/views/CartCheckoutView.jsx - Customer Accounts
apps/customer-web/src/context/CustomerAuthContext.jsx - Order Tracking
apps/customer-web/src/views/OrderTrackingView.jsx
Staff Workspace
- Staff Workspace
src/App.jsx - Point Of Sale
src/components/POSView.jsx - POS State
src/context/POSContext.jsx - Operations Dashboard
src/components/Dashboard.jsx - Kitchen Tickets
src/components/KDSView.jsx - Inventory Operations
src/components/InventoryOperations.jsx - SaaS Administration
src/components/PlatformAdmin.jsx
Delivery Operations
- Driver App
apps/driver-web/src/App.jsx - Delivery Proof
apps/driver-web/src/ProofOfDeliveryModal.jsx
Shared API And Services
- Express API
server.js - Inventory Routes
routes/inventory-operations.js - Manual Payments
routes/manual-payments.js - Order Amendments
routes/service-exceptions.js - Tender Utilities
lib/tenders.js
Persistence
- Local POS Store
src/database/db.js - Remote libSQL Store
lib/libsql-store.js
Other components
- Customer
Connections 26
- Customer → Customer App: uses
README.md - Customer App → Restaurant Discovery: routes to
apps/customer-web/src/App.jsx - Customer App → Menu Browsing: routes to
apps/customer-web/src/App.jsx - Customer App → Order Checkout: routes to
apps/customer-web/src/App.jsx - Customer App → Order Tracking: routes to
apps/customer-web/src/App.jsx - Menu Browsing → Cart State: adds items
- Order Checkout → Cart State: reads cart
apps/customer-web/src/views/CartCheckoutView.jsx - Order Checkout → Customer Accounts: uses account
apps/customer-web/src/views/CartCheckoutView.jsx - Order Checkout → Express API: submits orders
- Customer Accounts → Express API: requests account
apps/customer-web/src/context/CustomerAuthContext.jsx - Order Tracking → Express API: requests status
- Staff Workspace → Point Of Sale: routes to
src/App.jsx - Staff Workspace → Operations Dashboard: routes to
src/App.jsx - Staff Workspace → Kitchen Tickets: routes to
src/App.jsx - Staff Workspace → Inventory Operations: routes to
- Staff Workspace → SaaS Administration: routes to
src/App.jsx - Point Of Sale → POS State: uses state
src/components/POSView.jsx - POS State → Local POS Store: reads and writes
src/context/POSContext.jsx - Driver App → Express API: updates deliveries
- Driver App → Delivery Proof: opens proof
apps/driver-web/src/App.jsx - Express API → Inventory Routes: registers routes
server.js - Express API → Manual Payments: registers routes
server.js - Express API → Order Amendments: registers routes
server.js - Order Amendments → Tender Utilities: uses amounts
routes/service-exceptions.js - Inventory Routes → Tender Utilities: uses amounts
routes/inventory-operations.js - Express API → Remote libSQL Store: selects remote store
server.js