Pular para o conteúdo

Motor e testes

O motor é o código que faz todas as contas do Refund. Os números desta página são contados direto do repositório, rodando os testes.

regras no motor
9
testes do motor passando
316
testes de conferência com fontes publicadas
39

Como o motor trabalha

  • Ele não acessa a internet, banco de dados nem IA. Recebe os fatos e as tabelas da lei e devolve cada valor com a conta passo a passo.
  • Dinheiro é sempre um número inteiro de centavos; as contas intermediárias usam aritmética decimal exata, sem os arredondamentos escondidos do ponto flutuante.
  • A mesma entrada dá sempre a mesma saída, e o mesmo código roda no servidor e no seu navegador (é ele que recalcula quando você mexe num controle).
  • Cada citação de lei vem da própria regra, e um teste confere que todo artigo citado existe no acervo de leis do Refund.

As regras

RegraCódigoReferências legais
Fator R e pró-laboreR0117
Exportação separadaR0517
Produtos monofásicosR0610
IRPF do sócioR047
Recuperar o que foi pago a maisR05-REC15
Dividendos acima de R$ 50 milR024
Limite do Simples e do MEIR0317
Despesa pessoal na empresaA015
Pró-labore abaixo do mínimoA025

Os testes

Conferência com fontes oficiais39
O motor refaz exemplos publicados pela Receita Federal e pelo governo federal (manual do PGDAS-D, exemplos da Lei 15.270, tabela do simulador de IR) e precisa chegar ao mesmo centavo. Um dos exemplos vem de fonte secundária (COAD). Onde as fontes oficiais divergem entre si ou têm erro de impressão, a escolha e o motivo ficam registrados no próprio teste.
Casos de referência das regras257
Para cada regra, casos com o valor esperado calculado à mão a partir da lei, incluindo as fronteiras (por exemplo, Fator R em 27,99% e em 28%).
Propriedades12
De 25 a 200 entradas geradas ao acaso em cada teste (até 1.000 na integração contínua): imposto nunca negativo, mais receita nunca reduz o DAS, todo valor é um número inteiro de centavos.
Invariantes da análise completa8
Na análise da persona de ponta a ponta: a soma das economias é igual ao total, sem contar nada duas vezes.

1 caso marcado como pendente, sem código ainda, fora da contagem. Fontes registradas para a conferência: 4 primárias e 1 secundária.

De onde vêm estes números

O script scripts/generate-engine-page.ts roda os testes do motor e grava as contagens. Um teste automático falha se algum arquivo de teste mudar sem que a contagem seja refeita. Motor versão 0.2.0, parâmetros 2026.11.14, impressão digital dos testes a475f2dcd0c6.

O que é real e o que é de teste no Refund está em Como funciona.