Files
SGF/docs/SGF_BANK_RECONCILIATION_SCOPE.md
2026-11-11 09:00:17 +02:00

37 lines
5.4 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Proposta agrupada — conferência de extracto bancário QA
`SGF-BANK-RECONCILIATION-QA-v1`,10/11/2026. **Autorizado expressamente e entregue**; ver `SGF_BANK_RECONCILIATION_DELIVERY.md`. O texto abaixo conserva o âmbito aprovado. Fecha a lacuna de conferência de extracto no módulo Financeiro, mantendo o percurso de Caixa e os livros existentes. Não é autorização para operar bancos ou dinheiro real.
## Percurso completo proposto
Na mesma8085/regressão, importar o CSV artificial `QA-EXTRACTO-20261110`: entidade fictícia `QA-BANCO-LOCAL`, MZN, abertura0, débito20 e crédito20 em10/11/2026, fecho0. O saldo intermédio−20 é parte deste exercício documental; não representa autorização de descoberto, caixa disponível ou crédito real.
O documento é um **extracto artificial interno**, sem conexão de instituição ou transmissão externa. Não se usa o recebimento1000 da Caixa, nem se reclassifica a Caixa fechada950. A referência de comparação são duas linhas contabilísticas de liquidação já existentes: crédito20 do diário2 e débito20 do diário3, conta artificial `QA-LIQUIDACAO` (linhas4/5 na8085). Corresponderam ao ciclo fornecedor20/reversão20 já provado. A conta não é declarada bancária globalmente; a comparação fica identificada e limitada a este exercício.
Importação13 → revisão distinta14 do extracto/abertura/fecho → escolha explícita, individual e fundamentada da linha do extracto e da linha contabilística → prévia do impacto → confirmação/revisão14 da correspondência exacta → conferência final com zero linhas por conferir e diferença0 → histórico e relatório interno recuperáveis. Não criar pagamento, estorno, comissão, ajuste ou lançamento para fazer coincidir valores. Referências de valor igual não são associadas automaticamente.
Importar o mesmo ficheiro/chave recupera a mesma origem, sem duplicar linhas. Ficheiro alterado não substitui fotografia confirmada. Uma linha contabilística ou de extracto já conciliada não pode ser usada de novo; divergência ou origem ausente permanece pendência. Dados fora da instituição/conta/período/empresa/unidade QA fixados são recusados. Datas, sinal, moeda, totais e sequência são conferidos sem inferir saldo de conta real a partir desta amostra.
Confirmação revalida autor/direitos/contexto, versão do extracto/correspondência, fonte contabilística e dependências. Histórico append-only com preparador/revisor/data/fundamento/estado anterior e posterior; recuperação de resposta incerta pelo pedido original. Sem reabertura de Caixa, período contabilístico ou conciliação finalizada. Importação não confirma correspondências nem altera o diário.
## Novos direitos a decidir
Quatro nomes e **oito concessões por cada base QA existente**,16 no conjunto, todos tenant1/empresa2/unidade2 e perfis existentes:
|Direito|Destinatários|
|---|---|
|`bank_reconciliation.view`|Financeiro13/14; Contabilidade15/16; consulta17|
|`bank_reconciliation.import`|Financeiro preparação13|
|`bank_reconciliation.prepare`|Financeiro preparação13|
|`bank_reconciliation.review`|Financeiro revisão14|
[Matriz integral](integration/sgf-bank-reconciliation-access-proposal.json). Consulta abrange apenas o extracto artificial e as duas fontes fixadas do exercício. Não confere acesso geral a dados bancários/documentos de outros módulos. `service_receivables.reconcile` já existente refere-se ao percurso de recebimento, não concede importação/conferência de extractos. Sem novo utilizador, PGrole, direito PUBLIC, conta bancária real ou concessão real.
## Provas e instalação depois da autorização
A base de regressão existente não contém as duas linhas de liquidação20/20 da8085 (confirmado por consulta só de leitura). Nesse livro, a persistência/concorrência/guardas serão testadas com um fornecedor de origem artificial injectado apenas no harness, sem criar pagamentos ou lançamentos para preparar testes. O leitor nativo de produção não terá fallback e continuará limitado ao seu livro físico; o percurso HTTP na8085 provará a ligação às duas linhas efectivamente existentes. O relatório distinguirá explicitamente a origem simulada nos testes de componente e a origem contabilística real do QA na instalação.
Primeiro regressão existente: leitura/importação por hash, filtros/páginas25/100 com metadados de teste, contexto/empresa/unidade/módulo, revisão própria, abertura/fecho/sinais/moeda, correspondências manuais, versões antigas, concorrência, reutilização indevida da mesma linha, repetição e falha/recuperação atómica. Depois disponibilizar o percurso completo limitado na mesma8085, conservando a evidência e exemplos anteriores. Não repetir aquisições, liquidações ou lançamentos que originaram as duas linhas.
Este bloco inteiro inclui os campos/testes do contrato, sem pedidos por cada detalhe. Preservar27 lançamentos, Caixa950, quatro versões IVA, quatro eventos de regra/dois cálculos, seis registos/cache/trabalho alheio. Sem novas bases/portas/demos, SGC/portal em execução, bancos/APIs/credenciais/dados reais, pagamentos/efeitos financeiros novos, mudança da classificação do plano, índices no destino, reabertura, publicação/candidata/checkpoint/aceitação ou capacidade de implantação. Visual/carga continuam separados. Outros motores fiscais, modelos oficiais e operação bancária geral permanecem fora deste recorte.