## Padrão para Handlers do MediatR e EF Core
✅ Padrão Correto:
```csharp
public sealed class GetCustomerByIdQueryHandler(AppDbContext context,
        ILogger<GetCustomerByIdQueryHandler> logger) 
    : IRequestHandler<GetCustomerByIdQuery, Result<CustomerDto>>
{
    public async Task<Result<CustomerDto>> Handle(GetCustomerByIdQuery request,
 CancellationToken cancellationToken)
    {
        var customer = await context.Customers
            .AsNoTracking()
            .FirstOrDefaultAsync(c => c.Id == request.Id, cancellationToken);

        if (customer is null)
            return Result.Failure<CustomerDto>(DomainErrors.Customer.NotFound(request.Id));

        return customer.ToDto();
    }
}

Todos os Handlers seguem este padrão: Primary Constructors + CancellationToken + AsNoTracking 
para leitura + Pattern Result.
```

## Processo de Revisão
Antes de concluir qualquer tarefa:
1. Execute `dotnet build` e garanta zero avisos de compilação (Warnings as Errors).
2. Avalie a conformidade — declare explicitamente ✅ ou ❌ para cada item:
   - Uso de `CancellationToken` em métodos assíncronos
   - Injeção de dependência via *Primary Constructors*
   - Tratamento de exceções e uso de tipos `Result`
   - Testes unitários atualizados

## Atualização de Entidades no EF Core
❌ Errado: Buscar entidade inteira apenas para atualizar um campo sem controle
var user = await context.Users.FindAsync(id);
user.Name = newName;
await context.SaveChangesAsync();

✅ Correto: Atualização via ExecuteUpdateAsync para operações pontuais de alta performance
await context.Users
    .Where(u => u.Id == id)
    .ExecuteUpdateAsync(s => s.SetProperty(u => u.Name, newName), cancellationToken);

minha-solucao/
├── CLAUDE.md                       # Global: regras Git, estilo C#, convenções da Solution
├── src/
│   ├── Apps.Web/
│   │   └── .claude/CLAUDE.md       # Específico para Blazor / Controllers / UI
│   └── Services.Payment/
│       └── .claude/CLAUDE.md       # Específico para gRPC, RabbitMQ e worker services