How abdalrahmanehab/spring-commerce works
Spring Commerce is a package-by-feature e-commerce REST API. The principal workflow spans product catalog and inventory, cart management, and order checkout; account registration is a separate entry point. Controllers delegate through service boundaries, with repositories and product-store adapters providing persistence. The README documents atomic checkout, stock handling, order snapshots and status transitions, but the order implementation was not sampled, so its internal calls are shown only as unverified relationships. Product, cart, order, and user capabilities are represented without inferring unsampled implementation details.
Main entry points: OrderServiceImpl.java Checkout and Status · CartServiceImpl.java Cart Management · ProductServiceImpl.java Catalog and Stock · ProductController.java Product API
Components 20
Catalog and Inventory
- Product API
src/main/java/com/abdalrahman/springcommerce/product/controller/ProductController.java - Catalog and Stock
src/main/java/com/abdalrahman/springcommerce/product/service/ProductServiceImpl.java - Product Repository
src/main/java/com/abdalrahman/springcommerce/product/repository/ProductRepositoryImpl.java - Product Store Adapters
src/main/java/com/abdalrahman/springcommerce/product/repository - Product Database
src/main/java/com/abdalrahman/springcommerce/product/Product.java
Cart and Orders
- Cart API
src/main/java/com/abdalrahman/springcommerce/cart/controller/CartController.java - Cart Management
src/main/java/com/abdalrahman/springcommerce/cart/service/CartServiceImpl.java - Cart Repository
src/main/java/com/abdalrahman/springcommerce/cart/repository/CartRepository.java - Cart Store
src/main/java/com/abdalrahman/springcommerce/cart/Cart.java - Order API
src/main/java/com/abdalrahman/springcommerce/order/controller/OrderController.java - Checkout and Status
src/main/java/com/abdalrahman/springcommerce/order/service/OrderServiceImpl.java - Order Repository
src/main/java/com/abdalrahman/springcommerce/order/repository/OrderRepository.java - Order Store
src/main/java/com/abdalrahman/springcommerce/order/Order.java
Accounts and Security
- Registration API
src/main/java/com/abdalrahman/springcommerce/auth/controller/AuthController.java - User Management
src/main/java/com/abdalrahman/springcommerce/user/service/UserServiceImpl.java - User Repository
src/main/java/com/abdalrahman/springcommerce/user/repository/UserRepository.java - User Store
src/main/java/com/abdalrahman/springcommerce/user/User.java - Security Configuration
src/main/java/com/abdalrahman/springcommerce/security/SecurityConfig.java
Shared API Support
- Error Responses
src/main/java/com/abdalrahman/springcommerce/shared/errors/handlers/GlobalExceptionHandler.java
Other components
- API Client
Connections 22
- API Client → Product API: requests
- API Client → Cart API: requests
- API Client → Order API: requests
- API Client → Registration API: registers
- Product API → Catalog and Stock: delegates to
src/main/java/com/abdalrahman/springcommerce/product/controller/ProductController.java - Catalog and Stock → Product Repository: uses
src/main/java/com/abdalrahman/springcommerce/product/service/ProductServiceImpl.java - Product Repository → Product Store Adapters: delegates to
src/main/java/com/abdalrahman/springcommerce/product/repository/ProductRepositoryImpl.java - Product Store Adapters → Product Database: stores products
src/main/java/com/abdalrahman/springcommerce/product/repository/DbService.java - Cart API → Cart Management: delegates to
src/main/java/com/abdalrahman/springcommerce/cart/controller/CartController.java - Cart Management → Cart Repository: uses
src/main/java/com/abdalrahman/springcommerce/cart/service/CartServiceImpl.java - Cart Repository → Cart Store: persists
src/main/java/com/abdalrahman/springcommerce/cart/repository/CartRepository.java - Cart Management → Catalog and Stock: checks stock
src/main/java/com/abdalrahman/springcommerce/cart/service/CartServiceImpl.java - Order API → Checkout and Status: delegates to
src/main/java/com/abdalrahman/springcommerce/order/controller/OrderController.java - Checkout and Status → Order Repository: persists orders
src/main/java/com/abdalrahman/springcommerce/order/service/OrderServiceImpl.java - Order Repository → Order Store: stores orders
src/main/java/com/abdalrahman/springcommerce/order/repository/OrderRepository.java - Checkout and Status → Cart Management: reads and clears cart
- Checkout and Status → Catalog and Stock: reserves stock
- Registration API → User Management: registers user
src/main/java/com/abdalrahman/springcommerce/auth/controller/AuthController.java - User Management → User Repository: uses
src/main/java/com/abdalrahman/springcommerce/user/service/UserServiceImpl.java - User Repository → User Store: persists
src/main/java/com/abdalrahman/springcommerce/user/repository/UserRepository.java - API Client → Security Configuration: authenticated requests
- Error Responses → API Client: returns errors