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

49 lines
4.5 KiB
Markdown

# 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.