my-code-codex

Escolhas que eu defendo

Opiniões de quem mantém sistema em produção. Discorde à vontade, mas com motivo.

Em vez deEu usoPor quê
MediatRChamada direta ao caso de usoUma camada de indireção a menos para debugar. Desde 2025 a biblioteca tem licença comercial.
AutoMapper ou MapsterMapeamento escrito à mãoCampo esquecido vira erro de compilação, não bug em produção.
Newtonsoft.JsonSystem.Text.JsonNativo, mais rápido e integrado ao pipeline do ASP.NET Core.
DbContext dentro do domínioRepository com a interface no DomainO domínio não sabe que o EF Core existe, e o teste não precisa de banco.
Exceção para regra de negócioResult com FluentResultsFalha esperada é retorno, não fluxo de controle escondido.

Um pedido, quatro camadas

O mesmo exemplo atravessa o guia: o agregado protege a regra, o caso de uso orquestra.

Domain/Entities/Order.cs
public static Order Create(string customerId, List<OrderItem> items)
{
    if (string.IsNullOrWhiteSpace(customerId))
        throw new DomainException("Cliente é obrigatório.");

    if (items == null || items.Count == 0)
        throw new DomainException("Pedido deve ter ao menos um item.");

    var order = new Order
    {
        Id = Guid.NewGuid(),
        CustomerId = customerId,
        Status = OrderStatus.Pending
    };

    foreach (var item in items)
        order._items.Add(item);

    order.Total = order._items.Sum(i => i.Price * i.Quantity);
    order._domainEvents.Add(new OrderCreatedEvent(order.Id, customerId));

    return order;
}
Application/UseCases/CreateOrderUseCase.cs
var existingOrders = await _orderRepository.GetByCustomerIdAsync(input.CustomerId, ct);

if (!_domainService.CustomerCanPlaceOrder(existingOrders))
    return Result.Fail("Cliente atingiu o limite de pedidos pendentes.");

var order = _factory.Create(
    input.CustomerId,
    input.Items.Select(i => (i.ProductId, i.Price, i.Quantity))
);

await _orderRepository.AddAsync(order, ct);

// Um único commit: tudo persiste junto ou nada persiste
await _unitOfWork.CommitAsync(ct);

foreach (var domainEvent in order.DomainEvents)
{
    var integrationEvent = new OrderCreatedIntegrationEvent(order.Id, order.CustomerId);
    await _eventPublisher.PublishAsync(integrationEvent, ct);
}

return Result.Ok(new CreateOrderOutput(order.Id, order.Total));