fix: reconcile accepted source classifications for protected investor aggregates

docs/investmoz/unification/traceability-and-manual.md

@@ -10303,3 +10303,20 @@ Recibo: `outputs/aggregate-supply-20261115/qa-verified.json`; capturas em `outpu
 
 
 **Bloqueante confirmado no destino:** a leitura técnica autenticada encontrou apenas cinco códigos gerais publicados (`agronegocio`, `economia-azul`, `infraestruturas`, `mercado-financeiro`, `turismo`) e nenhuma divisão CAE numérica publicada. Os quatro exemplares internos têm o contrato reconhecido e existem grupos documentados não singulares, mas a classificação não é compatível com o adaptador. As dez provas usam referências publicadas sintéticas em QA; não demonstram disponibilidade da classificação no destino. O recorte original CAE A/01/011/0112/01120 está preparado em lote existente e não cobre os cinco sectores. Não se publicou esse lote nem se presumiram correspondências CAE → sectores. O servidor devolve 422 com explicação compreensível quando falta a classificação, sem gravar um resultado falso ou alterar o dossier. O teste adicional passou sem desactivar a guarda de imutabilidade das referências. Instalação suspensa, homologação/main em d3067050, sem reserva, migração, alteração de configuração ou escrita de dados. É necessário reconciliar as referências originais CAE e as correspondências sectoriais no catálogo existente e obter a respectiva validação/publicação editorial, antes de habilitar o delta. A autorização de consulta agregada não publica automaticamente outro lote de referências (AGENTS.md: «Nunca publicar automaticamente um lote»). Isto não exige nem autoriza acesso a empresas individuais. Não existe neste momento um pacote apto para instalação útil nos cinco sectores.
+
+
+## Reconciliação real e remoção do bloqueio de classificação — 15/11/2026
+
+A instrução seguinte autorizou continuar `c8957ecb` e confirmou que divisões CAE numéricas publicadas não são um requisito universal. O bloqueio descrito acima era uma escolha de implementação, agora corrigida. O adaptador privado reutiliza o contrato existente `EconomicReferenceCatalog`, o exemplar CAE eBAU já aceite (SHA256 `83b4f120…506`) e a hierarquia SELF_ID/PARENT_ID: 1 339 nós com grupo amplo identificado, 88 grupos. Não cria outro cadastro, não insere/publica referências gerais e não altera os cinco códigos gerais publicados. Código demonstrado ou designação exacta são utilizáveis; diferenças de maiúsculas com acentos são tratadas de forma determinística, incluindo PostgreSQL com locale C.
+
+Não se inventam equivalências CAE → doze sectores do portal. O sector, intenção, território e orçamento mantêm-se no dossier; o utilizador escolhe a classificação da comparação. Correspondências publicadas já utilizáveis continuam disponíveis. «HOTÉIS COM RESTAURANTE» conserva o grupo amplo Alojamento; Restaurantes conserva Restauração e similares. O resultado explicita o agrupamento amplo, sem o apresentar como contagem exclusiva do subtipo seleccionado. O enquadramento amplo de alojamento do exemplar turístico, aceite anteriormente, é reutilizado apenas para essa fonte e sem inventar subtipo. Os seus registos sem identidade resolvida continuam excluídos dos limiares de divulgação. Não se tornam empresas únicas por terem uma actividade identificada.
+
+A reconciliação das observações reais separou correspondências por código, enquadramento documental amplo e ausência de classificação. Não encontrou pares concretos código/designação contraditórios na fotografia aceite; o teste de conflitos garante a sua exclusão quando existam. A ausência de classificação e as situações ambíguas não são convertidas em equivalências nem em ausência de actividade. A edição normativa do exemplar e os tipos específicos do recorte turístico continuam indeterminados. Não surgiu uma decisão editorial bloqueante para as correspondências demonstradas; não se publicou automaticamente nenhum lote.
+
+Prova real: leitura técnica autenticada SSH/PostgreSQL em transacção READ ONLY, usando o compilador de classificação da candidata, geografia pública canónica e as mesmas protecções de identidade, duplicados, grupo mínimo e intervalos. Retornaram-se apenas oito células agregadas de exemplo: em Cidade de Nampula, 25–29 identidades documentais em Alojamento e 290–294 em Restauração. São intervalos documentais históricos, não empresas únicas certificadas, clientes, procura ou cobertura nacional integral. Não se devolveram linhas, nomes, contactos, documentos ou identificadores individuais. Esta leitura técnica não é apresentada como login de um investidor operacional; as permissões e a interface de proprietário foram verificadas separadamente em QA, com contas sintéticas.
+
+Delta verificado: 3 testes HTTP/49 asserções e 1 teste/12 asserções para o enquadramento turístico; três testes frontend afectados, PHPStan, tipos, lint, Pint e compilação normal/Wayfinder aprovados. Quatro novas execuções autenticadas (hotéis/restaurantes × computador/390 px) demonstraram escolha por designação, gravação, recuperação, manutenção do sector e apenas intervalos protegidos. Emulação móvel, sem alegar telefone físico. Reutilizadas as provas aceites de `c8957ecb`, sem outra ronda geral. Recibos `outputs/aggregate-supply-20261115/source-reconciliation-qa.json`, `source-classification-reconciliation.json` e `real-protected-aggregates.json`.
+
+Utilização: no próprio dossier aberto, «Actividades existentes na localização» → pesquisar a actividade pelos primeiros três caracteres ou código → «Consultar e guardar análise agregada». A análise, classificação e histórico são privados e recuperáveis. A escolha não substitui a actividade do investimento. Sem correspondência previamente demonstrada, pede-se a escolha da classificação em vez de presumir equivalência entre taxonomias. Grupos pequenos, conflitos e falta de identidade/classificação conservam a explicação de cobertura insuficiente, nunca «não existem empresas».
+
+Estado desta passagem: candidato verificado, instalação já autorizada e ainda não executada neste registo. Prosseguir pelo executor Git com capacidade, backup/restauro frescos, pin da revisão, activação apenas de `INVESTOR_PROTECTED_SUPPLY_ENABLED` e conferência do delta. Sem migrações, novos papéis, exposição individual ou produção. Ofertas, dashboard, correcção financeira e d3067050 preservados. Tradução permanece separada.

docs/investmoz/v2/auditoria-portal/apresentacao-contexto-qa-20261115.md

@@ -342,3 +342,20 @@ Recibo: `outputs/aggregate-supply-20261115/qa-verified.json`; capturas em `outpu
 
 
 **Bloqueante confirmado no destino:** a leitura técnica autenticada encontrou apenas cinco códigos gerais publicados (`agronegocio`, `economia-azul`, `infraestruturas`, `mercado-financeiro`, `turismo`) e nenhuma divisão CAE numérica publicada. Os quatro exemplares internos têm o contrato reconhecido e existem grupos documentados não singulares, mas a classificação não é compatível com o adaptador. As dez provas usam referências publicadas sintéticas em QA; não demonstram disponibilidade da classificação no destino. O recorte original CAE A/01/011/0112/01120 está preparado em lote existente e não cobre os cinco sectores. Não se publicou esse lote nem se presumiram correspondências CAE → sectores. O servidor devolve 422 com explicação compreensível quando falta a classificação, sem gravar um resultado falso ou alterar o dossier. O teste adicional passou sem desactivar a guarda de imutabilidade das referências. Instalação suspensa, homologação/main em d3067050, sem reserva, migração, alteração de configuração ou escrita de dados. É necessário reconciliar as referências originais CAE e as correspondências sectoriais no catálogo existente e obter a respectiva validação/publicação editorial, antes de habilitar o delta. A autorização de consulta agregada não publica automaticamente outro lote de referências (AGENTS.md: «Nunca publicar automaticamente um lote»). Isto não exige nem autoriza acesso a empresas individuais. Não existe neste momento um pacote apto para instalação útil nos cinco sectores.
