Metodologia

Como cada número é construído, protegido e datado. Esta página é a âncora cruzada — cada produto aponta para a seção que explica o seu cálculo.

1. O grão: território × período

Todo indicador é agregado por município e período (mês, ano ou exercício, conforme a fonte). Nunca por pessoa. Isso é uma escolha de arquitetura: o que não existe no banco não pode vazar nem ser cruzado para reidentificar ninguém.

2. Supressão por privacidade (k-anonimato)

Quando a célula vem de origem sensível (saúde, sobretudo) e tem contagem pequena — tipicamente menos de 5 —, o valor é suprimido antes de gravar. A tela mostra um estado honesto, nunca o número por baixo e nunca um zero falso:

🔒 Protegido — havia dado, mas é pequeno demais para publicar sem risco de reidentificação.
○ Sem cobertura — a fonte não reporta este território/período. Ausência de dado ≠ ausência do fato.

A distinção entre os dois estados é deliberada e nunca colapsa em “0”.

3. O IVM — índice de vulnerabilidade municipal

O IVM resume emprego, finanças e saúde num só sinal semafórico (verde → vermelho). É um composto descritivo, não um diagnóstico: aponta onde olhar, não o que concluir. Cada subíndice mantém sua fonte e período próprios, e o que é protegido entra no composto como protegido — não como zero.

4. Proveniência

Cada indicador carrega fonte, método e atraso típico (lag). O selo de confiança consolida origem, licença e frescor em cada tela; a página de Fontes é a vista agregada. Cadência e atraso são típicos da fonte — não garantia de tempo real.

5. Honestidade editorial

O vocabulário do projeto é deliberado para não confundir o leitor:

Execução ≠ serviço. Liquidar uma despesa não é entregar a obra. Empenhar não é liquidar.
Fluxo é volátil. Saldos mensais (CAGED) oscilam; a tendência merece a pergunta, não o pânico.
Demonstração é demonstração. Quando a esteira existe mas o dado real ainda não fluiu, a tela diz isso.

6. IA ancorada

A resposta em linguagem natural só afirma o que o acervo sustenta e cita a fonte. Sem dado, abstém-se — não inventa número nem causalidade. A recuperação é restrita ao repositório; o modelo não “sabe” nada fora dele.

Limitações conhecidas, declaradas. Subnotificação em vigilância (SINAN), defasagem de meses em várias fontes, cobertura parcial do PNCP, e o mapa do IVM ainda em cartograma (falta a malha geométrica do IBGE no backend — limitação, não erro). Preferimos declarar a limitação a escondê-la.

Cada produto traz sua nota metodológica específica na própria tela. Esta página é o tronco comum; os galhos vivem em cada produto.