compras/docs/divisao-administrativa-sgc.md

Divisão administrativa comum do SGC

Fonte fornecida pelo proprietário: \\mac\Home\Documents\TEMPO\SEGI\SEGI NOVO\cartografia_moz.xlsx, folha Sheet1. O proprietário identifica o documento como oficial e validado pelo INE. O ficheiro não fornece uma edição confirmada nesta análise. Não se presume que representa a divisão vigente em qualquer data futura.

SHA-256 da fonte: 70996d9a9133785a848de90bedb4bf685e24d8f823cd153c0adc43eac642a292. Original apenas lido, sem alterações. Derivação em resources/data/geography/cartografia-moz.json, com todas as oito colunas originais, número da linha, códigos como texto (incluindo zeros iniciais), designação original e diagnóstico. O ID da linha identifica a referência nesta edição; não é tratado como código nacional universal entre edições.

Qualidade e selecção

São 20.407 registos: 11 registos no nível Provincia, 148 distritos, 437 postos administrativos, 1.334 localidades, 1.870 bairros urbanos e 16.607 aldeias/quarteirões, classificados pela última coluna de código preenchida. São contagens do ficheiro, não uma confirmação independente da divisão administrativa actual.

Há 48 grupos de percursos de códigos repetidos, envolvendo 96 linhas. Existem 9 designações vazias, 8.610 linhas sem pai imediato explícito e 377 com pai imediato ambíguo. Estes números referem-se a linhas e podem sobrepor-se. A análise inicial de 8.585 referia-se a percursos distintos sem pai, não ao número de linhas.

Os diagnósticos não corrigem a fonte por inferência. A relação pai/filho só é estabelecida quando existe exactamente uma linha com o prefixo imediato. São bloqueados para selecção os registos inconsistentes e os descendentes de ancestrais inconsistentes (1.688 linhas com esse diagnóstico). Resultado: 9.678 seleccionáveis e 10.729 pendentes de revisão. Nenhuma linha é apagada, fundida ou fabricada. É permitido seleccionar apenas a província ou outro nível superior confirmado, sem exigir todos os níveis.

O preparador scripts/prepare-geography-catalogue.py lê XLSX com a biblioteca padrão, valida cabeçalhos e IDs e rejeita substituir um catálogo por uma fonte com hash diferente. Uma nova edição deve usar outro destino, ser conferida e preservar a edição anterior. Não reutilizar IDs de outra edição nem remapear associações por semelhança de nomes. A configuração fixa os hashes da fonte e do catálogo derivado; divergência impede a leitura funcional.

Integração por cadastro

• Fornecedores: campo opcional na criação/edição, descrição na ficha e filtro territorial no directório, incluindo níveis inferiores confirmados. A referência contém apenas país MZ, hash da edição e ID da fonte. Designações e ascendentes são lidos do catálogo comum. Morada, NUIT e demais regras originais mantêm-se. Omitir o campo conserva a referência existente; retirar explicitamente remove só a referência. Endereços estrangeiros ou não classificados podem continuar sem referência. Isto não altera a validação fiscal nativa nem representa um novo regime de cadastro internacional.
• Empresa: sede na parametrização, só por administrador actual e fora de manutenção. Compara a referência anterior para rejeitar sobrescrita concorrente; apenas actualiza a localização, sem mudar alçadas, perfis, configurações ou aprovações.
• Outros módulos: serviço e selector comuns preparados para reutilização. Clientes não possuem um cadastro autónomo implementado no SGC inspeccionado; não foi criado um módulo de clientes/facturação ou feita integração SGF por inferência. G4 acrescenta escolha explícita da disponibilidade principal do candidato no catálogo, com referência e fotografia das designações na versão do perfil; texto antigo e locais adicionais continuam preservados sem correspondência automática. Ver docs/geografia-candidatos-sgc.md.

Alterações de localização de fornecedores usam o mesmo comando, bloqueio de empresa, versão da ficha e auditoria existentes. Tal como qualquer alteração material da ficha, retiram a validação actual e exigem nova revisão independente por Finanças. Uma submissão sem alterações não incrementa a versão nem cria ruído de auditoria. A instalação, por si só, não altera nenhum fornecedor ou aprovação.

API autenticada /api/divisao-administrativa: filhos confirmados de um registo, 50 por página. Sem dados pessoais nem endereços de outras empresas. Filtro de fornecedores mantém o âmbito nativo de empresa e valida edição/ID; não inclui resultados sem classificação por adivinhação.

Instalação e limites

Instalado e activado no piloto8005 com autorização específica do proprietário. Aplicada apenas a migração 2026_11_03_000004_add_administrative_geography_references, com duas colunas JSON anuláveis e vazias, sem preencher referências ou converter endereços. A cópia consistente foi restaurada e as114tabelas conferidas;111tabelas protegidas e colunas anteriores de empresas/fornecedores permaneceram intactas. O restauro descartável foi removido. Provas: administrative-geography-installation-authorization.json, administrative-geography-installation.json e administrative-geography-activation.json.

config/geography.php lê SGC_GEOGRAPHY_ENABLED, desligado por defeito. Apenas a configuração privada do piloto recebeu o valor true; restantes opções preservadas, incluindo MFA desligado. O circuito recusa operações se faltar qualquer coluna, mesmo com a opção ligada. Históricos classificados permanecem legíveis se posteriormente se desligar a selecção. ConsultasHTTP confirmaram campos disponíveis e cadastros ainda sem classificação; não se submeteram decisões ou alterações de ficha.

Não executar migração geral: há outras migrações e autorizações pendentes. A proposta original docs/proposta-instalacao-geografia.md fica preservada pelo hash; o seu estado pendente é histórico e a autorização/aplicação efectiva estão nas provas separadas. Não foram autorizadas nem executadas alterações de MFA, políticas, contas, alçadas, decisões, ordens ou SGF. A revisão humana das inconsistências e a identificação da edição continuam pendentes. Sem certificação oficial independente, mapas, coordenadas ou revisão visual completa nesta entrega.

G2: revisão administrativa das inconsistências

A parametrização liga à consulta /administracao/divisao-administrativa, limitada aos administradores actuais pelos mesmos controlos da parametrização. Mostra50linhas por página, pela ordem original, e permite filtrar por diagnóstico e pesquisar designação ou ID exacto. São visíveis linha, ID, nome e códigos originais, além dos diagnósticos. Registos de empresas e fornecedores não integram este relatório, comum à fonte geográfica.

A exportação CSV inclui todos os resultados filtrados, independentemente da página. Mantém os códigos como texto no ficheiro; ao abrir no Excel, importar essas colunas como texto para conservar zeros. Campos que poderiam ser interpretados como fórmulas recebem uma aspa inicial apenas no CSV. O JSON original e a fonte não são alterados. Consulta e exportação usam o mesmo conjunto filtrado, respostas privadas sem cache e não têm comandos de correcção, classificação ou aprovação. É necessária fonte esclarecida para uma futura edição; nunca resolver códigos repetidos escolhendo a primeira linha.

Validação G2 em docs/proofs/administrative-geography-review.json: testes de serviço/HTTP, paginação, exportação completa, permissões actuais, neutralização de fórmulas e bases descartáveis. Não equivale a revisão humana concluída das10.729pendências nem revisão visual completa.