# Transformações — Recife ITBI, snapshot da consulta

Este pacote é a cópia integral, em formato legível por máquina, da base derivada de Recife usada nesta versão da consulta. Não contém outras bases municipais nem planilhas brutas. Os 128 fragmentos JSON e o índice são os mesmos da pasta de consulta, com atribuição/licença adicionadas ao índice. O JSON consolidado apenas reúne essas estruturas sem modificar seus números ou textos.

## Herança do export legado

1. Entradas: CSVs oficiais Recife 2024, 2025 e 2026 presentes no cache. A checagem de 18/10/2026 confirmou identidade byte a byte desses três arquivos com os recursos municipais atuais. Os hashes das entradas e URLs estão em fonte.json. O snapshot servido é o legado gerado em 13/10/2026, não uma reimportação de 18/10.
2. Leitura CSV em UTF-8 com BOM e fallback Latin-1; delimitador inferido entre ponto e vírgula e vírgula. Seleção de logradouro, número, complemento, bairro, data_transacao, valor_avaliacao, area_construida e tipo_imovel. Não se selecionam nomes de partes, CPF, CNPJ, inscrição tributária ou identificador da guia. A natureza da operação fica vazia, pois esse leitor não a comprovou.
3. Datas convertidas a AAAA-MM-DD; números municipais convertidos de notação decimal brasileira quando aplicável. No gerador legado só entram registros com data reconhecida, valor de avaliação >= 10.000 reais, área construída >= 10 m² e chave de rua não vazia. Não há filtro Recife que comprove operação residencial, pagamento, fração transmitida ou natureza de mercado.
4. Chave legada da rua: decomposição Unicode/NFKD e remoção de acentos; maiúsculas; pontuação convertida em espaço; remoção de tipos de logradouro no início, títulos e preposições segundo o gerador legado. Essa chave pode juntar nomes de logradouro semelhantes e não inclui o bairro como identidade. O nome de exibição preserva o texto limpo, convertido a title case. Bairro também usa title case. A busca apresenta os bairros disponíveis para contextualização; isso não certifica identidade de rua/unidade.
5. Número: limpeza de espaços/apóstrofos externos, conversão de inteiro com sufixo .0 para inteiro textual e maiúsculas nos demais casos. Complemento limpo e truncado a 40 caracteres. Uso limpo, com remoção do sufixo a partir de parêntese, title case e limite de 30 caracteres. Avaliação arredondada ao real inteiro e área a uma casa decimal no export legado. Estes arredondamentos pertencem ao legado e não foram refeitos nesta preparação.
6. Deduplicação da tupla já normalizada e arredondada; pode fundir ocorrências indistinguíveis, não certifica negócios únicos. Janela histórica legada: 36 × 30,4 dias contados para trás da maior data do próprio export, em vez de meses de calendário até hoje. A borda calculada do índice é 04/10/2023; os registros efetivamente presentes vão de 01/01/2024 a 02/10/2026. Borda da janela não é data do primeiro registro.
7. Agrupamento por chave de rua; fragmentação FNV-1a de 32 bits sobre UTF-8 da chave, módulo 128. Dentro de cada rua, ordenação por número textual e data. Índice contém chave, nome, até três bairros e contagem; ruas ordenadas por quantidade decrescente. Não há estimativa ou mediana derivada adicionada a estes registros de Recife.

## Preparação desta versão

8. Projeção de privacidade aplicada ao conjunto legado: scanner de padrões de CPF/CNPJ/email em chaves e strings; nenhuma linha de Recife foi excluída nessa projeção. O scanner não certifica ausência de nomes livres nem impossibilidade de reidentificação. A projeção não acrescentou campos pessoais e não alterou os 128 fragmentos Recife.
9. Este pacote acrescenta atribuição, URI da licença, fonte e referência do pacote no índice; inclui licença, descrição, schema e hashes. A consolidação JSON reorganiza os mesmos dados em um único arquivo; ZIP reúne exatamente os fragmentos e documentos. Não se faz novo arredondamento, imputação, enriquecimento com terceiros, atualização automática ou integração com as novas planilhas Rio/Porto Alegre.
10. Na interface, Recife permanece legado sem comparação de preço. A seleção de rua determina o fragmento; número, se informado, filtra registros daquele número. A tabela é ordenada e paginada em blocos de 50. Esses filtros de tela não reduzem a cópia integral oferecida no pacote.

## Semântica e limitações

valor_avaliacao é avaliação fiscal municipal, não valor declarado de negócio e não valor de venda confirmado. Área construída municipal não equivale automaticamente à área útil ou privativa de anúncio. O dado de ITBI é amostra administrativa; filtros, subdeclaração, correções, atrasos e cobertura municipal limitam representatividade. Quantidade de linhas não equivale a transações ou imóveis únicos. Use como contexto documental, sem estimativa de revenda nesta cidade.