Files
Investidor-V2/docs/investmoz/v2/ativacao-segunda-entrega.md
T
nala 1106509116
tests / ci (push) Canceled after 0s
vrsao 2
2026-10-08 14:02:01 +02:00

8.6 KiB

Preparação da ativação e segunda entrega

8 de outubro de 2026. Código e evidências locais; a instalação na base ativa continua a exigir ação autenticada do utilizador.

Preparado para revisão

A leitura ativa confirmou investemoz:5432, 76 migrations, Bolsa interna instalada e ausência do novo Balcão/acompanhamento. Continuam necessárias exatamente:

  1. 2026_10_07_190000_create_internal_virtual_desk: cria desk_service_versions, desk_cases, desk_requests, desk_documents, desk_events, desk_revisions, desk_messages, desk_notifications, desk_institutional_links e desk_payments.
  2. 2026_10_08_120000_extend_desk_investor_guidance: acrescenta ordem dos eventos; associações opcionais a investidor/projeto/percurso/pedido existente; referências do Balcão, aceitação explícita e estado de sincronização nas tarefas existentes. Acrescenta índices, FKs e constraints; não copia contactos nem envia dados externos.

O plano aparece em /management/balcao-install, acessível apenas a conta verificada com manage-portal. Mostra destino real, migrations pendentes, data do backup/restauro, compatibilidade, permissões DDL, QA desta versão, scan e reversão. O botão exige confirmação explícita e provas correspondentes ao código/destino. O backup expira para instalação após 24 horas; código alterado invalida QA/compatibilidade. O backend reapura o preview sob lock antes da transação e recusa prova de outra base ou preview alterado.

No servidor local existente: http://127.0.0.1:8000/management/balcao-install. Depois de iniciar sessão com a sua conta autorizada, rever os indicadores e o plano, assinalar «Confirmo aplicar exactamente as alterações pré-visualizadas» e executar Aplicar instalação autenticada. Publicar um serviço de preparação interna é uma ação posterior e separada. Nenhuma ação de instalação foi executada nesta entrega.

Backup e restauro isolado

tools/desk-activation-backup.php cria dump com snapshot PostgreSQL consistente de leitura, mantendo a conexão ativa READ ONLY. Restaurou exclusivamente em desk_restore_20261008_093355_test:55441; nome/porta reais foram verificados antes de escrever. Os conteúdos das 278 tabelas, incluindo schemas adicionais, coincidiram linha a linha/hash com o snapshot.

O arquivo privado inclui os quatro ficheiros referenciados por documents.storage_key e .env, necessário para recuperar a configuração e a chave de cifragem. Cinco entradas foram lidas do arquivo, restauradas numa pasta privada isolada e comparadas por hash. O arquivo é confidencial, não publicado, não enviado a CRM ou outros serviços. O dump preserva a definição original; o restauro QA utiliza --no-owner --no-privileges, portanto não comprova a reprodução dos grants/roles de produção.

Evidências privadas: storage/app/private/virtual-desk/backup-proof.json, dump/arquivo na pasta activation-backup-*, activation-compatibility.json e activation-preview.json. O dump verificado tem SHA-256 78242c13b5a5942891a52aa86184cbba89f018e8ca9ec229d368d7e6743ddc1d. Não há exportação de conteúdo pessoal no relatório.

tools/desk-activation-compatibility.php ensaia as duas migrations apenas nessa cópia, verifica todos os campos/linhas originais das 278 tabelas e executa a reversão vazia em ordem inversa, comparando novamente os hashes. A reversão com dados novos não é destrutiva: os down() recusam eliminar dossiers, associações/tarefas e registos do Balcão. Depois de utilização real, preservar/exportar o novo histórico e reconciliar mudanças posteriores antes de qualquer restauro integral numa janela autorizada. Não aplicar dump antigo sobre alterações posteriores sem essa reconciliação.

ClamD e ficheiros reais

Não foi encontrado serviço ClamD nem listener local na porta 3310. Foram novamente executados ClamDScannerIntegrationTest e ClamDQueueWorkerIntegrationTest: seis casos, três aprovados, três saltados, 13 asserções. Os três casos reais continuam sem evidência porque requerem daemon/assinaturas atuais. Não foi instalado ou simulado um serviço como substituto do scan real.

