Como eu faço backend em .NET
As boas práticas que eu uso no dia a dia: código, arquitetura, dados, produção e o trabalho em time.
Cada linha é uma página do guia, na ordem de leitura.
- 01 Backend com ASP.NET Core Código
- 02 APIs REST Código
- 03 ASP.NET Core na prática Código
- 04 Clean code Código
- 05 Princípios SOLID Código
- 06 Design patterns Código
- 07 Visão geral Arquitetura
- 08 N-camadas Arquitetura
- 09 Domain-Driven Design Arquitetura
- 10 Microsserviços Arquitetura
- 11 System design Arquitetura
- 12 Repository Dados
- 13 EF Core Dados
- 14 Consultas SQL Dados
- 15 APIs externas Integração
- 16 Mensageria Integração
- 17 Outbox e idempotência Integração
- 18 Testes Qualidade
- 19 Testes de integração Qualidade
- 20 Segurança Qualidade
- 21 Performance Produção
- 22 Cache Produção
- 23 Observabilidade Produção
- 24 Cloud Produção
- 25 DevOps Produção
- 26 Git Produção
- 27 Docker e Kubernetes Produção
- 28 Pipelines de CI/CD Produção
- 29 Soft skills Carreira
- 30 Comunicação escrita Carreira
- 31 Code review Carreira
- 32 Carreira Carreira
- 33 Entrevistas técnicas Carreira
- 34 Referências Carreira
Escolhas que eu defendo
Opiniões de quem mantém sistema em produção. Discorde à vontade, mas com motivo.
| Em vez de | Eu uso | Por quê |
|---|---|---|
| MediatR | Chamada direta ao caso de uso | Uma camada de indireção a menos para debugar. Desde 2025 a biblioteca tem licença comercial. |
| AutoMapper ou Mapster | Mapeamento escrito à mão | Campo esquecido vira erro de compilação, não bug em produção. |
| Newtonsoft.Json | System.Text.Json | Nativo, mais rápido e integrado ao pipeline do ASP.NET Core. |
| DbContext dentro do domínio | Repository com a interface no Domain | O domínio não sabe que o EF Core existe, e o teste não precisa de banco. |
| Exceção para regra de negócio | Result com FluentResults | Falha 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.
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;
}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));