SGF/docs/SGF_SOLUTION_DELIVERY.md

# Directiva de entrega: SGF autónomo, completo e apresentável

Estado actual de10/11/2026: [consolidação funcional dos seis módulos](SGF_SIX_MODULE_CLOSURE_20261110.md), [guião de apresentação](SGF_GUIAO_APRESENTACAO.md), [guia de uso](SGF_USO_LOCAL.md). Entrada única `/sgf`,18 lançamentos no diário comum, integração física Oficina–Stock, continuação Oficina–Comercial, trânsito com recepção distinta, lotes/ajuste valorizado e fecho QA integral provados. Stock confirmado visualmente pelo utilizador; revisão visual restante e aceitação integral não presumidas. O diagnóstico e as etapas abaixo são históricos e não reabrem lacunas já fechadas. Carga/implantação e reinício completo do sistema mantêm prova própria.

10/11/2026. O proprietário determinou concluir **todos os módulos do SGF** e entregar uma solução para apresentar a potenciais clientes. Este passa a ser o objectivo de fecho do projecto, substituindo a continuação de incrementos do conector SGC como prioridade.

## Entrega obrigatória

Uma instalação SGF, um endereço de entrada, empresa/unidade e perfis coerentes: **Comercial, Compras, Stock, Oficinas, Financeiro e Contabilidade**. Cada módulo tem de oferecer os ecrãs, operações, consultas e histórico previstos, e os percursos entre módulos têm de conservar documento, versão, autoridade e efeito único. O produto não pode exigir o SGC a correr ou pedir ao apresentador para mudar entre demonstrações.

O [contrato de conclusão](integration/sgf-solution-contract.json) fixa funcionalidades por módulo e oito condições de entrega. Fonte de código, menu, catálogo de relatórios ou teste antigo isolado não contam como funcionalidade entregue na instalação. Não se declara percentagem de conclusão a partir do número de testes.

Além das funções: apresentação visual coerente, percurso comercial de ponta a ponta, dados fictícios identificados, perfis e isolamento, arranque, recuperação e guião de apresentação. As operações reais/fiscais/bancárias continuam sujeitas às suas validações e autorizações: a apresentação controlada não lhes atribui validade por inferência.

## Conferência de partida efectuada

A [conferência da instalação actual](proofs/sgf-solution-closure-baseline-final-20261110.json) foi executada por SQL **READ ONLY**, sem arrancar aplicações nem alterar bases, direitos, cache ou8085. Confirmou a identidade física/role do destino e confrontou tabelas com declarações reais do código, caminhos de fontes e provas existentes.

- Compras tem o percurso aceite até obrigação em8085; conservar e reutilizar essa prova.
- Comercial, Oficinas, Financeiro e Contabilidade ainda têm estruturas de host necessárias ausentes nessa instalação. As suas provas em outras composições não equivalem à entrega no mesmo SGF.
- Stock tem leitura e relatório integrados, mas faltam comandos/interfaces SGF obrigatórios e partes do percurso de transferência. Uma tabela ausente no host não é presumida ausente do livro nativo de Stock/Compras.
- Menus de Stock e Contabilidade ainda incluem descrições e catálogos de funcionalidades por implementar; isso tem de ser resolvido com operações/consultas efectivas, não com outra página informativa.

Estado honesto: **SGF ainda não pronto para apresentação comercial completa**. A conferência é um inventário mínimo de estruturas e fonte, não uma instalação/migração aprovada ou teste funcional dos seis módulos. A primeira projecção provisória tinha três nomes de tabela e uma referência de prova incorrectos; foi corrigida contra o código antes de ser usada como diagnóstico. Só a versão final acima é válida.

## Ordem de fecho

Actualização de10/11/2026:70 tabelas de composição instaladas na mesma8085, com backup e preservação comparada de dados/sequências/permissões/associações. Guardas de Comercial/Oficinas/custos/recebíveis preparadas com identidade QA exacta e flag desligada; código Stock instalado inactivo, agora também com contagem/aplicação de diferença/equipamento. A [prova consolidada](proofs/sgf-six-module-composition-20261110.json) reúne ensaios dirigidos e consultas HTTP ao percurso existente. Não há novos acessos nem efeitos financeiros na8085. A [decisão de disponibilização](SGF_8085_NEXT_AUTHORIZATION.md) apresenta os perfis sintéticos e a continuação financeira excluída da aprovação anterior. O inventário de host agora só sinaliza Financeiro/Contabilidade; não se copiará dívida nativa para eliminar um aviso de tabelas ausentes.

1. **Composição única:** preparar o plano exacto de schema/configurações/guardas e perfis sintéticos para os seis módulos, preservando dados anteriores. Confrontar as estruturas já existentes; não executar migrations globais nem mover responsabilidades/associações por inferência.
2. **Funcionalidades:** fechar lacunas dos próprios módulos, reutilizando os motores existentes. Não substituir conclusão funcional por filtros, benchmarks ou melhorias do conector SGC.
3. **Integração:** fechar Comercial→Financeiro→Contabilidade, Compras→Stock→Financeiro→Contabilidade e Oficinas→Stock→Custos→Comercial/Contabilidade, com revisão individual e fonte única.
4. **Produto apresentável:** rever visual/navegação, erros, formulários, continuidade, relatórios e guião; testar o arranque/recuperação da mesma instalação. Não presumir revisão visual a partir de DOM simulado.
5. **Aceitação integral:** um percurso demonstrável dos seis módulos na mesma instalação e um relatório consolidado de limitações reais. Corrigir as falhas detectadas antes de declarar pronto.

O contrato é de fecho, não uma autorização para aumentar o escopo indefinidamente. Capacidades adicionais propostas devem ser identificadas separadamente, sem reabrir decisões aceites ou produzir nova demonstração por incremento.

## Verificação de entrega

```powershell
& 'C:/laragon/tools/sgf-tempo/node-v24.22.1-win-arm64/node.exe' scripts/check-sgf-solution.mjs
```

O comando lê apenas metadados do destino conhecido e termina com código2 enquanto a aceitação integral estiver ausente/incompleta. Uma captura de inventário pode ser escrita em ficheiro novo, mas não significa aprovação. O fecho exige `docs/proofs/sgf-single-solution-acceptance.json`, ligado ao hash deste contrato, aos seis módulos/funcionalidades e a todos os critérios na instalação escolhida; a existência do ficheiro ou de tabelas não basta isoladamente.

O [roteiro histórico](MODULE_IMPLEMENTATION_AUDIT.md), as aceitações e provas anteriores ficam preservados como evidência de componentes. Os seis registos, cache bloqueada, direitos reais e trabalho alheio continuam protegidos. Não houve activação, publicação, novo servidor/base/demonstração, concessão ou checkpoint nesta definição de entrega.