Convert Figma logo to code with AI

ardalis logoCleanArchitecture

Clean Architecture Solution Template: A starting point for Clean Architecture with ASP.NET Core

16,130
2,777
16,130
56
View on GitHub

Top Related Projects

jasontaylordev's avatar

CleanArchitecture

16,581

Clean Architecture Solution Template for ASP.NET Core

dotnet-architecture's avatar

eShopOnWeb

10,123

Sample ASP.NET Core 8.0 reference application, powered by Microsoft, demonstrating a layered application architecture with monolithic deployment model. Download the eBook PDF from docs folder.

ivanpaulovich's avatar

clean-architecture-manga

3,955

:cyclone: Clean Architecture with .NET6, C#10 and React+Redux. Use cases as central organizing structure, completely testable, decoupled from frameworks

EduardoPires's avatar

EquinoxProject

6,374

Web Application ASP.NET 8 using Clean Architecture, DDD, CQRS, Event Sourcing and a lot of good practices

kgrzybek's avatar

modular-monolith-with-ddd

10,870

Full Modular Monolith application with Domain-Driven Design approach.

jasontaylordev's avatar

NorthwindTraders

5,004

Northwind Traders is a sample application built using ASP.NET Core and Entity Framework Core.

Quick Overview

CleanArchitecture is a sample application built with ASP.NET Core following the principles of Clean Architecture. It demonstrates how to structure a .NET application with a clear separation of concerns, making it easier to maintain, test, and evolve over time.

Pros

  • Provides a clear and organized project structure
  • Demonstrates SOLID principles and dependency inversion
  • Includes examples of domain-driven design concepts
  • Offers a good starting point for building scalable applications

Cons

  • May be overly complex for small projects
  • Requires a learning curve for developers unfamiliar with Clean Architecture
  • Some might find the number of projects/layers excessive
  • Could lead to over-engineering if not applied judiciously

Code Examples

  1. Domain Entity:
public class ToDoItem : BaseEntity
{
    public string Title { get; set; } = string.Empty;
    public string Description { get; set; } = string.Empty;
    public bool IsDone { get; private set; }

    public void MarkComplete()
    {
        IsDone = true;
    }
}

This code defines a ToDoItem entity with properties and a method to mark it as complete.

  1. Application Service:
public class CreateToDoItemCommand : IRequest<int>
{
    public string Title { get; set; } = string.Empty;
    public string Description { get; set; } = string.Empty;
}

public class CreateToDoItemCommandHandler : IRequestHandler<CreateToDoItemCommand, int>
{
    private readonly IRepository<ToDoItem> _repository;

    public CreateToDoItemCommandHandler(IRepository<ToDoItem> repository)
    {
        _repository = repository;
    }

    public async Task<int> Handle(CreateToDoItemCommand request, CancellationToken cancellationToken)
    {
        var item = new ToDoItem
        {
            Title = request.Title,
            Description = request.Description
        };

        await _repository.AddAsync(item);

        return item.Id;
    }
}

This example shows a command and its handler for creating a new ToDoItem.

  1. API Controller:
[ApiController]
[Route("api/[controller]")]
public class ToDoItemsController : ControllerBase
{
    private readonly IMediator _mediator;

    public ToDoItemsController(IMediator mediator)
    {
        _mediator = mediator;
    }

    [HttpPost]
    public async Task<ActionResult<int>> Create(CreateToDoItemCommand command)
    {
        return await _mediator.Send(command);
    }
}

This controller demonstrates how to use MediatR to handle the creation of a ToDoItem.

Getting Started

  1. Clone the repository:

    git clone https://github.com/ardalis/CleanArchitecture.git

  2. Open the solution in Visual Studio or your preferred IDE.

  3. Set the Web project as the startup project.

  4. Run the application using IIS Express or by executing:

    dotnet run --project src/CleanArchitecture.Web

  5. Navigate to https://localhost:5001 in your browser to see the application running.

Competitor Comparisons

jasontaylordev logo

CleanArchitecture

16,581

Clean Architecture Solution Template for ASP.NET Core

Pros of CleanArchitecture (Jason Taylor)

  • More comprehensive, including features like authentication, authorization, and API versioning
  • Utilizes modern .NET features and patterns, such as Minimal APIs and Vertical Slice Architecture
  • Includes a robust testing suite with examples of unit, integration, and functional tests

