How shamailabbas/mirocservices-masterclass works
This repository is an educational, multi-language e-commerce microservices example. Users authenticate, browse products, manage a cart, review shipping costs, and purchase; the React UI calls an Express gateway, which routes selected API calls to services. Order management checks stock and product details, calculates totals, persists orders, and updates inventory. The README also documents standalone catalog, inventory, shipping, profile, and support services. Cross-service links not visible in excerpts are shown only where README or sampled source supports them; the service implementations are not all sampled.
Main entry points: server.js Express gateway · App.js React application · OrderService.java Cart and purchase logic · routes Catalog, stock, shipping, contact routes
Components 24
Storefront
- React application
ecommerce-ui/client/src/App.js - Sign-in and signup
ecommerce-ui/client/src/pages/AuthPage.js - Product browsing
ecommerce-ui/client/src/pages/ProductList.js - Product details
ecommerce-ui/client/src/pages/ProductDetail.js - Cart and orders
ecommerce-ui/client/src/pages/Orders.js - Inventory view
ecommerce-ui/client/src/pages/Inventory.js - Shipping view
ecommerce-ui/client/src/pages/ShippingHandling.js - Profile
ecommerce-ui/client/src/pages/Profile.js - Contact support
ecommerce-ui/client/src/pages/Contact.js
API Gateway
- Express gateway
ecommerce-ui/server/server.js - Auth routes
ecommerce-ui/server/routes/auth.js - Order routes
ecommerce-ui/server/routes/orders.js - Catalog, stock, shipping, contact routes
ecommerce-ui/server/routes
Commerce Services
- Product catalog
product-catalog/index.js - Inventory API
product-inventory/inventory_api.py - Order controller
order-management/src/main/java/com/ltp/ordermanagement/OrderController.java - Cart and purchase logic
order-management/src/main/java/com/ltp/ordermanagement/service/OrderService.java - Cart item model
order-management/src/main/java/com/ltp/ordermanagement/model/CartItem.java - Product model
order-management/src/main/java/com/ltp/ordermanagement/model/Product.java - Order repository
order-management/src/main/java/com/ltp/ordermanagement/repository/OrderRepository.java - Shipping service
shipping-and-handling/main.go
Identity and Support
- Profile and auth service
profile-management/auth_api.js - Support API
contact-support-team/server.py
Other components
- Shopper
Connections 33
- Shopper → React application: uses
ecommerce-ui/client/src/App.js - React application → Sign-in and signup: routes
ecommerce-ui/client/src/App.js - React application → Product browsing: routes
ecommerce-ui/client/src/App.js - React application → Product details: routes
ecommerce-ui/client/src/App.js - React application → Cart and orders: routes
ecommerce-ui/client/src/App.js - React application → Inventory view: routes
ecommerce-ui/client/src/App.js - React application → Shipping view: routes
ecommerce-ui/client/src/App.js - React application → Profile: routes
ecommerce-ui/client/src/App.js - React application → Contact support: routes
ecommerce-ui/client/src/App.js - Sign-in and signup → Express gateway: requests
ecommerce-ui/client/src/pages/AuthPage.js - Product browsing → Express gateway: requests
- Product details → Express gateway: requests
- Cart and orders → Express gateway: requests
- Inventory view → Express gateway: requests
- Shipping view → Express gateway: requests
- Profile → Express gateway: requests
- Contact support → Express gateway: requests
- Express gateway → Auth routes: mounts
ecommerce-ui/server/server.js - Express gateway → Order routes: mounts
ecommerce-ui/server/server.js - Express gateway → Catalog, stock, shipping, contact routes: mounts
ecommerce-ui/server/server.js - Auth routes → Profile and auth service: forwards auth
ecommerce-ui/server/routes/auth.js - Order routes → Order controller: forwards orders
ecommerce-ui/server/routes/orders.js - Order controller → Cart and purchase logic: delegates
order-management/src/main/java/com/ltp/ordermanagement/OrderController.java - Cart and purchase logic → Inventory API: checks and updates stock
order-management/src/main/java/com/ltp/ordermanagement/service/OrderService.java - Cart and purchase logic → Product catalog: loads product details
order-management/src/main/java/com/ltp/ordermanagement/service/OrderService.java - Cart and purchase logic → Shipping service: requests shipping fee
order-management/src/main/java/com/ltp/ordermanagement/service/OrderService.java - Cart and purchase logic → Order repository: persists orders
order-management/src/main/java/com/ltp/ordermanagement/service/OrderService.java - Cart and purchase logic → Cart item model: creates items
order-management/src/main/java/com/ltp/ordermanagement/service/OrderService.java - Cart and purchase logic → Product model: reads product data
order-management/src/main/java/com/ltp/ordermanagement/service/OrderService.java - Catalog, stock, shipping, contact routes → Product catalog: forwards catalog
- Catalog, stock, shipping, contact routes → Inventory API: forwards inventory
- Catalog, stock, shipping, contact routes → Shipping service: forwards shipping
- Catalog, stock, shipping, contact routes → Support API: forwards contact