dotnet-clean-architecture

Clean Architecture para .NET

Estrutura de Camadas

Solution/
├── src/
│   ├── Domain/                    # Camada de Domínio (núcleo)
│   ├── Application/               # Camada de Aplicação
│   ├── Infrastructure/            # Camada de Infraestrutura
│   └── Presentation/              # Camada de Apresentação
├── tests/
│   ├── Domain.Tests/
│   ├── Application.Tests/
│   ├── Infrastructure.Tests/
│   └── Presentation.Tests/
└── Solution.sln

Camadas e Responsabilidades

1. Domain (Núcleo)

Projeto: {SolutionName}.Domain

Dependências: Nenhuma (camada mais interna)

Conteúdo:

Domain/
├── Entities/           # Entidades de domínio
├── ValueObjects/       # Objetos de valor
├── Aggregates/         # Raízes de agregados
├── Enums/              # Enumerações de domínio
├── Events/             # Eventos de domínio
├── Exceptions/         # Exceções de domínio
├── Interfaces/         # Contratos (repositories, services)
└── Services/           # Serviços de domínio (lógica pura)

Regras:

• Zero dependências externas (exceto primitivos .NET)
• Contém toda lógica de negócio invariante
• Entidades com comportamento, não anêmicas
• Value Objects imutáveis
• Interfaces de repositórios (não implementações)

---

2. Application (Orquestração)

Projeto: {SolutionName}.Application

Dependências: Domain

Conteúdo:

Application/
├── Commands/           # Comandos (write operations)
│   └── {Feature}/
│       ├── {Command}Command.cs
│       └── {Command}CommandHandler.cs
├── Queries/            # Consultas (read operations)
│   └── {Feature}/
│       ├── {Query}Query.cs
│       └── {Query}QueryHandler.cs
├── DTOs/               # Data Transfer Objects
├── Interfaces/         # Contratos de serviços externos
├── Mappings/           # Configurações AutoMapper
├── Behaviors/          # Pipeline behaviors (validation, logging)
├── Exceptions/         # Exceções de aplicação
└── Common/             # Classes compartilhadas

Regras:

• Implementa casos de uso
• Orquestra fluxos de trabalho
• Define DTOs de entrada/saída
• Não conhece detalhes de infraestrutura
• Usa CQRS (Commands/Queries separados)

---

3. Infrastructure (Implementações)

Projeto: {SolutionName}.Infrastructure

Dependências: Domain, Application

Conteúdo:

Infrastructure/
├── Persistence/
│   ├── Configurations/     # Entity configurations (EF Core)
│   ├── Repositories/       # Implementações de repositórios
│   ├── Migrations/         # Migrations do banco
│   └── ApplicationDbContext.cs
├── Services/
│   ├── Email/              # Serviço de email
│   ├── Storage/            # Serviço de arquivos
│   └── External/           # Integrações externas
├── Identity/               # Autenticação/Autorização
└── DependencyInjection.cs  # Registro de serviços

Regras:

• Implementa interfaces definidas em Domain/Application
• Contém detalhes de persistência (EF Core, Dapper)
• Integrações com serviços externos
• Configurações de infraestrutura

---

4. Presentation (Gateway)

Projeto: {SolutionName}.Presentation ou {SolutionName}.API

Dependências: Application, Infrastructure (apenas para DI)

Conteúdo:

Presentation/
├── Controllers/        # Endpoints da API
├── Middleware/         # Middlewares customizados
├── Filters/            # Action filters
├── Models/             # View models / Request models
├── Extensions/         # Extension methods
├── Program.cs          # Entry point
└── appsettings.json    # Configurações

Regras:

• Recebe requisições externas
• Valida input básico
• Roteia para Application layer
• Formata responses
• Não contém lógica de negócio

---

Fluxo de Dependências

┌─────────────────────────────────────────────────────────┐
│                    PRESENTATION                          │
│              (Controllers, Endpoints)                    │
└─────────────────────────┬───────────────────────────────┘
                          │ usa
                          ▼
┌─────────────────────────────────────────────────────────┐
│                    APPLICATION                           │
│           (Commands, Queries, Handlers)                  │
└─────────────────────────┬───────────────────────────────┘
                          │ usa
                          ▼
┌─────────────────────────────────────────────────────────┐
│                      DOMAIN                              │
│        (Entities, Value Objects, Interfaces)             │
└─────────────────────────────────────────────────────────┘
                          ▲
                          │ implementa
┌─────────────────────────┴───────────────────────────────┐
│                   INFRASTRUCTURE                         │
│         (Repositories, DbContext, Services)              │
└─────────────────────────────────────────────────────────┘

Regra de Dependência: Dependências apontam apenas para dentro (camadas internas).

---

Convenções de Nomenclatura

Elemento	Padrão	Exemplo
Entidade	{Nome}	Product, Order
Value Object	{Nome}	Money, Address
Repository Interface	I{Entidade}Repository	IProductRepository
Repository Impl	{Entidade}Repository	ProductRepository
Command	{Ação}{Entidade}Command	CreateProductCommand
Query	Get{Entidade}Query	GetProductByIdQuery
Handler	{Command/Query}Handler	CreateProductCommandHandler
DTO	{Entidade}Dto	ProductDto
Controller	{Entidade}Controller	ProductsController

---

Referências

Para detalhes de implementação de cada camada, consulte:

• references/domain-layer.md - Detalhes da camada Domain
• references/application-layer.md - Detalhes da camada Application
• references/infrastructure-layer.md - Detalhes da camada Infrastructure
• references/presentation-layer.md - Detalhes da camada Presentation