Files
SGF/docs/SGF_MULTI_LINE_INVOICE_DELIVERY.md
T
2026-11-11 15:04:01 +02:00

69 lines
9.8 KiB
Markdown
Raw 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.
# Facturação multilinha integrada — entrega QA na8085
11/11/2026. Âmbito `SGF-MULTI-LINE-INVOICE-INTEGRATED-QA-v1`, expressamente autorizado. Código, interface e percurso efectivo entregues na instalação existente; sem novas demonstrações ou dependência do SGC. [Prova consolidada](proofs/sgf-multi-line-invoice-20261111.json). Não constitui aceitação, checkpoint, publicação ou conformidade fiscal real.
## Resultado utilizável
Em `/sgf`, módulo Comercial → Facturação → **Documento com várias linhas QA**: cabeçalho/cliente e dados documentais,1–25 linhas de serviços, pesquisa paginada, unidade/quantidade/preço e modalidade explícita, totais e diferenças, preparação auditada, cálculo conservado, revisão temporal distinta e emissão de teste/PDF. A configuração das séries permanece separada. O menu horizontal/dropdown aceite é preservado.
|Exemplo existente|Modalidade|Linhas|Base|Imposto QA|Total|Recebível em aberto|
|---|---|---|---:|---:|---:|---:|
|TEST-MULTI-2026/1|Acrescido|400+600|1000|160|1160|1160MZN|
|TEST-MULTI-2026/2|Incluído|464+696|1000|160|1160|1160MZN|
Dois recebíveis explicitamente preparados/revistos; nenhum pagamento, recebimento ou afectação. Duas origens explicitamente preparadas/revistas/aplicadas no mesmo diário em três linhas: D QA-CLIENTES1160 / C QA-VENDAS1000 / C QA-IMPOSTO-TESTE160. **29→31 lançamentos;24 contas intactas.** Não há emissão ou contabilização automática ao guardar/calcular.
Nova preparação/revisão de resultado interno parcial v5/v6, usando a mesma correspondência revista v4:24 contas de plano,23 com movimento,31 lançamentos; activos classificados5575, fornecedor100, rendimentos4586,21, gastos2300, subtotal conhecido2286,21MZN. Dez contas continuam por classificar; capital, resultado completo e balanço completo indeterminados. Os CSV/snapshots19/27 e23/29 mantêm os bytes anteriores. Conferência actual do período somente de leitura:44 factos, zero pendentes, débitos/créditos iguais; período aberto.
## Distribuição de funções sem novas concessões
Os22 nomes de direitos verificados não pertencem todos à mesma pessoa. A implementação conserva a distribuição efectiva:
- Comercial preparação QA8 prepara o rascunho, propõe a regra temporal e emite após revisão; não enumera o catálogo fiscal comum.
- Financeiro preparação QA13, no contexto Comercial explicitamente escolhido, conserva o cálculo com `fiscal_rules.prepare` e consulta a regra com `fiscal_rules.view`. Isto não concede ao Comercial o poder fiscal de13.
- Comercial revisão QA9 decide a versão temporal, com revalidação estritamente vinculada ao cálculo já conservado; não administra regras fiscais.
- Financeiro QA13/14 prepara/revê o recebível no módulo Financeiro.
- Contabilidade QA15/16 prepara/revê/aplica o lançamento no módulo Contabilidade. Consulta conserva os seus direitos existentes.
Nenhum direito, concessão, utilizador, perfil, conta contabilística ou role PostgreSQL novo. Os rascunhos conservam associação **Comercial**. `QualifiedInvoiceSource` permite a leitura qualificada da dependência tipada pelos módulos financeiros autorizados, sem acrescentar associações modulares. A API Comercial directa continua a exigir troca explícita de módulo; a consulta financeira usa o seu próprio percurso. Não introduzir atalhos que contornem essa guarda.
## Mecanismos e protecções
`MultiLineDrafts` compõe atomicamente os escritores originais de prestação, rascunho e preparação. Regista a origem dos novos rascunhos em `mi_drafts`; não adopta ou altera rascunhos antigos. Campos desconhecidos podem permanecer no rascunho; impedem cálculo/emissão em vez de assumir zero. Prévia é revertida; confirmação exige autor/contexto/versões/catálogos actuais e fundamento. Depois de emitida, esta origem não é editável pelo editor novo.
`MultiLineInvoiceCalculation` usa `FiscalRules::invoiceDocument` e o mesmo `FiscalDocumentMath`: truncatura por linha, base incluída=bruto−imposto documental e conservação das diferenças racionais. A captura vincula origem, preparação, unidades, modalidade, regra/vigência, data e identidade/poderes do preparador. Alterações invalidam conferências pendentes; uma recuperação de comando já concluído devolve o comprovativo histórico, sem revalidar uma emissão nova.
`MultiLineInvoiceIssuance` adapta apenas o novo tipo de captura ao **ServiceInvoicing original**, seu contador, eventos, PDF guardado e recibos. O ramo de uma linha mantém o seu contrato. `SalesLedgerSource` confere os totais documentais congelados pelo mesmo cálculo e fornece o mesmo escritor de vendas, sem outro diário. Prévia de emissão não atribui número nem cria dívida. Recibos novos são individuais, isolados e append-only. Catálogos novos têm SQL25/100; decisões da página são lidas conjuntamente. Não se declara que a listagem administrativa antiga passou a ser um registo universal paginado.
Nas operações novas, o bloqueio por empresa serializa confirmações; permissões são novamente conferidas após o bloqueio. O tratamento HTTP traduz espera excedida em503 com indicação para recuperar a mesma chave. A interface conserva pedido/chave quando o resultado é incerto e impede trocar origem/contexto em curso. A recuperação após recarregar a página depende do identificador original/comprovativo; não existe uma caixa de saída persistente nova no navegador.
## Provas dirigidas e reutilizadas
**143 verificações dirigidas,122 de preservação, concorrência separada e conferência de período somente de leitura.** Não somar as passagens iniciais substituídas. As suites alheias de Compras/Stock/RH/activos não foram repetidas.
|Prova final|Verificações|Cobertura|
|---|---:|---|
|Percurso financeiro na regressão|26|Acrescido/incluído,100 incluído86,21+13,79, PDF, recebível, três linhas GL e propriedade Comercial; rollback|
|Controlador|18|Direitos, campos protegidos, SQL25/100, decisões, recibos e unidade estrangeira; rollback|
|Fronteiras|20|Desconhecidos,1/25/26 linhas, identidade/poderes, regra retirada, versões e modalidade; rollback|
|Falha parcial|6|Falha após escritores originais/antes do recibo, rollback integral e recuperação única de rascunho; falha tardia da emissão desfaz contador/factura/PDF/evento/recibo; rollback|
|Interface|21|Handlers com API simulada, escolha explícita, totais, incerteza/mesma operação, revisão distinta/menu; não é navegador|
|HTTP8085|28|Percurso concluído, fotografias/PDF/SHA, permissões e ficheiros efectivamente servidos|
|Resultado interno parcial|12|Duas decisões novas, mesmas correspondências, saldos e exportações históricas|
|Leituras finais HTTP|12|Registo Comercial25/100, posições Financeiras2320, prazo desconhecido e origem/recibos exactos|
|Preservação|122|96 conjuntos originais, appends exactos, três bindings, PDFs anteriores, escritores antigos, contas/diário/período e ficheiros instalados|
Concorrência só na regressão existente: duas emissões com chaves distintas sobre o mesmo documento. A primeira retém a transacção; `pg_blocking_pids`/`pg_stat_activity` identificam a espera Lock/transactionid no bloqueio da empresa. A segunda recebe503 após **5,09s**. Libertada a primeira, a segunda recusa a conferência desactualizada com409; recuperar a primeira devolve200/replayed. Uma factura, um recibo de emissão e último número1. A fixture de concorrência fica identificada exclusivamente na regressão, sem recebível/GL: não é uma pendência da8085 nem deve ser usada para declarar fecho geral da regressão.
Os dois percursos8085 somam22 comandos guardados em progresso privado; mais dois de resultado interno. Não os repetir para apresentação. A retomada do ensaio HTTP reutilizou resultados/chaves conservados após corrigir no harness o endereço de comando GL e a consulta de documento no módulo indevido. Não foram criados documentos suplementares. O teste de período inicialmente procurava uma propriedade `balanced` inexistente: a observação válida foi reutilizada e compararam-se `debit_minor`/`credit_minor`, sem repetir a consulta ou fechar o período.
PDF máximo25linhas: amostra não emitida, cinco páginas renderizadas e inspeccionadas; texto legível, sem corte/colisão observado. O renderizador textual existente pode dividir a descrição de uma linha entre páginas; não é um modelo fiscal oficial nem revisão visual da aplicação. As capturas fornecidas orientaram os campos e percurso, sem importar dados pessoais ou copiar taxas como legislação.
## Preservação e limites
Todas as linhas anteriores dos96 conjuntos conferidos permanecem idênticas. Mantêm-se29 lançamentos originais,24 contas, seis versões/recibos de activos, custo1200/acumulado100/líquido1100, Caixa950, RH, Stock, Compras, permissões/utilizadores e três bindings. Novas escritas limitadas aos dois documentos e suas preparações/decisões/recebíveis/GL e resultado parcial autorizados. Os seis registos protegidos não foram escolhidos ou escritos; nenhum comando de limpeza de cache, migração geral, nova demonstração, publicação, SGC ou candidata de Compras foi executado.
A proposta de vencimento no rascunho não se converte automaticamente em condição do recebível: os dois prazos efectivos permanecem desconhecidos. O livro/mapa IVA anterior conserva quatro versões e não inclui estes documentos. Não presumir que a nova regra artificial16% é taxa legal, que este ciclo valida emissão real ou que foram implementados regimes mistos, isenções, descontos fiscais, artigos/famílias, POS ou Excel.
A instalação continua QA: revisão visual da aplicação, carga sustentada, armazenamento/recuperação operacional, fiscalidade/modelos legais e capacidade de implantação exigem evidência própria. A [matriz v30](integration/sgf-solution-contract.json) mantém `full_product_complete=false` e `client_presentable=false`.