3.0 KiB
O1 — verificação operacional dos documentos da recepção
O comando técnico php artisan sgc:receipt-documents-check --json cruza os registos da recepção com o armazenamento privado. É uma consulta global da instalação, com saída apenas agregada, destinada à consola sem identidade interactiva. Não existe rota HTTP, acesso adicional ou inscrição automática em monitorização.
Verifica a ligação do documento à recepção/empresa, o caminho dentro do armazenamento privado, a existência do ficheiro, o tamanho e o SHA-256. Só calcula o hash quando o tamanho coincide e respeita o máximo de2MB do upload. A listagem distingue ficheiros sem referência recentes e com pelo menos uma hora. Esta idade é uma indicação técnica; não prova abandono nem autoriza apagar ficheiros. Um upload em curso pode surgir como ficheiro recente sem referência.
Não escreve registos, ficheiros, auditoria ou estado de saúde persistente; não elimina, reanexa ou repara conteúdo. Nomes, caminhos, empresas, pessoas e conteúdo não integram a saída. Falhas inesperadas devolvem indicação genérica e ficam no registo técnico da instalação. A recusa de identidade interactiva impede confundir este agregado com uma consulta por empresa.
--limit=1000 limita independentemente documentos e ficheiros; aceita de1a10000. Ao atingir o limite, a saída indica complete=false, motivo limit_reached e código1, sem declarar a instalação saudável. Este bloco não oferece paginação/cursor para grandes volumes nem substitui ensaio de capacidade. A enumeração de directórios e as consultas técnicas podem consumir recursos; não foi instalado um serviço periódico.
Código0 significa consulta completa sem divergências observadas; código1 significa divergências, estrutura/armazenamento indisponível, consulta incompleta ou falha; código2 indica limite inválido. A consulta PostgreSQL usa snapshot de leitura, mas ficheiros e base não têm snapshot conjunto: o resultado é uma observação técnica, não uma certificação de backup ou recuperação.
Não foram executados comandos no piloto nem alteradas contas, aprovações ou configuração por esta entrega. Ensaios de ficheiros, bases e erros são descartáveis. Não há novo frontend, migração, activação de MFA ou alteração SGF. Provas receipt-document-health.json e receipt-document-health-pg.json. Revisão visual, retenção, limpeza de ficheiros, backup/restauro conjunto e instalação comercial continuam separados.
Fecho: 14 testes/135 verificações integradas de saúde documental, upload/descarga e impressão. PostgreSQL descartável6testes/33verificações,base removida. Cobertura de duas empresas,ausência de mutações,conteúdo alterado,ficheiros ausentes/sem referência,caminho inválido,limite,estrutura/armazenamento indisponível,ocultação de erros e recusa de identidade interactiva. PHPStan sem erros,Pint,diff e18hashes de execução conferidos. Sem alteração de frontend,nova compilação ou revisão visual nesta entrega.