How michaelngogoyo/nexus-pos works
This is a restaurant and retail point-of-sale platform with React POS and admin workspaces, a Spring Boot REST backend, and a separate Java desktop client with offline synchronization. The main workflow runs from cashier checkout through sales/order processing, with related kitchen, floor, shift, inventory, procurement, and reporting capabilities. Backend persistence and the desktop sync path are included as internal layers. Some subsystems are represented by directory paths because their source was not sampled; those links are left unasserted where the excerpts do not establish them.
Main entry points: api.js API Client · controller REST Controllers · SyncService.java Sync Service · SalesService.java Sales Processing
Components 31
Web Workspaces
- App Routing
posFrontend/src/App.jsx - API Client
posFrontend/src/services/api.js
POS Operations
- Touch Checkout
posFrontend/src/pos/checkout/POSCheckout.jsx - Order Management
posFrontend/src/pos/orders/POSOrders.jsx - Kitchen Display
posFrontend/src/pos/kitchen/POSKitchen.jsx - Tables and Reservations
posFrontend/src/pos/tables/POSTables.jsx - Shift Management
posFrontend/src/pos/shift/POSShift.jsx
Business Management
- Admin Workspace
posFrontend/src/admin/AdminLayout.jsx - Catalog and Inventory
posFrontend/src/pages/product/Products.jsx - Purchases and Finance
posFrontend/src/pages/finance/Purchases.jsx - Analytics and Reports
posFrontend/src/pages/reports/Reports.jsx - Audit Management
posFrontend/src/pages/admin/AuditLog.jsx
Backend Services
- REST Controllers
posBackend/src/main/java/com/pos/controller - Sales Processing
posBackend/src/main/java/com/pos/service/impl/SalesService.java - Restaurant Orders
posBackend/src/main/java/com/pos/service/RestaurantOrderService.java - Purchase Orders
posBackend/src/main/java/com/pos/service/PurchaseOrderService.java - Report Generation
posBackend/src/main/java/com/pos/service/impl/ReportService.java - Audit Logging
posBackend/src/main/java/com/pos/service/impl/AuditService.java - Product Repository
posBackend/src/main/java/com/pos/repository/ProductRepository.java - Stock Movements
posBackend/src/main/java/com/pos/repository/StockMovementRepository.java
Desktop Offline
- Desktop Application
POS_Desktop/src/main/java/com/pos/desktop/PosDesktopApplication.java - Desktop Authentication
POS_Desktop/src/main/java/com/pos/desktop/auth/AuthService.java - Offline Modules
POS_Desktop/src/main/java/com/pos/desktop/service/ModuleService.java - Local Entity Store
POS_Desktop/src/main/java/com/pos/desktop/core/LocalEntityStore.java - Sync Queue
POS_Desktop/src/main/java/com/pos/desktop/core/SyncQueueStore.java - Sync Service
POS_Desktop/src/main/java/com/pos/desktop/core/SyncService.java - Network Client
POS_Desktop/src/main/java/com/pos/desktop/core/NetworkClient.java - Desktop Session
POS_Desktop/src/main/java/com/pos/desktop/auth/SessionStore.java
Other components
- POS Staff
- Keycloak
- MinIO Storage
Connections 42
- POS Staff → App Routing: uses
- App Routing → Touch Checkout: routes to
posFrontend/src/App.jsx - App Routing → Admin Workspace: routes to
posFrontend/src/App.jsx - Touch Checkout → API Client: requests data
- Order Management → API Client: requests data
- Kitchen Display → API Client: requests data
- Tables and Reservations → API Client: requests data
- Shift Management → API Client: requests data
- Catalog and Inventory → API Client: requests data
- Purchases and Finance → API Client: requests data
- Analytics and Reports → API Client: requests data
- API Client → REST Controllers: calls REST API
- REST Controllers → Sales Processing: dispatches
- REST Controllers → Restaurant Orders: dispatches
- REST Controllers → Purchase Orders: dispatches
- REST Controllers → Report Generation: dispatches
- Sales Processing → Product Repository: reads products
posBackend/src/main/java/com/pos/service/impl/SalesService.java - Sales Processing → Stock Movements: records movements
posBackend/src/main/java/com/pos/service/impl/SalesService.java - Restaurant Orders → Product Repository: updates stock
posBackend/src/main/java/com/pos/service/RestaurantOrderService.java - Restaurant Orders → Stock Movements: records movements
posBackend/src/main/java/com/pos/service/RestaurantOrderService.java - Purchase Orders → Product Repository: receives products
posBackend/src/main/java/com/pos/service/PurchaseOrderService.java - Purchase Orders → Stock Movements: records movements
posBackend/src/main/java/com/pos/service/PurchaseOrderService.java - Analytics and Reports → Report Generation: requests reports
- Report Generation → Product Repository: queries analytics
posBackend/src/main/java/com/pos/service/impl/ReportService.java - Audit Management → REST Controllers: uses audit API
- Sales Processing → Audit Logging: logs actions
posBackend/src/main/java/com/pos/service/impl/SalesService.java - Restaurant Orders → Audit Logging: logs actions
posBackend/src/main/java/com/pos/service/RestaurantOrderService.java - Purchase Orders → Audit Logging: logs actions
posBackend/src/main/java/com/pos/service/PurchaseOrderService.java - Admin Workspace → Keycloak: authenticates with
- REST Controllers → MinIO Storage: stores images
- POS Staff → Desktop Application: uses
- Desktop Application → Desktop Authentication: authenticates through
- Desktop Authentication → Network Client: requests tokens
POS_Desktop/src/main/java/com/pos/desktop/auth/AuthService.java - Desktop Authentication → Desktop Session: stores session
POS_Desktop/src/main/java/com/pos/desktop/auth/AuthService.java - Desktop Authentication → Local Entity Store: caches account
POS_Desktop/src/main/java/com/pos/desktop/auth/AuthService.java - Offline Modules → Network Client: fetches remotely
POS_Desktop/src/main/java/com/pos/desktop/service/ModuleService.java - Offline Modules → Local Entity Store: caches entities
POS_Desktop/src/main/java/com/pos/desktop/service/ModuleService.java - Offline Modules → Sync Queue: queues offline writes
POS_Desktop/src/main/java/com/pos/desktop/service/ModuleService.java - Sync Service → Sync Queue: reads and clears
POS_Desktop/src/main/java/com/pos/desktop/core/SyncService.java - Sync Service → Local Entity Store: marks clean
POS_Desktop/src/main/java/com/pos/desktop/core/SyncService.java - Sync Service → Network Client: sends queued writes
POS_Desktop/src/main/java/com/pos/desktop/core/SyncService.java - Sync Service → Desktop Session: reads token
POS_Desktop/src/main/java/com/pos/desktop/core/SyncService.java