How yashsinha23/cupflow-erp works
CupFlow ERP supports disposable-cup manufacturing from order creation and material reservation through production-stage tracking and dispatch. The frontend provides role-protected operational pages; the Spring backend exposes REST capabilities and coordinates manufacturing domain services with relational persistence. The README documents the broader modules and lifecycle; sampled backend services confirm order reservation, inventory ledger/reservation behavior, and production-stage logging. Several controller-to-service and frontend-module connections are not shown in excerpts, so those implementation links are omitted.
Main entry points: DispatchService.java Dispatch management · OrderService.java Order management · App.jsx React app routes · ProductionService.java Stage tracking
Components 20
Frontend operations
- React app routes
frontend/src/App.jsx - Order workspace
frontend/src/modules/orders/Page.jsx - Login page
frontend/src/modules/auth/Page.jsx - REST API client
frontend/src/api/apiClient.js
Identity and access
- JWT authentication
backend/src/main/java/com/cupflow/CupFlow_ERP/auth/AuthService.java - User management
backend/src/main/java/com/cupflow/CupFlow_ERP/user/UserService.java
Manufacturing setup
- Material catalog
backend/src/main/java/com/cupflow/CupFlow_ERP/material/MaterialService.java - Cup specifications
backend/src/main/java/com/cupflow/CupFlow_ERP/cup/CupService.java - Bill of materials
backend/src/main/java/com/cupflow/CupFlow_ERP/bom/BomService.java
Order and production
- Order management
backend/src/main/java/com/cupflow/CupFlow_ERP/order/OrderService.java - Stage tracking
backend/src/main/java/com/cupflow/CupFlow_ERP/production/ProductionService.java - Order records
backend/src/main/java/com/cupflow/CupFlow_ERP/order/Order.java - Production stage logs
backend/src/main/java/com/cupflow/CupFlow_ERP/production/ProductionStageLog.java
Inventory and dispatch
- Inventory operations
backend/src/main/java/com/cupflow/CupFlow_ERP/inventory/InventoryService.java - Dispatch management
backend/src/main/java/com/cupflow/CupFlow_ERP/dispatch/DispatchService.java - Stock ledger and reservations
backend/src/main/java/com/cupflow/CupFlow_ERP/inventory/StockLedger.java - Dispatch records
backend/src/main/java/com/cupflow/CupFlow_ERP/dispatch/DispatchRecord.java
Other components
- ERP user
- Spring REST backend
backend/src/main/java/com/cupflow/CupFlow_ERP/CupFlowErpApplication.java - PostgreSQL database
Connections 21
- ERP user → React app routes: uses
README.md - React app routes → Login page: routes to
frontend/src/App.jsx - React app routes → Order workspace: routes to
frontend/src/App.jsx - Order workspace → REST API client: loads orders
frontend/src/modules/orders/Page.jsx - React app routes → Spring REST backend: calls REST API
README.md - Login page → JWT authentication: authenticates
- Spring REST backend → PostgreSQL database: persists data
README.md - Order management → Inventory operations: reserves stock
backend/src/main/java/com/cupflow/CupFlow_ERP/order/OrderService.java - Order management → Bill of materials: reads requirements
backend/src/main/java/com/cupflow/CupFlow_ERP/order/OrderService.java - Order management → Order records: saves orders
backend/src/main/java/com/cupflow/CupFlow_ERP/order/OrderService.java - Inventory operations → Stock ledger and reservations: writes movements
backend/src/main/java/com/cupflow/CupFlow_ERP/inventory/InventoryService.java - Stage tracking → Order records: updates stage
backend/src/main/java/com/cupflow/CupFlow_ERP/production/ProductionService.java - Stage tracking → Production stage logs: records transitions
backend/src/main/java/com/cupflow/CupFlow_ERP/production/ProductionService.java - Dispatch management → Inventory operations: consumes stock
backend/src/main/java/com/cupflow/CupFlow_ERP/dispatch/DispatchService.java - Dispatch management → Order records: updates order
backend/src/main/java/com/cupflow/CupFlow_ERP/dispatch/DispatchService.java - Dispatch management → Production stage logs: records dispatch stage
backend/src/main/java/com/cupflow/CupFlow_ERP/dispatch/DispatchService.java - Dispatch management → Dispatch records: saves dispatch
backend/src/main/java/com/cupflow/CupFlow_ERP/dispatch/DispatchService.java - Order management → Stage tracking: advances workflow
- Stage tracking → Dispatch management: ready for dispatch
README.md - Material catalog → Inventory operations: provides stock items
- Cup specifications → Bill of materials: defines BOM scope
README.md