How shivanisingh2k/orderflow works
OrderFlow is a Spring REST API for product and user management, authentication, and inventory-backed order creation. Clients call the controllers; services perform business operations and use JPA repositories to persist entities. Order creation validates the user and products, totals prices, reduces stock, and runs transactionally. Login verifies a password and issues a JWT; the security filter and configuration enforce authenticated and role-restricted access. The README also documents pagination and OpenAPI. Some subsystem links rely on the source index or README because not all source was excerpted.
Main entry points: repository JPA repositories · AuthController.java Authentication API · UserService.java User service · orderflow Domain entities
Components 18
REST API
- Authentication API
src/main/java/com/orderflow/orderflow/controller/AuthController.java - Product API
src/main/java/com/orderflow/orderflow/controller/ProductController.java - User API
src/main/java/com/orderflow/orderflow/controller/UserController.java - Order API
src/main/java/com/orderflow/orderflow/controller/OrderController.java - OpenAPI setup
src/main/java/com/orderflow/orderflow/config/OpenApiConfig.java - Request responses
src/main/java/com/orderflow/orderflow/dto - API error handling
src/main/java/com/orderflow/orderflow/exception
Business Domain
- Product service
src/main/java/com/orderflow/orderflow/service/ProductService.java - User service
src/main/java/com/orderflow/orderflow/service/UserService.java - Order service
src/main/java/com/orderflow/orderflow/service/OrderService.java - Domain entities
src/main/java/com/orderflow/orderflow
Persistence
- JPA repositories
src/main/java/com/orderflow/orderflow/repository - PostgreSQL
Security
- Security configuration
src/main/java/com/orderflow/orderflow/config/SecurityConfig.java - JWT filter
src/main/java/com/orderflow/orderflow/security/JwtAuthenticationFilter.java - JWT service
src/main/java/com/orderflow/orderflow/security/JwtService.java - BCrypt encoder
Other components
- API client
Connections 21
- API client → Authentication API: logs in
README.md - API client → Product API: manages products
README.md - API client → User API: manages users
README.md - API client → Order API: creates order
README.md - Product API → Product service: delegates to
src/main/java/com/orderflow/orderflow/controller/ProductController.java - User API → User service: delegates to
src/main/java/com/orderflow/orderflow/controller/UserController.java - Order API → Order service: delegates to
src/main/java/com/orderflow/orderflow/controller/OrderController.java - Authentication API → JPA repositories: looks up user
src/main/java/com/orderflow/orderflow/controller/AuthController.java - Authentication API → JWT service: issues token
src/main/java/com/orderflow/orderflow/controller/AuthController.java - Authentication API → BCrypt encoder: checks password
src/main/java/com/orderflow/orderflow/controller/AuthController.java - User service → BCrypt encoder: hashes password
src/main/java/com/orderflow/orderflow/service/UserService.java - Product service → JPA repositories: reads and writes
src/main/java/com/orderflow/orderflow/service/ProductService.java - User service → JPA repositories: reads and writes
src/main/java/com/orderflow/orderflow/service/UserService.java - Order service → JPA repositories: loads and saves
src/main/java/com/orderflow/orderflow/service/OrderService.java - Order service → Domain entities: builds order
src/main/java/com/orderflow/orderflow/service/OrderService.java - Product service → Domain entities: maps products
src/main/java/com/orderflow/orderflow/service/ProductService.java - User service → Domain entities: maps users
src/main/java/com/orderflow/orderflow/service/UserService.java - JPA repositories → PostgreSQL: persists entities
README.md - Security configuration → JWT filter: registers filter
src/main/java/com/orderflow/orderflow/config/SecurityConfig.java - JWT filter → JWT service: validates token
src/main/java/com/orderflow/orderflow/security/JwtAuthenticationFilter.java - Domain entities → API error handling: raises domain errors
src/main/java/com/orderflow/orderflow/service/OrderService.java