Projeto · Robôs diários de aviso fiscal

Esteira fiscal de avisos, da auditoria à operação

Quatro robôs de aviso fiscal rodavam todo dia com uma falha silenciosa na fila de e-mail, e ninguém via. Assumi esses robôs de outro desenvolvedor, auditei, corrigi a falha e passei a operar o ciclo. Eu não construí essa esteira.

Cliente
Reduzzi Brasil
Meu papel
Assumi e corrigi, auditei, operei
Estado
Em produção no período em que eu operei
Diagrama: documentos passam por quatro estações de inspeção, e o único trecho reparado da linha aparece em azul.

Contexto

Quatro robôs que já rodavam todo dia

A Reduzzi Brasil tinha quatro robôs diários de aviso fiscal. Outro desenvolvedor escreveu os quatro, e eles já estavam em produção quando eu cheguei. Eu assumi os robôs.

Eu era o único desenvolvedor da casa. A partir dali, cuidar deles era comigo.

O problema

Uma falha que não acusava erro

Havia uma falha silenciosa na fila de e-mail. Ela não acusava erro, e ninguém via. Em robô de aviso, erro silencioso é o pior tipo de erro, porque por fora tudo parece funcionar.

Meu papel

Assumi e corrigi

Primeiro auditei o que existia. Depois corrigi o que falhava e operei o ciclo. Os robôs são de outro desenvolvedor. Eu não desenhei nem escrevi a primeira versão.

A virada

Da auditoria ao alarme

  • Auditei os quatro robôs e classifiquei 14 achados por gravidade.
  • Corrigi a falha silenciosa na fila de e-mail.
  • Passei a validar 100% dos contatos.
  • Coloquei alarme e um teste canário.
  • Quando o extrator por IA parou, troquei o motor de OpenAI para Gemini.
  • Conferi o ciclo CPF a CPF.

Resultado

O ciclo que eu conduzi

  • 4 robôsAssumidos de outro desenvolvedor.
  • 14 achadosNa auditoria, classificados por gravidade.
  • 100%Dos contatos validados.

No ciclo que eu conduzi, conferi os avisos CPF a CPF. Não houve falha de envio registrada.

Limites

O que este projeto não prova

  • Foi takeover. Eu não desenhei nem escrevi a primeira versão dos robôs.
  • O resultado é de um ciclo, o que eu conduzi. Não é série histórica.
  • "Sem falha de envio registrada" vale para os registros desse ciclo. Não é garantia para os ciclos seguintes.
  • Eu não descrevo aqui o detalhe da falha que encontrei. Isso é assunto interno do cliente.
  • Trabalhei sozinho. Nenhum outro engenheiro revisou o código.

Stack

  • n8n self-hosted
  • OpenAI
  • Gemini
  • Alarme
  • Teste canário