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