12 KiB
V2 — rastreabilidade territorial e aplicação autenticada
Entrega preparada em 9 de outubro de 2026 (Africa/Johannesburg). Complementa a qualidade territorial por registo e a reconciliação documental dos 46 registos.
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.