my-code-codex

Arquitetura N-Camadas

Domain

Não depende de outra

Contém a lógica central e regras de negócio puras da aplicação, totalmente independente de frameworks, infraestrutura ou tecnologia externa, facil de testar.

Só depende de .NET puro (System.*). Nada de EF, nada de HTTP, nada de infra, nada de usar libs externas.

• Entidade (as invariantes de negócio vivem dentro dos seus métodos)
• ValueObject (inclui enums de domínio quando carregam comportamento ou validação)
• Domain Service (usado quando uma regra de negócio não pertence claramente a uma única entidade)
• Repositorios (Interface)
• Agregados (Aggregate Root)
• Domain Events
• Specification (encapsula regras de negócio reutilizáveis e combináveis)
• Factory (responsável por criar Agregados complexos)

Application

Depende da Domain

Coordena os casos de uso da aplicação, orquestrando o domínio e definindo interfaces para dependências externas, sem conhecer detalhes de implementação.

• CasoDeUso
• DTO
• InterfaceDeServicoExterno
• Integration Events
• IEventPublisher (Interface)
• IUnitOfWork (Interface)
• ICacheService (Interface)

Recomendo usar FluentResults
X Não indico usar AutoMapper / Mapster
X Não indico usar MediatR

Infra

Depende da Domain e da Application

Implementa os contratos definidos nas camadas superiores, lidando com detalhes técnicos como persistência, serviços externos e infraestrutura.

• DbContext
• Repositorios (Implementação)
• UnitOfWork (Implementação do IUnitOfWork)
• CacheService (Implementação do ICacheService)
• CachedRepository (Decorator do repositório)
• ServicoExterno
• EventPublisher (Implementação do IEventPublisher)
• Consumers (ex: KafkaConsumer, recebe mensagem e chama CasoDeUso)

Ferramentais Uteis

• Entity Framework Core
• Dapper (se for usar micro-ORM)
• HttpClient / Refit : chamadas HTTP para serviços externos.
• Serilog / NLog / log4net : logging.
• SendGrid / MailKit / SmtpClient : envio de e-mail.
• Polly : retry e resiliente para chamadas externas.
• MassTransit / Confluent.Kafka : mensageria.

Presentation/API

Depende da Application

Expõe os recursos da aplicação ao mundo externo (ex: via HTTP), recebendo requisições, validando dados e delegando o processamento para a Application.

• Controllers
• Request/Response Dtos
• Configs
• Middlewares

Ferramentas Uteis

• ASP.NET Core WebAPI
• Swashbuckle.AspNetCore (Swagger)
• FluentValidation : para validação automática de modelos.
• JwtBearer : autenticação com JWT.
• ExceptionHandlerMiddleware

Diagrama

Presentation/API Controller Request / Response DTO Middleware

Infra DbContext Repositório (Implementação) Unit of Work Cache Service Cached Repository (Decorator) Serviço Externo Event Publisher Consumer (Kafka)

↓   ambos dependem   ↓

Application Caso de Uso  ·  DTO  ·  Integration Event  ·  Interface de Event Publisher  ·  Interface de Serviço Externo  ·  IUnitOfWork  ·  ICacheService

↓   depende   ↓

Domain Entidade  ·  Value Object  ·  Agregado (Aggregate Root)  ·  Domain Event  ·  Repositório (Interface)  ·  Domain Service  ·  Factory  ·  Specification