How stablelife11-commits/retail-flow-backend works
Retail Flow is a Spring backend for retail operations: users authenticate, maintain product and customer data, and record purchases, sales, orders, payments, and returns; a dashboard aggregates business totals. The sampled services show stock changes during purchases, sales, orders, and returns, with purchase and sale services also writing inventory audit transactions. The graph emphasizes these domain stages and reporting. Several controller-to-service links are supported by the SOURCE INDEX; unsampled subsystem relationships are omitted rather than inferred from naming alone.
Main entry points: PurchaseService.java Purchasing · SaleService.java Sales · ProductVariantRepository.java Product variants · AuthService.java Authentication
Components 24
Identity and access
- User accounts
src/main/java/com/retail/flow/user/entity/User.java - Authentication API
src/main/java/com/retail/flow/auth/controller/AuthController.java - Authentication
src/main/java/com/retail/flow/auth/service/AuthService.java - JWT tokens
src/main/java/com/retail/flow/common/security/JwtTokenProvider.java
Retail records
- Product API
src/main/java/com/retail/flow/product/controller/ProductController.java - Product catalog
src/main/java/com/retail/flow/product/service/ProductService.java - Product records
src/main/java/com/retail/flow/product/repository/ProductRepository.java - Customer records
src/main/java/com/retail/flow/customer/service/CustomerService.java - Supplier records
src/main/java/com/retail/flow/supplier/service/SupplierService.java - Expense records
src/main/java/com/retail/flow/expense/service/ExpenseService.java
Stock and transactions
- Purchase API
src/main/java/com/retail/flow/purchase/controller/PurchaseController.java - Purchasing
src/main/java/com/retail/flow/purchase/service/PurchaseService.java - Purchase records
src/main/java/com/retail/flow/purchase/repository/PurchaseRepository.java - Product variants
src/main/java/com/retail/flow/product/repository/ProductVariantRepository.java - Inventory audit
src/main/java/com/retail/flow/inventory/repository/InventoryTransactionRepository.java
Commerce operations
- Sale API
src/main/java/com/retail/flow/sale/controller/SaleController.java - Sales
src/main/java/com/retail/flow/sale/service/SaleService.java - Sale records
src/main/java/com/retail/flow/sale/repository/SaleRepository.java - Customer orders
src/main/java/com/retail/flow/order/service/OrderService.java - Payment records
src/main/java/com/retail/flow/payment/service/PaymentService.java - Sale returns
src/main/java/com/retail/flow/returns/service/ReturnService.java
Reporting
- Dashboard API
src/main/java/com/retail/flow/report/controller/ReportController.java - Dashboard summary
src/main/java/com/retail/flow/report/service/ReportService.java
Other components
- Retail user
Connections 27
- Retail user → Authentication API: submits credentials
- Authentication API → Authentication: delegates
src/main/java/com/retail/flow/auth/controller/AuthController.java - Authentication → User accounts: reads and saves
src/main/java/com/retail/flow/auth/service/AuthService.java - Authentication → JWT tokens: generates token
src/main/java/com/retail/flow/auth/service/AuthService.java - Retail user → Product API: manages catalog
- Product API → Product catalog: delegates
src/main/java/com/retail/flow/product/controller/ProductController.java - Product catalog → Product records: saves and reads
src/main/java/com/retail/flow/product/service/ProductService.java - Retail user → Purchase API: records purchase
- Purchase API → Purchasing: delegates
src/main/java/com/retail/flow/purchase/controller/PurchaseController.java - Purchasing → Purchase records: saves purchases
src/main/java/com/retail/flow/purchase/service/PurchaseService.java - Purchasing → Product variants: updates stock
src/main/java/com/retail/flow/purchase/service/PurchaseService.java - Purchasing → Inventory audit: records movement
src/main/java/com/retail/flow/purchase/service/PurchaseService.java - Purchasing → Supplier records: looks up supplier
src/main/java/com/retail/flow/purchase/service/PurchaseService.java - Retail user → Sale API: records sale
- Sale API → Sales: delegates
src/main/java/com/retail/flow/sale/controller/SaleController.java - Sales → Sale records: saves and reads
src/main/java/com/retail/flow/sale/service/SaleService.java - Sales → Product variants: checks and updates stock
src/main/java/com/retail/flow/sale/service/SaleService.java - Sales → Inventory audit: records movement
src/main/java/com/retail/flow/sale/service/SaleService.java - Retail user → Dashboard API: requests summary
- Dashboard API → Dashboard summary: delegates
src/main/java/com/retail/flow/report/controller/ReportController.java - Dashboard summary → Sale records: reads totals
src/main/java/com/retail/flow/report/service/ReportService.java - Dashboard summary → Purchase records: reads totals
src/main/java/com/retail/flow/report/service/ReportService.java - Retail user → Customer orders: places order
- Customer orders → Product variants: checks and updates stock
src/main/java/com/retail/flow/order/service/OrderService.java - Retail user → Payment records: records payment
- Retail user → Sale returns: requests return
- Sale returns → Product variants: restores stock
src/main/java/com/retail/flow/returns/service/ReturnService.java