+
+
+## Reconciliação real e remoção do bloqueio de classificação — 15/11/2026
+
+A instrução seguinte autorizou continuar `c8957ecb` e confirmou que divisões CAE numéricas publicadas não são um requisito universal. O bloqueio descrito acima era uma escolha de implementação, agora corrigida. O adaptador privado reutiliza o contrato existente `EconomicReferenceCatalog`, o exemplar CAE eBAU já aceite (SHA256 `83b4f120…506`) e a hierarquia SELF_ID/PARENT_ID: 1 339 nós com grupo amplo identificado, 88 grupos. Não cria outro cadastro, não insere/publica referências gerais e não altera os cinco códigos gerais publicados. Código demonstrado ou designação exacta são utilizáveis; diferenças de maiúsculas com acentos são tratadas de forma determinística, incluindo PostgreSQL com locale C.
+
+Não se inventam equivalências CAE → doze sectores do portal. O sector, intenção, território e orçamento mantêm-se no dossier; o utilizador escolhe a classificação da comparação. Correspondências publicadas já utilizáveis continuam disponíveis. «HOTÉIS COM RESTAURANTE» conserva o grupo amplo Alojamento; Restaurantes conserva Restauração e similares. O resultado explicita o agrupamento amplo, sem o apresentar como contagem exclusiva do subtipo seleccionado. O enquadramento amplo de alojamento do exemplar turístico, aceite anteriormente, é reutilizado apenas para essa fonte e sem inventar subtipo. Os seus registos sem identidade resolvida continuam excluídos dos limiares de divulgação. Não se tornam empresas únicas por terem uma actividade identificada.
+
+A reconciliação das observações reais separou correspondências por código, enquadramento documental amplo e ausência de classificação. Não encontrou pares concretos código/designação contraditórios na fotografia aceite; o teste de conflitos garante a sua exclusão quando existam. A ausência de classificação e as situações ambíguas não são convertidas em equivalências nem em ausência de actividade. A edição normativa do exemplar e os tipos específicos do recorte turístico continuam indeterminados. Não surgiu uma decisão editorial bloqueante para as correspondências demonstradas; não se publicou automaticamente nenhum lote.
+
+Prova real: leitura técnica autenticada SSH/PostgreSQL em transacção READ ONLY, usando o compilador de classificação da candidata, geografia pública canónica e as mesmas protecções de identidade, duplicados, grupo mínimo e intervalos. Retornaram-se apenas oito células agregadas de exemplo: em Cidade de Nampula, 25–29 identidades documentais em Alojamento e 290–294 em Restauração. São intervalos documentais históricos, não empresas únicas certificadas, clientes, procura ou cobertura nacional integral. Não se devolveram linhas, nomes, contactos, documentos ou identificadores individuais. Esta leitura técnica não é apresentada como login de um investidor operacional; as permissões e a interface de proprietário foram verificadas separadamente em QA, com contas sintéticas.
+
+Delta verificado: 3 testes HTTP/49 asserções e 1 teste/12 asserções para o enquadramento turístico; três testes frontend afectados, PHPStan, tipos, lint, Pint e compilação normal/Wayfinder aprovados. Quatro novas execuções autenticadas (hotéis/restaurantes × computador/390 px) demonstraram escolha por designação, gravação, recuperação, manutenção do sector e apenas intervalos protegidos. Emulação móvel, sem alegar telefone físico. Reutilizadas as provas aceites de `c8957ecb`, sem outra ronda geral. Recibos `outputs/aggregate-supply-20261115/source-reconciliation-qa.json`, `source-classification-reconciliation.json` e `real-protected-aggregates.json`.
+
+Utilização: no próprio dossier aberto, «Actividades existentes na localização» → pesquisar a actividade pelos primeiros três caracteres ou código → «Consultar e guardar análise agregada». A análise, classificação e histórico são privados e recuperáveis. A escolha não substitui a actividade do investimento. Sem correspondência previamente demonstrada, pede-se a escolha da classificação em vez de presumir equivalência entre taxonomias. Grupos pequenos, conflitos e falta de identidade/classificação conservam a explicação de cobertura insuficiente, nunca «não existem empresas».
+
+Estado desta passagem: candidato verificado, instalação já autorizada e ainda não executada neste registo. Prosseguir pelo executor Git com capacidade, backup/restauro frescos, pin da revisão, activação apenas de `INVESTOR_PROTECTED_SUPPLY_ENABLED` e conferência do delta. Sem migrações, novos papéis, exposição individual ou produção. Ofertas, dashboard, correcção financeira e d3067050 preservados. Tradução permanece separada.