How aljolandaalhandhali/inventory-order-management-api works
This is a Spring Boot REST API for inventory, customers, and order lifecycle management. Clients create catalog and customer records, open draft orders, add items, confirm orders (which validates and deducts stock), then ship, deliver, or cancel them; status history records transitions. Separate product operations adjust stock and report low-stock items. The sampled services show repository-backed persistence and transactional order handling; the README documents Oracle as the database. Edges into controllers are based on the endpoint documentation and indexed references; unsampled implementation details are not inferred.
Main entry points: OrderService.java Order Lifecycle · CustomerController.java Customer API · OrderController.java Order API · ProductService.java Inventory Operations
Components 26
REST API
- Category API
src/main/java/com/Invetory/mangment/Inventory/Order/Management/controller/CategoryController.java - Product API
src/main/java/com/Invetory/mangment/Inventory/Order/Management/controller/ProductController.java - Customer API
src/main/java/com/Invetory/mangment/Inventory/Order/Management/controller/CustomerController.java - Order API
src/main/java/com/Invetory/mangment/Inventory/Order/Management/controller/OrderController.java - Error Mapping
src/main/java/com/Invetory/mangment/Inventory/Order/Management/exception/GlobalExceptionHandler.java
Business Services
- Category Management
src/main/java/com/Invetory/mangment/Inventory/Order/Management/service/CategoryService.java - Inventory Operations
src/main/java/com/Invetory/mangment/Inventory/Order/Management/service/ProductService.java - Customer Records
src/main/java/com/Invetory/mangment/Inventory/Order/Management/service/CustomerService.java - Order Lifecycle
src/main/java/com/Invetory/mangment/Inventory/Order/Management/service/OrderService.java
Persistence
- Category Repository
src/main/java/com/Invetory/mangment/Inventory/Order/Management/repository/CategoryRepository.java - Product Repository
src/main/java/com/Invetory/mangment/Inventory/Order/Management/repository/ProductRepository.java - Customer Repository
src/main/java/com/Invetory/mangment/Inventory/Order/Management/repository/CustomerRepository.java - Phone Repository
src/main/java/com/Invetory/mangment/Inventory/Order/Management/repository/CustomerPhoneRepository.java - Order Repository
src/main/java/com/Invetory/mangment/Inventory/Order/Management/repository/OrderRepository.java - Order Item Repository
src/main/java/com/Invetory/mangment/Inventory/Order/Management/repository/OrderItemRepository.java - Status History Repository
src/main/java/com/Invetory/mangment/Inventory/Order/Management/repository/OrderStatusHistoryRepository.java
Domain Model
- Catalog Entities
src/main/java/com/Invetory/mangment/Inventory/Order/Management/entity/Category.java - Product Entity
src/main/java/com/Invetory/mangment/Inventory/Order/Management/entity/Product.java - Customer Entity
src/main/java/com/Invetory/mangment/Inventory/Order/Management/entity/Customer.java - Customer Phone Entity
src/main/java/com/Invetory/mangment/Inventory/Order/Management/entity/CustomerPhone.java - Order Entity
src/main/java/com/Invetory/mangment/Inventory/Order/Management/entity/Order.java - Order Item Entity
src/main/java/com/Invetory/mangment/Inventory/Order/Management/entity/OrderItem.java - Order Status
src/main/java/com/Invetory/mangment/Inventory/Order/Management/entity/OrderStatus.java - Status History Entity
src/main/java/com/Invetory/mangment/Inventory/Order/Management/entity/OrderStatusHistory.java
Other components
- API Client
- Oracle Database
Connections 27
- API Client → Category API: calls category endpoints
README.md - API Client → Product API: calls product endpoints
README.md - API Client → Customer API: calls customer endpoints
README.md - API Client → Order API: calls order endpoints
README.md - Category API → Category Management: delegates to
src/main/java/com/Invetory/mangment/Inventory/Order/Management/controller/CategoryController.java - Product API → Inventory Operations: delegates to
src/main/java/com/Invetory/mangment/Inventory/Order/Management/controller/ProductController.java - Customer API → Customer Records: delegates to
src/main/java/com/Invetory/mangment/Inventory/Order/Management/controller/CustomerController.java - Customer API → Order Lifecycle: creates draft orders
src/main/java/com/Invetory/mangment/Inventory/Order/Management/controller/CustomerController.java - Order API → Order Lifecycle: delegates to
src/main/java/com/Invetory/mangment/Inventory/Order/Management/controller/OrderController.java - Category Management → Category Repository: saves and lists
src/main/java/com/Invetory/mangment/Inventory/Order/Management/service/CategoryService.java - Inventory Operations → Category Repository: loads category
src/main/java/com/Invetory/mangment/Inventory/Order/Management/service/ProductService.java - Inventory Operations → Product Repository: saves and queries
src/main/java/com/Invetory/mangment/Inventory/Order/Management/service/ProductService.java - Customer Records → Customer Repository: saves and loads
src/main/java/com/Invetory/mangment/Inventory/Order/Management/service/CustomerService.java - Customer Records → Phone Repository: saves phones
src/main/java/com/Invetory/mangment/Inventory/Order/Management/service/CustomerService.java - Order Lifecycle → Order Repository: loads and saves orders
src/main/java/com/Invetory/mangment/Inventory/Order/Management/service/OrderService.java - Order Lifecycle → Customer Repository: loads customer
src/main/java/com/Invetory/mangment/Inventory/Order/Management/service/OrderService.java - Order Lifecycle → Product Repository: reads and updates stock
src/main/java/com/Invetory/mangment/Inventory/Order/Management/service/OrderService.java - Order Lifecycle → Order Item Repository: saves order items
src/main/java/com/Invetory/mangment/Inventory/Order/Management/service/OrderService.java - Order Lifecycle → Status History Repository: records status changes
src/main/java/com/Invetory/mangment/Inventory/Order/Management/service/OrderService.java - Category Repository → Oracle Database: persists entities
README.md - Product Repository → Oracle Database: persists entities
README.md - Customer Repository → Oracle Database: persists entities
README.md - Phone Repository → Oracle Database: persists entities
README.md - Order Repository → Oracle Database: persists entities
README.md - Order Item Repository → Oracle Database: persists entities
README.md - Status History Repository → Oracle Database: persists entities
README.md - Order API → Error Mapping: errors handled by