Repolode
Enviar
ardalis

ardalis/CleanArchitecture

Template de solução Clean Architecture para ASP.NET Core, com projetos separados para Core, Use Cases, Infrastructure e Web.

Ver no GitHub
Estrelas
18,527
Forks
3,142
Issues abertas
45
Último commit
mês passado

O que é?

Este projeto é um template inicial de solução para criar aplicações ASP.NET Core com Clean Architecture, um estilo com dependências invertidas também conhecido como arquitetura hexagonal ou onion. Ele é distribuído como um template do dotnet CLI, em uma variante completa (clean-arch) e uma mínima (min-clean), para que os desenvolvedores possam gerar uma nova solução sem precisar configurar as camadas manualmente.

A solução é dividida em Core (entidades de domínio, eventos de domínio e interfaces), uma camada de Use Cases para a lógica da aplicação, um projeto de Infrastructure para acesso a dados e serviços externos e um projeto Web para a camada HTTP. O template inclui projetos de teste e, na branch principal, tem como alvo o .NET 9. Para a camada web, há opções como Ardalis.ApiEndpoints, controllers ou Razor Pages.

O repositório é mantido por Steve Smith e serve como implementação de referência para os cursos de Clean Architecture e DDD do autor.

Recursos principais

  • 01Oferece templates do dotnet CLI nas variantes completa (clean-arch) e mínima (min-clean).
  • 02Separa o núcleo do domínio, os casos de uso, a infraestrutura e a camada web em projetos distintos.
  • 03Inclui eventos de domínio e projetos de teste na solução.
  • 04Dá suporte a ApiEndpoints, controllers ou Razor Pages na camada web.

Casos de uso

  • Começar um novo backend ASP.NET Core que precise ser fácil de manter a longo prazo.
  • Aprender a estruturar uma aplicação .NET usando Clean Architecture e DDD.
  • Usar uma estrutura de referência como base para o template interno de projetos de uma equipe.

Início rápido

  1. 1

    Consulte as etapas de introdução na documentação oficial

Antes de usar

  • A branch main tem como alvo o .NET 9.
  • O site usa HTTPS e requer um certificado de desenvolvedor autoassinado para localhost.

Tópicos

#clean-architecture#aspnet-core#dotnet#csharp#ddd#hexagonal-architecture#project-template#architecture#domain-driven-design#hacktoberfest

Perguntas frequentes

O que é CleanArchitecture?
Template de solução Clean Architecture para ASP.NET Core, com projetos separados para Core, Use Cases, Infrastructure e Web. Este projeto é um template inicial de solução para criar aplicações ASP.NET Core com Clean Architecture, um estilo com dependências invertidas também conhecido como arquitetura hexagonal ou onion. Ele é distribuído como um template do dotnet CLI, em uma variante completa (clean-arch) e uma mínima (min-clean), para que os desenvolvedores possam gerar uma nova solução sem precisar configurar as camadas manualmente.
CleanArchitecture é gratuito? Qual é a licença?
CleanArchitecture é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
CleanArchitecture ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de CleanArchitecture foi em 21 de set. de 2026.
Para que posso usar CleanArchitecture?
Começar um novo backend ASP.NET Core que precise ser fácil de manter a longo prazo. Aprender a estruturar uma aplicação .NET usando Clean Architecture e DDD. Usar uma estrutura de referência como base para o template interno de projetos de uma equipe.
Como instalar CleanArchitecture?
Consulte as etapas de introdução na documentação oficial
Onde consigo CleanArchitecture?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/ardalis/CleanArchitecture

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados