Problema real e contexto
Integrações assíncronas sofriam com reentrega de eventos e execução duplicada de processos.
Era necessário implementar barreiras de idempotência sem aumentar complexidade arquitetural.
Decisões técnicas
-
Chaves de idempotência por operação com TTL.
-
Locks com tempo curto para seções críticas.
-
Filas simples para amortecer picos de processamento.
-
Auditoria de eventos descartados por duplicidade.
Tip: Desenhe as chaves com semântica de negócio, não apenas com IDs técnicos.
Checklist final
-
Definir política de expiração por tipo de operação.
-
Garantir idempotência também no destino final.
-
Medir taxa de mensagens duplicadas evitadas.
-
Planejar comportamento para expiração antecipada de chave.
Erros comuns
-
TTL longo demais consumindo memória desnecessária.
-
Lock sem estratégia de renovação/expiração.
-
Assumir que dedup elimina necessidade de observabilidade.