Cons of CleanArchitecture (Jason Taylor)

  • May be overwhelming for beginners due to its complexity and extensive feature set
  • Opinionated approach might not fit all project requirements or team preferences
  • Steeper learning curve compared to simpler implementations

Code Comparison

CleanArchitecture (Jason Taylor):

public sealed class CreateTodoItemCommandHandler : IRequestHandler<CreateTodoItemCommand, int>
{
    private readonly IApplicationDbContext _context;

    public CreateTodoItemCommandHandler(IApplicationDbContext context)
    {
        _context = context;
    }

CleanArchitecture (Ardalis):

public class CreateProjectCommandHandler : IRequestHandler<CreateProjectCommand, int>
{
  private readonly IRepository<Project> _repository;

  public CreateProjectCommandHandler(IRepository<Project> repository)
  {
    _repository = repository;
  }

Both examples showcase similar command handler structures, but Jason Taylor's implementation uses a custom database context interface, while Ardalis' version utilizes a generic repository pattern.

dotnet-architecture logo

eShopOnWeb

10,123

Sample ASP.NET Core 8.0 reference application, powered by Microsoft, demonstrating a layered application architecture with monolithic deployment model. Download the eBook PDF from docs folder.

Pros of eShopOnWeb

  • More comprehensive e-commerce example with real-world scenarios
  • Includes additional features like basket management and ordering
  • Better documentation and explanations of architectural decisions

Cons of eShopOnWeb

  • More complex and potentially overwhelming for beginners
  • Less focused on clean architecture principles
  • Harder to extract and apply to non-e-commerce projects

Code Comparison

CleanArchitecture:

public class DeleteProjectCommand : IRequest
{
    public int Id { get; set; }
}

public class DeleteProjectCommandHandler : IRequestHandler<DeleteProjectCommand>
{
    private readonly IRepository<Project> _repository;

    public DeleteProjectCommandHandler(IRepository<Project> repository)
    {
        _repository = repository;
    }

eShopOnWeb:

public class CreateOrderCommand : IRequest<int>
{
    public string BuyerId { get; set; }
    public Address ShippingAddress { get; set; }
    public Address BillingAddress { get; set; }
    public List<OrderItemDTO> Items { get; set; }
}

public class CreateOrderCommandHandler : IRequestHandler<CreateOrderCommand, int>
{
    private readonly IOrderRepository _orderRepository;

Both repositories demonstrate CQRS pattern usage, but eShopOnWeb's example is more complex, reflecting real-world e-commerce scenarios. CleanArchitecture focuses on simpler, more generic implementations that are easier to adapt to various project types.

ivanpaulovich logo

clean-architecture-manga

3,955

:cyclone: Clean Architecture with .NET6, C#10 and React+Redux. Use cases as central organizing structure, completely testable, decoupled from frameworks

Pros of clean-architecture-manga

  • More comprehensive implementation of Clean Architecture principles
  • Includes additional features like CQRS and Event Sourcing
  • Provides a more detailed domain model and use cases

Cons of clean-architecture-manga

  • Higher complexity, which may be overwhelming for beginners
  • Steeper learning curve due to advanced concepts and patterns
  • Less focus on simplicity and ease of understanding

Code Comparison

CleanArchitecture:

public class DeleteProjectHandler : ICommandHandler<DeleteProjectCommand, ProjectDto>
{
    private readonly IRepository<Project> _repository;
    public DeleteProjectHandler(IRepository<Project> repository) => _repository = repository;
    public async Task<ProjectDto> Handle(DeleteProjectCommand request, CancellationToken cancellationToken)
    {
        var projectToDelete = await _repository.GetByIdAsync(request.ProjectId);
        await _repository.DeleteAsync(projectToDelete);
        return new ProjectDto(projectToDelete.Id, projectToDelete.Name);
    }
}

clean-architecture-manga:

public sealed class CloseAccountUseCase : ICloseAccountUseCase
{
    private readonly IAccountRepository _accountRepository;
    private readonly IUnitOfWork _unitOfWork;
    public CloseAccountUseCase(IAccountRepository accountRepository, IUnitOfWork unitOfWork)
    {
        _accountRepository = accountRepository;
        _unitOfWork = unitOfWork;
    }
    public async Task<CloseAccountOutput> Execute(CloseAccountInput input)
    {
        var account = await _accountRepository.Get(input.AccountId);
        if (account == null) throw new AccountNotFoundException($"The account {input.AccountId} does not exist or is already closed.");
        account.Close();
        await _accountRepository.Update(account);
        await _unitOfWork.Save();
        return new CloseAccountOutput(account);
    }
}
EduardoPires logo

EquinoxProject

6,374

Web Application ASP.NET 8 using Clean Architecture, DDD, CQRS, Event Sourcing and a lot of good practices

Pros of EquinoxProject

