How triramisu/shop works
Shop is a Java/Spring modular-monolith e-commerce application, currently adding hosted payment. Its documented product spans identity, catalog, inventory, cart/checkout/order, and payment. The principal flow is a customer managing a cart, requesting checkout, and progressing through order and inventory reservation toward payment; administration and storefront catalog access are separate capabilities. The README documents module boundaries, while sampled source confirms authentication/CAPTCHA, catalog persistence, cart transactions, and inventory-orchestration state. Unsampled payment and some integration details are represented only at documented module level.
Main entry points: CheckoutController.java Checkout API · OrderCreationService.java Order creation · AuthenticationController.java Authentication API · AuthenticationService.java Authentication
Components 24
Identity and access
- Authentication API
src/main/java/com/shop/identity/internal/controller/AuthenticationController.java - Authentication
src/main/java/com/shop/identity/internal/service/AuthenticationService.java - Adaptive CAPTCHA
src/main/java/com/shop/identity/internal/captcha/service/AdaptiveCaptchaService.java - User and role admin
src/main/java/com/shop/identity/internal/administration/service/SystemUserAdministrationService.java
Catalog and storefront
- Catalog administration
src/main/java/com/shop/catalog/internal/controller/CatalogAdministrationController.java - Catalog products
src/main/java/com/shop/catalog/internal/service/CatalogProductService.java - Storefront catalog
src/main/java/com/shop/catalog/internal/storefront/service/StorefrontCatalogService.java - Product images
src/main/java/com/shop/catalog/internal/image/service/ProductImageService.java - Catalog persistence
src/main/java/com/shop/catalog/internal/repository/ProductRepository.java
Cart and orders
- Cart API
src/main/java/com/shop/order/internal/controller/CartController.java - Cart transactions
src/main/java/com/shop/order/internal/service/CartTransactionService.java - Checkout API
src/main/java/com/shop/order/internal/checkout/controller/CheckoutController.java - Checkout pricing
src/main/java/com/shop/order/internal/checkout/service/CheckoutPricingService.java - Order creation
src/main/java/com/shop/order/internal/checkout/service/OrderCreationService.java - Reservation orchestration
src/main/java/com/shop/order/internal/checkout/orchestration/OrderInventoryOrchestration.java
Stock management
- Inventory administration
src/main/java/com/shop/inventory/internal/controller/InventoryAdministrationController.java - Stock reservations
src/main/java/com/shop/inventory/internal/service/StockReservationService.java - Stock target lookup
src/main/java/com/shop/inventory/internal/service/StockReservationTargetQueryService.java - Inventory persistence
src/main/java/com/shop/inventory/internal/repository/StockItemRepository.java
Payment
- Payment initiation
src/main/java/com/shop/payment/internal/service/PaymentInitiationService.java - Hosted checkout return
src/main/java/com/shop/payment/internal/checkout/HostedCheckoutReturnController.java - Payment attempts
src/main/java/com/shop/payment/internal/repository/PaymentAttemptRepository.java
Other components
- Customer
- Administrator
Connections 21
- Customer → Authentication API: authenticates
- Authentication API → Authentication: handles requests
- Authentication → Adaptive CAPTCHA: verifies challenge
src/main/java/com/shop/identity/internal/service/AuthenticationService.java - Administrator → User and role admin: administers users
- Administrator → Catalog administration: manages catalog
- Customer → Storefront catalog: browses catalog
- Catalog administration → Catalog products: manages products
- Catalog products → Catalog persistence: reads and writes
src/main/java/com/shop/catalog/internal/service/CatalogProductService.java - Customer → Cart API: updates cart
- Cart API → Cart transactions: handles cart
- Customer → Checkout API: requests checkout
- Checkout API → Checkout pricing: quotes checkout
- Checkout API → Order creation: creates order
- Order creation → Reservation orchestration: coordinates stock
- Reservation orchestration → Stock reservations: requests reservation
- Inventory administration → Inventory persistence: manages stock
- Stock reservations → Stock target lookup: resolves target
src/main/java/com/shop/inventory/internal/service/StockReservationTargetQueryService.java - Stock target lookup → Inventory persistence: looks up item
src/main/java/com/shop/inventory/internal/service/StockReservationTargetQueryService.java - Order creation → Payment initiation: initiates payment
- Payment initiation → Payment attempts: records attempt
- Customer → Hosted checkout return: returns from checkout