42 lines
7.7 KiB
Markdown
42 lines
7.7 KiB
Markdown
# 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.
|