commit melhorias1

docs/sgf-invoice-preparation.md

@@ -0,0 +1,11 @@
+# Preparação do envio de rascunhos de factura para SGF8085
+
+Continuação autorizada: [ecrã/persistência auditados entregues](sgf-invoice-workspace.md). O texto abaixo conserva a preparação anterior; essas funcionalidades já foram implementadas, mas instalação e activação continuam pendentes.
+
+10/11/2026. Gateway de transporte preparado, **desligado** e sem integração automática no workflow actual. `config/sgf_invoice.php`: `enabled=false`, pacote/hashNULL e ligações vazias. Nenhuma conta, segredo, concessão, migração, listener, job ou rota de envio foi criada/activada; o piloto e os workflows existentes não foram executados.
+
+`app/Services/SgfInvoiceGateway.php` prepara um cliente portátil verificado por SHA256, com autenticação/empresa/função financeira/limites de manutenção revalidados antes de cada operação. Transporte Laravel sem redirects/retry automático, timeout15s e ligação3s. O pacote proposto está em `C:/laragon/www/sgf-tempo/packages/sgc-invoice-client/src/InvoiceClient.php`; não foi instalado ou configurado no SGC.
+
+O contrato aceita somente rascunho recebido **ainda não registado** e autoridade documental exclusiva SGF. Não reenviar modelos `Invoice` pendentes/validados/pagos nem transformar a dívida do SGC noutra responsabilidade em8085. A ligação de um rascunho autorizado à intenção durável, conferência/decisão e recibo necessita do ecrã/persistência próprios antes de utilização; não está implementada como fluxo do utilizador nesta preparação. Não há simulação de que a aprovação ocorreu por chamar uma função.
+
+[Contrato completo, pacote inactivo, provas e passos pendentes](C:/laragon/www/sgf-tempo/docs/SGC_8085_INTEGRATION_PREPARATION.md). Reutiliza o mesmo motor do SGF; não cria outro escritor de facturas, orçamento, stock, obrigações, pagamentos ou contabilidade. Documentos históricos e futuras contas/configurações reais continuam sujeitos a decisões explícitas.

docs/sgf-invoice-workspace.md

@@ -0,0 +1,11 @@
+# Rascunhos e envio auditado ao SGF
+
+10/11/2026. Ecrã `/facturas/envio-sgf`, serviço `SgfInvoiceDispatches` e migração `2026_11_10_000001_create_sgf_invoice_dispatches.php` implementados e provados, **sem instalação/activação no piloto**. `workspace_enabled=false`, transporte desligado e ligações vazias. A rota nativa de facturas só oferece o atalho quando a capacidade estiver autorizada/activa.
+
+Percurso: escolha de mapeamento explícito → rascunho versionado → prévia → decisão individual conservada antes da rede → factura pendente/recibo → recuperação da mesma intenção em falha. Reserva empresa/fornecedor/número bloqueia duplicação pelo writer nativo mesmo se a capacidade for desligada. Não se envia `Invoice` já registada, não se valida financeiramente a factura nem se cria dívida/pagamento/stock/orçamento paralelo.
+
+Duas tabelas novas guardam fonte/intenção/estado cifrado e eventos append-only com autor/data UTC/fundamento/antes/depois. Instalação da migração tem de ser exacta e aprovada; não executar migrations pendentes por inferência. Ficheiros/caches/fontes do piloto não foram limpos, migrados ou activados. Nenhum acesso real/MFA/política nativa foi alterado.
+
+20 casos únicos/142 asserções em SQLite em memória;14 verificações PostgreSQL entre duas aplicações/livros de regressão existentes, sem criar demonstrações. A concorrência produz uma decisão/envio e409 na segunda; resposta perdida após commit recupera o mesmo recibo. Tipos e compilação TSX privada passaram, Blade/HTTP testados. Visual, TCP em8085 e implantação não foram declarados.
+
+[Entrega completa, prova, pacote inactivo e passos de instalação/configuração](C:/laragon/www/sgf-tempo/docs/SGC_INVOICE_WORKSPACE_DELIVERY.md). A preparação de transporte anterior continua histórica; ecrã/persistência já não são lacunas deste bloco. Usar somente após aprovação da instalação/configuração/activação, sem criar outra demonstração.