Como calculamos
Por que a conta no Contaí bate com a holerite / DARF / contrato real. Esta é a metodologia resumida.
1. Engine stateless e puro
Cada calculadora é uma função TypeScript sem efeitos colaterais: mesma entrada → mesma saída, sempre. Nenhuma calc depende do horário do servidor, cookie ou estado interno.
Isso garante três coisas: (1) o resultado é 100% reproduzível — você pode repetir amanhã e confere; (2) dá pra testar cada fórmula com propriedades matemáticas (property-based testing); (3) podemos expor a mesma função como API sem dor.
2. Tabelas de fontes oficiais
- INSS · Portaria MPS publicada anualmente em jan/fev
- IRRF · Tabela progressiva RFB (Lei 7.713/1988 + atualizações)
- Simples Nacional · LC 123/2006 + Anexos I a V vigentes
- FGTS · Lei 8.036/1990 + regras saque-aniversário
- CLT · Lei 13.467/2017 (Reforma) + CLT original
Um worker cron-diário monitora as fontes e abre uma task para atualizar tabelas quando detecta mudança. A equipe revisa antes de aplicar — nunca roda atualização automática em regra fiscal.
3. Cobertura de testes ≥ 95%
Toda calc tem suite de testes com três camadas:
- Golden references — casos de teste com valor esperado confirmado contra holerite real ou exemplo oficial.
- Casos de borda — salário mínimo, teto INSS, frações, arredondamentos.
- Property-based — com `fast-check`, geramos milhares de inputs aleatórios e verificamos invariantes (ex.: líquido ≤ bruto, soma das parcelas = saldo financiado).
4. Versionamento explícito
Cada calculadora tem um número de versão (ex.: v1.0.0) exibido junto ao resultado. Quando a regra fiscal muda, a versão aumenta. Isso significa que, se você guardar uma simulação hoje, daqui a 6 meses dá pra saber se ela ainda vale ou se a tabela foi revisada.
5. Revisão por profissional
Calcs de CLT, impostos e PJ são revisadas por contador parceiro da W1 Consultoria antes de serem publicadas. Calcs de saúde (IMC, gestação) passam por revisor médico. O nome e função do revisor aparecem no box de autoria da calc.
6. Você pode conferir
Toda calc exibe a fórmula usada + memória de cálculo linha a linha. Sem conta mágica.
Se o resultado não bate com sua holerite, provavelmente há um benefício, desconto sindical ou adicional específico que a calc não cobre. Mande um e-mail para erros@calculas.com.br com o caso e a gente investiga.