How dev-victory/aspnetcore-microservices works
This is a microservice-powered shopping portal. Shoppers browse products, manage a basket, and place orders through a web UI and gateway; the aggregator combines basket, product, and order data for the shopping view. Basket checkout applies discounts and publishes an event that Ordering consumes to create an order and send email. Catalog, Basket, and Ordering have separate persistence, while Discount also exposes gRPC. The README documents these capabilities; links not visible in sampled source are cited to it or left unverified.
Main entry points: BasketController.cs Basket API · ShoppingController.cs Shopping aggregator · Orders Order commands and queries · AspnetRunBasics Shopping website
Components 22
Shopping experience
- Shopping website
src/WebApps/AspnetRunBasics - Ocelot gateway
src/ApiGateways/OcelotApiGw - Shopping aggregator
src/ApiGateways/Shopping.Aggregator/Controllers/ShoppingController.cs
Basket and catalog
- Basket API
src/Services/Basket/Basket.API/Controllers/BasketController.cs - Basket repository
src/Services/Basket/Basket.API/Repositiories/BasketRepository.cs - Catalog API
src/Services/Catalog/Catalog.API/Controllers/CatalogController.cs - Catalog repository
src/Services/Catalog/Catalog.API/Repositories/ProductRepository.cs
Order processing
- Order API
src/Services/Ordering/Ordering.API/Controllers/OrderController.cs - Order commands and queries
src/Services/Ordering/Ordering.Application/Features/Orders - Order list handler
src/Services/Ordering/Ordering.Application/Features/Orders/Queries/GetOrdersList/GetOrdersListQueryHandler.cs - Order repository
src/Services/Ordering/Ordering.Infrastructure/Repositories/RepositoryBase.cs - Order context
src/Services/Ordering/Ordering.Infrastructure/Persistence/OrderContext.cs - Order database
- Email service
src/Services/Ordering/Ordering.Infrastructure/Mail/EmailService.cs - Checkout consumer
src/Services/Ordering/Ordering.API/EventBusConsumer/BasketCheckoutConsumer.cs
Discount service
- Discount API
src/Services/Discount/Discount.API/Controllers/DiscountController.cs - Discount gRPC
src/Services/Discount/Discount.Grpc/Services/DiscountService.cs - Discount repository
src/Services/Discount/Discount.Grpc/Repositories/DiscountRepository.cs
Events and messaging
- Checkout event
src/BuildingBlocks/EventBus.Message/Events/BasketCheckoutEvent.cs - RabbitMQ broker
Other components
- Shopper
- Email provider
Connections 21
- Shopper → Shopping website: uses
- Shopping website → Ocelot gateway: calls
- Ocelot gateway → Shopping aggregator: routes
- Shopping aggregator → Basket API: gets basket
src/ApiGateways/Shopping.Aggregator/Controllers/ShoppingController.cs - Shopping aggregator → Catalog API: gets products
src/ApiGateways/Shopping.Aggregator/Controllers/ShoppingController.cs - Shopping aggregator → Order API: gets orders
src/ApiGateways/Shopping.Aggregator/Controllers/ShoppingController.cs - Basket API → Basket repository: reads and writes
src/Services/Basket/Basket.API/Controllers/BasketController.cs - Basket API → Discount gRPC: gets discount
src/Services/Basket/Basket.API/Controllers/BasketController.cs - Basket API → Checkout event: publishes
src/Services/Basket/Basket.API/Controllers/BasketController.cs - Basket API → RabbitMQ broker: publishes to
- Catalog API → Catalog repository: queries
src/Services/Catalog/Catalog.API/Controllers/CatalogController.cs - Order API → Order commands and queries: sends requests
src/Services/Ordering/Ordering.API/Controllers/OrderController.cs - Order commands and queries → Order list handler: dispatches queries
src/Services/Ordering/Ordering.Application/Features/Orders/Queries/GetOrdersList/GetOrdersListQueryHandler.cs - Order list handler → Order repository: loads orders
src/Services/Ordering/Ordering.Application/Features/Orders/Queries/GetOrdersList/GetOrdersListQueryHandler.cs - Order repository → Order context: queries and saves
src/Services/Ordering/Ordering.Infrastructure/Repositories/RepositoryBase.cs - Order context → Order database: persists orders
src/Services/Ordering/Ordering.Infrastructure/Persistence/OrderContext.cs - RabbitMQ broker → Checkout consumer: delivers event
- Checkout consumer → Order commands and queries: starts checkout
- Order commands and queries → Email service: sends email
- Email service → Email provider: sends mail
- Discount gRPC → Discount repository: queries