Metodologia, Rastreabilidade e Fontes Oficiais

O Compromisso Estimei

O Estimei não é banco, corretora, imobiliária nem leiloeiro — não recebemos comissão embutida em nenhuma fórmula, e nenhum cálculo é ajustado pra favorecer um produto financeiro em detrimento de outro. O resultado que aparece na tela é o mesmo, seja qual for o banco, o leilão ou a construtora que você está avaliando.

Esse compromisso é operacional, não só declarativo: toda fórmula usada nas 46 calculadoras é auditável, todo índice de mercado tem fonte nomeada e data de competência visível, e a resposta básica — o cálculo principal, o gráfico, o comparativo — nunca fica atrás de cadastro ou paywall.

Fontes Oficiais Primárias

Todo índice ou taxa usado nos cálculos vem de uma fonte oficial nomeada, nunca de um valor aproximado ou de memória. Veja o detalhamento completo — com exemplos de calculadoras por fonte — na Central de Fontes Oficiais.

Engenharia e Garantia de Exatidão

Uma fonte oficial só vale alguma coisa se a fórmula que a usa estiver correta — por isso cada mudança de código passa por uma suíte de testes de regressão antes de qualquer publicação, com zero falha tolerada.

Essa suíte roda a cada atualização de código, comparando o resultado de cada calculadora contra valores de referência (golden values) conferidos manualmente — se um único cenário sair do esperado, a publicação é bloqueada até a causa ser corrigida. Na prática, isso cobre:

• Execução contínua dos 63 cenários-ouro com valores de referência conferidos manualmente (golden-values.json), rodada a cada atualização de código, antes de qualquer publicação chegar ao ar.
• Testes de regressão cobrindo as fórmulas centrais do portal — amortização SAC e Price (financiamento), Custo Unitário Básico por UF (CUB, NBR 12.721), alíquotas de ITBI municipal e Ganho de Capital na venda de imóveis.
• Verificação de consistência numérica e tolerância de arredondamento (0,01 por padrão, ajustável por cenário quando a própria matemática exige) a cada deploy — nenhuma calculadora vai ao ar com resultado fora do valor de referência esperado.

Além da checagem que roda antes de cada publicação, um monitoramento automático semanal (GitHub Actions, toda segunda-feira às 8h de Brasília) audita essa mesma suíte de forma independente do ciclo de deploy — garantindo que nenhuma regressão passe despercebida mesmo em semanas sem nenhuma mudança de código nova.

📋 Veja o resultado da última execução, calculadora por calculadora — cenários, casos-limite e data de revisão de cada fórmula — na Central de Qualidade e Auditoria.

Ecossistema para Agentes de IA e Desenvolvedores

Além da interface para pessoas, o Estimei expõe seus dados e cálculos de forma estruturada para agentes de IA e desenvolvedores integrarem diretamente, sem depender de scraping ou estimativa.

O servidor MCP expõe as 46 calculadoras do catálogo como ferramentas (45 calcular_* e o analisar_leilao, que cobre a Jornada de Leilão): em vez de um agente estimar um número, ele pode chamar a ferramenta e receber o resultado real, calculado com a mesma fórmula usada no site. A Central do Desenvolvedor lista cada ferramenta com entradas, saída e um exemplo real.

O catálogo em JSON reúne, para cada calculadora, as entradas e saídas com unidade, a fórmula e as limitações com o mesmo texto desta página e das calculadoras, as fontes legais e um exemplo conferido pela suíte de testes. Ele é gerado automaticamente a cada versão do site, a partir das mesmas fontes que as páginas usam; nada nele é escrito à mão.

Histórico de Versões da Metodologia

Esta é a versão da metodologia, independente da versão de software do site (que muda a cada deploy) — ela sobe quando uma mudança afeta como um número é calculado ou de onde ele vem, não a cada ajuste visual ou de código.