Files
SGF/docs/GENERAL_LEDGER_RECEIPT_RECOVERY_DELIVERY.md
2026-11-04 09:37:20 +02:00

16 lines
2.8 KiB
Markdown

# Recuperação de comprovativos contabilísticos — 03/11/2026
Extensão posterior: [reconhecimento e liquidação de fornecedor](FINANCIAL_RECEIPT_RECOVERY_DELIVERY.md) agora consultáveis por domínio explícito na mesma área contabilística. O endpoint original e os limites desta entrega mantêm-se; não é uma consulta universal dos restantes motores.
Implementada consulta por chave UUID no mesmo núcleo: `GET /api/general-ledger/receipts/{key}`. Recupera exclusivamente comprovativos do utilizador actual, no tenant/empresa/unidade seleccionados, com direito contabilístico de consulta e identidade financeira actuais. Outro autor, âmbito diferente ou chave inexistente não revela o comprovativo. Não aceita contexto por parâmetros.
Mostra chave, data, hash do pedido e resultado original. É evidência histórica, não conferência da fonte actual nem nova execução. Usa uma fotografia `REPEATABLE READ READ ONLY`, sem bloqueios de escrita; uma consulta lê um comprovativo, sem listar o universo. Não cria efeitos, eventos ou chaves novas. A ausência na captura não prova que o comando falhou e não autoriza repetição automática.
Diário, vendas, custo directo, industrial e painel conjunto reutilizam o mesmo formulário de recuperação. Os erros dos comandos apresentam a chave do pedido. O resultado é mostrado como texto, sem HTML executável. O formulário faz apenas GET e não reenvia comandos. Não se acrescentaram direitos, migrações ou dependências.
Provas numa base/role nova55439 (`922dac0c0596`), com custo275 efectivamente capturado/revisto/aplicado pelos workflows existentes:10 verificações de serviço,16 HTTP e3 do JavaScript renderizado em Node VM. Cobrem resultado original/repetição de consulta, autor diferente, unidade estrangeira elegível, direito revogado, UUID inválido, autenticação/contexto/módulo, ausência, `no-store`, transacção de leitura, zero bloqueios, renderização e GET sem execução. Fontes/direitos/comprovativos preservados e um só lançamento. Não se repetiram suites financeiras alheias.
Manifesto: [provas e hashes](proofs/ledger-receipt-recovery-20261103.json). Demos e provas anteriores, seis associações e cache bloqueada intactas. Sem publicação, activação de Compras, operações reais, aceitação ou checkpoint. A consulta também não concede acesso a comprovativos de outro perfil para revisão: cada perfil consulta as suas próprias chaves, e a revisão partilhada conserva as páginas de evidência já existentes.
Limites: não recupera uma chave que o utilizador já não possui, não é arquivo de relatórios nem mecanismo transversal aos outros motores financeiros. Não armazena automaticamente pedidos no navegador. Uma captura anterior não valida dependências presentes. Revisão visual, carga sustentada e implantação permanecem pendentes; HTTP/Node VM não são prova visual.