Files
Investidor-V2/docs/investmoz/document-library-schema-incident-2026-10-05.md
T
nala e65cb26901
tests / ci (push) Canceled after 0s
varias alteracoes
2026-10-06 14:50:12 +02:00

4.5 KiB

Incidente de esquema — biblioteca documental — 5 de Outubro de 2026

Causa confirmada

A consulta de recursos essenciais em PortalServicesController::resources() corresponde ao modelo da biblioteca: a migração 2026_10_05_120000_extend_portal_document_catalogue declara rights_status em portal_resources e documents. O código não está a usar um nome alternativo ou incorrecto. A base activa ainda não recebeu essa migração.

Leitura do esquema activo: PostgreSQL 17.11, base investemoz, host 127.0.0.1, porta 5432.

  • portal_resources: 12 colunas. Tem published, essential, legislation, título/categoria/tópico, referência e auditoria básica; não tem rights_status nem os campos de metadados, revisão e relações da biblioteca.
  • documents: 19 colunas. Tem estado, classificação, hash, chave privada, MIME, versão e datas; não tem rights_status, original_source ou qualquer coluna malware_*.
  • portal_resource_links, portal_resource_revisions e document_malware_scans ainda não existem.
  • Ambas as migrações específicas da biblioteca estão Pending. Também existem seis migrações pendentes anteriores e não relacionadas; não foram executadas.
  • portal_resources tem zero linhas no relatório de contagens da base activa.

Compatibilidade e protecções

A consulta continua a exigir publicação explícita, classificação pública, estado activo, direitos não restritos, análise antimalware clean e igualdade entre o hash guardado e o hash analisado. Nenhum destes filtros foi removido.

As migrações definem unconfirmed como valor inicial para direitos e pending para análise. Assim, dados antigos não passam automaticamente a autorizados, públicos ou limpos. O novo comando php artisan portal:check-document-library-schema verifica tabelas, colunas, migrações, valores predefinidos e coerência do hash de documentos clean; é só leitura e falha de forma explícita quando a estrutura está incompleta.

Erros SQL e de ligação recebidos por HTTP passam a apresentar 503 com mensagem genérica e referência. A excepção completa continua no registo interno. Não foi possível validar a apresentação no browser activo nesta execução.

Alterações desta correcção

  • app/Console/Commands/CheckDocumentLibrarySchema.php: verificação pré-activação da estrutura e dos valores predefinidos seguros.
  • bootstrap/app.php e resources/views/errors/database-unavailable.blade.php: ocultação de SQL, host, base e caminhos na resposta pública para erros SQL/de ligação.
  • tests/Feature/DocumentLibrarySchemaCompatibilityTest.php e tests/Feature/DatabaseErrorRedactionTest.php: regressão de compatibilidade e redacção.
  • docs/investmoz/deployment.md: procedimento para validar backup, executar apenas as duas migrações da biblioteca por ordem e confirmar compatibilidade antes da activação.

Testes e limites da evidência

Executados na base isolada investemoz_test (127.0.0.1:55441):

  • php artisan test --filter='DocumentLibrarySchemaCompatibilityTest|DatabaseErrorRedactionTest' — 5 testes, 21 asserções, aprovados.
  • php artisan test --filter=PortalServicesTest — 9 testes, 289 asserções, aprovados.

Executado na base activa, sem escrita: php artisan portal:check-document-library-schema terminou com falha esperada e listou as colunas/tabelas e migrações em falta, sem imprimir SQL, credenciais ou caminho interno.

A revisão automática bloqueou a criação do backup local por pg_dump; não foi criado backup. Portanto, nenhuma migração foi aplicada e os testes QA não são apresentados como prova de compatibilidade activa. A tentativa de abrir Edge headless para a captura activa também foi bloqueada pela política de execução. O percurso visual do Início, Documentos e Formulários e o download real continuam por demonstrar.

Procedimento pendente

  1. Criar e validar um backup recuperável numa sessão local autorizada.
  2. Confirmar outra vez o destino investemoz antes da escrita.
  3. Aplicar apenas 2026_10_05_120000_extend_portal_document_catalogue.php e depois 2026_10_05_130000_add_document_malware_scanning.php.
  4. Exigir sucesso de php artisan portal:check-document-library-schema.
  5. Testar no browser activo o Início e a biblioteca. O catálogo deve mostrar vazio enquanto não houver documentos com direitos, publicação e análise adequados.
  6. Quando existir documento autorizado, demonstrar pesquisa, download protegido e acesso no módulo associado. Não marcar documentos existentes como aprovados para preencher o catálogo.