Files
Investidor-V2/docs/investmoz/v2/ativacao-rastreabilidade-territorial.md
T

77 lines
12 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# V2 — rastreabilidade territorial e aplicação autenticada
Entrega preparada em 9 de outubro de 2026 (Africa/Johannesburg). Complementa [a qualidade territorial por registo](qualidade-territorial.md) e [a reconciliação documental dos 46 registos](reconciliacao-fontes-territoriais.md).
## Aceitação e âmbito
A regra permanente de `AGENTS.md` mantém a aceitação das fontes oficiais/governamentais identificadas. Não foi repetida a verificação da proveniência. As 11 referências oficiais/legais, os 14 estados cadastrais `validated` e a aceitação existente do pacote INE foram reutilizados. Recuperar uma referência não desvalida os dados; os seis estados legais `pending` preexistentes não foram alterados por este incremento.
O plano abrange 46 registos: seis oportunidades, 16 projetos, oito clusters e 16 zonas. Contém **112 entradas de rastreabilidade**: proveniência do registo, implantação cadastrada, locais dos projetos, impacto, associações territoriais das zonas e membros dos clusters, preservando os papéis originais. Cada entrada identifica fonte, informação fundamentada, estado existente, pendência específica e efeito na interface. Citações já existentes nas 28 associações de projetos foram reutilizadas, sem nova validação.
Foram recuperadas citações explícitas para as **13 associações cluster–projeto existentes**. A proposta preenche apenas `source_reference` e `evidence_reference` em `cluster_projects`, incrementando a versão. Não muda `validation_status`, `association_type`, autoria original ou classificação de divulgação. O dossier de programação citado documenta essa relação existente; não recebe a classificação de documento oficial por esta operação.
As seis oportunidades têm território principal, mas não têm correspondência explícita a âncoras/clusters nas referências já reconciliadas. O plano não cria essas ligações por setor ou proximidade. Há **41 entradas de pendência**, incluindo essas seis correspondências e 35 pontes de rastreabilidade; não são 41 invalidações nem pedidos de revalidação da origem oficial. A correspondência técnica entre o PDF INE aceite e o workbook administrativo não foi presumida.
## Pré-visualização e efeitos
Página existente: **http://127.0.0.1:8000/management/relationship-repair**, com autenticação e a permissão de gestão já utilizada pelo projeto. O bloco inicial **“V2 — aplicar rastreabilidade territorial”** apresenta o destino `investemoz:5432`, os campos atuais e propostos das 13 alterações, a fonte/citação e as 112 entradas por associação. O plano anterior da página permanece preservado e separado.
A ação desta entrega é exclusivamente **“Aplicar rastreabilidade territorial V2”**. A operação é transacional, verifica o hash do plano/código, o destino, o backup e o estado atual de cada registo. Conflitos apresentam um erro no próprio bloco e não aplicam parte do plano. O botão fica desativado durante a operação. Pedidos repetidos do mesmo plano aplicado não criam duplicados.
O evento de auditoria guarda a projeção das fontes, o ator autenticado e os valores antes/depois. As fichas autorizadas mostram o fundamento por associação; as permissões atuais dos dossiers, locais e membros continuam a ser verificadas. Pesquisa, filtros e mapa reutilizam as relações existentes; preencher referências não altera implantação, contexto, impacto, abrangência, geometria ou disponibilidade. Registos sem coordenadas continuam consultáveis.
## Backup, compatibilidade e reversão
Backup atualizado restaurado em **`desk_restore_20261008_235546_test:55441`**. Foram comparadas **288 tabelas por contagem e hash dos dados**, e restaurados/verificados quatro ficheiros documentais mais a configuração privada. Isto comprova restauro; não declara scan antimalware desses documentos.
Na cópia restaurada, o mesmo plano aplicou 13 alterações, repetiu a operação sem duplicados e reverteu as 13. Valores de referência e estados de validação foram restituídos, com versões monotónicas e histórico de auditoria preservado. Onze tabelas territoriais/documentais relacionadas mantiveram os mesmos hashes; não houve nova geografia nem novas ligações de oportunidades.
A prova está vinculada ao plano e ao código, com validade de 24 horas: **até 10/10/2026 às 01:55:55, Africa/Johannesburg**. Após expiração ou mudança do código/plano, o botão exige nova preparação. Não há migrations nesta aplicação.
Após aplicação, a mesma página disponibiliza **“Reverter este incremento de rastreabilidade”**. A reversão restitui apenas os campos deste incremento, preservando eventos e versões. Se os campos/versões já tiverem sido alterados depois da aplicação, recusa sobrescrever a alteração posterior. Recuperação integral do backup permanece um procedimento operacional separado; nunca executar restauro de QA contra a base ativa.
## Evidência e estado
- 56 testes PHP passaram, com 884 asserções: relações, território, zonas, carteira, unificação e o novo fluxo autenticado. Os novos testes cobrem permissões, idempotência, reversão, consulta autorizada, conflito e prova expirada/alterada.
- Quatro testes de reconciliação verificam os estados independentes e a preservação da aceitação. São testes de comportamento com fixtures; não reabrem a proveniência dos documentos.
- TypeScript, lint/formatação, PHPStan dos serviços/controladores afetados e compilação passaram.
- Navegador QA: pré-visualização autenticada, clique no botão V2, HTTP 302, sucesso visível, recuperação após recarregar, fonte por associação na ficha e reversão; sem erros de JavaScript. Somente login e duas ações de gestão na cópia isolada.
- Dez casos territoriais de navegador passaram em computador/móvel, sem escritas: localização própria, contexto associado, vários locais, informação insuficiente e localização sem coordenadas.
- Leitura ativa em `READ ONLY` às 00:00:12 UTC de 9 de outubro: domínio territorial inalterado e **zero eventos de aplicação deste incremento**. O hash comparado consta da prova privada; sucesso em QA não é aplicação ativa.
Provas privadas em `storage/app/private/investmoz-v2`: `territory-activation-plan.json`, `territory-backup-proof.json`, `territory-reversal-evidence.json`, `territory-activation-browser.json` e `territory-activation-active-preservation.json`. Backup, configuração e matrizes privadas não entram no commit nem são publicados.
**Preparado:** código, pré-visualização e aplicação autenticada. **Validado em QA:** aplicação, reversão, permissões e apresentação. **Aplicado na base ativa:** nenhuma alteração de dados deste incremento; ação autenticada do responsável permanece por executar.
Continuam separadas: questões jurídicas específicas de âmbito/versão/aplicabilidade ainda não resolvidas; diferença de cobertura do inventário; ClamD real; primeiro pedido real no Balcão. A aceitação da proveniência oficial não foi reaberta e nenhuma dessas pendências foi concluída pelos testes territoriais.
## Confirmação após as ações autenticadas
Leitura `READ ONLY` de `investemoz:5432` em 09/10/2026 às 00:10:09 UTC (02:10:09 local). A auditoria regista `traceability_applied` às 02:06:31 e `traceability_reversed` às 02:06:47 locais, ambas pelo utilizador 13 e para o mesmo hash do plano preparado. **Estado atual: incremento revertido; referências propostas não permanecem aplicadas.**
As 13 alterações registadas no evento de aplicação correspondem exatamente aos valores propostos. Após reversão, os 13 pares de referências regressaram aos valores anteriores e as versões aumentaram duas unidades, preservando o histórico. Estados de validação e tipos de associação mantiveram-se; os 46 registos territoriais, as fontes legais, a hierarquia e a geometria também foram preservados. A projeção de fontes deste plano deixa de estar ativa após reversão.
Evidência privada: `territory-post-action-confirmation.json`, incluindo identificação das duas ações e comparação por associação. Esta confirmação não realizou escritas na base ativa. Para reaplicar, é necessário preparar uma nova pré-visualização com as versões atuais e provas correspondentes; não repetir o plano revertido nem a aplicação automaticamente.
## Diagnóstico da reversão e novo plano
9 de outubro de 2026. O evento antigo de reversão identifica a conta 13, a ação e o plano, mas **não contém motivo**. Não é possível inferir a intenção humana. No código, `traceability_reversed` é registado quando a ação explícita de reversão é executada; uma falha transacional não gera esse evento. A comparação anterior comprovou que aplicação e restituição funcionaram corretamente, sem perda de validações.
Foi corrigida uma fragilidade de interação: o mesmo botão mudava de aplicar para reverter após sucesso. A reversão passa a exigir um motivo preenchido e a confirmação expressa de restituição das referências, verificados também no servidor. O motivo e os valores restituídos ficam no novo evento de auditoria. O histórico antigo permanece intacto e apresenta «motivo não registado»; não foi preenchido retroativamente. Um plano revertido aparece como tal e o seu botão fica desativado, exigindo novo plano.
**Nova pré-visualização:** mesma página e ação `Aplicar rastreabilidade territorial V2`; destino `investemoz:5432`, 112 entradas e 13 atualizações, agora com guardas da versão **3** das associações. Hash privado do plano: `ec11b9e400b7b127fbc8d42a2afe5e4d2c8a3919216a5d7439fb38b0751c57c6`. Não cria relações ou geometrias nem reabre a aceitação oficial.
**Provas atualizadas:** backup/restauro de 288 tabelas e cinco ficheiros; cópia `desk_restore_20261009_001345_test:55441`. Ensaio aplicou 13 referências, confirmou idempotência e reverteu 13, preservando validações e onze tabelas relacionadas. A prova nova substitui a anterior para esta aplicação e expira em **10/10/2026 às 02:13:54 locais**. Os ficheiros do plano e da prova anteriores foram preservados privadamente.
Os três testes afetados passaram, com 30 asserções, incluindo recusa de reversão sem motivo/confirmação e conservação do motivo no histórico. TypeScript, formatação/lint, PHPStan e build passaram. As pendências de rastreabilidade, jurídicas específicas, cobertura documental, ClamD e primeiro pedido real permanecem separadas. **Não houve reaplicação automática na base ativa.**
O navegador QA confirmou pré-visualização, aplicação, recuperação e reversão após preencher motivo e confirmação; o botão de reversão estava inicialmente desativado. Sem erros de JavaScript. Leitura ativa final confirmou todas as guardas atuais do novo plano e apenas os dois eventos históricos, sendo o último a reversão.
## Confirmação da aplicação do novo plano
Leitura `READ ONLY` em 09/10/2026 às 02:18:17 locais: o novo plano foi aplicado às **02:16:24**, pela conta **13**. Evento `traceability_applied`, ID `62ca4e39-93b3-4de1-b575-b15bc026d2e4`, corresponde ao hash `ec11b9e400b7b127fbc8d42a2afe5e4d2c8a3919216a5d7439fb38b0751c57c6`, com 112 entradas e 13 alterações. Não há reversão deste novo plano nesta leitura.
As 13 referências persistidas correspondem exatamente à proposta e ao evento de auditoria; versões passaram de 3 para 4. Validações e tipos das associações foram preservados. A comparação dos estados existentes nas guardas confirma preservação, incluindo as 14 zonas `validated` e os seis estados legais `pending` preexistentes. **Estado atual: novo incremento aplicado na base ativa pelo fluxo autenticado.** Histórico da aplicação/reversão anterior permanece intacto.
Evidência privada: `territory-new-plan-confirmation.json`, com verificação por associação. Esta confirmação não escreveu na base ativa nem repetiu a aplicação. Pendências documentais específicas, cobertura do inventário, ClamD e primeiro pedido real mantêm os seus estados independentes.