dotnet-architecture
Installation
SKILL.md
Arquitetura .NET C# / ASP.NET Core
Decisões de estrutura que valem para todo serviço .NET. Os exemplos em examples/ mostram a forma
esperada de cada peça e só devem ser lidos quando a tarefa tocar aquela peça.
Decisões
| Tema | Decisão | Motivo |
|---|---|---|
| Camadas | Clean Architecture: Domain, Application, Api e um Infra.* por tecnologia |
Domínio isolado de framework e persistência |
| API HTTP | Minimal API, um {Agregado}Endpoints com MapGroup por agregado; controllers não são usados |
Recomendação oficial do ASP.NET Core para projetos novos; menos cerimônia |
| Identificadores | UUIDv7 (Guid.CreateVersion7()) gerado no domínio; Guid.NewGuid() banido |
Índice ordenado por tempo e Id conhecido antes do insert |
| Casos de uso | Uma classe por caso de uso, com interface própria; sem MediatR ou dispatcher | Fluxo navegável sem reflection; MediatR tem licença comercial |
| Mapeamento | Manual, com static From{Entidade} no Output |
AutoMapper tem licença comercial |
| Validação de input | FluentValidation chamada explicitamente pelo caso de uso; AddValidation() nativo não é ligado |
Uma única fonte de 400 |
| Eventos | Levantados pelo agregado e gravados no outbox pelo IUnitOfWork |
Estado e evento na mesma transação |
| Fronteiras | Verificadas por ProjectName.ArchitectureTests (ArchUnitNET) |
Violação falha a pipeline em vez de depender de review |