# yashsinha23/cupflow-erp architecture

> Architecture diagram of the GitHub repository yashsinha23/cupflow-erp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/yashsinha23/cupflow-erp
- Repository: https://github.com/yashsinha23/cupflow-erp

## Overview

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: [`backend/src/main/java/com/cupflow/CupFlow_ERP/dispatch/DispatchService.java`](https://github.com/yashsinha23/cupflow-erp/blob/master/backend/src/main/java/com/cupflow/CupFlow_ERP/dispatch/DispatchService.java) (Dispatch management), [`backend/src/main/java/com/cupflow/CupFlow_ERP/order/OrderService.java`](https://github.com/yashsinha23/cupflow-erp/blob/master/backend/src/main/java/com/cupflow/CupFlow_ERP/order/OrderService.java) (Order management), [`frontend/src/App.jsx`](https://github.com/yashsinha23/cupflow-erp/blob/master/frontend/src/App.jsx) (React app routes), [`backend/src/main/java/com/cupflow/CupFlow_ERP/production/ProductionService.java`](https://github.com/yashsinha23/cupflow-erp/blob/master/backend/src/main/java/com/cupflow/CupFlow_ERP/production/ProductionService.java) (Stage tracking)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend operations"]
  node_webapp["React app routes<br/>[App.jsx]"]
  node_orderui["Order workspace<br/>[Page.jsx]"]
  node_authui["Login page<br/>[Page.jsx]"]
  node_api["REST API client<br/>[apiClient.js]"]
end

subgraph group_access["Identity and access"]
  node_auth["JWT authentication<br/>[AuthService.java]"]
  node_users["User management<br/>[UserService.java]"]
end

subgraph group_catalog["Manufacturing setup"]
  node_materials["Material catalog"]
  node_cups["Cup specifications<br/>[CupService.java]"]
  node_bom["Bill of materials<br/>[BomService.java]"]
end

subgraph group_operations["Order and production"]
  node_orders["Order management<br/>[OrderService.java]"]
  node_production["Stage tracking"]
  node_orderstore[("Order records<br/>[Order.java]")]
  node_stagehistory[("Production stage logs")]
end

subgraph group_fulfillment["Inventory and dispatch"]
  node_inventory["Inventory operations"]
  node_dispatch["Dispatch management"]
  node_stockstore[("Stock ledger and reservations<br/>[StockLedger.java]")]
  node_dispatchrecords[("Dispatch records")]
end

node_operator(("ERP user"))
node_backend["Spring REST backend"]
node_postgres[("PostgreSQL database")]

node_operator -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_authui
node_webapp -->|"routes to"| node_orderui
node_orderui -->|"loads orders"| node_api
node_webapp -->|"calls REST API"| node_backend
node_authui -.->|"authenticates"| node_auth
node_backend -->|"persists data"| node_postgres
node_orders -->|"reserves stock"| node_inventory
node_orders -->|"reads requirements"| node_bom
node_orders -->|"saves orders"| node_orderstore
node_inventory -->|"writes movements"| node_stockstore
node_production -->|"updates stage"| node_orderstore
node_production -->|"records transitions"| node_stagehistory
node_dispatch -->|"consumes stock"| node_inventory
node_dispatch -->|"updates order"| node_orderstore
node_dispatch -->|"records dispatch stage"| node_stagehistory
node_dispatch -->|"saves dispatch"| node_dispatchrecords
node_orders -.->|"advances workflow"| node_production
node_production -->|"ready for dispatch"| node_dispatch
node_materials -.->|"provides stock items"| node_inventory
node_cups -->|"defines BOM scope"| node_bom

click node_webapp "https://github.com/yashsinha23/cupflow-erp/blob/master/frontend/src/App.jsx"
click node_orderui "https://github.com/yashsinha23/cupflow-erp/blob/master/frontend/src/modules/orders/Page.jsx"
click node_authui "https://github.com/yashsinha23/cupflow-erp/blob/master/frontend/src/modules/auth/Page.jsx"
click node_api "https://github.com/yashsinha23/cupflow-erp/blob/master/frontend/src/api/apiClient.js"
click node_auth "https://github.com/yashsinha23/cupflow-erp/blob/master/backend/src/main/java/com/cupflow/CupFlow_ERP/auth/AuthService.java"
click node_users "https://github.com/yashsinha23/cupflow-erp/blob/master/backend/src/main/java/com/cupflow/CupFlow_ERP/user/UserService.java"
click node_materials "https://github.com/yashsinha23/cupflow-erp/blob/master/backend/src/main/java/com/cupflow/CupFlow_ERP/material/MaterialService.java"
click node_cups "https://github.com/yashsinha23/cupflow-erp/blob/master/backend/src/main/java/com/cupflow/CupFlow_ERP/cup/CupService.java"
click node_bom "https://github.com/yashsinha23/cupflow-erp/blob/master/backend/src/main/java/com/cupflow/CupFlow_ERP/bom/BomService.java"
click node_orders "https://github.com/yashsinha23/cupflow-erp/blob/master/backend/src/main/java/com/cupflow/CupFlow_ERP/order/OrderService.java"
click node_production "https://github.com/yashsinha23/cupflow-erp/blob/master/backend/src/main/java/com/cupflow/CupFlow_ERP/production/ProductionService.java"
click node_inventory "https://github.com/yashsinha23/cupflow-erp/blob/master/backend/src/main/java/com/cupflow/CupFlow_ERP/inventory/InventoryService.java"
click node_dispatch "https://github.com/yashsinha23/cupflow-erp/blob/master/backend/src/main/java/com/cupflow/CupFlow_ERP/dispatch/DispatchService.java"
click node_orderstore "https://github.com/yashsinha23/cupflow-erp/blob/master/backend/src/main/java/com/cupflow/CupFlow_ERP/order/Order.java"
click node_stockstore "https://github.com/yashsinha23/cupflow-erp/blob/master/backend/src/main/java/com/cupflow/CupFlow_ERP/inventory/StockLedger.java"
click node_stagehistory "https://github.com/yashsinha23/cupflow-erp/blob/master/backend/src/main/java/com/cupflow/CupFlow_ERP/production/ProductionStageLog.java"
click node_dispatchrecords "https://github.com/yashsinha23/cupflow-erp/blob/master/backend/src/main/java/com/cupflow/CupFlow_ERP/dispatch/DispatchRecord.java"
click node_backend "https://github.com/yashsinha23/cupflow-erp/blob/master/backend/src/main/java/com/cupflow/CupFlow_ERP/CupFlowErpApplication.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_webapp,node_orderui,node_authui,node_api,node_operator toneBlue
class node_auth,node_users,node_postgres toneAmber
class node_materials,node_cups,node_bom toneMint
class node_orders,node_production,node_orderstore,node_stagehistory toneRose
class node_inventory,node_dispatch,node_stockstore,node_dispatchrecords toneIndigo
class node_backend toneTeal
```

## Components

### Frontend operations

- [React app routes](https://github.com/yashsinha23/cupflow-erp/blob/master/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Order workspace](https://github.com/yashsinha23/cupflow-erp/blob/master/frontend/src/modules/orders/Page.jsx): `frontend/src/modules/orders/Page.jsx`
- [Login page](https://github.com/yashsinha23/cupflow-erp/blob/master/frontend/src/modules/auth/Page.jsx): `frontend/src/modules/auth/Page.jsx`
- [REST API client](https://github.com/yashsinha23/cupflow-erp/blob/master/frontend/src/api/apiClient.js): `frontend/src/api/apiClient.js`

### Identity and access

- [JWT authentication](https://github.com/yashsinha23/cupflow-erp/blob/master/backend/src/main/java/com/cupflow/CupFlow_ERP/auth/AuthService.java): `backend/src/main/java/com/cupflow/CupFlow_ERP/auth/AuthService.java`
- [User management](https://github.com/yashsinha23/cupflow-erp/blob/master/backend/src/main/java/com/cupflow/CupFlow_ERP/user/UserService.java): `backend/src/main/java/com/cupflow/CupFlow_ERP/user/UserService.java`

### Manufacturing setup

- [Material catalog](https://github.com/yashsinha23/cupflow-erp/blob/master/backend/src/main/java/com/cupflow/CupFlow_ERP/material/MaterialService.java): `backend/src/main/java/com/cupflow/CupFlow_ERP/material/MaterialService.java`
- [Cup specifications](https://github.com/yashsinha23/cupflow-erp/blob/master/backend/src/main/java/com/cupflow/CupFlow_ERP/cup/CupService.java): `backend/src/main/java/com/cupflow/CupFlow_ERP/cup/CupService.java`
- [Bill of materials](https://github.com/yashsinha23/cupflow-erp/blob/master/backend/src/main/java/com/cupflow/CupFlow_ERP/bom/BomService.java): `backend/src/main/java/com/cupflow/CupFlow_ERP/bom/BomService.java`

### Order and production

- [Order management](https://github.com/yashsinha23/cupflow-erp/blob/master/backend/src/main/java/com/cupflow/CupFlow_ERP/order/OrderService.java): `backend/src/main/java/com/cupflow/CupFlow_ERP/order/OrderService.java`
- [Stage tracking](https://github.com/yashsinha23/cupflow-erp/blob/master/backend/src/main/java/com/cupflow/CupFlow_ERP/production/ProductionService.java): `backend/src/main/java/com/cupflow/CupFlow_ERP/production/ProductionService.java`
- [Order records](https://github.com/yashsinha23/cupflow-erp/blob/master/backend/src/main/java/com/cupflow/CupFlow_ERP/order/Order.java): `backend/src/main/java/com/cupflow/CupFlow_ERP/order/Order.java`
- [Production stage logs](https://github.com/yashsinha23/cupflow-erp/blob/master/backend/src/main/java/com/cupflow/CupFlow_ERP/production/ProductionStageLog.java): `backend/src/main/java/com/cupflow/CupFlow_ERP/production/ProductionStageLog.java`

### Inventory and dispatch

- [Inventory operations](https://github.com/yashsinha23/cupflow-erp/blob/master/backend/src/main/java/com/cupflow/CupFlow_ERP/inventory/InventoryService.java): `backend/src/main/java/com/cupflow/CupFlow_ERP/inventory/InventoryService.java`
- [Dispatch management](https://github.com/yashsinha23/cupflow-erp/blob/master/backend/src/main/java/com/cupflow/CupFlow_ERP/dispatch/DispatchService.java): `backend/src/main/java/com/cupflow/CupFlow_ERP/dispatch/DispatchService.java`
- [Stock ledger and reservations](https://github.com/yashsinha23/cupflow-erp/blob/master/backend/src/main/java/com/cupflow/CupFlow_ERP/inventory/StockLedger.java): `backend/src/main/java/com/cupflow/CupFlow_ERP/inventory/StockLedger.java`
- [Dispatch records](https://github.com/yashsinha23/cupflow-erp/blob/master/backend/src/main/java/com/cupflow/CupFlow_ERP/dispatch/DispatchRecord.java): `backend/src/main/java/com/cupflow/CupFlow_ERP/dispatch/DispatchRecord.java`

### Other components

- **ERP user**
- [Spring REST backend](https://github.com/yashsinha23/cupflow-erp/blob/master/backend/src/main/java/com/cupflow/CupFlow_ERP/CupFlowErpApplication.java): `backend/src/main/java/com/cupflow/CupFlow_ERP/CupFlowErpApplication.java`
- **PostgreSQL database**

## Connections

- ERP user → React app routes: uses (evidence: `README.md`)
- React app routes → Login page: routes to (evidence: `frontend/src/App.jsx`)
- React app routes → Order workspace: routes to (evidence: `frontend/src/App.jsx`)
- Order workspace → REST API client: loads orders (evidence: `frontend/src/modules/orders/Page.jsx`)
- React app routes → Spring REST backend: calls REST API (evidence: `README.md`)
- Login page → JWT authentication: authenticates
- Spring REST backend → PostgreSQL database: persists data (evidence: `README.md`)
- Order management → Inventory operations: reserves stock (evidence: `backend/src/main/java/com/cupflow/CupFlow_ERP/order/OrderService.java`)
- Order management → Bill of materials: reads requirements (evidence: `backend/src/main/java/com/cupflow/CupFlow_ERP/order/OrderService.java`)
- Order management → Order records: saves orders (evidence: `backend/src/main/java/com/cupflow/CupFlow_ERP/order/OrderService.java`)
- Inventory operations → Stock ledger and reservations: writes movements (evidence: `backend/src/main/java/com/cupflow/CupFlow_ERP/inventory/InventoryService.java`)
- Stage tracking → Order records: updates stage (evidence: `backend/src/main/java/com/cupflow/CupFlow_ERP/production/ProductionService.java`)
- Stage tracking → Production stage logs: records transitions (evidence: `backend/src/main/java/com/cupflow/CupFlow_ERP/production/ProductionService.java`)
- Dispatch management → Inventory operations: consumes stock (evidence: `backend/src/main/java/com/cupflow/CupFlow_ERP/dispatch/DispatchService.java`)
- Dispatch management → Order records: updates order (evidence: `backend/src/main/java/com/cupflow/CupFlow_ERP/dispatch/DispatchService.java`)
- Dispatch management → Production stage logs: records dispatch stage (evidence: `backend/src/main/java/com/cupflow/CupFlow_ERP/dispatch/DispatchService.java`)
- Dispatch management → Dispatch records: saves dispatch (evidence: `backend/src/main/java/com/cupflow/CupFlow_ERP/dispatch/DispatchService.java`)
- Order management → Stage tracking: advances workflow
- Stage tracking → Dispatch management: ready for dispatch (evidence: `README.md`)
- Material catalog → Inventory operations: provides stock items
- Cup specifications → Bill of materials: defines BOM scope (evidence: `README.md`)
