How x-nfo/pos works
This is a Laravel, Inertia, and React point-of-sale and retail-operations application. The main workflow runs from cashier product search and cart management through pricing, checkout, payment, transaction recording, and receipt generation; offline transactions synchronize when connectivity returns. Separate product areas cover stock and purchasing, customer finance, CRM and loyalty, public ordering, reporting, and administration. The graph uses sampled source references and README capabilities; unsampled subsystem internals are represented at their existing directory paths, and relationships not evidenced are omitted.
Main entry points: PosApiController.php POS API · index.jsx POS interface · CheckoutService.php Checkout · Transaction.php Transaction records
Components 25
Sales and POS
- POS interface
resources/js/Components/POS/index.jsx - POS API
app/Http/Controllers/Api/PosApiController.php - Cart and transactions
app/Models/Cart.php - Promotion pricing
app/Services/PricingService.php - Checkout
app/Services/CheckoutService.php - Payment gateways
app/Services/Payments/PaymentGatewayManager.php - Transaction records
app/Models/Transaction.php - Receipt printing
app/Services/ThermalPrintService.php - Offline sync
resources/js/Utils/syncEngine.js
Inventory and purchasing
- Product catalog
app/Models/Product.php - Warehouse stock
app/Models/Warehouse.php - Stock operations
app/Services/StockMutationService.php - Purchasing
app/Services/PurchaseOrderService.php
Customers and finance
- Customer and loyalty
app/Models/Customer.php - CRM automation
app/Services/CrmAutomationService.php - WhatsApp gateway
whatsapp-service/server.js - Receivables and payables
app/Http/Controllers/Apps/ReceivableController.php
Channels and reporting
- Public catalog orders
app/Http/Controllers/PublicCatalogController.php - Reports and exports
app/Http/Controllers/Reports
Platform and administration
- Administration
app/Http/Controllers/Apps - Audit logging
app/Services/AuditLogService.php - Store settings
app/Models/Setting.php
Other components
- Cashier
- Mobile or partner client
- Public shopper
Connections 23
- Cashier → POS interface: operates
README.md - POS interface → POS API: submits POS requests
README.md - POS API → Cart and transactions: manages cart
app/Http/Controllers/Api/PosApiController.php - POS API → Checkout: invokes checkout
app/Http/Controllers/Api/PosApiController.php - Checkout → Promotion pricing: applies promotions
- Checkout → Payment gateways: creates payment
- Payment gateways → Transaction records: charges transaction
app/Services/Payments/PaymentGatewayManager.php - Checkout → Transaction records: records sale
- Transaction records → Receipt printing: renders receipt
app/Services/ThermalPrintService.php - POS interface → Offline sync: queues offline sales
README.md - Offline sync → POS API: syncs transactions
- POS interface → Product catalog: searches products
README.md - Stock operations → Warehouse stock: records stock changes
- Purchasing → Stock operations: receives stock
- Mobile or partner client → POS API: uses POS API
README.md - Public shopper → Public catalog orders: places catalog order
README.md - Public catalog orders → Promotion pricing: prices catalog items
app/Http/Controllers/PublicCatalogController.php - Public catalog orders → Warehouse stock: selects branch
app/Http/Controllers/PublicCatalogController.php - CRM automation → WhatsApp gateway: sends campaigns
app/Services/CrmAutomationService.php - CRM automation → Customer and loyalty: segments customers
app/Services/CrmAutomationService.php - Reports and exports → Transaction records: analyzes sales
README.md - Administration → Audit logging: records changes
app/Http/Controllers/Apps/SalesReturnController.php - Receipt printing → Store settings: reads print settings
app/Services/ThermalPrintService.php