O worker existente conserva ficheiros sem resultado conclusivo em quarentena/estado indeterminado; anexos recém-recebidos permanecem pendentes até scan. Download, uso documental seguro e conferência que requer ficheiro limpo continuam a exigir resultado válido para os bytes atuais. Guardar dossier/rascunho, alterar pressupostos e preparar pedidos internos permanece disponível. Não foi alterado qualquer estado de scan de documento ativo por esta preparação.

Segunda entrega em QA

  • Mensagens: no envio, um evento cifrado guarda ID e tipo da mensagem. Mudanças posteriores de permissões ou remoção de membro não reclassificam o histórico. Autoria, corpo e data permanecem. Registos antigos sem tipo documentado aparecem como «Mensagem histórica — tipo original não registado»; não há backfill por inferência de papel atual.
  • Coerência: campos opcionais comparam procura/capacidade na mesma unidade/período, recursos necessários/disponíveis e financiamento necessário/comprometido na mesma moeda. Zero declarado é um valor; ausência nunca é zero. Sem unidade/período/moeda ou valores comparáveis, a conclusão é informação insuficiente. Lacunas e datas contraditórias são declarações contestáveis, não incompatibilidades oficiais ou bloqueio do percurso. Nenhuma previsão, taxa fiscal ou probabilidade de sucesso foi criada.
  • Ligações institucionais: conferência interna explícita por gestor guarda evidência, autoria, URL, versão, contacto e data em auditoria. A validade de sete dias é uma política interna de disponibilidade, não prazo institucional/legal. Verificação ausente/expirada, URL inválida ou indisponibilidade produzem aviso e contacto alternativo/pedido no mesmo dossier. Serviços internos continuam disponíveis. Não há crawler, integração externa ou envio de dados; a disponibilidade real de cada URL exige consulta humana registada. O controlo de monitoria está preparado, mas links reais não foram inventados ou declarados verificados.
  • Permissões: viewer/antigo membro não ganha acesso por existência do histórico; apenas leitores atualmente autorizados podem consultá-lo. Conferência de ligações é restrita à gestão, com conflito de versão rejeitado.

QA global: 348 testes PHP, 345 aprovados, 3 saltados, 4065 asserções; verificação específica final: 18 testes, 272 asserções. Frontend: 151 aprovados; TypeScript, lint, PHPStan e Pint passaram. Build concluído, mantendo os avisos já conhecidos de fontes opcionais e dimensão dos bundles. Uma primeira execução global coincidiu com a regeneração dos assets e falhou por CSS transitoriamente ausente; build e suite foram depois executados sequencialmente e a suite passou.

O plano ativo reapurado apresenta backup/restauro, QA, compatibilidade e permissões da base verificados, com as duas migrations pendentes e ClamD indisponível. Evidências privadas: second-phpunit.txt, second-targeted.txt, second-frontend.txt, second-types.txt, second-lint.txt, second-phpstan.txt, second-pint.txt, second-build.txt e activation-preview.json.

A revisão autenticada no navegador aprovou guardar os novos pressupostos, apresentar as comparações, registar a conferência de ligação, mostrar contacto alternativo e continuar o dossier internamente; aprovou também a apresentação do destino e da indisponibilidade ClamD na página de instalação QA. Zero erros JavaScript. Evidência: second-browser-evidence.json e captura privada second-install-qa.png. O teste de isolamento do plano final passou separadamente: um teste, 13 asserções.

Os ficheiros alterados nesta fase constam de ficheiros-segunda-entrega.csv, com hashes para comparar antes de reverter. O CSV é um artefacto gerado e não inclui o seu próprio hash.

O backlog distingue estes resultados da aplicação na base ativa. O snapshot storage/app/private/investmoz-v2/second-before preserva os ficheiros antes desta segunda entrega; reverter apenas os deltas correspondentes, sem reset global. Os três novos scripts desk-activation-* escrevem provas privadas ou na cópia QA; não instalam o Balcão na base ativa.

Aplicado na base ativa

Nenhuma alteração de esquema ou dados aplicada. Houve leitura para diagnóstico e backup consistente. Instalação, publicação de serviços, scan real e utilização dos novos fluxos na base ativa não são resultados certificados por QA. A identidade do operador continua pendente e as integrações externas continuam sem ativação.