How dotnet/eshop works
eShop is a services-based e-commerce application with web and MAUI clients, catalog and basket services, identity, ordering, payment and event-driven supporting services. The expected customer journey is browsing products, building a basket and checking out into an order; the tree also shows order-status processing, location, chatbot and webhook capabilities. The sampled evidence supports several internal calls and registrations, but not most client-to-service or cross-service wiring, so those connections are omitted rather than inferred.
Main entry points: ValidateOrAddBuyerAggregateWhenOrderStartedDomainEventHandler.cs Buyer validation · ClientApp MAUI client · IEventBus.cs Event bus · GracePeriodManagerService.cs Grace period
Components 24
Customer clients
- Web application
src/WebApp - MAUI client
src/ClientApp - Location model
src/ClientApp/Models/Location/Location.cs - Order client
src/ClientApp/Services/Order/OrderService.cs - Basket client
src/ClientApp/Services/Basket/Protos/Basket.cs - Client settings
src/ClientApp/Services/Settings/ISettingsService.cs
Commerce services
- Product catalog
src/Catalog.API/Apis/CatalogApi.cs - Basket service
src/Basket.API/Grpc/BasketService.cs - Basket storage
src/Basket.API/Repositories/RedisBasketRepository.cs - Order API
src/Ordering.API/Apis/OrdersApi.cs - Buyer validation
src/Ordering.API/Application/DomainEventHandlers/ValidateOrAddBuyerAggregateWhenOrderStartedDomainEventHandler.cs - Order domain
src/Ordering.Domain/AggregatesModel/OrderAggregate/Order.cs - Ordering context
src/Ordering.Infrastructure/OrderingContext.cs
Identity
- Identity service
src/Identity.API/Quickstart/Account/AccountController.cs - Device authorization
src/Identity.API/Quickstart/Device/DeviceController.cs
Events and processing
- Event bus
src/EventBus/Abstractions/IEventBus.cs - Integration event
src/EventBus/Events/IntegrationEvent.cs - Grace period
src/OrderProcessor/Services/GracePeriodManagerService.cs - Payment processor
src/PaymentProcessor/Program.cs - Event log
src/IntegrationEventLogEF/Services/IntegrationEventLogService.cs
Webhooks
- Webhook API
src/Webhooks.API/Services/WebhooksRetriever.cs - Webhook subscriptions
src/Webhooks.API/Infrastructure/WebhooksContext.cs - Webhook client
src/WebhookClient/Endpoints/WebhookEndpoints.cs
Other components
- Customer
Connections 8
- MAUI client → Client settings: reads
src/ClientApp/App.xaml.cs - MAUI client → Location model: updates location
src/ClientApp/App.xaml.cs - Buyer validation → Ordering context: saves entities
src/Ordering.API/Application/DomainEventHandlers/ValidateOrAddBuyerAggregateWhenOrderStartedDomainEventHandler.cs - Buyer validation → Integration event: creates
src/Ordering.API/Application/DomainEventHandlers/ValidateOrAddBuyerAggregateWhenOrderStartedDomainEventHandler.cs - Buyer validation → Event log
- Grace period → Event bus: publishes events
src/OrderProcessor/Services/GracePeriodManagerService.cs - Payment processor → Event bus: registers subscription
src/PaymentProcessor/Program.cs - Webhook API → Webhook subscriptions: reads subscriptions
src/Webhooks.API/Services/WebhooksRetriever.cs