Async Processing Dotnet

Regras de implementacao

Consumers e workers

• Manter consumer fino; delegar regra ao use case.
• Isolar parse, validacao minima e chamada de aplicacao.
• Nao espalhar retry e idempotencia de forma ad-hoc em varios pontos.

Mensagens

• Definir contratos explicitos.
• Evitar usar entidades internas completas como payload de fila.
• Incluir correlacao quando isso ajudar rastreabilidade.

Idempotencia

• Assumir entrega duplicada como possibilidade real.
• Definir estrategia de deduplicacao antes de considerar o fluxo pronto.

Retry e falha

• Diferenciar falha transitoria de falha terminal.
• Ter estrategia clara para poison message ou reprocessamento quando aplicavel.

Observabilidade

• Logar inicio, sucesso, falha e retry.
• Expor metricas ou pelo menos contadores relevantes quando a operacao exigir.
• Health checks para dependencias criticas do fluxo assincrono.

Checklist rapido

• worker/consumer fino
• use case no centro do fluxo
• contrato de mensagem explicito
• idempotencia prevista
• retry previsto
• logging e metricas avaliados
• testes cobrindo duplicidade e falha

Docs complementares

• ../../docs/architecture/architecture-baseline.md
• ../../docs/async-processing/worker-and-messaging-patterns.md
• ../../skills/observability/SKILL.md