Como evitamos que nossas calculadoras de impostos e folha de pagamento fiquem desatualizadas sem ninguém perceber

Toda calculadora deste site que envolve impostos, previdência social ou salário mínimo tem a mesma falha estrutural: está correta no dia em que a publicamos, e depois, seis meses mais tarde, um governo atualiza uma alíquota e a ferramenta passa a dar respostas erradas silenciosamente. Nenhuma mensagem de erro aparece. A página continua funcionando exatamente como antes — só que agora está errada, e com total confiança.

Esse é um resultado pior do que simplesmente não ter a ferramenta. Por isso criamos um sistema especificamente para detectar esse tipo de problema.

O problema de “a gente lembra de verificar”

A solução óbvia — “basta verificar os números periodicamente” — não escala. Mantemos calculadoras de salário líquido, previdência social e folha de pagamento em meia dúzia de países, cada um com suas próprias faixas de imposto, alíquotas de contribuição e limites reajustados anualmente. Multiplique isso pelo tempo que passa até alguém lembrar de conferir de novo, e a resposta honesta é: mais cedo ou mais tarde, algum número fica desatualizado e ninguém percebe até que um usuário perceba primeiro.

O que construímos em vez disso

Um arquivo de registro lista cada número oficial fixo no código de cada calculadora: em qual arquivo ele está, o que o número representa, onde fica a fonte oficial e com que frequência ele realisticamente costuma mudar (alguns valores mudam todo mês de janeiro, quando começa um novo ano fiscal; outros só mudam quando uma lei é alterada, o que é imprevisível, mas raro).

Uma tarefa agendada roda semanalmente, verifica quais itens estão previstos para revisão de acordo com esse cronograma e, para cada um deles:

Busca o valor atual na fonte oficial do governo
Pede a um modelo de linguagem que extraia o número específico dos resultados da busca — nada além disso, apenas o número e um nível de confiança
Se o modelo está confiante e o número mudou, aplica isso como uma substituição de texto literal e verificada diretamente no código (nunca uma reescrita livre — o modelo não tem permissão para improvisar a lógica ao redor)
Executa um build completo para confirmar que nada quebrou antes de confirmar qualquer alteração
Se o build falhar, a alteração é revertida automaticamente e sinalizada para revisão humana

Todo o sistema gira em torno de um princípio simples: a automação tem permissão para atualizar um número, mas nunca tem permissão para adivinhar. Se não conseguir encontrar uma resposta confiável em uma fonte oficial, ela não faz nada e relata isso claramente, em vez de deixar um número errado, mas plausível, no lugar.

Independente de qualquer ferramenta única

A tarefa em si roda em uma infraestrutura independente de um único fornecedor ou conta — se uma parte do pipeline falhar, o sistema inteiro não para, apenas recorre a um caminho alternativo para extrair o número. Essa redundância importa mais aqui do que na maioria das automações: uma calculadora de impostos errada causa dano real, de um jeito que, por exemplo, um gerador de memes quebrado simplesmente não causa.

O que isso significa para você

Toda calculadora coberta por esse sistema mostra diretamente na página uma data de “dados oficiais verificados”, separada da data de “última atualização” que você pode ver numa página de conteúdo normal. Se algum dia você vir essa data com aparência suspeitamente antiga, vale a pena nos avisar diretamente — normalmente isso significa que a verificação automática encontrou uma fonte que não conseguiu interpretar, não que esquecemos dela.

Experimente

Essas são ferramentas de um único idioma, construídas especificamente para as regras do seu próprio país, então os links abaixo abrem nesse idioma: