4.7 KiB
Referência territorial para segmentação dos cadastros
Continuação funcional: o selector comum, gravação/histórico e segmentação estão agora entregues na composição QA8069, com83 verificações. As indicações de implementação pendente abaixo descrevem o estado desta preparação inicial; não se aplicam às capacidades demonstradas nesse recorte. Correcção/publicação de versões, migração histórica, utilização real, revisão visual e implantação permanecem separadas.
Fonte fornecida pelo utilizador: cartografia_moz.xlsx, declarada como cartografia validada pelo INE. A análise é da versão exacta do ficheiro recebido, não uma verificação independente de validade/vigência nacional. SHA256: 70996d9a9133785a848de90bedb4bf685e24d8f823cd153c0adc43eac642a292. Não foi modificado nem reexportado.
Estrutura observada
Sheet1!A1:H20408:20.407 registos, sem fórmulas ou linhas ocultas. Campos ID, Provincia, Distrito, Posto_Administrativo, Localidade, Bairro_Urbano, Aldeia_Quarteirao, Designacao.
| Nível mais detalhado do registo na fonte | Registos |
|---|---|
| Província | 11 |
| Distrito | 148 |
| Posto administrativo | 437 |
| Localidade | 1.334 |
| Bairro urbano | 1.870 |
| Aldeia/quarteirão | 16.607 |
| Total | 20.407 |
Os componentes são códigos de texto, incluindo zeros iniciais e os valores alfanuméricos 7A/7B. O ID é único nesta folha; não se presume que seja um código INE estável entre versões. A identidade técnica preparada usa versão da fonte + ID original. Designações e códigos originais ficam intactos.
Foram conservados48 grupos com caminho de códigos repetido,39 dos quais com designações diferentes, e nove registos sem designação. Há8.610 registos sem uma linha correspondente ao pai imediato, abrangendo8.585 caminhos distintos, e377 com mais de um candidato a pai imediato. Isto descreve relações ausentes/ambíguas na folha recebida, não prova que um território administrativo seja inválido. Códigos como99 também permanecem intactos, sem significado inventado. Nomes repetidos entre territórios são normais e não servem de chave de associação.
Preparação implementada
App\Shared\Geography\Cartography prepara um catálogo versionado com todas as linhas, componentes, nível, designação, candidatos a pai e pendências. Não funde duplicados, não inventa designações e não executa conteúdo do Excel. A selecção técnica exige chave e versão exactas; recusa nomes soltos, versão antiga e entradas com pendências próprias ou de ascendência. Permite precisão apenas de província quando é essa a informação conhecida. A fonte extraída e o catálogo preparado ficam no directório privado de execução; não se incorporou a carga de dados no repositório nem no destino.
Prova técnica:16 verificações, incluindo reconciliação dos níveis, conservação integral, zeros, alfanuméricos, duplicados, designações ausentes, selecção explícita, recusa de ambiguidades/versões antigas e preparação determinística. Sem ligação a bases ou atribuição a cadastros.
Aplicação comum no SGF
Usar um único catálogo de referência para empresas/unidades, clientes, fornecedores e outras entidades. Cada localização deve guardar país, versão da fonte, chave do território, precisão realmente conhecida, finalidade do endereço e endereço livre complementar. Sede, endereço fiscal, estabelecimento e destino de entrega podem ser diferentes; a cartografia não os torna equivalentes.
O formulário deve seleccionar em cascata os níveis disponíveis e exibir pendências da fonte. A associação é uma decisão explícita do cadastro, com permissões e isolamento da entidade, autor/data e histórico. Uma actualização de cartografia cria outra versão e conferência de diferenças, preservando associações históricas. Segmentação e relatórios filtram pelos componentes territoriais da localização escolhida, sem confundir localização com direitos de acesso ou inventar precisão mais fina.
Ainda não entregue: tabela/API/selector comuns montados no SGF, ligação dos formulários de empresas/clientes/fornecedores, persistência/histórico das localizações e filtros dos relatórios. O que existe nesta passagem é leitura, preparação do catálogo, contrato de utilização e provas. Não foram atribuídas localizações aos registos existentes, nem alteradas as seis associações protegidas, a cache, acessos ou dados reais. As pendências da fonte exigem conferência antes da activação, sem impedir o desenvolvimento sintético das interfaces.