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. Tempublished,essential,legislation, título/categoria/tópico, referência e auditoria básica; não temrights_statusnem 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 temrights_status,original_sourceou qualquer colunamalware_*.portal_resource_links,portal_resource_revisionsedocument_malware_scansainda 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_resourcestem 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.phperesources/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.phpetests/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
- Criar e validar um backup recuperável numa sessão local autorizada.
- Confirmar outra vez o destino
investemozantes da escrita. - Aplicar apenas
2026_10_05_120000_extend_portal_document_catalogue.phpe depois2026_10_05_130000_add_document_malware_scanning.php. - Exigir sucesso de
php artisan portal:check-document-library-schema. - 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.
- 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.