dotnet-application-feature

.NET Application Feature Generator

Gera Commands (escrita) e Queries (leitura) na camada Application seguindo CQRS, MediatR e Clean Architecture.

Instruções

ANTES de gerar código, consulte as referências:

1. Leia references/command-template.md para estrutura de Commands
2. Leia references/query-template.md para estrutura de Queries
3. Leia references/behaviors.md para pipeline behaviors

Passo 1: Identificar Tipo de Operação

Tipo	Quando Usar	Retorno
Command	Altera estado (Create, Update, Delete)	Result<T> ou Result
Query	Apenas leitura (Get, List, Search)	Result<TDto> ou Result<PagedResult<TDto>>

Passo 2: Coletar Informações

Para Command:

• Nome da ação (Create, Update, Delete, Approve, Cancel, etc.)
• Nome da entidade
• Campos necessários
• Validações de negócio
• Retorno esperado (Id, void, DTO)

Para Query:

• Tipo (ById, List, Search, Filter)
• Nome da entidade
• Filtros necessários
• Se precisa paginação
• Campos do DTO de retorno

Passo 3: Gerar Artefatos

Para Command (na ordem):

Application/
└── {Feature}/
    └── Commands/
        └── {Action}{Entity}/
            ├── {Action}{Entity}Command.cs
            ├── {Action}{Entity}CommandHandler.cs
            └── {Action}{Entity}CommandValidator.cs

Para Query (na ordem):

Application/
└── {Feature}/
    └── Queries/
        └── Get{Entity}{Suffix}/
            ├── Get{Entity}{Suffix}Query.cs
            └── Get{Entity}{Suffix}QueryHandler.cs
    └── DTOs/
        └── {Entity}Dto.cs

Passo 4: Validar Checklist

• Command/Query é um record imutável
• Implementa IRequest<Result<T>> (não IRequest<T>)
• Handler injeta apenas interfaces (não implementações)
• CancellationToken propagado em todos os métodos async
• Validações de negócio retornam Result.Invalid() ou Result.NotFound()
• Validator usa FluentValidation (apenas para Commands)
• DTO é record com todos os campos necessários

Padrões Obrigatórios

Nomenclatura

Artefato	Padrão	Exemplo
Command	{Action}{Entity}Command	CreateProductCommand
Command Handler	{Action}{Entity}CommandHandler	CreateProductCommandHandler
Command Validator	{Action}{Entity}CommandValidator	CreateProductCommandValidator
Query	Get{Entity}{Suffix}Query	GetProductByIdQuery, GetProductListQuery
Query Handler	Get{Entity}{Suffix}QueryHandler	GetProductByIdQueryHandler
DTO	{Entity}Dto	ProductDto

Result Pattern (Obrigatório)

// CORRETO - Usar Result<T>
public record CreateProductCommand(...) : IRequest<Result<Guid>>;

// INCORRETO - Não usar tipo direto
public record CreateProductCommand(...) : IRequest<Guid>;

Injeção de Dependências

// CORRETO - Injetar interfaces
public class Handler(IProductRepository repository, IUnitOfWork unitOfWork)

// INCORRETO - Não injetar implementações
public class Handler(ProductRepository repository, ApplicationDbContext context)

Fluxo de Decisão

Usuário quer criar feature
         │
         ▼
    Altera estado?
    ┌────┴────┐
   Sim       Não
    │         │
    ▼         ▼
 COMMAND    QUERY
    │         │
    ▼         ▼
 Precisa    Retorna
validação?  lista?
    │         │
   Sim       Sim
    │         │
    ▼         ▼
Validator  Paginação

Troubleshooting

Erro: Handler não encontrado pelo MediatR

Causa: Assembly não registrado ou handler não público Solução: Verificar AddMediatR(cfg => cfg.RegisterServicesFromAssembly(...))

Erro: Validator não executa

Causa: ValidationBehavior não registrado Solução: Adicionar services.AddTransient(typeof(IPipelineBehavior<,>), typeof(ValidationBehavior<,>))

Erro: Dependência não resolvida no Handler

Causa: Interface não registrada no DI Solução: Verificar registro em Infrastructure/DependencyInjection.cs