SGF/docs/GENERAL_LEDGER_COMPLETE_SYNTHETIC_SCOPE.md

Ciclo contabilístico sintético integrado — recorte para decisão

02/11/2026. Autorização expressa recebida: «Autorizar o ciclo sintético proposto». Implementação local concluída no recorte aprovado. Continuação agrupada do percurso funcional financeiro → lançamento. O texto de decisão abaixo conserva o recorte autorizado; não é um pedido pendente de nova aprovação. Entrega, demonstrações e limites em GENERAL_LEDGER_COMPLETE_CYCLE_DELIVERY.md.

Porque a decisão é necessária

O AGENTS.md, primeira instrução do lançamento, delimita a autorização anterior: «não autoriza lançamentos/contas/direitos reais, migração no destino, fecho/reabertura, novos efeitos de pagamentos, activação de Compras, publicação, aceitação ou checkpoint». O recorte primeiro exclui também correcção/estorno e composição contabilística autónoma. O desenvolvimento técnico do primeiro efeito e das suas ligações está concluído no âmbito demonstrado; não se presume autorização destes novos efeitos.

Uma entrega funcional, com bases novas e decisões individuais

COMMON-LEDGER-COMPLETE-CYCLE-SIM-v1: autorização conjunta proposta para construir e demonstrar o seguinte ciclo, sem aprovações intermédias de cada ligação técnica:

1. Liquidação sintética de 20 MZN sobre a obrigação QA de 60 MZN. Reutilizar os comandos e decisões independentes do núcleo de liquidações, sem execução monetária/bancária. Só a afectação efectivamente confirmada é origem do efeito contabilístico. Principal permanece 60 e saldo financeiro passa a 40. Facto de pagamento sem afectação confirmada não lança automaticamente contra o fornecedor.
2. Lançamento da afectação confirmada, proposta/revisão/aplicação distintas: débito 20 em QA-FORNECEDOR, crédito 20 em nova conta artificial de movimento QA-LIQUIDACAO. A conta não representa uma conta bancária real, dinheiro verificado ou reconciliação. Uma única aplicação por afectação factual e tipo de efeito; fotografia/versionamento e autor/fundamento conservados.
3. Reversão financeira e contabilística ligada. Reutilizar o circuito financeiro existente de reversão independente; quando a reversão confirmada for contabilizada, débito 20 em QA-LIQUIDACAO, crédito 20 em QA-FORNECEDOR. Preservar afectação, lançamento e decisões originais. Saldo financeiro volta a 60; nenhuma reversão implícita da obrigação original. Contabilização em falta fica pendência visível, nunca compensação silenciosa.
4. Correcção técnica de um lançamento de reconhecimento, sem mudar a dívida: proposta de correcção captura o lançamento de 60 e a razão; revisão distinta aprova exactamente um par atómico de estorno integral (D fornecedor/C contrapartida) e substituição integral (D contrapartida/C fornecedor), 60 MZN cada. Novos efeitos correctivos referenciam o original e a decisão; não reutilizam uma nova chave para furar a unicidade do efeito de reconhecimento. O original não é editado/apagado. Alteração comercial de principal, imposto ou moeda fica fora desta proposta.
5. Fecho do período QA, preparado e revisto por pessoas distintas: fotografia do conjunto de origens/lançamentos/pendências e igualdade D/C; impedir fecho enquanto houver efeitos confirmados obrigatórios sem conferência, inconsistências ou propostas necessárias não resolvidas. Aplicação revalida a fotografia numa transacção; nova origem/lançamento/decisão exige nova conferência. Após fecho, bloquear novos lançamentos nesse período, mantendo leitura e recuperação dos recibos existentes. Reabertura continua excluída deste recorte; não é necessária para demonstrar o ciclo fechado.
6. Duas composições QA sobre o mesmo núcleo, adaptador SGF e adaptador autónomo SGC. Reutilizar o pacote canónico, sem cópia divergente do motor, pacote instalado substituído, candidata activada ou dependência de SGF remoto. Bases de prova separadas representam livros independentes; não apresentar a mesma dívida como responsabilidade financeira operacional nos dois hosts.
7. Uma demonstração persistente própria, com entrada, papéis, referências e pendências ligadas, permitindo executar o ciclo completo. Base de regressão separada; histórico mantido, sem reset do demo para ocultar decisões.

Direitos propostos antes de concessão

Conservar general_ledger.view/prepare/validate/post apenas QA. Novos direitos propostos, apenas em novas fixtures: general_ledger.correct_prepare, general_ledger.correct_validate, general_ledger.correct_post, general_ledger.period_prepare, general_ledger.period_validate, general_ledger.period_close. Separar preparador/aplicador do revisor por conta e pessoa. Reutilizar os direitos explícitos existentes de liquidação/reversão exclusivamente nas identidades QA necessárias, enumerados na preparação da fixture, sem conceder novos acessos empresariais ou direitos públicos. Consulta não herda comandos; contexto financeiro não concede contabilidade.

Critério de conclusão e exclusões

Entregar código, interfaces, dois adaptadores, guião único, relatório de pendências, testes afectados e prova end-to-end do reconhecimento60 → afectação20/saldo40 → contabilização → reversão/saldo60 → correcção técnica com originais → fecho. Incluir tenant/empresa/unidade indevidos, revogações, auto-revisão, versões alteradas, concorrência, repetição com mesma/outra chave, falhas em cada fronteira atómica e recuperação sem duplicação; fontes e montantes exactos devem reconciliar. Ensaios anteriores válidos reutilizados, sem repetir suites alheias.

Contas/períodos/regras artificiais; bases/roles novas no cluster55439; sem tocar seis associações pendentes, cache bloqueada, demos existentes ou trabalho alheio. Sem emissão/fiscalidade real, novas contas/concessões/dados reais, operações monetárias, reconciliação bancária, valorização/efeitos de stock/orçamento, reabertura de período, migração no destino, activação de Compras, publicação, aceitação/checkpoint presumidos. Revisão visual e capacidade de implantação continuam separadas.

Decisão pedida: autorizar este ciclo sintético agrupado e os direitos exclusivamente QA acima. A autorização abrange a implementação e as provas deste recorte, não a sua aceitação posterior ou utilização real.