How swmiller/aspnetcore-microservices-architecture works
This is an educational ASP.NET Core microservices shopping application, with separate web, basket, catalog, discount, and ordering components plus shared building blocks. The principal workflow is browsing products, maintaining a basket, checking out, and managing orders. The excerpts show the web app’s gateway-based client setup and the basket checkout’s publish-and-delete behavior; ordering and several service interactions are represented from the tree and index, so uncertain connections are omitted or marked unverified.
Main entry points: Services API clients · CreateOrderHandler.cs Order handlers · Basket Basket endpoints · CheckoutBasketHandler.cs Basket checkout
Components 22
Shopping web
- Razor storefront
src/WebApps/Shopping.Web/Pages - API clients
src/WebApps/Shopping.Web/Services
Commerce APIs
- YARP gateway
src/ApiGateways/YarpApiGateway/Program.cs - Product catalog
src/Services/Catalog/Catalog.API/Products - Catalog data
src/Services/Catalog/Catalog.API/Models/Product.cs - Basket endpoints
src/Services/Basket/Basket.API/Basket - Shopping cart
src/Services/Basket/Basket.API/Models/ShoppingCart.cs - Basket repository
src/Services/Basket/Basket.API/Data/CachedBasketRepository.cs - Basket persistence
src/Services/Basket/Basket.API/Data/BasketRepository.cs - Discount gRPC
src/Services/Discount/Discount.Grpc/Services/DiscountService.cs - Coupon store
src/Services/Discount/Discount.Grpc/Data/DiscountContext.cs - Basket checkout
src/Services/Basket/Basket.API/Basket/CheckoutBasket/CheckoutBasketHandler.cs
Order management
- Order endpoints
src/Services/Ordering/Ordering.API/Endpoints/CreateOrder.cs - Order handlers
src/Services/Ordering/Ordering.Application/Orders/Commands/CreateOrder/CreateOrderHandler.cs - Order domain
src/Services/Ordering/Ordering.Domain/Models/Order.cs - Order persistence
src/Services/Ordering/Ordering.Infrastructure/Data/ApplicationDbContext.cs
Shared infrastructure
- Message broker
src/BuildingBlocks/BuildingBlocks.Messaging/MassTransit/Extentions.cs - Checkout event
src/BuildingBlocks/BuildingBlocks.Messaging/Events/BasketCheckoutEvent.cs - CQRS contracts
src/BuildingBlocks/BuildingBlocks/CQRS/ICommand.cs - Request behaviors
src/BuildingBlocks/BuildingBlocks/Behaviors/ValidationBehavior.cs - Exception handling
src/BuildingBlocks/BuildingBlocks/Exceptions/Handler/CustomExceptionHandler.cs
Other components
- Shopper
Connections 22
- Shopper → Razor storefront: uses
- Razor storefront → API clients: calls
src/WebApps/Shopping.Web/Pages/ProductList.cshtml.cs - API clients → YARP gateway: targets
- API clients → Product catalog: requests products
- API clients → Basket endpoints: requests basket
src/WebApps/Shopping.Web/Services/IBasketService.cs - YARP gateway → Product catalog
- YARP gateway → Basket endpoints
- Product catalog → Catalog data: manages products
- Basket endpoints → Shopping cart: uses cart
- Basket repository → Basket persistence: persists
- Basket endpoints → Basket repository: uses repository
- Discount gRPC → Coupon store: reads and writes
src/Services/Discount/Discount.Grpc/Services/DiscountService.cs - Basket checkout → Basket repository: loads and deletes
src/Services/Basket/Basket.API/Basket/CheckoutBasket/CheckoutBasketHandler.cs - Basket checkout → Checkout event: creates
src/Services/Basket/Basket.API/Basket/CheckoutBasket/CheckoutBasketHandler.cs - Basket checkout → Message broker: publishes
src/Services/Basket/Basket.API/Basket/CheckoutBasket/CheckoutBasketHandler.cs - Checkout event → Order endpoints: may trigger order creation
- Order endpoints → Order handlers: dispatches requests
- Order handlers → Order domain: updates order
- Order handlers → Order persistence: persists orders
- Order handlers → CQRS contracts: uses contract
- Request behaviors → CQRS contracts: validates commands
src/BuildingBlocks/BuildingBlocks/Behaviors/ValidationBehavior.cs - Exception handling → Razor storefront: formats errors