Ajuda e metodologia — Busco Rumo

1. Como usar

O Busco Rumo ajuda a comparar municípios brasileiros para decidir onde morar, investir ou visitar, usando dados públicos (IBGE, INEP, PNUD, Atlas da Violência, SINISA) e as suas próprias preferências.

Descobrir

Na aba 🔍 Descobrir você filtra cidades por região, porte, clima, custo de vida, esportes/atividades e outros critérios da barra lateral, e ordena a lista por Qualidade, Compatibilidade, PIB/hab, população, entre outros.

Ações sobre uma cidade

• 🏠 Moro Aqui — marca a cidade onde você já vive hoje.
• 💭 Queria Morar Aqui — cidades que você avalia como destino real de mudança.
• ✈️ Quero Visitar — cidades de interesse turístico, sem intenção de mudança.
• Descartar — cidades que você já avaliou e decidiu excluir das suas comparações (some das recomendações da Bússola, mas continua disponível em Descobrir).

Todas essas marcações ficam em 🏠 Meu Rumo, com histórico e opção de compartilhar.

2. Como funciona a Bússola de Mudança

A Bússola é uma recomendação de compatibilidade entre suas respostas a um questionário e os atributos das cidades da base — não é uma previsão de futuro nem uma garantia de qualidade de vida. O resultado é uma ordenação, não um veredito.

Filtro eliminatório

Antes de pontuar qualquer cidade, a Bússola aplica um piso de IDH-E ≥ 0,700. Esse piso só é descartado (voltando a considerar todas as cidades) se sobrarem menos de 5 cidades acima dele — ou seja, é eliminatório por padrão, mas nunca a ponto de deixar a lista vazia.

Fatores de preferência e pontuação

Depois do filtro, cada cidade recebe pontos conforme casa com as respostas do questionário. Os pesos abaixo estão no código (bussola.html, função de pontuação da recomendação) e não em uma escala de 0 a 100 — são pontos que se somam entre si:

Fatores de segurança e saneamento entram como pontuação de base — sempre aplicados, independente de você ter marcado alguma persona — usando os mesmos campos oficiais descritos na seção 4.

Diferença entre os três números que você vê no app

• Recomendação da Bússola (esta seção) — pontos do questionário, só existe dentro de bussola.html, não é uma nota de 0 a 100.
• Nota de Qualidade /100 (seção 3) — indicador objetivo do card, igual para todo mundo, não depende de preferências pessoais.
• Compatibilidade — pontuação de aderência a uma "persona" (ex.: família com filhos, remoto, aposentadoria) ativada na aba Descobrir; é pessoal como a Bússola, mas usa outra fórmula e outra tela.

Nenhum desses três números se sobrepõe ou conta a mesma coisa duas vezes — cada um tem seu próprio cálculo de segurança/saneamento quando aplicável.

3. Como é calculada a nota de Qualidade do card

A nota Qualidade (0–100) exibida em todo card de cidade é objetiva: não usa suas respostas de preferência, é a mesma para todos os usuários. Soma 7 componentes:

Dicas Outdoor usa a mesma fórmula, mas sem o componente de saneamento (fora do escopo daquele app): IDH-E 37, IDEB 26, PIB 16, Natureza 6, Turismo 6, Segurança 9 — também soma 100.

Dados ausentes, estimados ou de fallback estadual

• IDEB ausente (cerca de 300 municípios pequenos, geralmente com menos de 5.000 habitantes, sem escola estadual testada): entra como valor neutro 0,4, nem penaliza nem beneficia.
• PIB é estimado por proporção de população para a maioria dos municípios (só SP, RJ e MG têm PIB granular oficial do IBGE); a imprecisão pode chegar a 200–300% em cidades com indústria concentrada.
• Segurança e saneamento com fallback estadual: quando o município não tem série própria, o valor vem da média/série oficial do estado (nunca é inventado) e o componente é amortecido a 50% da distância até o neutro — fórmula 0,5 + (valor_bruto - 0,5) × 0,5 — para reduzir o peso prático do dado indireto sem zerá-lo. O card sempre mostra (estadual) ao lado da nota nesse caso.

Badges e barras

As barras do detalhamento de score mostram a proporção de cada um dos 7 (ou 6, no Outdoor) componentes acima. O selo (estadual) é a única classificação interpretativa dentro da nota de Qualidade — indica fallback regional, não um julgamento de qualidade. Badges de conquista (ex.: "Refúgio Seguro" no Dicas Outdoor) são independentes da nota de Qualidade: usam critério próprio (ex.: tendência de segurança não pode estar em alta, além da taxa baixa) e não somam nem subtraem pontos da nota do card.

4. Dados, fontes e limitações

Cobertura

