# ardalis/cleanarchitecture architecture

> Architecture diagram of the GitHub repository ardalis/cleanarchitecture, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ardalis/cleanarchitecture
- Repository: https://github.com/ardalis/cleanarchitecture

## Overview

This repository is an ASP.NET Core Clean Architecture starter/template, with both a contributor-management sample and a minimal cart-and-catalog sample. The principal workflows accept HTTP requests, handle application use cases, apply domain behavior, and access persistence or integrations. The graph preserves both samples’ distinct capabilities and the shared architectural layers. Source excerpts confirm selected dependency registrations, listing-query persistence, and contributor deletion/event dispatch; other endpoint-to-handler wiring is not shown, so those links are omitted.

Main entry points: [`MinimalClean/src/MinimalClean.Architecture.Web/Program.cs`](https://github.com/ardalis/cleanarchitecture/blob/main/MinimalClean/src/MinimalClean.Architecture.Web/Program.cs) (Minimal API), [`src/Clean.Architecture.Core/Services/DeleteContributorService.cs`](https://github.com/ardalis/cleanarchitecture/blob/main/src/Clean.Architecture.Core/Services/DeleteContributorService.cs) (Delete service), [`src/Clean.Architecture.Web/Program.cs`](https://github.com/ardalis/cleanarchitecture/blob/main/src/Clean.Architecture.Web/Program.cs) (Contributor API), [`src/Clean.Architecture.Infrastructure/Data/EfRepository.cs`](https://github.com/ardalis/cleanarchitecture/blob/main/src/Clean.Architecture.Infrastructure/Data/EfRepository.cs) (Contributor repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["HTTP applications"]
  node_fullweb["Contributor API<br/>[Program.cs]"]
  node_contributor_routes["Contributor routes<br/>[Contributors]"]
  node_minweb["Minimal API<br/>[Program.cs]"]
  node_product_routes["Product routes<br/>[ProductFeatures]"]
  node_cart_routes["Cart routes<br/>[CartFeatures]"]
end

subgraph group_usecases["Application workflows"]
  node_contributor_cases["Contributor use cases<br/>[Contributors]"]
  node_contributor_list["Contributor listing"]
  node_product_list["Product listing"]
  node_cart_handlers["Cart handlers<br/>[CartFeatures]"]
end

subgraph group_domain["Domain model"]
  node_contributor_domain["Contributor aggregate<br/>[Contributor.cs]"]
  node_delete_service["Delete service"]
  node_cart_domain["Cart aggregate<br/>[Cart.cs]"]
  node_product_domain["Product aggregate<br/>[Product.cs]"]
  node_order_domain["Order aggregate<br/>[Order.cs]"]
end

subgraph group_infrastructure["Persistence and integrations"]
  node_contributor_repo["Contributor repository<br/>[EfRepository.cs]"]
  node_contributor_query["Contributor query service"]
  node_minimal_repo["Minimal repository<br/>[EfRepository.cs]"]
  node_product_query["Product query service"]
  node_contributor_db[("Contributor database<br/>[AppDbContext.cs]")]
  node_minimal_db[("Cart catalog database<br/>[AppDbContext.cs]")]
  node_event_dispatch["Domain event dispatch"]
  node_email_sender["Email sender"]
end

node_client(("API client"))
node_mailserver(("Mail server"))

node_client -->|"sends requests"| node_fullweb
node_client -->|"sends requests"| node_minweb
node_fullweb -->|"maps endpoints"| node_contributor_routes
node_minweb -->|"maps endpoints"| node_product_routes
node_minweb -->|"maps endpoints"| node_cart_routes
node_contributor_list -->|"requests page"| node_contributor_query
node_contributor_query -->|"queries contributors"| node_contributor_db
node_product_list -->|"requests page"| node_product_query
node_product_query -->|"queries products"| node_minimal_db
node_delete_service -->|"loads and deletes"| node_contributor_repo
node_contributor_repo -->|"persists aggregates"| node_contributor_db
node_delete_service -->|"publishes event"| node_event_dispatch
node_event_dispatch -.->|"dispatches event"| node_email_sender
node_email_sender -.->|"sends email"| node_mailserver

click node_fullweb "https://github.com/ardalis/cleanarchitecture/blob/main/src/Clean.Architecture.Web/Program.cs"
click node_contributor_routes "https://github.com/ardalis/cleanarchitecture/tree/main/src/Clean.Architecture.Web/Contributors"
click node_minweb "https://github.com/ardalis/cleanarchitecture/blob/main/MinimalClean/src/MinimalClean.Architecture.Web/Program.cs"
click node_product_routes "https://github.com/ardalis/cleanarchitecture/tree/main/MinimalClean/src/MinimalClean.Architecture.Web/ProductFeatures"
click node_cart_routes "https://github.com/ardalis/cleanarchitecture/tree/main/MinimalClean/src/MinimalClean.Architecture.Web/CartFeatures"
click node_contributor_cases "https://github.com/ardalis/cleanarchitecture/tree/main/src/Clean.Architecture.UseCases/Contributors"
click node_contributor_list "https://github.com/ardalis/cleanarchitecture/blob/main/src/Clean.Architecture.UseCases/Contributors/List/ListContributorsHandler.cs"
click node_product_list "https://github.com/ardalis/cleanarchitecture/blob/main/MinimalClean/src/MinimalClean.Architecture.Web/ProductFeatures/List/ListProductsHandler.cs"
click node_cart_handlers "https://github.com/ardalis/cleanarchitecture/tree/main/MinimalClean/src/MinimalClean.Architecture.Web/CartFeatures"
click node_contributor_domain "https://github.com/ardalis/cleanarchitecture/blob/main/src/Clean.Architecture.Core/ContributorAggregate/Contributor.cs"
click node_delete_service "https://github.com/ardalis/cleanarchitecture/blob/main/src/Clean.Architecture.Core/Services/DeleteContributorService.cs"
click node_cart_domain "https://github.com/ardalis/cleanarchitecture/blob/main/MinimalClean/src/MinimalClean.Architecture.Web/Domain/CartAggregate/Cart.cs"
click node_product_domain "https://github.com/ardalis/cleanarchitecture/blob/main/MinimalClean/src/MinimalClean.Architecture.Web/Domain/ProductAggregate/Product.cs"
click node_order_domain "https://github.com/ardalis/cleanarchitecture/blob/main/MinimalClean/src/MinimalClean.Architecture.Web/Domain/OrderAggregate/Order.cs"
click node_contributor_repo "https://github.com/ardalis/cleanarchitecture/blob/main/src/Clean.Architecture.Infrastructure/Data/EfRepository.cs"
click node_contributor_query "https://github.com/ardalis/cleanarchitecture/blob/main/src/Clean.Architecture.Infrastructure/Data/Queries/ListContributorsQueryService.cs"
click node_minimal_repo "https://github.com/ardalis/cleanarchitecture/blob/main/MinimalClean/src/MinimalClean.Architecture.Web/Infrastructure/Data/EfRepository.cs"
click node_product_query "https://github.com/ardalis/cleanarchitecture/blob/main/MinimalClean/src/MinimalClean.Architecture.Web/Infrastructure/Data/Queries/ListProductsQueryService.cs"
click node_contributor_db "https://github.com/ardalis/cleanarchitecture/blob/main/src/Clean.Architecture.Infrastructure/Data/AppDbContext.cs"
click node_minimal_db "https://github.com/ardalis/cleanarchitecture/blob/main/MinimalClean/src/MinimalClean.Architecture.Web/Infrastructure/Data/AppDbContext.cs"
click node_event_dispatch "https://github.com/ardalis/cleanarchitecture/blob/main/src/Clean.Architecture.Infrastructure/Data/EventDispatcherInterceptor.cs"
click node_email_sender "https://github.com/ardalis/cleanarchitecture/blob/main/src/Clean.Architecture.Infrastructure/Email/MimeKitEmailSender.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_fullweb,node_contributor_routes,node_minweb,node_product_routes,node_cart_routes,node_client toneBlue
class node_contributor_cases,node_contributor_list,node_product_list,node_cart_handlers toneAmber
class node_contributor_domain,node_delete_service,node_cart_domain,node_product_domain,node_order_domain,node_mailserver toneMint
class node_contributor_repo,node_contributor_query,node_minimal_repo,node_product_query,node_contributor_db,node_minimal_db,node_event_dispatch,node_email_sender toneRose
```

## Components

### HTTP applications

- [Contributor API](https://github.com/ardalis/cleanarchitecture/blob/main/src/Clean.Architecture.Web/Program.cs): `src/Clean.Architecture.Web/Program.cs`
- [Contributor routes](https://github.com/ardalis/cleanarchitecture/tree/main/src/Clean.Architecture.Web/Contributors): `src/Clean.Architecture.Web/Contributors`
- [Minimal API](https://github.com/ardalis/cleanarchitecture/blob/main/MinimalClean/src/MinimalClean.Architecture.Web/Program.cs): `MinimalClean/src/MinimalClean.Architecture.Web/Program.cs`
- [Product routes](https://github.com/ardalis/cleanarchitecture/tree/main/MinimalClean/src/MinimalClean.Architecture.Web/ProductFeatures): `MinimalClean/src/MinimalClean.Architecture.Web/ProductFeatures`
- [Cart routes](https://github.com/ardalis/cleanarchitecture/tree/main/MinimalClean/src/MinimalClean.Architecture.Web/CartFeatures): `MinimalClean/src/MinimalClean.Architecture.Web/CartFeatures`

### Application workflows

- [Contributor use cases](https://github.com/ardalis/cleanarchitecture/tree/main/src/Clean.Architecture.UseCases/Contributors): `src/Clean.Architecture.UseCases/Contributors`
- [Contributor listing](https://github.com/ardalis/cleanarchitecture/blob/main/src/Clean.Architecture.UseCases/Contributors/List/ListContributorsHandler.cs): `src/Clean.Architecture.UseCases/Contributors/List/ListContributorsHandler.cs`
- [Product listing](https://github.com/ardalis/cleanarchitecture/blob/main/MinimalClean/src/MinimalClean.Architecture.Web/ProductFeatures/List/ListProductsHandler.cs): `MinimalClean/src/MinimalClean.Architecture.Web/ProductFeatures/List/ListProductsHandler.cs`
- [Cart handlers](https://github.com/ardalis/cleanarchitecture/tree/main/MinimalClean/src/MinimalClean.Architecture.Web/CartFeatures): `MinimalClean/src/MinimalClean.Architecture.Web/CartFeatures`

### Domain model

- [Contributor aggregate](https://github.com/ardalis/cleanarchitecture/blob/main/src/Clean.Architecture.Core/ContributorAggregate/Contributor.cs): `src/Clean.Architecture.Core/ContributorAggregate/Contributor.cs`
- [Delete service](https://github.com/ardalis/cleanarchitecture/blob/main/src/Clean.Architecture.Core/Services/DeleteContributorService.cs): `src/Clean.Architecture.Core/Services/DeleteContributorService.cs`
- [Cart aggregate](https://github.com/ardalis/cleanarchitecture/blob/main/MinimalClean/src/MinimalClean.Architecture.Web/Domain/CartAggregate/Cart.cs): `MinimalClean/src/MinimalClean.Architecture.Web/Domain/CartAggregate/Cart.cs`
- [Product aggregate](https://github.com/ardalis/cleanarchitecture/blob/main/MinimalClean/src/MinimalClean.Architecture.Web/Domain/ProductAggregate/Product.cs): `MinimalClean/src/MinimalClean.Architecture.Web/Domain/ProductAggregate/Product.cs`
- [Order aggregate](https://github.com/ardalis/cleanarchitecture/blob/main/MinimalClean/src/MinimalClean.Architecture.Web/Domain/OrderAggregate/Order.cs): `MinimalClean/src/MinimalClean.Architecture.Web/Domain/OrderAggregate/Order.cs`

### Persistence and integrations

- [Contributor repository](https://github.com/ardalis/cleanarchitecture/blob/main/src/Clean.Architecture.Infrastructure/Data/EfRepository.cs): `src/Clean.Architecture.Infrastructure/Data/EfRepository.cs`
- [Contributor query service](https://github.com/ardalis/cleanarchitecture/blob/main/src/Clean.Architecture.Infrastructure/Data/Queries/ListContributorsQueryService.cs): `src/Clean.Architecture.Infrastructure/Data/Queries/ListContributorsQueryService.cs`
- [Minimal repository](https://github.com/ardalis/cleanarchitecture/blob/main/MinimalClean/src/MinimalClean.Architecture.Web/Infrastructure/Data/EfRepository.cs): `MinimalClean/src/MinimalClean.Architecture.Web/Infrastructure/Data/EfRepository.cs`
- [Product query service](https://github.com/ardalis/cleanarchitecture/blob/main/MinimalClean/src/MinimalClean.Architecture.Web/Infrastructure/Data/Queries/ListProductsQueryService.cs): `MinimalClean/src/MinimalClean.Architecture.Web/Infrastructure/Data/Queries/ListProductsQueryService.cs`
- [Contributor database](https://github.com/ardalis/cleanarchitecture/blob/main/src/Clean.Architecture.Infrastructure/Data/AppDbContext.cs): `src/Clean.Architecture.Infrastructure/Data/AppDbContext.cs`
- [Cart catalog database](https://github.com/ardalis/cleanarchitecture/blob/main/MinimalClean/src/MinimalClean.Architecture.Web/Infrastructure/Data/AppDbContext.cs): `MinimalClean/src/MinimalClean.Architecture.Web/Infrastructure/Data/AppDbContext.cs`
- [Domain event dispatch](https://github.com/ardalis/cleanarchitecture/blob/main/src/Clean.Architecture.Infrastructure/Data/EventDispatcherInterceptor.cs): `src/Clean.Architecture.Infrastructure/Data/EventDispatcherInterceptor.cs`
- [Email sender](https://github.com/ardalis/cleanarchitecture/blob/main/src/Clean.Architecture.Infrastructure/Email/MimeKitEmailSender.cs): `src/Clean.Architecture.Infrastructure/Email/MimeKitEmailSender.cs`

### Other components

- **API client**
- **Mail server**

## Connections

- API client → Contributor API: sends requests
- API client → Minimal API: sends requests
- Contributor API → Contributor routes: maps endpoints
- Minimal API → Product routes: maps endpoints
- Minimal API → Cart routes: maps endpoints
- Contributor listing → Contributor query service: requests page
- Contributor query service → Contributor database: queries contributors
- Product listing → Product query service: requests page
- Product query service → Cart catalog database: queries products
- Delete service → Contributor repository: loads and deletes
- Contributor repository → Contributor database: persists aggregates
- Delete service → Domain event dispatch: publishes event
- Domain event dispatch → Email sender: dispatches event
- Email sender → Mail server: sends email
