# dev-victory/aspnetcore-microservices architecture

> Architecture diagram of the GitHub repository dev-victory/aspnetcore-microservices, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dev-victory/aspnetcore-microservices
- Repository: https://github.com/dev-victory/aspnetcore-microservices

## Overview

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: [`src/Services/Basket/Basket.API/Controllers/BasketController.cs`](https://github.com/dev-victory/aspnetcore-microservices/blob/main/src/Services/Basket/Basket.API/Controllers/BasketController.cs) (Basket API), [`src/ApiGateways/Shopping.Aggregator/Controllers/ShoppingController.cs`](https://github.com/dev-victory/aspnetcore-microservices/blob/main/src/ApiGateways/Shopping.Aggregator/Controllers/ShoppingController.cs) (Shopping aggregator), [`src/Services/Ordering/Ordering.Application/Features/Orders`](https://github.com/dev-victory/aspnetcore-microservices/tree/main/src/Services/Ordering/Ordering.Application/Features/Orders) (Order commands and queries), [`src/WebApps/AspnetRunBasics`](https://github.com/dev-victory/aspnetcore-microservices/tree/main/src/WebApps/AspnetRunBasics) (Shopping website)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Shopping experience"]
  node_web_ui["Shopping website"]
  node_ocelot["Ocelot gateway"]
  node_aggregator["Shopping aggregator"]
end

subgraph group_basket_catalog["Basket and catalog"]
  node_basket_service["Basket API"]
  node_basket_store[("Basket repository")]
  node_catalog_api["Catalog API"]
  node_catalog_store[("Catalog repository")]
end

subgraph group_ordering["Order processing"]
  node_ordering_api["Order API<br/>[OrderController.cs]"]
  node_order_application["Order commands and queries<br/>[Orders]"]
  node_query_handler["Order list handler"]
  node_order_repository["Order repository<br/>[RepositoryBase.cs]"]
  node_order_context["Order context<br/>[OrderContext.cs]"]
  node_order_store[("Order database")]
  node_email_service["Email service<br/>[EmailService.cs]"]
  node_checkout_consumer["Checkout consumer"]
end

subgraph group_discount["Discount service"]
  node_discount_api["Discount API"]
  node_discount_grpc["Discount gRPC<br/>[DiscountService.cs]"]
  node_discount_store[("Discount repository")]
end

subgraph group_shared["Events and messaging"]
  node_checkout_event["Checkout event"]
  node_message_broker["RabbitMQ broker"]
end

node_shopper(("Shopper"))
node_email_provider["Email provider"]

node_shopper -->|"uses"| node_web_ui
node_web_ui -->|"calls"| node_ocelot
node_ocelot -.->|"routes"| node_aggregator
node_aggregator -->|"gets basket"| node_basket_service
node_aggregator -->|"gets products"| node_catalog_api
node_aggregator -->|"gets orders"| node_ordering_api
node_basket_service -->|"reads and writes"| node_basket_store
node_basket_service -->|"gets discount"| node_discount_grpc
node_basket_service -->|"publishes"| node_checkout_event
node_basket_service -->|"publishes to"| node_message_broker
node_catalog_api -->|"queries"| node_catalog_store
node_ordering_api -->|"sends requests"| node_order_application
node_order_application -.->|"dispatches queries"| node_query_handler
node_query_handler -->|"loads orders"| node_order_repository
node_order_repository -->|"queries and saves"| node_order_context
node_order_context -->|"persists orders"| node_order_store
node_message_broker -->|"delivers event"| node_checkout_consumer
node_checkout_consumer -.->|"starts checkout"| node_order_application
node_order_application -.->|"sends email"| node_email_service
node_email_service -.->|"sends mail"| node_email_provider
node_discount_grpc -.->|"queries"| node_discount_store

click node_web_ui "https://github.com/dev-victory/aspnetcore-microservices/tree/main/src/WebApps/AspnetRunBasics"
click node_ocelot "https://github.com/dev-victory/aspnetcore-microservices/tree/main/src/ApiGateways/OcelotApiGw"
click node_aggregator "https://github.com/dev-victory/aspnetcore-microservices/blob/main/src/ApiGateways/Shopping.Aggregator/Controllers/ShoppingController.cs"
click node_basket_service "https://github.com/dev-victory/aspnetcore-microservices/blob/main/src/Services/Basket/Basket.API/Controllers/BasketController.cs"
click node_basket_store "https://github.com/dev-victory/aspnetcore-microservices/blob/main/src/Services/Basket/Basket.API/Repositiories/BasketRepository.cs"
click node_catalog_api "https://github.com/dev-victory/aspnetcore-microservices/blob/main/src/Services/Catalog/Catalog.API/Controllers/CatalogController.cs"
click node_catalog_store "https://github.com/dev-victory/aspnetcore-microservices/blob/main/src/Services/Catalog/Catalog.API/Repositories/ProductRepository.cs"
click node_ordering_api "https://github.com/dev-victory/aspnetcore-microservices/blob/main/src/Services/Ordering/Ordering.API/Controllers/OrderController.cs"
click node_order_application "https://github.com/dev-victory/aspnetcore-microservices/tree/main/src/Services/Ordering/Ordering.Application/Features/Orders"
click node_query_handler "https://github.com/dev-victory/aspnetcore-microservices/blob/main/src/Services/Ordering/Ordering.Application/Features/Orders/Queries/GetOrdersList/GetOrdersListQueryHandler.cs"
click node_order_repository "https://github.com/dev-victory/aspnetcore-microservices/blob/main/src/Services/Ordering/Ordering.Infrastructure/Repositories/RepositoryBase.cs"
click node_order_context "https://github.com/dev-victory/aspnetcore-microservices/blob/main/src/Services/Ordering/Ordering.Infrastructure/Persistence/OrderContext.cs"
click node_email_service "https://github.com/dev-victory/aspnetcore-microservices/blob/main/src/Services/Ordering/Ordering.Infrastructure/Mail/EmailService.cs"
click node_discount_api "https://github.com/dev-victory/aspnetcore-microservices/blob/main/src/Services/Discount/Discount.API/Controllers/DiscountController.cs"
click node_discount_grpc "https://github.com/dev-victory/aspnetcore-microservices/blob/main/src/Services/Discount/Discount.Grpc/Services/DiscountService.cs"
click node_discount_store "https://github.com/dev-victory/aspnetcore-microservices/blob/main/src/Services/Discount/Discount.Grpc/Repositories/DiscountRepository.cs"
click node_checkout_event "https://github.com/dev-victory/aspnetcore-microservices/blob/main/src/BuildingBlocks/EventBus.Message/Events/BasketCheckoutEvent.cs"
click node_checkout_consumer "https://github.com/dev-victory/aspnetcore-microservices/blob/main/src/Services/Ordering/Ordering.API/EventBusConsumer/BasketCheckoutConsumer.cs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_web_ui,node_ocelot,node_aggregator toneBlue
class node_basket_service,node_basket_store,node_catalog_api,node_catalog_store toneAmber
class node_ordering_api,node_order_application,node_query_handler,node_order_repository,node_order_context,node_order_store,node_email_service,node_checkout_consumer toneMint
class node_discount_api,node_discount_grpc,node_discount_store toneRose
class node_checkout_event,node_message_broker,node_shopper,node_email_provider toneIndigo
```

## Components

### Shopping experience

- [Shopping website](https://github.com/dev-victory/aspnetcore-microservices/tree/main/src/WebApps/AspnetRunBasics): `src/WebApps/AspnetRunBasics`
- [Ocelot gateway](https://github.com/dev-victory/aspnetcore-microservices/tree/main/src/ApiGateways/OcelotApiGw): `src/ApiGateways/OcelotApiGw`
- [Shopping aggregator](https://github.com/dev-victory/aspnetcore-microservices/blob/main/src/ApiGateways/Shopping.Aggregator/Controllers/ShoppingController.cs): `src/ApiGateways/Shopping.Aggregator/Controllers/ShoppingController.cs`

### Basket and catalog

- [Basket API](https://github.com/dev-victory/aspnetcore-microservices/blob/main/src/Services/Basket/Basket.API/Controllers/BasketController.cs): `src/Services/Basket/Basket.API/Controllers/BasketController.cs`
- [Basket repository](https://github.com/dev-victory/aspnetcore-microservices/blob/main/src/Services/Basket/Basket.API/Repositiories/BasketRepository.cs): `src/Services/Basket/Basket.API/Repositiories/BasketRepository.cs`
- [Catalog API](https://github.com/dev-victory/aspnetcore-microservices/blob/main/src/Services/Catalog/Catalog.API/Controllers/CatalogController.cs): `src/Services/Catalog/Catalog.API/Controllers/CatalogController.cs`
- [Catalog repository](https://github.com/dev-victory/aspnetcore-microservices/blob/main/src/Services/Catalog/Catalog.API/Repositories/ProductRepository.cs): `src/Services/Catalog/Catalog.API/Repositories/ProductRepository.cs`

### Order processing

- [Order API](https://github.com/dev-victory/aspnetcore-microservices/blob/main/src/Services/Ordering/Ordering.API/Controllers/OrderController.cs): `src/Services/Ordering/Ordering.API/Controllers/OrderController.cs`
- [Order commands and queries](https://github.com/dev-victory/aspnetcore-microservices/tree/main/src/Services/Ordering/Ordering.Application/Features/Orders): `src/Services/Ordering/Ordering.Application/Features/Orders`
- [Order list handler](https://github.com/dev-victory/aspnetcore-microservices/blob/main/src/Services/Ordering/Ordering.Application/Features/Orders/Queries/GetOrdersList/GetOrdersListQueryHandler.cs): `src/Services/Ordering/Ordering.Application/Features/Orders/Queries/GetOrdersList/GetOrdersListQueryHandler.cs`
- [Order repository](https://github.com/dev-victory/aspnetcore-microservices/blob/main/src/Services/Ordering/Ordering.Infrastructure/Repositories/RepositoryBase.cs): `src/Services/Ordering/Ordering.Infrastructure/Repositories/RepositoryBase.cs`
- [Order context](https://github.com/dev-victory/aspnetcore-microservices/blob/main/src/Services/Ordering/Ordering.Infrastructure/Persistence/OrderContext.cs): `src/Services/Ordering/Ordering.Infrastructure/Persistence/OrderContext.cs`
- **Order database**
- [Email service](https://github.com/dev-victory/aspnetcore-microservices/blob/main/src/Services/Ordering/Ordering.Infrastructure/Mail/EmailService.cs): `src/Services/Ordering/Ordering.Infrastructure/Mail/EmailService.cs`
- [Checkout consumer](https://github.com/dev-victory/aspnetcore-microservices/blob/main/src/Services/Ordering/Ordering.API/EventBusConsumer/BasketCheckoutConsumer.cs): `src/Services/Ordering/Ordering.API/EventBusConsumer/BasketCheckoutConsumer.cs`

### Discount service

- [Discount API](https://github.com/dev-victory/aspnetcore-microservices/blob/main/src/Services/Discount/Discount.API/Controllers/DiscountController.cs): `src/Services/Discount/Discount.API/Controllers/DiscountController.cs`
- [Discount gRPC](https://github.com/dev-victory/aspnetcore-microservices/blob/main/src/Services/Discount/Discount.Grpc/Services/DiscountService.cs): `src/Services/Discount/Discount.Grpc/Services/DiscountService.cs`
- [Discount repository](https://github.com/dev-victory/aspnetcore-microservices/blob/main/src/Services/Discount/Discount.Grpc/Repositories/DiscountRepository.cs): `src/Services/Discount/Discount.Grpc/Repositories/DiscountRepository.cs`

### Events and messaging

- [Checkout event](https://github.com/dev-victory/aspnetcore-microservices/blob/main/src/BuildingBlocks/EventBus.Message/Events/BasketCheckoutEvent.cs): `src/BuildingBlocks/EventBus.Message/Events/BasketCheckoutEvent.cs`
- **RabbitMQ broker**

### Other components

- **Shopper**
- **Email provider**

## Connections

- Shopper → Shopping website: uses
- Shopping website → Ocelot gateway: calls
- Ocelot gateway → Shopping aggregator: routes
- Shopping aggregator → Basket API: gets basket (evidence: `src/ApiGateways/Shopping.Aggregator/Controllers/ShoppingController.cs`)
- Shopping aggregator → Catalog API: gets products (evidence: `src/ApiGateways/Shopping.Aggregator/Controllers/ShoppingController.cs`)
- Shopping aggregator → Order API: gets orders (evidence: `src/ApiGateways/Shopping.Aggregator/Controllers/ShoppingController.cs`)
- Basket API → Basket repository: reads and writes (evidence: `src/Services/Basket/Basket.API/Controllers/BasketController.cs`)
- Basket API → Discount gRPC: gets discount (evidence: `src/Services/Basket/Basket.API/Controllers/BasketController.cs`)
- Basket API → Checkout event: publishes (evidence: `src/Services/Basket/Basket.API/Controllers/BasketController.cs`)
- Basket API → RabbitMQ broker: publishes to
- Catalog API → Catalog repository: queries (evidence: `src/Services/Catalog/Catalog.API/Controllers/CatalogController.cs`)
- Order API → Order commands and queries: sends requests (evidence: `src/Services/Ordering/Ordering.API/Controllers/OrderController.cs`)
- Order commands and queries → Order list handler: dispatches queries (evidence: `src/Services/Ordering/Ordering.Application/Features/Orders/Queries/GetOrdersList/GetOrdersListQueryHandler.cs`)
- Order list handler → Order repository: loads orders (evidence: `src/Services/Ordering/Ordering.Application/Features/Orders/Queries/GetOrdersList/GetOrdersListQueryHandler.cs`)
- Order repository → Order context: queries and saves (evidence: `src/Services/Ordering/Ordering.Infrastructure/Repositories/RepositoryBase.cs`)
- Order context → Order database: persists orders (evidence: `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
