Automação de fundo idempotente

Rita Bevilacqua recebeu quatro faturas iguais no mesmo cliente numa terça de manhã. Cena inventada para a didática deste curso: um marco de medição aprovado uma vez, quatro faturas emitidas e a primeira automação de fundo da Vinco desligada antes do almoço. Este capítulo projeta a rotina que não repete: evento nomeado, chave de idempotência e log por tentativa.

A regra da rotina era inofensiva no papel: quando o marco de medição passa para aprovado, gere a fatura e avise o cliente. Faltava a pergunta que a regra nunca fez, já fiz isso antes para este marco, e o custo da manhã foi contado em confiança. O cliente perguntou se a Vinco sabia quanto ele devia, Rita mandou desligar a automação e a equipe voltou a gerar fatura à mão.

O passo 06 do método é a automação de fundo, e o autor escreve que ela é o trabalho que nunca deveria tocar num humano. Os exemplos que ele dá são deliberadamente domésticos, e é essa costura que faz o sistema parecer vivo entre uma ação humana e a próxima.

O paper da Boom apresenta três propriedades como condição de ligar qualquer rotina. Ela é event-driven, é idempotente e escreve em log de auditoria, de modo que um disparo em dobro não muda nada e toda ação é rastreável. A formulação é curta e a consequência é grande: as três se cobram juntas.

Separe o que você adota como doutrina do que você adota como número. As três propriedades são exigências de projeto e você as confere na sua própria implementação em uma tarde: dispare o mesmo evento cinco vezes e conte quantas faturas saíram. A contagem de 28 automações é relato do fornecedor, sem auditoria independente, e vale como ordem de grandeza, nunca como meta.

A pergunta que mais atrasa esse passo é qual rotina construir primeiro, e o método responde sem precisar de reunião. Luke Pierce, da Boom Automations, escreve em material publicado em 17 de agosto de 2026 que a lista de automação sai pronta do mapa do passo 01: todo handoff e toda tarefa repetitiva sinalizada é candidata, o ranqueamento é pelas horas cronometradas e a construção vai de cima para baixo. Quem cronometrou o mapa já tem a fila. Quem não cronometrou vai escolher a automação que parece mais divertida de construir, que quase nunca é a mais cara em horas.

Repare no que a tabela faz com a ordem. As duas primeiras linhas atacam o mesmo workflow, o mais caro do mapa da Vinco, e por isso entram juntas. As duas últimas são baratas e ficam para depois, mesmo sendo mais fáceis de construir. Essa inversão é o valor prático de ter cronometrado: sem as horas na mão, a rotina de arquivamento de documento seria a primeira, porque ela não pede conversa com ninguém.

Agora o exemplo resolvido do começo ao fim, e ele é o mesmo caso da abertura, feito certo. A automação da fatura da Vinco tem seis atos, nesta ordem, e o quarto é o que a versão quebrada não tinha.

A ordem dos atos três e quatro é a parte contraintuitiva. A tentação é gerar a fatura primeiro e registrar depois, porque assim o log conta a verdade do que aconteceu. O problema é a janela entre as duas coisas: se duas entregas do evento chegam no mesmo segundo, as duas consultam o log vazio, as duas concluem que nunca fizeram e as duas geram fatura. Reservar a chave dentro da transação fecha essa janela, porque o banco não deixa a mesma chave ser gravada duas vezes. É a mesma lógica do caminho único de escrita por entidade, aplicada ao registro do que já foi executado.

O efeito externo do ato cinco pede uma decisão adicional que ninguém gosta de tomar. Se o e-mail falhar depois de a fatura existir, a rotina tenta de novo e o cliente pode receber duas cópias do mesmo aviso. Se ela desistir, o cliente não recebe nada e alguém precisa perceber. A escolha correta depende do que dói menos naquele negócio, e o projeto tem que declarar qual foi. O que não é aceitável é descobrir a resposta no dia do incidente.

Os erros desta fase têm sintoma parecido e causa diferente, o que faz muita equipe consertar o lugar errado. Vale separar cada um pelo movimento de saída, porque é o movimento que muda.

Antes de ligar, use o checklist abaixo como portão local desta camada. Ele é mais curto que os portões A e B do método, porém tem a mesma natureza: se uma linha não está marcada, a automação fica na prancheta. Automação de fundo é a única parte do sistema que age quando ninguém está olhando, então ela é também a única que precisa provar o próprio comportamento antes de ganhar permissão de agir.

Uma observação de projeto que a fonte não faz e que vale carregar daqui. O log de auditoria da automação e o log das escritas de agente são o mesmo artefato, e é bom que sejam. O paper registra que toda escrita de agente é validada contra o schema antes de gravar e que toda escrita é registrada em log. Se a automação escrever no mesmo lugar, você ganha uma única linha do tempo por entidade, com ação humana, ação de agente e ação de rotina lado a lado. Sem isso, investigar um número estranho numa fatura exige abrir três históricos e conciliar relógios diferentes.

Volte à terça-feira de Rita. As quatro faturas nasceram de uma rotina que não tinha como perguntar se já havia feito aquilo. Com evento nomeado, chave derivada do marco e log por tentativa, o mesmo acúmulo de reentrega, clique repetido e teste manual produz uma fatura e um histórico legível. O erro humano continua existindo. Ele deixa de virar dado errado.