From 3f66201cbe1da2c06b0c4315dc2c8fcc175d4117 Mon Sep 17 00:00:00 2001
From: nala
Date: Fri, 20 Nov 2026 20:07:16 +0200
Subject: [PATCH] fix(demography): verify D01-D06 in isolated QA with INE
traceability
---
app/Http/Controllers/DemographyController.php | 6 +-
app/Services/DemographicEvidence.php | 4 +-
app/Services/SectorContentAnalysis.php | 6 +-
.../unification/traceability-and-manual.md | 6 +
.../apresentacao-contexto-qa-20261115.md | 31 ++++-
.../conferencia-celulas-ine-d03-20261120.json | 68 ++++++++++
.../prova-demografia-d01-d06-20261120.json | 88 +++++++++++++
.../js/components/demographic-evidence.tsx | 116 +++++++++--------
.../demographic-reading-summary.tsx | 4 +-
resources/js/lib/demographic-reading.ts | 12 +-
resources/js/pages/investment/demography.tsx | 24 +++-
tests/Feature/DemographyTest.php | 55 +++++++-
tests/Feature/SectorContentAnalysisTest.php | 2 +-
tests/frontend/demographic-reading.test.mjs | 121 ++++++++++++++++--
tools/demography-requirements-audit.php | 25 ++++
tools/demography-requirements-qa.php | 49 +++++++
tools/demography-requirements-sources.py | 42 ++++++
17 files changed, 570 insertions(+), 89 deletions(-)
create mode 100644 docs/investmoz/v2/auditoria-portal/conferencia-celulas-ine-d03-20261120.json
create mode 100644 docs/investmoz/v2/auditoria-portal/prova-demografia-d01-d06-20261120.json
create mode 100644 tools/demography-requirements-audit.php
create mode 100644 tools/demography-requirements-qa.php
create mode 100644 tools/demography-requirements-sources.py
diff --git a/app/Http/Controllers/DemographyController.php b/app/Http/Controllers/DemographyController.php
index 1a8da895..e67caa39 100644
--- a/app/Http/Controllers/DemographyController.php
+++ b/app/Http/Controllers/DemographyController.php
@@ -34,7 +34,11 @@ final class DemographyController extends Controller
}
$territories = $service->territories()->orderBy('name')->get(['id', 'name', 'parent_id', 'location_type']);
- return Inertia::render('investment/demography', ['sectorReadings' => app(SectorContentAnalysis::class)->forTerritories($data['territories'] ?? []), 'evidence' => $evidence, 'filters' => $data, 'territories' => $territories, 'sectors' => DemographicEvidence::sectors()]);
+ $sector = $data['sector'] ?? 'general';
+ $slug = ['commerce' => 'comercio-e-servicos', 'tourism' => 'turismo', 'industry' => 'industria', 'agriculture' => 'agronegocio', 'education' => 'educacao', 'health' => 'saude'][$sector] ?? null;
+ $entrySector = $slug ? DB::table('sectors')->where('slug', $slug)->where('is_active', true)->value('slug') : null;
+
+ return Inertia::render('investment/demography', ['entrySector' => $entrySector, 'sectorReadings' => app(SectorContentAnalysis::class)->forTerritories($data['territories'] ?? [], $sector), 'evidence' => $evidence, 'filters' => $data, 'territories' => $territories, 'sectors' => DemographicEvidence::sectors()]);
}
public function management(Request $request, DemographicImport $service): Response|RedirectResponse
diff --git a/app/Services/DemographicEvidence.php b/app/Services/DemographicEvidence.php
index 8f27fa8a..49bacfb0 100644
--- a/app/Services/DemographicEvidence.php
+++ b/app/Services/DemographicEvidence.php
@@ -31,7 +31,7 @@ final class DemographicEvidence
/** @return array */
public static function sectors(): array
{
- return ['commerce' => 'Comércio e serviços', 'industry' => 'Indústria', 'agriculture' => 'Agricultura e agro-indústria', 'education' => 'Educação', 'health' => 'Saúde', 'general' => 'Contexto geral'];
+ return ['commerce' => 'Comércio e serviços', 'tourism' => 'Turismo', 'industry' => 'Indústria', 'agriculture' => 'Agricultura e agro-indústria', 'education' => 'Educação', 'health' => 'Saúde', 'general' => 'Contexto geral'];
}
/** Broader administrative evidence stays labelled as context, never local data.
@@ -122,7 +122,7 @@ final class DemographicEvidence
foreach (array_slice($result['territories'], $i + 1) as $right) {
foreach ($left['series'] as $a) {
foreach ($right['series'] as $b) {
- foreach (array_unique([$start, $end]) as $year) {
+ foreach (range($start, $end) as $year) {
$isTotal = fn ($r) => $r['year'] === $year && $r['indicator'] === 'population' && $r['age_group'] === 'all' && $r['residence'] === 'all';
$x = array_values(array_filter($a['values'], $isTotal))[0] ?? null;
$y = array_values(array_filter($b['values'], $isTotal))[0] ?? null;
diff --git a/app/Services/SectorContentAnalysis.php b/app/Services/SectorContentAnalysis.php
index 40514e0c..50650753 100644
--- a/app/Services/SectorContentAnalysis.php
+++ b/app/Services/SectorContentAnalysis.php
@@ -198,7 +198,7 @@ final class SectorContentAnalysis
* @param list $ids
* @return list>
*/
- public function forTerritories(array $ids): array
+ public function forTerritories(array $ids, string $sector = 'general'): array
{
if (! app(LegacyContent::class)->available() || $ids === []) {
return [];
@@ -213,7 +213,9 @@ final class SectorContentAnalysis
}
$result = [];
foreach (config('legacy_content.articles', []) as $slug => $identity) {
- if ($identity['group'] !== 'turismo') {
+ // Provincial articles currently cover tourism only. Never substitute
+ // those ideas for another economic intention or infer missing offers.
+ if ($sector !== 'tourism' || $identity['group'] !== 'turismo') {
continue;
}
preg_match('/post-(\d+)-/', $identity['external_id'], $match);
diff --git a/docs/investmoz/unification/traceability-and-manual.md b/docs/investmoz/unification/traceability-and-manual.md
index 94188b14..1a95d708 100644
--- a/docs/investmoz/unification/traceability-and-manual.md
+++ b/docs/investmoz/unification/traceability-and-manual.md
@@ -10529,3 +10529,9 @@ C09/C10/B07 passam a INTEGRADO E VALIDADO no âmbito demonstrado. B02 aceite em
Por decisão expressa do proprietário, C09, C10 e B07 ficam **APROVADOS E ENCERRADOS EM QA**, com base no commit `15e15d0b` e nas provas E11 da matriz única. Preservadas as aprovações de B02, F16 e F31-A e a pendência documental F31-B. Mantidas 88 linhas e os limites da aceitação anterior.
A próxima frente de Demografia e Viabilidade Territorial corresponde às linhas **D01–D06** da [matriz existente](../v2/auditoria-portal/apresentacao-contexto-qa-20261115.md): Turismo, população inteira, células das fontes, referências técnicas, comparação anual e conservação do sector. A identificação prepara uma autorização separada; não inicia implementação nem altera os seus estados. Esta execução altera apenas documentação, sem testes, código funcional, instalação ou publicação.
+
+### 20/11/2026 — D01–D06: demografia demonstrada em QA
+
+Entrega delimitada em E12 da matriz de 88 requisitos, sobre `558c11ef` e o Mapa de erros Revisão 1. Turismo passa a constar da selecção; população recebe inteiros com agrupamento em todos os componentes comuns; comparações são organizadas por ano; referências técnicas ficam fora da apresentação do investidor. Comércio e Serviços e Funhalouro foram conservados na passagem autenticada para um dossier de ensaio e no rascunho persistido. Sem ideias documentadas compatíveis, a aplicação informa a ausência e permite uma ideia própria, sem sugerir Turismo por substituição.
+
+Conferidas as referências originais: `2026!B179` de Maputo Província é Moamba (distrito); `2026!B54` de ambos os exemplares de Inhambane é Funhalouro (distrito). Valores e hashes constam da prova D03, sem alterações aos originais. Auditoria de 486 observações exactas na QA: zero diferenças. Conferência real em computador e emulação móvel 390 × 844; 12 testes frontend, três HTTP/36 asserções, tipos, lint e compilação QA aprovados. As seis linhas ficam integradas e validadas em QA, sujeitas à aceitação do proprietário; as restantes 82 linhas e aprovações são preservadas, incluindo F31-B documental. Sem instalação, publicação, migrações operacionais ou alteração financeira. Ver E12 e o recibo `docs/investmoz/v2/auditoria-portal/prova-demografia-d01-d06-20261120.json` para limites e reprodução.
diff --git a/docs/investmoz/v2/auditoria-portal/apresentacao-contexto-qa-20261115.md b/docs/investmoz/v2/auditoria-portal/apresentacao-contexto-qa-20261115.md
index ef2d81ce..173941d1 100644
--- a/docs/investmoz/v2/auditoria-portal/apresentacao-contexto-qa-20261115.md
+++ b/docs/investmoz/v2/auditoria-portal/apresentacao-contexto-qa-20261115.md
@@ -1211,12 +1211,12 @@ Nomes de ficheiros na coluna de implementação referem-se a `resources/js/lib/`
| C09 | PN P0031; ME P0017–0019/P0078–0081/P0135/P0157 | Portal — continuidade | Conservar intenção, empresa, sector, localização, necessidade e valores em todo o percurso Hotel/Agronegócio, ida/volta | APROVADO E ENCERRADO EM QA | dossier-navigation-context.tsx; investment-step-help.tsx; serviços e formulários existentes | e299afda + E10/E11 | E11: login normal, oportunidade associada pela pesquisa e confirmação, instituição → dossier → preparação da empresa → comparação jurídica → simulador → guarda/regresso, recarga e recuperação em 1440/390 px. Sector, localização, oportunidade, referência financeira e valores recuperados. Entidade por definir preservada; provas anteriores de associação de entidade existente reutilizadas. Não equivale a todos os cenários empresariais. |
| C10 | ME P0079/P0081 | Portal — continuidade | Não escolher dossier antigo ou sector sem intervenção do investidor | APROVADO E ENCERRADO EM QA | dossier-navigation-context.tsx; navigation-focus.ts; provider e controlos existentes | e299afda + E10/E11 | E11: mudança explícita Hotel → Agricultura → Hotel pela interface, recarga e recuperação em 1440/390 px; Agricultura sem referências/resultados financeiros do Hotel. Corrigido cabeçalho transitório do dossier anterior, com regressão do estado pendente. Duas contas normais: dossiers/contexto 403 e rascunho 404 para o outro investidor; listagem sem dossiers alheios. |
| C11 | ME P0080/P0170 | Portal — continuidade | Pesquisa/associação de oportunidades e orientação por conhecimento territorial e financeiro disponível | NÃO DETERMINADO | páginas investor-path; SectorContentAnalysis.php; OpportunitySearchFilters | 6e7dfdab (antepassado de c34670ef) | Módulos presentes, mas não há evidência suficiente de todos os resultados pedidos no mesmo contexto. Conteúdo disponível não prova adequação nem procura. |
-| D01 | ME P0031 | Portal — demografia | Turismo no selector de sectores da demografia | NÃO IMPLEMENTADO | app/Services/DemographicEvidence.php:33–35 | base c34670ef | Lista actual só commerce, industry, agriculture, education, health e general; Tourism não consta. Evidência directa de código, sem necessidade de teste repetido. |
-| D02 | ME P0024/P0032 | Portal — demografia | População inteira em todos os locais, incluindo tabela por idade/residência | NÃO IMPLEMENTADO | demographic-evidence.tsx:265; demographic-reading.ts:39 | fb076c17 (última alteração do componente na QA) | Síntese formata inteiros, mas tabela por dimensão imprime v.original_value. Correcção transversal incompleta; não considerar teste da síntese como cobertura de todos os valores. |
-| D03 | ME P0033 | Portal — demografia | Confirmar células 2026!B179 e 2026!B54 nas fontes originais | NÃO DETERMINADO | DemographicEvidence.php; dados/fontes demográficas | — | Não foram conferidas as duas células e os dois exemplares nesta auditoria; não declarar erro de importação nem confirmação da origem sem evidência específica. |
-| D04 | ME P0020/P0033–0034 | Portal — demografia | Ocultar células, nomes de ficheiro e SHA256 da vista do investidor | NÃO IMPLEMENTADO | demographic-evidence.tsx:195–199/229 | fb076c17 | Detalhe acessível ao investidor ainda contém file_name, SHA256, Referência e sheet/cell. Estar num detalhe fechado não cumpre ocultação pedida. |
-| D05 | ME P0035 | Portal — demografia | Comparação legível por ano, números inteiros e advertência única | IMPLEMENTADO MAS NÃO VALIDADO | demographic-reading-summary.tsx; demographic-evidence.tsx; demographic-reading.ts | fb076c17 (incorporação selectiva) | Há resumo e tendências legíveis; divergências ainda imprimem valores originais. E7 contém prova de síntese; não prova todos os exemplos Bilene/Funhalouro 2026/2028 com advertência única. |
-| D06 | ME P0036 | Portal — demografia | Conservar Comércio e Serviços e apresentar ideias desse sector | IMPLEMENTADO MAS NÃO VALIDADO | DemographyController.php; sector-entry.tsx; SectorContentAnalysis.php | 6e7dfdab | Implementação sectorial é antepassada de c34670ef; não é código exclusivamente noutro ramo. Falta prova específica actual dos dois exemplos do documento. |
+| D01 | ME P0031 | Portal — demografia | Turismo no selector de sectores da demografia | INTEGRADO E VALIDADO | DemographicEvidence.php; DemographyController.php; investment/demography.tsx | E12; prova-demografia-d01-d06-20261120.json | Turismo aceite no selector real; contexto populacional explicitamente separado da indisponibilidade de estatisticas turisticas distritais. |
+| D02 | ME P0024/P0032 | Portal — demografia | População inteira em todos os locais, incluindo tabela por idade/residência | INTEGRADO E VALIDADO | demographic-reading.ts; demographic-evidence.tsx; demographic-reading-summary.tsx | E12; prova-demografia-d01-d06-20261120.json | Inteiros com agrupamento em totais, residencia, idade, series e diferencas. 486 observacoes exactas conservadas, sem arredondamento persistido. |
+| D03 | ME P0033 | Portal — demografia | Confirmar células 2026!B179 e 2026!B54 nas fontes originais | INTEGRADO E VALIDADO | conferencia-celulas-ine-d03-20261120.json; tools/demography-requirements-sources.py | E12; prova-demografia-d01-d06-20261120.json | Originais conferidos: Maputo Provincia 2026!B179 = Moamba (distrito); Inhambane 2026!B54 = Funhalouro (distrito). Referencias validas; nenhum total provincial inferido. |
+| D04 | ME P0020/P0033–0034 | Portal — demografia | Ocultar células, nomes de ficheiro e SHA256 da vista do investidor | INTEGRADO E VALIDADO | demographic-evidence.tsx; demographic-reading-summary.tsx; demography-requirements-audit.php | E12; prova-demografia-d01-d06-20261120.json | Detalhes do investidor sem ficheiro, SHA256, celulas ou texto tecnico da edicao; rastreabilidade administrativa e valores exactos conservados. |
+| D05 | ME P0035 | Portal — demografia | Comparação legível por ano, números inteiros e advertência única | INTEGRADO E VALIDADO | DemographicEvidence.php; demographic-evidence.tsx; demographic-reading.test.mjs | E12; prova-demografia-d01-d06-20261120.json | Bilene/Funhalouro apresentados por 2026/2027/2028, com agrupamento de milhares e explicacao contextual sem repeticao em cada par. |
+| D06 | ME P0036 | Portal — demografia | Conservar Comércio e Serviços e apresentar ideias desse sector | INTEGRADO E VALIDADO | DemographyController.php; SectorContentAnalysis.php; investment/demography.tsx; DemographyTest.php | E12; prova-demografia-d01-d06-20261120.json | Comercio e servicos mantido na passagem para preparacao e no rascunho persistido de investidor normal. Sem sugestoes de Turismo; indisponibilidade de ideias compativeis explicitada, sem ofertas inventadas. |
| B01 | ME P0040–0047 | Portal — instituições financeiras | Coerência categoria/tipo/registo/necessidade; distinguir banco, seguradora, fundo e programa | INTEGRADO E VALIDADO | FundingCriteriaCoherenceTest.php; funding/index.tsx; serviços de pesquisa financeira | base bae996e1;04d8db6c | E0/E7: testes e provas V01–V03 anteriores para critérios, incompatibilidade e vazio válido; sem equivalências inventadas. |
| B02 | ME P0048 | Portal — instituições financeiras | Pesquisar apenas após localização e necessidade mínimas | INTEGRADO E VALIDADO | resources/js/pages/funding/index.tsx; funding-journey-coherence.test.mjs | e299afda + delta local experience-20261120 | E10: botão desactivado enquanto faltar localização ou necessidade; submissão por Enter também impedida; instrução acessível junto do botão. Cinco testes da página real, incluindo combinações incompletas e critérios suficientes; prévia com transporte simulado em 1440/390 px. Consulta pública inicial e URLs directos preservados; não é nova validação de API nem prova de gravação privada B07. |
| B03 | ME P0174–0177/P0196 | Portal — instituições financeiras | Pesquisa local por presença física; cobertura é consulta distinta | IMPLEMENTADO MAS NÃO VALIDADO | resources/js/pages/funding/index.tsx:71/321–338 | 04d8db6c;base bae996e1 | Modos physical/coverage existem, mas valor inicial é coverage. URL do anexo pede coverage/include_unknown; não comprova selecção local. Conversão da intenção para presença física em todas as entradas não validada. |
@@ -1435,3 +1435,22 @@ Pendências de Demografia e Viabilidade Territorial para autorização separada,
- **D06 — ME P0036:** conservar Comércio e Serviços e apresentar ideias desse sector.
Esta identificação não é uma nova avaliação funcional. A reconciliação com entregas demográficas de outras revisões deve preceder a futura intervenção autorizada; não se presume ausência ou regressão pela lista documental. Execução limitada à matriz e ao manual existentes: sem código funcional alterado, testes repetidos, consultas/escritas de dados, instalação ou publicação. A implementação de Demografia e Viabilidade Territorial não foi iniciada.
+
+### E12 — 20/11/2026 — D01–D06: Demografia e Viabilidade Territorial em QA
+
+Execução autorizada exclusivamente para D01–D06, sobre `558c11ef`, com a Revisão 1 do Mapa de erros e a matriz única de 88 requisitos. As seis linhas passam a **INTEGRADO E VALIDADO**, limitadas à QA demonstrada; aguardam a aceitação do proprietário. Preservadas sem alteração as restantes 82 linhas, incluindo C09/C10/B07, B02, F16, F31-A e a pendência documental F31-B. A conclusão desta frente não declara implementados os 88 requisitos.
+
+- **D01:** Turismo disponível no selector real, sem classificar população como estatística turística nem inferir procura turística distrital. A indisponibilidade desses dados sectoriais é explícita.
+- **D02:** formatação comum de população com inteiros e separadores de milhares, incluindo totais, urbana/rural, faixas etárias, evolução anual e diferenças. O arredondamento é apenas visual. Auditoria somente de leitura comparou 486 observações exactas com os recortes INE: zero divergências.
+- **D03:** conferidos os cabeçalhos e valores originais: `Maputo Provincia.xlsx`, `2026!B179`, corresponde a **Moamba, distrito**, valor `127905.47047248163`; `Inhambane.xlsx`, `2026!B54`, corresponde a **Funhalouro, distrito**, valor `46656.505898723823`. Também conferido o exemplar inicial distinto de Inhambane, fora de `Provincias`, com o mesmo valor e território em B54. As referências não demonstram erro de leitura; o rótulo provincial não transforma o valor distrital num total provincial. Não houve correcção arbitrária de correspondências.
+- **D04:** a consulta do investidor, incluindo detalhes abertos, não apresenta ficheiros, hashes, células ou texto técnico de edição. Os dados administrativos, originais, precisão, referências e hashes foram preservados. Esta mudança de apresentação não elimina os metadados internos usados pela aplicação.
+- **D05:** comparação Bilene/Funhalouro organizada por todos os anos do intervalo, incluindo 2027 entre 2026 e 2028. Valores e diferenças legíveis; o sinal corresponde à primeira localização menos a segunda. A explicação técnica não se repete por linha; limitações contextuais conservadas uma vez por consulta.
+- **D06:** artigos provinciais exclusivamente turísticos só são sugeridos quando Turismo foi escolhido. Comércio e Serviços permanece no link e na preparação normal do investidor; dossier sintético `817e61d1-ab45-4f8d-8bf6-f51e33b30503` recebeu Comércio e Serviços e Funhalouro. O rascunho persistido foi conferido com o próprio actor, sem alterar outros dossiers. Não há ideias documentadas compatíveis no recorte QA: o portal informa essa ausência e permite preparar uma ideia própria; não foram criadas oportunidades fictícias.
+
+Ambiente: `http://127.0.0.3:18720`, base `continuity_20261120_test`, PostgreSQL `55441`, esquema existente. A candidata estava sem observações demográficas; foram preparados 486 registos de consulta com valores exactos de três originais INE, associados a identidades territoriais de ensaio. **Os valores são oficiais; as identidades territoriais, conta e dossier são sintéticos**, sem códigos oficiais inferidos. Foram acrescentadas referências sectoriais apenas ao catálogo QA necessário ao ensaio. Não houve instalação, publicação, migração operacional, alteração de fonte original ou de funcionalidades financeiras.
+
+Conferência na aplicação real em Edge: computador (janela 1594 × 1031) e telemóvel emulado (viewport 390 × 844), com capturas inspeccionadas na sessão de execução. Inclui comparação, detalhes abertos, tabela por idade/residência com deslocamento horizontal no móvel, Turismo com aviso de dados indisponíveis e passagem normal autenticada para a preparação em Comércio e Serviços. O conector de navegador estava indisponível; foi usado controlo nativo. O endpoint de idiomas devolveu 503 nesta QA; não impediu as consultas demográficas. O ensaio de login exigiu corrigir o atributo de verificação do email na nova conta sintética, omitido pelo preenchimento protegido do fixture; não foram alterados controlos de autenticação.
+
+Verificação dirigida: **12 testes frontend e três testes HTTP/36 asserções aprovados**, tipos, lint dirigido, formatação PHP e compilação QA aprovados. A asserção antiga que exigia decimais e referências técnicas na vista do investidor foi substituída pelo comportamento aprovado em D02/D04; a preservação exacta é verificada separadamente. O primeiro teste de comparação usava uma referência territorial sintética sem o prefixo público documentado; foi corrigido o fixture, mantendo os controlos territoriais. Não se repetiram testes financeiros ou do percurso C09/C10/B07.
+
+Provas versionadas: [recibo individual D01–D06](prova-demografia-d01-d06-20261120.json) e [conferência das células INE](conferencia-celulas-ine-d03-20261120.json). Recortes e logs locais: `outputs/demography-d01-d06-20261120/`. Reprodução pelos utilitários `demography-requirements-sources.py`, `demography-requirements-qa.php` e `demography-requirements-audit.php`, com guarda explícita da QA. Limites de dados sectoriais mantidos como indisponibilidade, sem estimativas fictícias; não se declara cobertura estatística turística para todos os distritos.
diff --git a/docs/investmoz/v2/auditoria-portal/conferencia-celulas-ine-d03-20261120.json b/docs/investmoz/v2/auditoria-portal/conferencia-celulas-ine-d03-20261120.json
new file mode 100644
index 00000000..3d4bd09c
--- /dev/null
+++ b/docs/investmoz/v2/auditoria-portal/conferencia-celulas-ine-d03-20261120.json
@@ -0,0 +1,68 @@
+[
+ {
+ "file": "Inhambane.xlsx",
+ "sha256": "d45e5dea78f556c25d772374a42c54c6a422d7df9a9491e98d25c1cc9744b367",
+ "source_unchanged": true,
+ "state": "verified_from_original_labels",
+ "observation": {
+ "province": "Inhambane",
+ "territory": "Funhalouro",
+ "level": "district",
+ "year": 2026,
+ "indicator": "population",
+ "sex": "all",
+ "residence": "all",
+ "age_group": "all",
+ "unit": "pessoas",
+ "data_kind": "projected",
+ "original_value": "46656.505898723823",
+ "numeric_value": "46656.505898723823",
+ "sheet": "2026",
+ "cell": "B54"
+ }
+ },
+ {
+ "file": "Maputo Provincia.xlsx",
+ "sha256": "1bf2921ef43d18817878a6d05e487ce5b107c14aa149ad17bedae6f1c652430e",
+ "source_unchanged": true,
+ "state": "verified_from_original_labels",
+ "observation": {
+ "province": "Maputo Província",
+ "territory": "Moamba",
+ "level": "district",
+ "year": 2026,
+ "indicator": "population",
+ "sex": "all",
+ "residence": "all",
+ "age_group": "all",
+ "unit": "pessoas",
+ "data_kind": "projected",
+ "original_value": "127905.47047248163",
+ "numeric_value": "127905.47047248163",
+ "sheet": "2026",
+ "cell": "B179"
+ }
+ },
+ {
+ "file": "../Inhambane.xlsx (exemplar inicial distinto)",
+ "sha256": "ed11bcfa1dda314cde13d4f481ab19dcc80f23f507c76c17fc220ea93b440d58",
+ "source_unchanged": true,
+ "state": "verified_from_original_labels",
+ "observation": {
+ "province": "Inhambane",
+ "territory": "Funhalouro",
+ "level": "district",
+ "year": 2026,
+ "indicator": "population",
+ "sex": "all",
+ "residence": "all",
+ "age_group": "all",
+ "unit": "pessoas",
+ "data_kind": "projected",
+ "original_value": "46656.505898723823",
+ "numeric_value": "46656.505898723823",
+ "sheet": "2026",
+ "cell": "B54"
+ }
+ }
+]
diff --git a/docs/investmoz/v2/auditoria-portal/prova-demografia-d01-d06-20261120.json b/docs/investmoz/v2/auditoria-portal/prova-demografia-d01-d06-20261120.json
new file mode 100644
index 00000000..68038cb9
--- /dev/null
+++ b/docs/investmoz/v2/auditoria-portal/prova-demografia-d01-d06-20261120.json
@@ -0,0 +1,88 @@
+{
+ "date": "2026-11-20",
+ "baseline": "558c11ef",
+ "environment": {
+ "url": "http://127.0.0.3:18720",
+ "database": "continuity_20261120_test",
+ "port": 55441,
+ "investors": "synthetic normal accounts, normal login",
+ "territorial_ids": "QA identities, not official territorial codes",
+ "demographic_values": "486 exact observations read from three INE originals, not synthetic estimates",
+ "source_writes": false,
+ "operational_writes": false,
+ "installation_publication_migrations": false
+ },
+ "verification": {
+ "frontend": {
+ "passed": 12,
+ "failed": 0
+ },
+ "http": {
+ "passed": 3,
+ "assertions": 36
+ },
+ "types": "passed",
+ "focused_lint": "passed",
+ "pint": "passed after formatting",
+ "qa_build": "passed",
+ "exact_observations_compared": 486,
+ "data_mismatches": 0,
+ "browser": "real application in Microsoft Edge via native UI; screenshots inspected in execution session",
+ "desktop": "1594x1031 browser window, responsive desktop layout",
+ "mobile": "390x844 emulated viewport, not a physical phone",
+ "preexisting_environment_issue": "translation languages endpoint returns 503 in isolated QA; no demography request failure observed",
+ "qa_build_exit_code": 0,
+ "qa_build_warning": "Preexisting optional fontaine font fallback package absent; no dependency installed. Build completed successfully."
+ },
+ "requirements": {
+ "D01": {
+ "state": "integrated_and_verified_in_qa",
+ "evidence": "Real selector accepted Turismo, retained both districts and 2026-2028; explicit notice distinguishes population context from unavailable tourism demand statistics."
+ },
+ "D02": {
+ "state": "integrated_and_verified_in_qa",
+ "evidence": "Totals, residence, age bands, summary, annual series and differences use integer display and grouping. General consultation in Funhalouro showed population by age/residence in the real table. Exact original strings and internal values unchanged."
+ },
+ "D03": {
+ "state": "verified_in_originals",
+ "evidence": "2026!B179 in Maputo Provincia workbook is Moamba district, not province total; 2026!B54 in Inhambane is Funhalouro district. Verified numeric strings, labels and source hashes in companion cell report. No incorrect imported mapping demonstrated in this QA; no original or official mapping rewritten."
+ },
+ "D04": {
+ "state": "integrated_and_verified_in_qa",
+ "evidence": "Opened investor details in desktop and mobile: no sheet/cell column, file name, SHA256 or technical edition prose. Raw import provenance, precision and cell references remain in administrative data; exact audit passed. Concurrent divergence warning retained in plain language without internal identifiers."
+ },
+ "D05": {
+ "state": "integrated_and_verified_in_qa",
+ "evidence": "Bilene/Funhalouro grouped under 2026, 2027, 2028. 2026 displays 157983 and 46657 with grouping; exact difference rounds to 111326 (sign follows first minus second). Technical repeated comparison explanation removed; contextual limitations shown once per consultation."
+ },
+ "D06": {
+ "state": "integrated_and_verified_in_qa",
+ "evidence": "Commerce consultations do not offer tourism-only provincial ideas. No compatible documented ideas available in this QA; absence explicitly stated. Normal investor continued to a new isolated dossier; real preparation controls retained Comercio e servicos and Funhalouro. Read-only audit confirmed persisted context draft sector:9 and territory:5d3ec348-191e-4c48-9dad-6aef8928355f, needs_review=false.",
+ "qa_case": "817e61d1-ab45-4f8d-8bf6-f51e33b30503"
+ }
+ },
+ "available_data_limits": [
+ "No tourism-sector statistical series or commerce opportunities were invented.",
+ "Territorial observations remain specific to the district named in the original workbook; province context does not convert a district observation into a province total.",
+ "Synthetic QA sector catalogue entries support the normal investor entry; this execution does not install or populate an operational catalogue."
+ ],
+ "reproduce": [
+ "python tools/demography-requirements-sources.py --output outputs/demography-d01-d06-20261120",
+ "php tools/demography-requirements-qa.php (guarded existing QA schema only)",
+ "php tools/demography-requirements-audit.php (read only)",
+ "node --test tests/frontend/demographic-reading.test.mjs",
+ "DB_DATABASE=continuity_20261120_test php vendor/phpunit/phpunit/phpunit --bootstrap tools/continuity-qa-bootstrap.php --filter 'test_public_comparison_preserves_decimals_versions_and_missing_years|test_tourism_is_explicit_and_comparisons_include_intermediate_years|test_commerce_and_territory_reach_the_normal_investor_entry' tests/Feature/DemographyTest.php"
+ ],
+ "evidence_directory": "outputs/demography-d01-d06-20261120",
+ "preserved": [
+ "88 matrix rows",
+ "C09",
+ "C10",
+ "B07",
+ "B02",
+ "F16",
+ "F31-A",
+ "F31-B documentary pending",
+ "original DOCX and Revision 1"
+ ]
+}
diff --git a/resources/js/components/demographic-evidence.tsx b/resources/js/components/demographic-evidence.tsx
index b9aab369..3082722b 100644
--- a/resources/js/components/demographic-evidence.tsx
+++ b/resources/js/components/demographic-evidence.tsx
@@ -1,3 +1,4 @@
+import { populationValueLabel } from '@/lib/demographic-reading';
import EvidenceDetails from './evidence-details';
import DemographicReadingSummary from './demographic-reading-summary';
@@ -191,30 +192,13 @@ export default function DemographicEvidence({
antes de comparar ou utilizar os valores.
)}
-
-
- {s.version} · {s.file_name}
-
-
- SHA256: {s.sha256}
-
- {Object.keys(s.issue_counts).length > 0 && (
-
- Advertências da série
-
- {JSON.stringify(
- s.issue_counts,
- null,
- 2,
- )}
-
-
- )}
+
- Valores originais por ano e dimensão
- — versões apresentadas separadamente
+ Valores de apresentação por ano e
+ dimensão — versões apresentadas
+ separadamente
@@ -226,7 +210,6 @@ export default function DemographicEvidence({
'Valor',
'Unidade',
'Tipo',
- 'Referência',
].map((h) => (
|
{h}
@@ -262,7 +245,14 @@ export default function DemographicEvidence({
}[v.residence]
}
- | {v.original_value} |
+
+ {v.indicator ===
+ 'population'
+ ? populationValueLabel(
+ v.value,
+ )
+ : v.original_value}
+ |
{v.unit ===
'unspecified'
@@ -275,9 +265,6 @@ export default function DemographicEvidence({
? 'Projecção'
: 'Não especificado'}
|
-
- {v.sheet}!{v.cell}
- |
))}
@@ -293,38 +280,55 @@ export default function DemographicEvidence({
Diferenças entre localizações
- {evidence.comparisons.map((c) => (
-
- {c.year}: {c.left} ({c.left_value}) / {c.right} (
- {c.right_value}). Diferença:{' '}
- {c.difference ?? 'não comparável'}. {c.explanation}
-
- ))}
+ {Array.from(
+ new Set(evidence.comparisons.map((c) => c.year)),
+ )
+ .sort((a, b) => a - b)
+ .map((year) => (
+
+ {year}
+ {evidence.comparisons
+ .filter((c) => c.year === year)
+ .map((c) => (
+
+ {c.left} (
+ {populationValueLabel(c.left_value)}
+ ) / {c.right} (
+ {populationValueLabel(
+ c.right_value,
+ )}
+ ). Diferença:{' '}
+ {c.difference === null
+ ? 'não comparável: âmbitos ou metadados distintos'
+ : populationValueLabel(
+ c.difference,
+ )}
+ {c.difference !== null &&
+ ' pessoas'}
+ .
+
+ ))}
+
+ ))}
)}
- {evidence.differences.length > 0 && (
-
-
- Reconciliação entre exemplares:{' '}
- {evidence.differences.length} dimensões comuns
-
-
- {evidence.differences.map((d) => (
- -
- {d.dimension}:{' '}
- {d.state === 'matching_values'
- ? 'valores coincidentes; conservar ambas as fontes'
- : 'valores divergentes'}{' '}
- —{' '}
- {d.values
- .map((v) => `${v.value} (${v.data_kind})`)
- .join(' / ')}
-
- ))}
-
-
+ {evidence.differences.some(
+ (d) => d.state === 'divergent_values',
+ ) && (
+
+ Há valores divergentes entre séries para a mesma localização
+ e período. As séries são apresentadas separadamente; não
+ foram somadas nem escolhidas como substitutas umas das
+ outras.
+
)}
{evidence.limitations.map((l) => (
diff --git a/resources/js/components/demographic-reading-summary.tsx b/resources/js/components/demographic-reading-summary.tsx
index d09d3173..601a66ea 100644
--- a/resources/js/components/demographic-reading-summary.tsx
+++ b/resources/js/components/demographic-reading-summary.tsx
@@ -31,8 +31,8 @@ export default function DemographicReadingSummary({
{current.kind === 'projected'
? 'Projecção'
: 'Tipo de dado não especificado'}
- . Valores de apresentação arredondados; os originais permanecem
- disponíveis abaixo.
+ . Valores de apresentação arredondados; os originais são
+ preservados na administração.
{[
diff --git a/resources/js/lib/demographic-reading.ts b/resources/js/lib/demographic-reading.ts
index cd7389e0..4aca5d34 100644
--- a/resources/js/lib/demographic-reading.ts
+++ b/resources/js/lib/demographic-reading.ts
@@ -39,9 +39,15 @@ function one(rows: Row[], age: string, residence = 'all'): Row | undefined {
export const populationLabel = (n: number | null) =>
n === null
? 'Sem dados'
- : new Intl.NumberFormat('pt-MZ', { maximumFractionDigits: 0 }).format(
- n,
- );
+ : new Intl.NumberFormat('pt-MZ', {
+ maximumFractionDigits: 0,
+ useGrouping: 'always',
+ }).format(n);
+// Formatting only: never write rounded values back to evidence or calculations.
+export const populationValueLabel = (value: string) =>
+ /^-?\d+(\.\d+)?$/.test(value) && Number.isFinite(Number(value))
+ ? populationLabel(Number(value))
+ : 'Sem dados';
export const percentageLabel = (n: number | null) =>
n === null
? 'Sem dados'
diff --git a/resources/js/pages/investment/demography.tsx b/resources/js/pages/investment/demography.tsx
index 035850cf..719eb9ca 100644
--- a/resources/js/pages/investment/demography.tsx
+++ b/resources/js/pages/investment/demography.tsx
@@ -24,6 +24,7 @@ function DemographySelection({
territories,
sectors,
sectorReadings = [],
+ entrySector,
}: {
evidence: DemographicAnalysis;
filters: {
@@ -44,6 +45,7 @@ function DemographySelection({
href: string;
analysis: SectorAnalysis;
}[];
+ entrySector?: string | null;
}) {
const [selected, setSelected] = useState(filters.territories ?? []);
const [province, setProvince] = useState('');
@@ -211,6 +213,13 @@ function DemographySelection({
+ {filters.sector === 'tourism' && (
+
+ Os dados de população constituem contexto territorial. Não
+ há nesta consulta estatísticas sectoriais de Turismo que
+ permitam avaliar a procura turística por distrito.
+
+ )}
{evidence.territories.length > 0 && (
@@ -227,7 +236,11 @@ function DemographySelection({
className="block py-2 underline"
href={
'/investimentos/iniciar?source=' +
- encodeURIComponent('territory:' + t.id)
+ encodeURIComponent('territory:' + t.id) +
+ (entrySector
+ ? '§or=' +
+ encodeURIComponent(entrySector)
+ : '')
}
>
Preparar ideia em {t.name}
@@ -235,6 +248,15 @@ function DemographySelection({
))}
)}
+ {filters.sector &&
+ filters.sector !== 'general' &&
+ sectorReadings.length === 0 && (
+
+ Não há ideias documentadas compatíveis com o sector
+ seleccionado nesta consulta. Pode preparar a sua própria
+ ideia, sem substituir o sector escolhido.
+
+ )}
{sectorReadings.map((reading) => (
{reading.title}
diff --git a/tests/Feature/DemographyTest.php b/tests/Feature/DemographyTest.php
index ad0c1b8d..92033bb6 100644
--- a/tests/Feature/DemographyTest.php
+++ b/tests/Feature/DemographyTest.php
@@ -2,16 +2,20 @@
namespace Tests\Feature;
+use App\Models\Sector;
use App\Models\User;
use App\Services\DemographicEvidence;
use App\Services\DemographicImport;
use App\Services\InvestmentPreparationWorkspace;
+use App\Services\Malware\MalwareScanner;
+use App\Services\SectorContentAnalysis;
use Illuminate\Database\QueryException;
use Illuminate\Foundation\Testing\DatabaseTransactions;
use Illuminate\Support\Facades\Crypt;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Facades\Storage;
use Illuminate\Support\Str;
+use Symfony\Component\HttpKernel\Exception\HttpException;
use Tests\TestCase;
final class DemographyTest extends TestCase
@@ -77,6 +81,35 @@ final class DemographyTest extends TestCase
$this->assertSame([], app(DemographicEvidence::class)->analyse([$this->district], 2026, 2027)['territories']);
}
+ public function test_tourism_is_explicit_and_comparisons_include_intermediate_years(): void
+ {
+ $this->assertSame('Turismo', DemographicEvidence::sectors()['tourism']);
+ $response = $this->getJson('/api/v1/investment/demography?'.http_build_query(['territories' => [$this->district], 'start_year' => 2026, 'end_year' => 2028, 'sector' => 'tourism']))->assertOk();
+ $response->assertJsonPath('sector', 'tourism')->assertJsonPath('territories.0.series.0.values.0.original_value', '100.125');
+ $other = (array) DB::table('geo_locations')->where('id', $this->district)->first();
+ $other['id'] = (string) Str::uuid();
+ $other['code'] = $other['id'];
+ $other['external_id'] = '964a187ad32ea553b9e112cd159caa90b900050c42b7329594a75bcd798a96ff:QA:'.$other['id'];
+ DB::table('geo_locations')->insert($other);
+ foreach (DB::table('demographic_observations')->where('geo_location_id', $this->district)->get() as $row) {
+ $row = (array) $row;
+ unset($row['id']);
+ DB::table('demographic_observations')->insert([...$row, 'geo_location_id' => $other['id']]);
+ }
+ $analysis = app(DemographicEvidence::class)->analyse([$this->district, $other['id']], 2026, 2028, 'commerce');
+ $this->assertSame([2026, 2027], array_column($analysis['comparisons'], 'year'));
+ $this->assertSame([], app(SectorContentAnalysis::class)->forTerritories([$this->district], 'commerce'));
+ }
+
+ public function test_commerce_and_territory_reach_the_normal_investor_entry(): void
+ {
+ $sector = Sector::firstOrCreate(['slug' => 'comercio-e-servicos'], ['name' => 'Comércio e serviços', 'is_active' => true]);
+ $this->get('/localizacoes/demografia?'.http_build_query(['territories' => [$this->district], 'sector' => 'commerce']))
+ ->assertOk()->assertInertia(fn ($page) => $page->component('investment/demography')->where('entrySector', $sector->slug)->where('sectorReadings', []));
+ $this->actingAs(User::factory()->create())->get('/investimentos/iniciar?'.http_build_query(['source' => 'territory:'.$this->district, 'sector' => $sector->slug]))
+ ->assertOk()->assertInertia(fn ($page) => $page->component('investor-path/context-start')->where('entryQuery.sector_id', (string) $sector->id)->where('source.id', $this->district)->etc());
+ }
+
public function test_new_editions_remain_separate_and_divergence_is_reported(): void
{
$other = $this->batch('approved');
@@ -202,8 +235,10 @@ final class DemographyTest extends TestCase
{
Storage::fake('local');
$disk = Storage::disk('local');
- $original = 'SYNTHETIC prepared original'; $sha = hash('sha256', $original);
- $directory = 'prepared/'.$sha; $disk->makeDirectory($directory);
+ $original = 'SYNTHETIC prepared original';
+ $sha = hash('sha256', $original);
+ $directory = 'prepared/'.$sha;
+ $disk->makeDirectory($directory);
$disk->put('synthetic.xlsx', $original);
$row = ['province' => 'SYNTHETIC province', 'territory' => 'SYNTHETIC province', 'level' => 'province',
'year' => 2026, 'indicator' => 'population', 'sex' => 'all', 'residence' => 'all', 'age_group' => 'all', 'unit' => 'pessoas',
@@ -214,10 +249,11 @@ final class DemographyTest extends TestCase
$preview = json_encode($report, JSON_THROW_ON_ERROR);
$receipt = ['sha256' => $sha, 'baseline_year' => null, 'parser_sha256' => hash_file('sha256', base_path('tools/demography_workbook.py')),
'preview_sha256' => hash('sha256', $preview), 'records_sha256' => hash('sha256', $records), 'record_count' => 1];
- $disk->put($directory.'/preview.json', $preview); $disk->put($directory.'/records.ndjson', $records);
+ $disk->put($directory.'/preview.json', $preview);
+ $disk->put($directory.'/records.ndjson', $records);
$disk->put($directory.'/preparation.json', json_encode($receipt, JSON_THROW_ON_ERROR));
config(['demography.prepared_directory' => $disk->path('prepared'), 'demography.python' => '/missing-python-must-not-run']);
- $this->mock(\App\Services\Malware\MalwareScanner::class)->shouldReceive('scan')->once()->andReturn([
+ $this->mock(MalwareScanner::class)->shouldReceive('scan')->once()->andReturn([
'result' => 'clean', 'engine' => 'synthetic', 'engine_version' => 'test']);
$service = app(DemographicImport::class);
$this->assertTrue($service->preparedSourcesReady(['synthetic.xlsx' => ['sha256' => $sha, 'records' => 1]]));
@@ -227,9 +263,14 @@ final class DemographyTest extends TestCase
$this->assertSame('100.125', DB::table('demographic_observations')->where('import_id', $result['id'])->value('numeric_value'));
$this->assertSame('imported', DB::table('demographic_imports')->where('id', $result['id'])->value('status'));
$disk->put($directory.'/records.ndjson', 'TAMPERED');
- try { $service->preparedSource($sha, null); $this->fail('Changed prepared records must be refused.'); }
- catch (\Symfony\Component\HttpKernel\Exception\HttpException $error) { $this->assertSame(409, $error->getStatusCode()); }
- $receipt['parser_sha256'] = str_repeat('0', 64); $disk->put($directory.'/preparation.json', json_encode($receipt, JSON_THROW_ON_ERROR));
+ try {
+ $service->preparedSource($sha, null);
+ $this->fail('Changed prepared records must be refused.');
+ } catch (HttpException $error) {
+ $this->assertSame(409, $error->getStatusCode());
+ }
+ $receipt['parser_sha256'] = str_repeat('0', 64);
+ $disk->put($directory.'/preparation.json', json_encode($receipt, JSON_THROW_ON_ERROR));
$this->assertFalse($service->preparedSourcesReady(['synthetic.xlsx' => ['sha256' => $sha, 'records' => 1]]));
}
diff --git a/tests/Feature/SectorContentAnalysisTest.php b/tests/Feature/SectorContentAnalysisTest.php
index 67e23453..284349f5 100644
--- a/tests/Feature/SectorContentAnalysisTest.php
+++ b/tests/Feature/SectorContentAnalysisTest.php
@@ -131,7 +131,7 @@ final class SectorContentAnalysisTest extends TestCase
'location_type' => $type, 'source_system' => 'cartografia-workbook', 'data_classification' => 'public',
'external_id' => '964a187ad32ea553b9e112cd159caa90b900050c42b7329594a75bcd798a96ff:QA:'.$id]);
}
- $readings = app(SectorContentAnalysis::class)->forTerritories([$district]);
+ $readings = app(SectorContentAnalysis::class)->forTerritories([$district], 'tourism');
$this->assertCount(1, $readings);
$this->assertSame($article['href'], $readings[0]['href']);
$this->assertSame('Maputo Província', $readings[0]['analysis']['region']);
diff --git a/tests/frontend/demographic-reading.test.mjs b/tests/frontend/demographic-reading.test.mjs
index e372aaf1..ed30ea20 100644
--- a/tests/frontend/demographic-reading.test.mjs
+++ b/tests/frontend/demographic-reading.test.mjs
@@ -24,10 +24,26 @@ function load(path, overrides = {}) {
compileFunction(code, ['require', 'module', 'exports'])(
(n) => {
if (n in overrides) return overrides[n];
- const relative = n.startsWith('@/') ? n.slice(2) : n.startsWith('.') ? pathModule.posix.join(pathModule.posix.dirname(path), n) : null;
+ const relative = n.startsWith('@/')
+ ? n.slice(2)
+ : n.startsWith('.')
+ ? pathModule.posix.join(pathModule.posix.dirname(path), n)
+ : null;
if (relative) {
- for (const candidate of [relative, relative + '.tsx', relative + '.ts']) {
- if (fs.existsSync(new URL('../../resources/js/' + candidate, import.meta.url))) return load(candidate, overrides);
+ for (const candidate of [
+ relative,
+ relative + '.tsx',
+ relative + '.ts',
+ ]) {
+ if (
+ fs.existsSync(
+ new URL(
+ '../../resources/js/' + candidate,
+ import.meta.url,
+ ),
+ )
+ )
+ return load(candidate, overrides);
}
}
return require(n);
@@ -169,16 +185,23 @@ test('growth uses explicit comparable endpoints and does not fill missing interm
s.values[1].data_kind = 'observed';
assert.equal(helpers.demographicReading(s, 2026, 2028).growth, null);
});
-test('technical source and full decimals remain available in closed details after a readable summary', () => {
+test('public dimensions round population and hide technical references without modifying evidence', () => {
+ const original = base(),
+ before = JSON.stringify(original);
const html = renderToStaticMarkup(
- React.createElement(Component, { evidence: evidence([base()]) }),
+ React.createElement(Component, { evidence: evidence([original]) }),
);
assert.ok(
html.indexOf('Retrato da população') <
- html.indexOf('Valores originais por ano'),
+ html.indexOf('Valores de apresentação por ano'),
);
- assert.match(html, /1000.1234567890123/);
- assert.match(html, /Valores por dimensão, fonte e advertências/);
+ assert.doesNotMatch(
+ html,
+ /1000.1234567890123|SHA256|source.xlsx|Referência/,
+ );
+ assert.match(html, /1\s000/);
+ assert.match(html, /Valores por ano e dimensão/);
+ assert.equal(JSON.stringify(original), before);
assert.doesNotMatch(html, /]*\bopen\b/);
assert.match(html, /um único ano/);
assert.match(html, /capacidade instalada/);
@@ -233,3 +256,85 @@ test('Barue 2026 provided evidence produces the readable proportions without cha
assert.equal(Number(r.age15to64Share.toFixed(1)), 51.3);
assert.equal(JSON.stringify(s), before);
});
+
+test('annual comparisons format all populations and do not repeat technical explanations', () => {
+ const data = evidence([base()]);
+ data.comparisons = [2026, 2027, 2028].map((year) => ({
+ year,
+ left: 'Bilene',
+ right: 'Funhalouro',
+ left_value: '157982.9857834139',
+ right_value: '46656.505898723823',
+ difference: '111326.479884690077',
+ left_import: 'a',
+ right_import: 'b',
+ explanation: 'INTERNAL REPEATED EXPLANATION',
+ }));
+ const html = renderToStaticMarkup(
+ React.createElement(Component, { evidence: data }),
+ );
+ assert.match(html, /157\s983/);
+ assert.match(html, /46\s657/);
+ assert.match(html, /111\s326/);
+ assert.match(html, /]*>2027<\/h3>/);
+ assert.doesNotMatch(html, /111326\.479|INTERNAL REPEATED/);
+ assert.equal(
+ (
+ html.match(/Os indicadores demográficos não demonstram procura/g) ||
+ []
+ ).length,
+ 1,
+ );
+});
+
+test('concurrent divergence remains visible without exposing reconciliation identifiers', () => {
+ const data = evidence([base()]);
+ data.differences = [
+ {
+ territory_id: 'INTERNAL-TERRITORY',
+ dimension: '2026|population|all|all|pessoas',
+ state: 'divergent_values',
+ values: [
+ {
+ import_id: 'INTERNAL-IMPORT',
+ value: '1000.1234567890123',
+ data_kind: 'projected',
+ },
+ ],
+ },
+ ];
+ const html = renderToStaticMarkup(
+ React.createElement(Component, { evidence: data }),
+ );
+ assert.match(html, /Há valores divergentes entre séries/);
+ assert.doesNotMatch(
+ html,
+ /INTERNAL-TERRITORY|INTERNAL-IMPORT|2026\|population|1000\.1234567890123/,
+ );
+});
+
+test('commerce preparation carries the explicit sector and territory', () => {
+ const Page = load('pages/investment/demography.tsx', {
+ '@inertiajs/react': { router: {} },
+ './shared': {
+ Frame: ({ children }) =>
+ React.createElement('main', null, children),
+ button: '',
+ },
+ }).default;
+ const html = renderToStaticMarkup(
+ React.createElement(Page, {
+ evidence: evidence([base()]),
+ filters: { territories: ['district-one'], sector: 'commerce' },
+ territories: [],
+ sectors: { commerce: 'Comércio e serviços', tourism: 'Turismo' },
+ entrySector: 'comercio-e-servicos',
+ }),
+ );
+ assert.match(
+ html,
+ /source=territory%3Adistrict-one§or=comercio-e-servicos/,
+ );
+ assert.doesNotMatch(html, /Hotelaria e alojamento|sector=turismo/);
+ assert.match(html, /Não há ideias documentadas compatíveis/);
+});
diff --git a/tools/demography-requirements-audit.php b/tools/demography-requirements-audit.php
new file mode 100644
index 00000000..c047495a
--- /dev/null
+++ b/tools/demography-requirements-audit.php
@@ -0,0 +1,25 @@
+make(Kernel::class)->bootstrap();
+
+use Illuminate\Contracts\Console\Kernel;
+use Illuminate\Support\Facades\DB;
+
+$identity = DB::selectOne('select current_database() as name, inet_server_port() as port');
+throw_unless($identity->name === 'continuity_20261120_test' && (int) $identity->port === 55441, RuntimeException::class, 'Isolated QA only');
+$slices = json_decode(file_get_contents(dirname(__DIR__).'/outputs/demography-d01-d06-20261120/source-slices.json'), true, 512, JSON_THROW_ON_ERROR);
+$checked = 0;
+foreach ($slices as $slice) {
+ $batch = DB::table('demographic_imports')->where('sha256', $slice['sha256'])->first();
+ throw_unless($batch && $batch->file_name === $slice['file'], RuntimeException::class, 'Original provenance missing');
+ foreach ($slice['records'] as $row) {
+ $stored = DB::table('demographic_observations as o')->join('geo_locations as g', 'g.id', '=', 'o.geo_location_id')
+ ->where('o.import_id', $batch->id)->where('o.sheet', $row['sheet'])->where('o.cell', $row['cell'])->first(['o.*', 'g.name']);
+ throw_unless($stored && $stored->name === $row['territory'] && $stored->numeric_value === $row['numeric_value'] && $stored->original_value === $row['original_value'], RuntimeException::class, 'Observation mismatch');
+ $checked++;
+ }
+}
+echo json_encode(['database' => $identity->name, 'port' => $identity->port, 'exact_observations_checked' => $checked, 'mismatches' => 0, 'writes' => false, 'traceability_preserved' => true], JSON_PRETTY_PRINT).PHP_EOL;
diff --git a/tools/demography-requirements-qa.php b/tools/demography-requirements-qa.php
new file mode 100644
index 00000000..eb448e44
--- /dev/null
+++ b/tools/demography-requirements-qa.php
@@ -0,0 +1,49 @@
+make(Kernel::class)->bootstrap();
+
+use Illuminate\Contracts\Console\Kernel;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Str;
+
+$identity = DB::selectOne('select current_database() as name, inet_server_port() as port');
+throw_unless($identity->name === 'continuity_20261120_test' && (int) $identity->port === 55441, RuntimeException::class, 'Isolated QA only');
+$slices = json_decode(file_get_contents(dirname(__DIR__).'/outputs/demography-d01-d06-20261120/source-slices.json'), true, 512, JSON_THROW_ON_ERROR);
+$result = DB::transaction(function () use ($slices) {
+ $actor = DB::table('users')->first();
+ throw_unless($actor, RuntimeException::class, 'Existing synthetic investor required');
+ foreach (['comercio-e-servicos' => 'Comércio e serviços', 'turismo' => 'Turismo'] as $slug => $name) {
+ DB::table('sectors')->insertOrIgnore(['slug' => $slug, 'name' => $name, 'is_active' => true, 'published_at' => now(), 'created_at' => now(), 'updated_at' => now()]);
+ }
+ $country = DB::table('geo_locations')->where('location_type', 'country')->value('id');
+ $result = [];
+ foreach ($slices as $slice) {
+ $provinceName = $slice['records'][0]['province'];
+ $territoryName = $slice['records'][0]['territory'];
+ foreach ([['province', $provinceName], ['district', $territoryName]] as [$level, $name]) {
+ $id = (string) Str::uuid();
+ $external = '964a187ad32ea553b9e112cd159caa90b900050c42b7329594a75bcd798a96ff:D01-D06:'.$name;
+ DB::table('geo_locations')->insertOrIgnore(['id' => $id, 'parent_id' => $level === 'province' ? $country : $province, 'name' => $name, 'code' => 'QA-D01-'.$name, 'location_type' => $level, 'source_system' => 'cartografia-workbook', 'external_id' => $external, 'data_classification' => 'public']);
+ $id = DB::table('geo_locations')->where('external_id', $external)->value('id');
+ if ($level === 'province') {
+ $province = $id;
+ }
+ }
+ $batch = DB::table('demographic_imports')->where('sha256', $slice['sha256'])->value('id');
+ if (! $batch) {
+ $batch = (string) Str::uuid();
+ DB::table('demographic_imports')->insert(['id' => $batch, 'sha256' => $slice['sha256'], 'file_name' => $slice['file'], 'source' => 'Instituto Nacional de Estatística (INE)', 'publication_version' => 'Exemplar INE fornecido pela Tempo; edição não indicada; SHA256 identifica a versão', 'status' => 'approved', 'report' => json_encode(['issue_counts' => [], 'qa_slice' => true]), 'preview_sha256' => hash('sha256', json_encode($slice)), 'prepared_by' => $actor->id, 'created_at' => now(), 'updated_at' => now()]);
+ foreach ($slice['records'] as $row) {
+ unset($row['province'], $row['territory'], $row['level']);
+ DB::table('demographic_observations')->insert(['import_id' => $batch, 'geo_location_id' => $id, 'validation_status' => 'valid', ...$row]);
+ }
+ }
+ $result[$territoryName] = ['id' => $id, 'province' => $province, 'batch' => $batch, 'records' => count($slice['records'])];
+ }
+
+ return $result;
+});
+echo json_encode($result, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE).PHP_EOL;
diff --git a/tools/demography-requirements-sources.py b/tools/demography-requirements-sources.py
new file mode 100644
index 00000000..3d8e5771
--- /dev/null
+++ b/tools/demography-requirements-sources.py
@@ -0,0 +1,42 @@
+"""Read-only D01-D06 QA slices and cell verification; never modifies INE workbooks."""
+import argparse
+import hashlib
+import json
+from pathlib import Path
+from demography_workbook import parse
+
+cli = argparse.ArgumentParser()
+cli.add_argument('directory', type=Path)
+cli.add_argument('--output', type=Path, required=True)
+args = cli.parse_args()
+args.output.mkdir(parents=True, exist_ok=True)
+slices, references = [], []
+for name, territory, cell in [('Gaza.xlsx', 'Bilene', None),
+ ('Inhambane.xlsx', 'Funhalouro', 'B54'),
+ ('Maputo Provincia.xlsx', 'Moamba', 'B179')]:
+ original = args.directory / name
+ before = hashlib.sha256(original.read_bytes()).hexdigest()
+ parsed = parse(original)
+ rows = [r for r in parsed['records'] if r['territory'] == territory
+ and 2026 <= r['year'] <= 2028 and r['sex'] == 'all']
+ unchanged = before == hashlib.sha256(original.read_bytes()).hexdigest()
+ if not unchanged:
+ raise RuntimeError('Source changed during verification')
+ slices.append({'file': name, 'sha256': before, 'source_unchanged': unchanged, 'records': rows})
+ if cell:
+ matched = [r for r in rows if r['sheet'] == '2026' and r['cell'] == cell]
+ if len(matched) != 1:
+ raise RuntimeError('Reference not uniquely verified')
+ references.append({'file': name, 'sha256': before, 'source_unchanged': unchanged,
+ 'state': 'verified_from_original_labels', 'observation': matched[0]})
+initial = args.directory.parent / 'Inhambane.xlsx'
+if initial.is_file():
+ before = hashlib.sha256(initial.read_bytes()).hexdigest()
+ matched = [r for r in parse(initial)['records'] if r['sheet'] == '2026' and r['cell'] == 'B54']
+ if len(matched) != 1 or before != hashlib.sha256(initial.read_bytes()).hexdigest():
+ raise RuntimeError('Initial Inhambane exemplar not verified')
+ references.append({'file': '../Inhambane.xlsx (exemplar inicial distinto)', 'sha256': before,
+ 'source_unchanged': True, 'state': 'verified_from_original_labels', 'observation': matched[0]})
+(args.output / 'source-slices.json').write_text(json.dumps(slices, ensure_ascii=False, indent=2), encoding='utf-8')
+(args.output / 'source-references.json').write_text(json.dumps(references, ensure_ascii=False, indent=2), encoding='utf-8')
+print(json.dumps({'files': len(slices), 'verified_cells': len(references), 'originals_unchanged': True}))