Integrate monthly IVA with projected sales in QA

This commit is contained in:
2026-10-21 14:05:46 +02:00
parent 0d7b70459d
commit 3f5430c3ce
18 changed files with 690 additions and 12 deletions
@@ -1231,5 +1231,287 @@
"main_integrated": false,
"homologation_rule_changed": false,
"legal_coverage_expanded": false
},
"monthly_iva_projection_qa_20261021": {
"branch": "codex/iva-monthly-projection-QA",
"status": "candidate_verified_in_isolated_QA_only",
"source": "existing monthly product sales; saved constant cashflow revenue only when no business plan exists",
"basis": "explicit net/included/unknown; only net calculated; no silent conversion",
"selection": "published version selected by server; frozen at admission; same resolver/evaluator",
"cash_treatment": "separate IVA memorandum; declared receipts/payments unchanged; not cost, no inferred collection or final settlement",
"manual_tax": "custom planning only; never input into monthly IVA",
"unknown_vs_zero": "missing month indeterminate; explicit zero calculated as zero; aggregate indeterminate if any month unknown",
"tests": {
"api_tests": 3,
"api_assertions": 46,
"frontend_tests": 4,
"types": "passed",
"build": "passed",
"pint": "passed",
"accepted_calculation_and_exporter_proofs": "reused, not repeated"
},
"qa_fixture": {
"database": "simulator_fiscal_delta_20261021_test",
"rule_id": "01a15e50-7972-72e0-8991-82ca28df9b49",
"rule_version": 4,
"consumer_enabled": true,
"synthetic": true,
"left_available_for_review": true,
"draft_id": "e0201d19-286e-4d5c-9585-2c1e3bd1ad1e"
},
"live_history": [
{
"id": "06566910-9672-4176-804d-aad8350417cb",
"status": "completed",
"created_at": "2026-10-21T11:57:11.000000Z",
"basis": "net",
"rows": [
{
"vat": "160.0048",
"date": "2026-01-01",
"rate": "16",
"status": "calculated",
"rule_id": "01a15e50-7972-72e0-8991-82ca28df9b49",
"net_sales": "1000.03",
"gross_sales": "1160.0348",
"rule_version": 4,
"sales_declared": "1000.03"
},
{
"vat": "320.0096",
"date": "2026-02-01",
"rate": "16",
"status": "calculated",
"rule_id": "01a15e50-7972-72e0-8991-82ca28df9b49",
"net_sales": "2000.06",
"gross_sales": "2320.0696",
"rule_version": 4,
"sales_declared": "2000.06"
},
{
"vat": "0",
"date": "2026-03-01",
"rate": "16",
"status": "calculated",
"rule_id": "01a15e50-7972-72e0-8991-82ca28df9b49",
"net_sales": "0.00",
"gross_sales": "0",
"rule_version": 4,
"sales_declared": "0.00"
},
{
"vat": null,
"date": "2026-04-01",
"rate": null,
"status": "missing_sales",
"rule_id": "01a15e50-7972-72e0-8991-82ca28df9b49",
"net_sales": null,
"gross_sales": null,
"rule_version": 4,
"sales_declared": null
}
],
"total": null,
"reports": [
{
"id": "42b95158-6c4c-43c6-801d-28e973a087a6",
"same_snapshot": true,
"sha256": "b6d10565f82f7e83952fbdbb15a357ca3a7fee550e53c80a0ef5b9e314ccfa68"
}
]
},
{
"id": "098900ed-2f5f-4141-98c8-08f892912a5b",
"status": "completed",
"created_at": "2026-10-21T11:57:34.000000Z",
"basis": "net",
"rows": [
{
"vat": "480.0144",
"date": "2026-01-01",
"rate": "16",
"status": "calculated",
"rule_id": "01a15e50-7972-72e0-8991-82ca28df9b49",
"net_sales": "3000.09",
"gross_sales": "3480.1044",
"rule_version": 4,
"sales_declared": "3000.09"
},
{
"vat": "320.0096",
"date": "2026-02-01",
"rate": "16",
"status": "calculated",
"rule_id": "01a15e50-7972-72e0-8991-82ca28df9b49",
"net_sales": "2000.06",
"gross_sales": "2320.0696",
"rule_version": 4,
"sales_declared": "2000.06"
},
{
"vat": "0",
"date": "2026-03-01",
"rate": "16",
"status": "calculated",
"rule_id": "01a15e50-7972-72e0-8991-82ca28df9b49",
"net_sales": "0.00",
"gross_sales": "0",
"rule_version": 4,
"sales_declared": "0.00"
},
{
"vat": null,
"date": "2026-04-01",
"rate": null,
"status": "missing_sales",
"rule_id": "01a15e50-7972-72e0-8991-82ca28df9b49",
"net_sales": null,
"gross_sales": null,
"rule_version": 4,
"sales_declared": null
}
],
"total": null,
"reports": [
{
"id": "44211195-0a53-4f4c-93ef-6ff0e439082b",
"same_snapshot": true,
"sha256": "5de00868029b7a688585e180bcd8fbef1e46e289b19ab766c58f7406fb2af972"
}
]
},
{
"id": "96eec0d8-effa-4286-b465-6af50f756db4",
"status": "completed",
"created_at": "2026-10-21T11:58:35.000000Z",
"basis": "included",
"rows": [
{
"vat": null,
"date": "2026-01-01",
"rate": null,
"status": "unsupported_basis",
"rule_id": "01a15e50-7972-72e0-8991-82ca28df9b49",
"net_sales": null,
"gross_sales": null,
"rule_version": 4,
"sales_declared": "3000.09"
},
{
"vat": null,
"date": "2026-02-01",
"rate": null,
"status": "unsupported_basis",
"rule_id": "01a15e50-7972-72e0-8991-82ca28df9b49",
"net_sales": null,
"gross_sales": null,
"rule_version": 4,
"sales_declared": "2000.06"
},
{
"vat": null,
"date": "2026-03-01",
"rate": null,
"status": "unsupported_basis",
"rule_id": "01a15e50-7972-72e0-8991-82ca28df9b49",
"net_sales": null,
"gross_sales": null,
"rule_version": 4,
"sales_declared": "0.00"
},
{
"vat": null,
"date": "2026-04-01",
"rate": null,
"status": "missing_sales",
"rule_id": "01a15e50-7972-72e0-8991-82ca28df9b49",
"net_sales": null,
"gross_sales": null,
"rule_version": 4,
"sales_declared": null
}
],
"total": null,
"reports": [
{
"id": "821e6347-680c-4029-9756-c3169d79f85e",
"same_snapshot": true,
"sha256": "06abadc593e65cfff64d208fac6cac3a8f98db4bef92795a27ce637fe7958cec"
}
]
},
{
"id": "e88aaaea-4482-4b7d-869f-f0648a430651",
"status": "completed",
"created_at": "2026-10-21T12:00:32.000000Z",
"basis": "net",
"rows": [
{
"vat": "480.0144",
"date": "2026-01-01",
"rate": "16",
"status": "calculated",
"rule_id": "01a15e50-7972-72e0-8991-82ca28df9b49",
"net_sales": "3000.09",
"gross_sales": "3480.1044",
"rule_version": 4,
"sales_declared": "3000.09"
},
{
"vat": "320.0096",
"date": "2026-02-01",
"rate": "16",
"status": "calculated",
"rule_id": "01a15e50-7972-72e0-8991-82ca28df9b49",
"net_sales": "2000.06",
"gross_sales": "2320.0696",
"rule_version": 4,
"sales_declared": "2000.06"
},
{
"vat": "0",
"date": "2026-03-01",
"rate": "16",
"status": "calculated",
"rule_id": "01a15e50-7972-72e0-8991-82ca28df9b49",
"net_sales": "0.00",
"gross_sales": "0",
"rule_version": 4,
"sales_declared": "0.00"
},
{
"vat": null,
"date": "2026-04-01",
"rate": null,
"status": "missing_sales",
"rule_id": "01a15e50-7972-72e0-8991-82ca28df9b49",
"net_sales": null,
"gross_sales": null,
"rule_version": 4,
"sales_declared": null
}
],
"total": null,
"reports": [
{
"id": "bc204cc7-1f0c-4468-80fa-e093642a5eac",
"same_snapshot": true,
"sha256": "4ed224f7de50b533f144f7f411d240eb1ccca6f3e5bff7a64b1eca6f6d7971dc"
}
]
}
],
"main_integrated": false,
"homologation_changed": false,
"rule_publication_on_destination": false,
"coverage_expanded": false,
"limitations": [
"IVA included prices unsupported in current net lot",
"2026 only, max 12 consecutive months",
"no final payable, deductions, refunds, special/reduced/exempt regimes",
"examples prove arithmetic/integration, not legal eligibility of every transaction"
],
"remaining": "Tempo review/decision for code integration; no further generic preparation identified; keep real rule/publication/activation separate",
"proof_directory": "outputs/simulator-continuation-20261020"
}
}
@@ -1980,3 +1980,26 @@ As notas aparecem junto dos campos e num resumo com ligações que focam o campo
No Edge, simulador normal QA em127.0.0.1:18580: consulta anual2026, operação genérica explicitamente escolhida para o ensaio; moeda inicialmente vazia, depoisUSD escolhido expressamente como caso dirigido. Confirmaram-se notas, resumo, foco em «Rever moeda»/«Rever operação», fundamento da versão sintética3, eUSD/ano/periodicidade/operação conservados após gravação e recuperação do mesmo rascunho. A captura de prova é um ensaioUSD, não evidência deUSD no caso original. Não se executou cálculo nem se exportou relatório. A fixture publicada apenas emQA para observar o diagnóstico foi depois suspensa; o consumidorQA permaneceu desligado. Nenhuma fixture foi importada, regra alterada ou consumidor activado na homologação nesta correcção.
Provas privadas na pasta `outputs/simulator-continuation-20261020`: iva-diagnostic-api-test.txt, iva-diagnostic-summary.txt, iva-diagnostic-summary.png e iva-diagnostic-build-final.txt. O reciboJSON existente tem o estado detalhado. A candidata permanece na branch `codex/iva-diagnostics-QA`, separada de main; não é uma nova publicação fiscal nem altera a entrega autorizada anteriormente.
### IVA mensal ligado às vendas — candidata QA, 21/10/2026
Pedido da Tempo: o formulário recolhe pressupostos do negócio e calcula o IVA correspondente, sem repetir vendas nem tomar o imposto manual como entrada fiscal. A falta de ligação entre a projecção empresarial e o consumidor publicado era uma escolha de implementação; não uma nova obrigação do utilizador. Alteração na branch `codex/iva-monthly-projection-QA`, separada de main. Não altera a instalação, regra ou activação da homologação.
**Ligação:** o simulador normal reutiliza quantidades e preços por produto/mês do plano empresarial, com a mesma representação monetária das vendas já usada nesse plano. Se não existir plano, admite a receita mensal constante já guardada na projecção personalizada, identificando essa origem e exigindo declaração do enquadramento. Não usa os valores demonstrativos de um widget ainda não guardado. A indicação sem IVA/com IVA incluído fica explícita, sem a presumir. Neste lote só a base líquida declarada permite calcular: preços com IVA incluído, base desconhecida e meses sem vendas informadas permanecem indeterminados. Zero explícito calcula IVA zero; não se preenche um mês vazio com zero.
O cliente envia meses, vendas, moeda e declaração; não envia taxa, versão ou imposto manual. O servidor selecciona a versão publicada ligada ao consumidor e reutiliza o resolvedor temporal e avaliador decimal existentes em cada mês, dentro da mesma admissão transaccional. Nenhuma taxa foi fixada no formulário, nem introduzido arredondamento fiscal. A versão é congelada antes da fila; mantém-se a autorização/idempotência/histórico/relatório existentes. Sem migration ou reconstrução dos mecanismos. Cobertura permanece 2026, no máximo 12 meses consecutivos; um horizonte que atravessa o limite é explicado, sem truncar a projecção.
**Ecrã e dependências:** cada mês apresenta vendas declaradas, vendas tributáveis sem IVA, taxa efectivamente aplicada, IVA calculado e total com IVA. Após a primeira execução, a actualização automática fica ligada e pode ser pausada. Alterar vendas, moeda, período ou tratamento do IVA assinala imediatamente o resultado anterior como histórico desactualizado. A nova execução guarda outra versão sem modificar a anterior. Repetir sem alterações recupera a execução concluída; uma execução pendente é consultada pelo mesmo ID. Falhas conservam os pressupostos e permitem tentar novamente. O rascunho conserva configurações e resultado; o relatório distingue resultado actual e histórico desactualizado e não recalcula o IVA na exportação. Se algum mês estiver indeterminado, o total fiscal fica indeterminado, conservando os meses conhecidos.
**Tesouraria adoptada:** o IVA é um memorando fiscal separado; não se soma novamente aos recebimentos introduzidos, não se deduz como custo e não se apresenta como imposto final a pagar. Conserva-se o calendário de recebimentos/pagamentos declarado, sem inferir cobrança integral no mesmo mês nem liquidação fiscal. O imposto manual permanece exclusivamente no painel recolhido «Cenário personalizado de tesouraria — imposto manual, separado do IVA calculado», com rótulos de cenário personalizado. Não alimenta a base nem o resultado do consumidor IVA. Não foram acrescentados deduções, créditos, reembolsos, importações, isenções, taxas reduzidas ou regimes especiais ao cálculo fiscal; as hipóteses antigas de tesouraria continuam personalizadas e separadas.
**Provas apenas do delta:** 3 testes API novos/46 asserções, transacções no clone `simulator_fiscal_checks_20261021_test` com guarda QA; 4 testes frontend novos para reutilização das vendas, zero/informação em falta, invalidação e recuperação/relatório. Incluem taxa proibida no cliente, âmbito não declarado, preços brutos, período excluído, repetição sem duplicações, versão congelada antes da suspensão e conclusão depois dela. TypeScript/build/Pint/diff-check verificados. Reutilizadas as provas aceites do avaliador decimal, exportadores e PDF; não se voltou a testar paginação nem a ampliar cobertura legal.
**Percurso Edge no simulador normal:** dossier sintético privado «QA IVA mensal - vendas projectadas», ID `e0201d19-286e-4d5c-9585-2c1e3bd1ad1e`, QA127.0.0.1:18580. Vendas Janeiro1000.03/ Fevereiro2000.06/ Março0/ Abril vazio produziram IVA160.0048/320.0096/0/indeterminado. Alterar apenas a quantidade de Janeiro de1 para3 actualizou vendas3000.09, IVA480.0144 e total3480.1044. Assinalou-se resultado desactualizado durante a mudança. Seleccionar preços com IVA incluído conservou vendas e tornou base/IVA/total indeterminados; voltar manualmente à base líquida gerou nova execução. Após recarregar e recuperar o mesmo dossier, os valores permaneceram iguais e o fundamento mostrou a versão congelada. Quatro execuções mensais intencionais (inicial, venda alterada, base incluída, regresso à líquida), quatro relatórios com snapshots iguais às respectivas execuções; recuperação não criou a quinta. Não se atribui aplicabilidade fiscal universal a estes exemplos aritméticos.
A fixture sintética **v4**, ID `01a15e50-7972-72e0-8991-82ca28df9b49`, está publicada e o consumidor ligado **apenas no clone QA** `simulator_fiscal_delta_20261021_test`, deixados disponíveis para esta revisão. Isto substitui o estado local suspenso/off da prova diagnóstica anterior; não é indisponibilidade na homologação. Não importar esta fixture, os seus actores ou os scripts privados. A regra real de homologação v1 mantém-se fora desta execução.
**Revisão e disponibilização:** rever esta candidata QA e integrar somente o código autorizado, mantendo a ligação ao ID/versão reais do destino. Este delta não precisa de publicar outra regra nem de mudar a taxa/âmbito ou de reactivar um consumidor já activo. Conferir apenas revisão servida e ligação mensal no destino após autorização própria; conservar o procedimento separado de publicação e activação se alguma dessas operações vier a ser expressamente pedida. Suspender novas admissões pelo interruptor existente ou estado da regra preserva as já admitidas e os históricos. Não apagar snapshots para suspender ou reverter código. Sem integração em main, escrita activa, validação jurídica atribuída à Tempo ou nova ronda de preparação identificada nesta entrega QA.
Provas privadas em `outputs/simulator-continuation-20261020`: monthly-iva-api-test.txt, monthly-iva-build-final.txt, monthly-iva-initial.txt, monthly-iva-updated.txt, monthly-iva-stale.txt, monthly-iva-included.txt, monthly-iva-recovered.txt, monthly-iva-live-history.json e monthly-iva-proof.png. O recibo existente conserva o saldo e os IDs; AUD-SIM-INT02 da matriz existente recebe esta referência, sem outra matriz/backlog.
File diff suppressed because one or more lines are too long