  • Implements Event Sourcing and CQRS patterns, providing a more comprehensive approach to domain-driven design
  • Includes integration with Swagger for API documentation
  • Offers a more extensive set of features, including identity management and JWT authentication

Cons of EquinoxProject

  • More complex architecture, which may be overkill for smaller projects
  • Steeper learning curve due to the additional patterns and technologies used
  • Less frequently updated compared to CleanArchitecture

Code Comparison

CleanArchitecture:

public class DeleteToDoItemCommand : IRequest
{
    public int Id { get; set; }
}

EquinoxProject:

public class RegisterNewCustomerCommand : Command
{
    public Guid Id { get; private set; }
    public string Name { get; private set; }
    public string Email { get; private set; }
    public DateTime BirthDate { get; private set; }
}

The EquinoxProject example shows a more detailed command structure with additional properties, reflecting its focus on CQRS and event sourcing. CleanArchitecture's example is simpler, aligning with its more straightforward approach to clean architecture.

kgrzybek logo

modular-monolith-with-ddd

10,870

Full Modular Monolith application with Domain-Driven Design approach.

Pros of modular-monolith-with-ddd

  • Implements a more comprehensive Domain-Driven Design (DDD) approach
  • Provides a detailed example of modular monolith architecture
  • Includes more advanced patterns like CQRS and Event Sourcing

Cons of modular-monolith-with-ddd

  • More complex structure, potentially steeper learning curve
  • Less focus on Clean Architecture principles
  • May be overkill for smaller projects or teams new to DDD

Code Comparison

CleanArchitecture:

public class DeleteTodoItemCommand : IRequest
{
    public int Id { get; set; }
}

modular-monolith-with-ddd:

public class CreateMeetingGroupCommand : CommandBase<MeetingGroupId>
{
    public string Name { get; }
    public string Description { get; }
    public MeetingGroupLocation Location { get; }
}

The modular-monolith-with-ddd example shows a more detailed command structure with domain-specific types, while CleanArchitecture uses a simpler approach with primitive types.

Both repositories offer valuable insights into structuring .NET applications, but they cater to different levels of complexity and architectural focus. CleanArchitecture provides a cleaner, more straightforward implementation of Clean Architecture principles, while modular-monolith-with-ddd offers a more comprehensive example of DDD and modular monolith patterns.

jasontaylordev logo

NorthwindTraders

5,004

Northwind Traders is a sample application built using ASP.NET Core and Entity Framework Core.

Pros of NorthwindTraders

  • Implements a more comprehensive set of Clean Architecture principles
  • Includes a broader range of features and technologies (e.g., CQRS, MediatR)
  • Provides a more realistic and complex example of a business application

Cons of NorthwindTraders

  • May be overwhelming for beginners due to its complexity
  • Requires more setup and configuration to get started
  • Has a steeper learning curve compared to CleanArchitecture

Code Comparison

NorthwindTraders:

public class CreateCustomerCommand : IRequest<int>
{
    public string Id { get; set; }
    public string CompanyName { get; set; }
    public string ContactName { get; set; }
}

CleanArchitecture:

public class CreateToDoItemCommand : IRequest<ToDoItemRecord>
{
    public string Title { get; set; } = string.Empty;
    public string Description { get; set; } = string.Empty;
}

Both repositories demonstrate the use of CQRS patterns, but NorthwindTraders shows a more complex command structure with additional properties, reflecting its more comprehensive approach to Clean Architecture principles.

Convert Figma logo designs to code with AI

Visual Copilot

Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.

Try Visual Copilot

README

.NET Core publish Ardalis.CleanArchitecture Template to nuget Ardalis.CleanArchitecture.Template on NuGet

Follow @ardalis   Follow @nimblepros

Clean Architecture

A starting point for Clean Architecture with ASP.NET Core. Clean Architecture is just the latest in a series of names for the same loosely-coupled, dependency-inverted architecture. You will also find it named hexagonal, ports-and-adapters, or onion architecture.

This architecture is used in the DDD Fundamentals course by Steve Smith and Julie Lerman.

:school: Contact Steve's company, NimblePros, for Clean Architecture or DDD training and/or implementation assistance for your team.

Take the Course!

Learn about how to implement Clean Architecture from NimblePros trainers Sarah "sadukie" Dutkiewicz and Steve "ardalis" Smith.

Troubleshooting Chrome Errors

By default the site uses HTTPS and expects you to have a self-signed developer certificate for localhost use. If you get an error with Chrome see this answer for mitigation instructions.

Table Of Contents

Give a Star! :star:

If you like or are using this project to learn or start your solution, please give it a star. Thanks!

Or if you're feeling really generous, we now support GitHub sponsorships - see the button above.

Versions

The main branch is now using .NET 8. If you need a previous version use one of these tagged commits:

Learn More

Getting Started

To use this template, there are a few options:

