| name | async-processing-dotnet |
| description | Guia para processamento assincrono em .NET 8 ou 10. Use quando a tarefa envolver BackgroundService, IHostedService, workers, filas, eventos, consumidores, retries, idempotencia, orchestracao assincrona, jobs internos ou integracao entre mensageria e use cases. |
Async Processing .NET 8/10
Quando usar esta skill
Use quando a tarefa envolver:
BackgroundService ou IHostedService;- worker dedicado;
- fila, evento, consumer, producer ou broker;
- retry, deduplicacao, idempotencia ou reprocessamento;
- processamento desacoplado do request HTTP.
Baseline default
Application continua dono da regra de negocio.Infra.Messaging concentra adapters de broker e contratos tecnicos.Worker ou hosted service coordena consumo e execucao.- Idempotencia, retry e observabilidade fazem parte da implementacao.
Antes de implementar
- Ler
../../docs/architecture/architecture-baseline.md.
- Ler
../../docs/async-processing/worker-and-messaging-patterns.md.
- Ler
../../skills/observability/SKILL.md se houver metricas, tracing ou health checks.
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
Docs complementares
../../docs/architecture/architecture-baseline.md../../docs/async-processing/worker-and-messaging-patterns.md../../skills/observability/SKILL.md
