How whyeric92-eng/flash-sale-inventory works
Flash Sale Inventory is a Spring Boot API for product and stock administration, order creation, and JWT-based authentication. The principal order path is a client request through the order controller and service, which decrements stock, looks up the product, and persists a pending order. Product and inventory management and registration/login are separate API branches. PostgreSQL is documented as the business-data source of truth; Redis cache, atomic stock control, and an async order queue are documented capabilities, but the README marks the system in progress and their implementation is not shown in the sampled source.
Main entry points: OrderService.java Order service · ProductService.java Product service · InventoryService.java Inventory service · AuthService.java Auth service
Components 21
API endpoints
- Product API
src/main/java/com/flashsale/inventory/controller/ProductController.java - Inventory API
src/main/java/com/flashsale/inventory/controller/InventoryController.java - Order API
src/main/java/com/flashsale/inventory/controller/OrderController.java - Auth API
src/main/java/com/flashsale/inventory/controller/AuthController.java - Request DTOs
src/main/java/com/flashsale/inventory/dto
Business services
- Product service
src/main/java/com/flashsale/inventory/service/ProductService.java - Inventory service
src/main/java/com/flashsale/inventory/service/InventoryService.java - Order service
src/main/java/com/flashsale/inventory/service/OrderService.java
Authentication
- Auth service
src/main/java/com/flashsale/inventory/service/AuthService.java - JWT service
src/main/java/com/flashsale/inventory/security/JwtService.java - JWT filter
src/main/java/com/flashsale/inventory/security/JwtAuthenticationFilter.java - Security config
src/main/java/com/flashsale/inventory/config/SecurityConfig.java
Persistence and integrations
- Domain models
src/main/java/com/flashsale/inventory/entity - Product repository
src/main/java/com/flashsale/inventory/repository/ProductRepository.java - Inventory repository
src/main/java/com/flashsale/inventory/repository/InventoryRepository.java - Order repository
src/main/java/com/flashsale/inventory/repository/OrderRepository.java - User repository
src/main/java/com/flashsale/inventory/repository/UserRepository.java - PostgreSQL
- Redis
- Async order queue
Other components
- API client
Connections 24
- API client → Product API: manages products
src/main/java/com/flashsale/inventory/controller/ProductController.java - API client → Inventory API: manages stock
src/main/java/com/flashsale/inventory/controller/InventoryController.java - API client → Order API: places orders
src/main/java/com/flashsale/inventory/controller/OrderController.java - API client → Auth API: registers or logs in
src/main/java/com/flashsale/inventory/controller/AuthController.java - Product API → Product service: delegates
src/main/java/com/flashsale/inventory/controller/ProductController.java - Inventory API → Inventory service: delegates
src/main/java/com/flashsale/inventory/controller/InventoryController.java - Order API → Order service: delegates
src/main/java/com/flashsale/inventory/controller/OrderController.java - Auth API → Auth service: delegates
src/main/java/com/flashsale/inventory/controller/AuthController.java - Product service → Product repository: reads and writes
src/main/java/com/flashsale/inventory/service/ProductService.java - Inventory service → Inventory repository: reads and writes
src/main/java/com/flashsale/inventory/service/InventoryService.java - Order service → Inventory service: decreases stock
src/main/java/com/flashsale/inventory/service/OrderService.java - Order service → Product service: looks up product
src/main/java/com/flashsale/inventory/service/OrderService.java - Order service → Order repository: saves order
src/main/java/com/flashsale/inventory/service/OrderService.java - Auth service → User repository: checks and saves user
src/main/java/com/flashsale/inventory/service/AuthService.java - Auth service → JWT service: issues token
src/main/java/com/flashsale/inventory/service/AuthService.java - Security config → JWT filter: configures
src/main/java/com/flashsale/inventory/config/SecurityConfig.java - JWT filter → JWT service: validates token
src/main/java/com/flashsale/inventory/security/JwtAuthenticationFilter.java - Product repository → PostgreSQL: persists product data
README.md - Inventory repository → PostgreSQL: persists stock data
README.md - Order repository → PostgreSQL: persists order data
README.md - User repository → PostgreSQL: persists user data
README.md - Redis → Inventory service: planned stock control
README.md - Redis → Product service: planned product cache
README.md - Order service → Async order queue: planned async enqueue
README.md