• Segurança pública: 5.530 de 5.570 municípios com série direta (99,3%); os demais usam fallback estadual, sempre sinalizado.
• Saneamento: 5.272 de 5.570 municípios com série direta (94,6%); os demais usam fallback estadual, sempre sinalizado.
• IDEB: ausente em cerca de 300 municípios pequenos (ver seção 3).

Os campos det_homicidios e mtur_seguranca estão desativados desde a fase de reconciliação de dados (planilha do MTur sem ano, licença ou fonte documentados). Eles permanecem apenas como histórico dentro da base de dados, mas nenhum cálculo do app — Qualidade, Bússola ou Compatibilidade — os lê. Segurança pública hoje é calculada exclusivamente a partir do Atlas da Violência (Ipea/FBSP).

Números estimados (PIB por proporção de população, risco climático por região) nunca são apresentados como medição direta — a intenção é dar um indicativo, não uma métrica de precisão.

5. Testes e confiabilidade

O código passa por testes automatizados antes de qualquer publicação. Os principais, hoje:

• Bateria de integridade (scripts/test_battery.py) — confere volume e estrutura da base de municípios, IDs únicos, notas de Qualidade sempre entre 0 e 100 sem valores inválidos, determinismo do cálculo e isolamento entre Busco Rumo e os demais apps.
• Integridade estrutural (scripts/test_fase1_unitarios.py) — normalização de busca e contrato do módulo de território (regiões/UFs), sem auditar qualidade de dado em si.
• Confiança de dados (scripts/test_fase2_complementar.py) — inclui a verificação de que det_homicidios/mtur_seguranca continuam desativados.
• Compatibilidade (scripts/test_fase4_unitarios.py) — espelha em Python a lógica de pontuação de Compatibilidade usada no card.
• Segurança e saneamento (scripts/test_fase_seguranca_saneamento.py) — proveniência dos dados, cobertura oficial/fallback e integração correta na nota de Qualidade, sem contagem duplicada com a Compatibilidade.

Dados inválidos, duplicados ou incompletos são tratados assim: campos ausentes recebem valor neutro (nunca zero automático) quando descrito nesta página; municípios sem série própria usam fallback estadual sinalizado; nenhum dado é reaproveitado sem fonte documentada.

6. Contato e correção de dados

Ainda não temos um canal de contato oficial configurado (e-mail ou formulário dedicado) para este produto — canal de contato em breve. Enquanto isso, não há endereço para publicar aqui.

Se você notou um dado municipal desatualizado ou incorreto, anote o município, o campo e a fonte que você tem em mãos — quando o canal de contato estiver disponível, essa é a informação que vamos pedir primeiro.

7. Termos e privacidade

Os textos completos ficam em páginas próprias, compartilhadas entre Busco Rumo, Dicas Outdoor e ExploreBR:

• Termos de Uso — o que os produtos fazem, uso aceitável, isenção de responsabilidade sobre decisões reais de mudança/investimento.
• Política de Privacidade — quais dados são coletados, retenção e direitos LGPD.

Estes textos são informativos e ainda não passaram por revisão jurídica formal. Use o bom senso: os dados e scorecards do Busco Rumo apoiam decisão, não substituem due diligence profissional antes de qualquer mudança real de cidade ou investimento.

8. Perguntas frequentes

A Bússola garante que eu vou ser feliz na cidade recomendada?

Não. É uma ordenação por aderência às suas respostas, não uma previsão nem uma garantia de qualidade de vida.

Por que uma cidade com nota de Qualidade baixa aparece bem colocada na Bússola?

Porque são cálculos diferentes: a Bússola pontua aderência às suas preferências pessoais (ver seção 2), a Qualidade é um indicador objetivo igual para todos (ver seção 3). Uma cidade pode combinar muito com você sem ter a maior nota objetiva.

Por que nem toda cidade tem IDEB?

IDEB depende de escola estadual testada pela Prova Brasil. Municípios pequenos sem essa rede (cerca de 300, geralmente abaixo de 5 mil habitantes) não têm o dado oficial — o componente de Qualidade usa valor neutro (0,4) nesses casos.

O PIB por cidade é medido de verdade?

Só para São Paulo, Rio de Janeiro e Minas Gerais o IBGE publica PIB municipal granular. Para os demais municípios, o valor é estimado proporcionalmente à população do estado — pode ter imprecisão relevante em cidades com indústria concentrada.

Posso baixar os dados usados pelo app?

O arquivo cities_data.js é JSON válido depois de remover o prefixo window.CITIES_DB = e o ; final — pode ser importado em qualquer ferramenta de análise.

Por que os filtros "IDH mínimo" e "IDEB mínimo" desapareceram da barra lateral?

Eram controles pouco usados que ocupavam espaço útil da barra lateral. A lógica de filtro continua ativa internamente com os valores padrão de antes (IDH ≥ 0,50, sem piso de IDEB) — nenhuma recomendação, badge ou nota deixou de funcionar.