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

52 lines
8.6 KiB
Markdown

# 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](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](backlog-mestre.md) 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.