  • Install using dotnet new (recommended)
  • Download this Repository (and modify as needed)

Using the dotnet CLI template

First, install the template from NuGet (https://www.nuget.org/packages/Ardalis.CleanArchitecture.Template/):

dotnet new install Ardalis.CleanArchitecture.Template

You should see the template in the list of templates from dotnet new list after this installs successfully. Look for "ASP.NET Clean Architecture Solution" with Short Name of "clean-arch".

Navigate to the parent directory in which you'd like the solution's folder to be created.

Run this command to create the solution structure in a subfolder name Your.ProjectName:

dotnet new clean-arch -o Your.ProjectName

The Your.ProjectName directory and solution file will be created, and inside that will be all of your new solution contents, properly namespaced and ready to run/test!

Example: powershell screenshot showing steps

Thanks @dahlsailrunner for your help getting this working!

Known Issues:

  • Don't include hyphens in the name. See #201.
  • Don't use 'Ardalis' as your namespace (conflicts with dependencies).

What about Controllers and Razor Pages?

As of version 9, this solution template only includes support for API Endpoints using the FastEndpoints library. If you want to use my ApiEndpoints library, Razor Pages, and/or Controllers you can use the last template that included them, version 7.1. Alternately, they're easily added to this template after installation.

Add Ardalis.ApiEndpoints

To use Ardalis.ApiEndpoints instead of (or in addition to) FastEndpoints, just add the reference and use the base classes from the documentation.

dotnet add package Ardalis.ApiEndpoints

Add Controllers

You'll need to add support for controllers to the Program.cs file. You need:

builder.Services.AddControllers(); // ControllersWithView if you need Views

// and

app.MapControllers();

Once these are in place, you should be able to create a Controllers folder and (optionally) a Views folder and everything should work as expected. Personally I find Razor Pages to be much better than Controllers and Views so if you haven't fully investigated Razor Pages you might want to do so right about now before you choose Views.

Add Razor Pages

You'll need to add support for Razor Pages to the Program.cs file. You need:

builder.Services.AddRazorPages();

// and

app.MapRazorPages();

Then you just add a Pages folder in the root of the project and go from there.

Using the GitHub Repository

To get started based on this repository, you need to get a copy locally. You have three options: fork, clone, or download. Most of the time, you probably just want to download.

You should download the repository, unblock the zip file, and extract it to a new folder if you just want to play with the project or you wish to use it as the starting point for an application.

You should fork this repository only if you plan on submitting a pull request. Or if you'd like to keep a copy of a snapshot of the repository in your own GitHub account.

You should clone this repository if you're one of the contributors and you have commit access to it. Otherwise you probably want one of the other options.

Running Migrations

You shouldn't need to do this to use this template, but if you want migrations set up properly in the Infrastructure project, you need to specify that project name when you run the migrations command.

In Visual Studio, open the Package Manager Console, and run Add-Migration InitialMigrationName -StartupProject Your.ProjectName.Web -Context AppDbContext -Project Your.ProjectName.Infrastructure.

In a terminal with the CLI, the command is similar. Run this from the Web project directory:

dotnet ef migrations add MIGRATIONNAME -c AppDbContext -p ../Your.ProjectName.Infrastructure/Your.ProjectName.Infrastructure.csproj -s Your.ProjectName.Web.csproj -o Data/Migrations

To use SqlServer, change options.UseSqlite(connectionString)); to options.UseSqlServer(connectionString)); in the Your.ProjectName.Infrastructure.StartupSetup file. Also remember to replace the SqliteConnection with DefaultConnection in the Your.ProjectName.Web.Program file, which points to your Database Server.

To update the database use this command from the Web project folder (replace Clean.Architecture with your project's name):

dotnet ef database update -c AppDbContext -p ../Clean.Architecture.Infrastructure/Clean.Architecture.Infrastructure.csproj -s Clean.Architecture.Web.csproj

Goals

The goal of this repository is to provide a basic solution structure that can be used to build Domain-Driven Design (DDD)-based or simply well-factored, SOLID applications using .NET Core. Learn more about these topics here:

If you're used to building applications as single-project or as a set of projects that follow the traditional UI -> Business Layer -> Data Access Layer "N-Tier" architecture, I recommend you check out these two courses (ideally before DDD Fundamentals):

Steve Smith also maintains Microsoft's reference application, eShopOnWeb, and its associated free eBook. Check them out here:

Note that the goal of this project and repository is not to provide a sample or reference application. It's meant to just be a template, but with enough pieces in place to show you where things belong as you set up your actual solution. Instead of useless "Class1.cs" there are a few real classes in place. Delete them as soon as you understand why they're there and where you should put your own, similar files.

History and Shameless Plug Section

I've used this starter kit to teach the basics of ASP.NET Core using Domain-Driven Design concepts and patterns for some time now (starting when ASP.NET Core was still in pre-release). Typically I teach a one- or two-day hands-on workshop ahead of events like DevIntersection, or private on-site workshops for companies looking to bring their teams up to speed with the latest development technologies and techniques. Feel free to contact me if you'd like information about upcoming workshops.

Design Decisions and Dependencies

The goal of this sample is to provide a fairly bare-bones starter kit for new projects. It does not include every possible framework, tool, or feature that a particular enterprise application might benefit from. Its choices of technology for things like data access are rooted in what is the most common, accessible technology for most business software developers using Microsoft's technology stack. It doesn't (currently) include extensive support for things like logging, monitoring, or analytics, though these can all be added easily. Below is a list of the technology dependencies it includes, and why they were chosen. Most of these can easily be swapped out for your technology of choice, since the nature of this architecture is to support modularity and encapsulation.

Where To Validate

Validation of user input is a requirement of all software applications. The question is, where does it make sense to implement it in a concise and elegant manner? This solution template includes 4 separate projects, each of which might be responsible for performing validation as well as enforcing business invariants (which, given validation should already have occurred, are usually modeled as exceptions).

The domain model itself should generally rely on object-oriented design to ensure it is always in a consistent state. It leverages encapsulation and limits public state mutation access to achieve this, and it assumes that any arguments passed to it have already been validated, so null or other improper values yield exceptions, not validation results, in most cases.

The use cases / application project includes the set of all commands and queries the system supports. It's frequently responsible for validating its own command and query objects.

The Web project includes all API endpoints, which include their own request and response types, following the REPR pattern. The FastEndpoints library includes built-in support for validation using FluentValidation on the request types. This is a natural place to perform input validation as well.

Having validation occur both within the API endpoints and then again at the use case level is redundant, so in this template the choice has been made to validate at the edge of the application, in the API endpoints. This means some future consumer of the Use Cases project will also need to be responsible for its own validation as well, but in the vast majority of cases there won't be any other consumers of the use cases outside of the API endpoints.

The Core Project

The Core project is the center of the Clean Architecture design, and all other project dependencies should point toward it. As such, it has very few external dependencies. The Core project should include the Domain Model including things like:

  • Entities
  • Aggregates
  • Value Objects
  • Domain Events
  • Domain Event Handlers
  • Domain Services
  • Specifications
  • Interfaces
  • DTOs (sometimes)

The Use Cases Project

An optional project, I've included it because many folks were demanding it and it's easier to remove than to add later. This is also often referred to as the Application or Application Services layer. The Use Cases project is organized following CQRS into Commands and Queries. Commands mutate the domain model and thus should always use Repository abstractions for their data access. Queries are readonly, and thus do not need to use the repository pattern, but instead can use whatever query service or approach is most convenient. However, since the Use Cases project is set up to depend on Core and not directly on Infrastructure, there will still need to be abstractions defined for its data access. And it can use things like specifications, which can sometimes help encapsulate query logic as well as result type mapping. But it doesn't have to use repository/specification - it can just issue a SQL query or call a stored procedure if that's the most efficient way to get the data.

Although this is an optional project to include (without it, your API endpoints would just work directly with the domain model or query services), it does provide a nice UI-ignorant place to add automated tests.

The Infrastructure Project

Most of your application's dependencies on external resources should be implemented in classes defined in the Infrastructure project. These classes should implement interfaces defined in Core. If you have a very large project with many dependencies, it may make sense to have multiple Infrastructure projects (e.g. Infrastructure.Data), but for most projects one Infrastructure project with folders works fine. The sample includes data access and domain event implementations, but you would also add things like email providers, file access, web api clients, etc. to this project so they're not adding coupling to your Core or UI projects.

The Infrastructure project depends on Microsoft.EntityFrameworkCore.SqlServer and Autofac. The former is used because it's built into the default ASP.NET Core templates and is the least common denominator of data access. If desired, it can easily be replaced with a lighter-weight ORM like Dapper. Autofac (formerly StructureMap) is used to allow wireup of dependencies to take place closest to where the implementations reside. In this case, an InfrastructureRegistry class can be used in the Infrastructure class to allow wireup of dependencies there, without the entry point of the application even having to have a reference to the project or its types. Learn more about this technique. The current implementation doesn't include this behavior - it's something I typically cover and have students add themselves in my workshops.

The Web Project

The entry point of the application is the ASP.NET Core web project. This is actually a console application, with a public static void Main method in Program.cs. It currently uses the default MVC organization (Controllers and Views folders) as well as most of the default ASP.NET Core project template code. This includes its configuration system, which uses the default appsettings.json file plus environment variables, and is configured in Startup.cs. The project delegates to the Infrastructure project to wire up its services using Autofac.

The SharedKernel Project

Many solutions will also reference a separate Shared Kernel project/package. I recommend creating a separate SharedKernel project and solution if you will require sharing code between multiple bounded contexts (see DDD Fundamentals). I further recommend this be published as a NuGet package (most likely privately within your organization) and referenced as a NuGet dependency by those projects that require it.

Previously a project for SharedKernel was included in this project. However, for the above reasons I've made it a separate package, Ardalis.SharedKernel, which you should replace with your own when you use this template.

If you want to see another example of a SharedKernel package, the one I use in my updated Pluralsight DDD course is on NuGet here.

The Test Projects

Test projects could be organized based on the kind of test (unit, functional, integration, performance, etc.) or by the project they are testing (Core, Infrastructure, Web), or both. For this simple starter kit, the test projects are organized based on the kind of test, with unit, functional and integration test projects existing in this solution. In terms of dependencies, there are three worth noting:

  • xunit I'm using xunit because that's what ASP.NET Core uses internally to test the product. It works great and as new versions of ASP.NET Core ship, I'm confident it will continue to work well with it.

  • NSubstitute I'm using NSubstitute as a mocking framework for white box behavior-based tests. If I have a method that, under certain circumstances, should perform an action that isn't evident from the object's observable state, mocks provide a way to test that. I could also use my own Fake implementation, but that requires a lot more typing and files. NSubstitute is great once you get the hang of it, and assuming you don't have to mock the world (which we don't in this case because of good, modular design).

  • Microsoft.AspNetCore.TestHost I'm using TestHost to test my web project using its full stack, not just unit testing action methods. Using TestHost, you make actual HttpClient requests without going over the wire (so no firewall or port configuration issues). Tests run in memory and are very fast, and requests exercise the full MVC stack, including routing, model binding, model validation, filters, etc.

Patterns Used

This solution template has code built in to support a few common patterns, especially Domain-Driven Design patterns. Here is a brief overview of how a few of them work.

Domain Events

Domain events are a great pattern for decoupling a trigger for an operation from its implementation. This is especially useful from within domain entities since the handlers of the events can have dependencies while the entities themselves typically do not. In the sample, you can see this in action with the ToDoItem.MarkComplete() method. The following sequence diagram demonstrates how the event and its handler are used when an item is marked complete through a web API endpoint.

Domain Event Sequence Diagram

Related Projects