3.0 KiB
O2 — diagnóstico operacional integrado
03/11/2026. O comando php artisan sgc:operations-check --json reúne as verificações existentes de reposição durável e integridade documental da recepção. Não instala serviços nem executa recuperação, compras, aprovações ou reparações. Os comandos individuais continuam disponíveis.
--document-limit=1000 limita a verificação documental de 1 a 10000 registos/ficheiros, segundo o verificador nativo. Limites inválidos devolvem código 2 antes de inspeccionar. O comando só pode executar em consola, sem identidade autenticada ou sessão interactiva, pois agrega observações de várias empresas.
O resultado JSON tem schema_version=1, início e fim da consulta, ok, complete e checks. Cada verificação conserva o seu resultado e data nativos. As consultas são sequenciais e não representam uma fotografia atómica entre módulos. Não se cria um segundo motor de avaliação.
Estados por verificação:
passed: nenhuma divergência observada pela verificação.attention: consulta concluída com pendências ou divergências, incluindo ausência de passagem recente da reposição.incomplete: a verificação não cobriu todo o âmbito, por exemplo limite documental atingido ou estrutura indisponível.unavailable: erro na execução; o outro verificador continua e o resultado apresenta apenas motivo genérico.
ok só é verdadeiro se ambas passarem. complete indica apenas que ambas as consultas terminaram com cobertura completa; pode ser verdadeiro com ok=false. Código de saída 0 indica ausência de divergências observadas e 1 indica atenção/incompletude/indisponibilidade. Não certifica prontidão comercial, cópias de segurança, restauro, capacidade, serviço instalado ou aprovação humana.
O comando não inclui nomes, identificadores de empresas, caminhos privados ou credenciais no resultado. Excepções conservam o registo técnico existente; a saída não inclui a mensagem privada. Não agenda tarefas, publica notificações nem grava telemetria. Quem monitoriza pode integrar o código de saída e o JSON conforme a instalação autorizada.
Sem alterações na interface ou migrações. Perfis, aprovações e dados do piloto preservados; MFA desligado. Testes em bases descartáveis cobrem composição nativa, ausência de mutações e de alteração do heartbeat, falha parcial com continuação, limite incompleto, pendências e rejeição de execução interactiva. Provas em docs/proofs/operational-health.json e operational-health-pg.json; sem nova revisão visual ou teste de carga.
Validação O2: 17 testes/112 verificações aprovados em OperationalHealthTest, ReplenishmentHealthTest e ReceiptDocumentHealthTest; PostgreSQL descartável 5 testes/36 verificações aprovados e base removida. Contagens não aditivas às provas anteriores. Interface inalterada, sem repetição da compilação nesta etapa.
Análise PHPStan sem erros, formatação e verificação do diff aprovadas.