How mario-pv/e-commerce-modular-monolith works
This is a single-deployment e-commerce modular monolith with a React storefront and Spring backend. Shoppers browse live stock, build a cart or simulate competing purchases, then submit checkout; the order service deducts inventory and persists orders transactionally, while post-commit events feed notifications. Order history and the notification feed are exposed through the observability view. The README documents the transactional outbox, locking strategies, and pagination; unsampled implementation details are represented only where documented, and edge evidence is limited to shown excerpts, indexed references, or the README.
Main entry points: App.jsx Storefront app · client.js API client · InventoryService.java Inventory service · OrderService.java Order service
Components 23
Storefront
- Storefront app
frontend/src/App.jsx - Product catalog
frontend/src/Catalog.jsx - Product actions
frontend/src/ProductActions.jsx - Cart checkout UI
frontend/src/Cart.jsx - Rush simulator
frontend/src/RushSimulator.jsx - Observability UI
frontend/src/Observability.jsx - API client
frontend/src/api/client.js
Catalog and inventory
- Product API
src/main/java/com/portfolio/modulith/inventory/ProductController.java - Inventory API
src/main/java/com/portfolio/modulith/inventory/InventoryController.java - Inventory service
src/main/java/com/portfolio/modulith/inventory/InventoryService.java - Stock view DTO
src/main/java/com/portfolio/modulith/inventory/StockView.java - Stock repository
src/main/java/com/portfolio/modulith/inventory/internal/StockRepository.java - Stock entity
src/main/java/com/portfolio/modulith/inventory/internal/Stock.java
Checkout and orders
- Order API
src/main/java/com/portfolio/modulith/order/OrderController.java - Order service
src/main/java/com/portfolio/modulith/order/OrderService.java - Order repository
src/main/java/com/portfolio/modulith/order/OrderRepository.java - Order entity
src/main/java/com/portfolio/modulith/order/Order.java - Order-created event
src/main/java/com/portfolio/modulith/order/OrderCreatedEvent.java - Event publication outbox
src/main/resources/db/migration/V2__modulith_publication_lifecycle.sql
Notifications and activity
- Notification listener
src/main/java/com/portfolio/modulith/notification/NotificationListener.java - Notification API
src/main/java/com/portfolio/modulith/notification/NotificationController.java
Other components
- Shopper
- MySQL database
Connections 31
- Shopper → Storefront app: uses
README.md - Storefront app → Product catalog: renders
frontend/src/App.jsx - Storefront app → Cart checkout UI: renders
frontend/src/App.jsx - Storefront app → Rush simulator: opens
frontend/src/App.jsx - Storefront app → Observability UI: renders
frontend/src/App.jsx - Storefront app → API client: calls
frontend/src/App.jsx - Product catalog → Product actions: renders
frontend/src/Catalog.jsx - Product actions → Storefront app: invokes callbacks
frontend/src/App.jsx - Cart checkout UI → Storefront app: submits checkout
frontend/src/App.jsx - Rush simulator → API client: simulates requests
- Observability UI → API client: fetches activity
frontend/src/Observability.jsx - API client → Product API: requests products
README.md - API client → Order API: requests orders
README.md - API client → Notification API: requests notifications
README.md - Product API → Inventory service: reads stock
src/main/java/com/portfolio/modulith/inventory/ProductController.java - Inventory API → Inventory service: delegates to
src/main/java/com/portfolio/modulith/inventory/InventoryController.java - Inventory service → Stock repository: reads and writes
src/main/java/com/portfolio/modulith/inventory/InventoryService.java - Inventory service → Stock entity: uses
src/main/java/com/portfolio/modulith/inventory/InventoryService.java - Inventory service → Stock view DTO: maps to
src/main/java/com/portfolio/modulith/inventory/InventoryService.java - Stock repository → Stock entity: persists
src/main/java/com/portfolio/modulith/inventory/internal/StockRepository.java - Stock repository → MySQL database: reads and writes
- Order API → Order service: delegates to
src/main/java/com/portfolio/modulith/order/OrderController.java - Order service → Inventory service: deducts stock
src/main/java/com/portfolio/modulith/order/OrderService.java - Order service → Order repository: saves and queries
src/main/java/com/portfolio/modulith/order/OrderService.java - Order repository → Order entity: persists
src/main/java/com/portfolio/modulith/order/OrderRepository.java - Order repository → MySQL database: reads and writes
- Order service → Order-created event: publishes
src/main/java/com/portfolio/modulith/order/OrderService.java - Order-created event → Event publication outbox: records transactionally
README.md - Event publication outbox → Notification listener: dispatches after commit
README.md - Notification listener → Order-created event: handles
src/main/java/com/portfolio/modulith/notification/NotificationListener.java - Notification API → Notification listener: reads feed
src/main/java/com/portfolio/modulith/notification/NotificationController.java