This commit is contained in:
@@ -87,6 +87,8 @@ As15–26h anteriores eram condicionais e incluíam o trabalho de cadastro e int
|
||||
|
||||
## Revisão consolidada de83d2f97d
|
||||
|
||||
**Actualização técnica de21/10/2026 — delta2ced7b79 implementado em QA:** o consumidor por versão publicada está ligado ao simulador normal, com activação desligada por omissão, selecção da regra no servidor e gravação/recuperação/relatório pelo histórico existente. O mesmo manual regista a demonstração pelo Edge, indeterminação sem declaração de âmbito, repetição sem duplicação, suspensão antes do processamento da fila, conclusão com versão congelada e recusa de novas execuções. Oito testes dirigidos/75asserções e dois testes frontend novos passaram, além deTypeScript/build/Pint. Mantêm-se integralmente o âmbito2026, exclusões, fontes e precisão desta ficha; não se repete a fundamentação jurídica nem se lhe atribui validação da Tempo. O procedimento único foi actualizado para integração, publicação da versão real e activação, decisões ainda não executadas na homologação. A fixture publicada exclusivamente no clone QA foi suspensa após o ensaio; os históricos foram preservados. As notas abaixo sobre ausência do consumidor descrevem o estado anterior à implementação deste delta.
|
||||
|
||||
**Disponibilização no simulador existente:** a proposta única «Consumidor IVA no simulador da homologação», no mesmo manual, delimita o código ainda necessário e as três operações distintas: integração com consumidor desligado, publicação da versão pela governação existente e activação da ligação à versão autorizada. O percurso QA aceite não equivale a esse consumidor público. Mantêm-se âmbito2026, exclusões, precisão exacta e históricos; suspensão impede novas admissões e preserva execuções já admitidas. Esta proposta não executa nenhuma das três operações nem amplia a cobertura fiscal.
|
||||
|
||||
O [mesmo manual de rastreabilidade](../unification/traceability-and-manual.md) consolida âmbito/período, operações excluídas/indeterminadas e os procedimentos concretos de integração, publicação, activação e desactivação, preservando históricos. Identifica também que83d2f97d não contém um consumidor fiscal público: a publicação torna parâmetros elegíveis na API existente, mas não transforma o percurso QA em cálculo público activado.
|
||||
|
||||
@@ -484,5 +484,109 @@
|
||||
"consumer_activation": false,
|
||||
"user_legal_validation": false,
|
||||
"record": "docs/investmoz/unification/traceability-and-manual.md: Proposta unica - consumidor IVA"
|
||||
},
|
||||
"published_consumer_qa_20261021": {
|
||||
"proposal_base": "2ced7b79",
|
||||
"status": "Implemented and demonstrated in normal QA simulator; separate integration/publication/activation decisions pending",
|
||||
"consumer_default_enabled": false,
|
||||
"scope": "IVA general net taxable base, declared internal general operation, MZN, exigibility 2026 only",
|
||||
"feature_tests": {
|
||||
"passed": 8,
|
||||
"assertions": 75,
|
||||
"isolated_database": "simulator_fiscal_checks_20261021_test",
|
||||
"rls_non_superuser": true,
|
||||
"separate_connection_lock_probe": true
|
||||
},
|
||||
"frontend_new_link_tests_passed": 2,
|
||||
"typescript": "passed",
|
||||
"build": "passed",
|
||||
"pint": "passed",
|
||||
"accepted_evidence_reused": [
|
||||
"decimal calculation",
|
||||
"exporters",
|
||||
"native PDF pagination",
|
||||
"financial planning and recovery"
|
||||
],
|
||||
"normal_simulator_browser_journey": {
|
||||
"database": "simulator_fiscal_delta_20261021_test",
|
||||
"url": "http://127.0.0.1:18580/simulador-fiscal",
|
||||
"fixture_only": true,
|
||||
"user_id": 167,
|
||||
"rule_id": "01a15ddc-b0c5-727f-bb24-d806a69bd1f5",
|
||||
"rule_status": "suspended",
|
||||
"suspended_at": "2026-10-21T09:52:16.000000Z",
|
||||
"executions": [
|
||||
{
|
||||
"id": "53663785-2e5d-4be2-8a05-c0c96a57896d",
|
||||
"status": "completed",
|
||||
"base": "1000.03",
|
||||
"value": null,
|
||||
"result_status": "indeterminate",
|
||||
"scope_status": "undetermined",
|
||||
"admitted_at": "2026-10-21T09:50:53.949756Z",
|
||||
"frozen_rule_status": "published",
|
||||
"rule_id": "01a15ddc-b0c5-727f-bb24-d806a69bd1f5",
|
||||
"rule_version": 2,
|
||||
"report_id": "63d427ac-e6ae-481c-adad-e5f39fcc3c15",
|
||||
"report_sha256": "d405705f6ce050518a0b400bed842b2aeaec143af3d78c54088100417d326c64",
|
||||
"result_report_hash_equal": true
|
||||
},
|
||||
{
|
||||
"id": "5fa778f1-413e-4643-8c67-1b93ab290da7",
|
||||
"status": "completed",
|
||||
"base": "1000.03",
|
||||
"value": "160.0048",
|
||||
"result_status": "calculated",
|
||||
"scope_status": "user_declared",
|
||||
"admitted_at": "2026-10-21T09:51:11.307106Z",
|
||||
"frozen_rule_status": "published",
|
||||
"rule_id": "01a15ddc-b0c5-727f-bb24-d806a69bd1f5",
|
||||
"rule_version": 2,
|
||||
"report_id": "533b60df-ce44-40fd-9911-c7ed492dbd7e",
|
||||
"report_sha256": "2c5cc798c06920aee0707465ab8b7fee517783db24939b3921c76a70999dad77",
|
||||
"result_report_hash_equal": true
|
||||
},
|
||||
{
|
||||
"id": "be1e8399-ea95-4aa7-9ac0-7fa392932ac1",
|
||||
"status": "completed",
|
||||
"base": "1001.03",
|
||||
"value": "160.1648",
|
||||
"result_status": "calculated",
|
||||
"scope_status": "user_declared",
|
||||
"admitted_at": "2026-10-21T09:52:11.782758Z",
|
||||
"frozen_rule_status": "published",
|
||||
"rule_id": "01a15ddc-b0c5-727f-bb24-d806a69bd1f5",
|
||||
"rule_version": 2,
|
||||
"report_id": "5e416a48-db07-449b-8eae-aa51a1538f04",
|
||||
"report_sha256": "997f026665e586c662ae574fd2ff7f62e0254819adb26aea920575e47e0490a3",
|
||||
"result_report_hash_equal": true
|
||||
}
|
||||
],
|
||||
"execution_count": 3,
|
||||
"pending_queue_records": 0,
|
||||
"main_integration": false,
|
||||
"homologation_publication_or_activation": false
|
||||
},
|
||||
"observed": [
|
||||
"initial disabled consumer",
|
||||
"insufficient scope persisted as indeterminate",
|
||||
"declared scope calculated through published server binding",
|
||||
"repeat without duplicate",
|
||||
"database queue admitted before suspension and processed after suspension",
|
||||
"new input refused with values preserved",
|
||||
"hard reload and history recovery of calculated and indeterminate snapshots",
|
||||
"CSV control enabled without rerunning download"
|
||||
],
|
||||
"final_qa_fixture_status": "suspended",
|
||||
"final_qa_switch_enabled": false,
|
||||
"historical_records_preserved": true,
|
||||
"main_local_head": "13f68f1b",
|
||||
"main_integration": false,
|
||||
"homologation_rule_publication": false,
|
||||
"homologation_consumer_activation": false,
|
||||
"user_legal_validation": false,
|
||||
"user_local_file_review": false,
|
||||
"procedure": "Existing manual: Procedimento unico das tres operacoes - agora executavel apos decisao",
|
||||
"proofs_private": true
|
||||
}
|
||||
}
|
||||
|
||||
@@ -1864,3 +1864,43 @@ Excluem-se preço com IVA incluído, taxas reduzidas, isenções/listas, bases e
|
||||
Históricos não são recalculados, apagados ou renomeados como se tivessem usado a versão nova. A suspensão fica no registo de governação, sem alterar retroactivamente o conteúdo/hash do relatório. Retoma exige versão publicada elegível e ligação/activação autorizada; não existe transição directa de suspended parapublished no fluxo actual. Não eliminar a leitura de snapshots fiscais ao reverter código.
|
||||
|
||||
**Verificação nova estritamente necessária:** contrato público e permissões existentes; impossibilidade de executar desligado ou com versão não publicada; correspondência temporal/âmbito e precisão na ligação; cenário publicado na interface/histórico/relatório/exportação; suspensão versus admissão concorrente e repetição sem duplicação; preservação da leitura histórica e do modo personalizado. Não repetir as10páginas, valores/CSV ou ensaios QA aceites. Não se cria nova matriz/backlog; AUD-SIM-INT02 conserva o estado parcial do simulador fiscal integral e referencia esta delimitação. As fontes e provas existentes sustentam a proposta; não se atribui ao utilizador conferência local ou validação jurídica.
|
||||
|
||||
### Consumidor publicado implementado no simulador normal — fecho QA de21/10/2026
|
||||
|
||||
**Autorização:** instrução expressa da Tempo para implementar2ced7b79 em QA, sem nova proposta, integração emmain, publicação de regra real ou activação na homologação. O delta descrito acima está agora implementado. O fecho é da ligação deste único consumidor; mantém âmbito/exclusões da ficha v1.2 e não encerra o simulador fiscal integral.
|
||||
|
||||
**Percurso utilizável:** `/simulador-fiscal` → percurso habitual → etapa «Operação fiscal» → «IVA geral sobre base líquida» → base decimal textual, moeda explicitamente seleccionada, exigibilidade e declaração de contexto → «Calcular IVA e gravar». O resultado aparece no próprio simulador e no histórico existente. Pode recuperar-se sem recalcular; relatório, referência/hash e exportações usam o mesmo snapshot. Não é necessário acesso à administração fiscal para calcular. A consulta de parâmetros e o planeamento personalizado conservam os seus percursos e rótulos próprios. A base de orçamento e a taxa manual não são usadas como entradas implícitas deste IVA.
|
||||
|
||||
#### Implementação e fronteiras efectivas
|
||||
|
||||
- `StoreSimulationRequest` e `SimulationController::store` distinguem `fiscal_rule_published` do planeamento. O servidor recebe apenas entradas declaradas, não taxa/regra/versão/snapshot executável fornecidos pelo cliente; valida formato decimal textual, MZN, data e contexto. Falta de declaração de enquadramento grava indeterminação com valor nulo, nunca zero. Campos inválidos/período fora2026 são recusados com mensagens portuguesas e entradas preservadas.
|
||||
- `SimulationPublishedFiscal` selecciona o ID/versão configurado no servidor, exige estado publicado e âmbito do lote, reutiliza `SimulationTaxParameterResolver` e `SimulationTaxRuleExpression`, e congela a proveniência antes da fila. `SimulationFiscalSnapshot` partilha a representação decimal com o adaptador QA, cujas guardas não foram removidas. Não há regra fiscal activada por importação ou arranque.
|
||||
- `SimulationExecution` consulta a chave idempotente antes de verificar nova admissão. Assim, desligamento/suspensão não impedem recuperar o mesmo pedido já admitido. Nova chave exige consumidor ligado e versão publicada elegível; mudar entradas com a mesma chave dá conflito. A interface conserva a chave do pedido fiscal concluído para que repetir o mesmo cálculo não crie uma execução adicional. Novas entradas produzem nova chave/execução.
|
||||
- Bloqueios consultivos transaccionais partilhados na admissão e exclusivos nas transições de governação/fonte serializam suspensão/revogação e admissão. Não se usa `SELECT FOR SHARE` na regra pública: poderia exigir uma política de alteração, contrariando as permissões existentes. A decisão de usar bloqueios consultivos é escolha de implementação, não nova exigência da Tempo. Não se alteraram políticas/grants nem se acrescentaram papéis de produto.
|
||||
- `RunSimulation` processa o snapshot fiscal já admitido, sem resolver outra taxa/versão e sem reconsultar a activação. Guarda resultado, relatório e proveniência nos modelos existentes. Notas internas de revisão e identificadores dos funcionários ficam fora da proveniência devolvida pelo novo consumidor. Snapshots QA antigos conservam os seus rótulos/estado originais.
|
||||
- O leitor de resultados do simulador foi adaptado ao contrato fiscal: o leitor aritmético anterior marcava o novo snapshot como inconsistente e desactivava exportação/conversão. Agora reconhece valor fiscal e indeterminação coerentes, e recusa divergência entre valor calculado e apresentação. CSV e dossier encaminham o novo tipo pelos componentes existentes; não se reescreveram os exportadores nem se repetiram provas aceites de paginação/valores.
|
||||
- Configuração nova e desligada por omissão: `INVESTMOZ_IVA_CONSUMER_ENABLED=false`, `INVESTMOZ_IVA_CONSUMER_RULE_ID=` e `INVESTMOZ_IVA_CONSUMER_RULE_VERSION=0`, documentadas em `.env.example`. `/api/v1/fiscal-consumer` informa a disponibilidade sem cache; o servidor continua a exigir autorização na execução, independentemente do estado previamente visto no ecrã. A interface actualiza disponibilidade após uma tentativa, preservando entradas quando encontra suspensão. Configuração incompleta não escolhe outra regra automaticamente.
|
||||
|
||||
#### Provas novas, sem reabrir o conjunto aceite
|
||||
|
||||
Oito testes dirigidos deAPI/serviço,75asserções, passaram no clone isolado `simulator_fiscal_checks_20261021_test`, com transacções revertidas: ligação publicada, identidade/propriedade, token anónimo, idempotência/conflito, histórico/relatório/hash, contexto/fonte insuficientes, contrato/cobertura, suspensão/desligamento e trabalhador congelado, planeamento ainda disponível, configuração inválida e bloqueios de admissão. Um papel PostgreSQL temporário sem superutilizador/bypassRLS comprovou execução com a política pública de leitura, sem acesso aos eventos da governação ou alteração da regra; papel/grants de ensaio foram revertidos com a transacção. Uma segunda ligação comprovou que os bloqueios exclusivos da regra/fonte não atravessam a transacção de admissão. Dois testes frontend dirigidos ao novo tipo publicado passaram: encaminhamento coerente para ecrã/CSV/dossier e aceitação da indeterminação/recusa da apresentação divergente. TypeScript, build ePint passaram. Aviso do build sobre optimização opcional de fontes/fontaine não impediu a compilação.
|
||||
|
||||
**Observação no Edge, formulário normal:** porta18580, clone `simulator_fiscal_delta_20261021_test`, conta sintética de utilizador comum167, sem papéis fiscais administrativos. A fixture publicada é a versão sintética2 de `IVA-GERAL-BASE-LIQUIDA`, ID`01a15ddc-b0c5-727f-bb24-d806a69bd1f5`, para não substituir o rascunho QA anterior; fonte/actores sintéticos só neste clone. A governação existente foi usada na preparação da fixture. Não houve publicação na homologação nem declaração de aprovação jurídica da regra real.
|
||||
|
||||
1. Observou-se inicialmente o consumidor desligado e o botão indisponível. Habilitou-se somente a fixture local guardada contra qualquer outra base.
|
||||
2. Base1000.03MZN, exigibilidade2026-10-21, sem declaração de contexto: execução`53663785-2e5d-4be2-8a05-c0c96a57896d`, resultado indeterminado, entradas conservadas e relatório guardado. A mesma base/data/moeda com declaração criou`5fa778f1-413e-4643-8c67-1b93ab290da7`, valor160.0048. Repetir o botão manteve essas duas execuções, sem terceira duplicada.
|
||||
3. Reteve-se somente a fila QA dedicada `fiscal-consumer-qa-20261021`. A base1001.03 admitiu`be1e8399-ea95-4aa7-9ac0-7fa392932ac1` às09:52:11.782758UTC. Suspendeu-se a fixture pela governação às09:52:16UTC, ainda com essa execução emqueued e snapshot publicado congelado. O trabalhador real `queue:work database --queue=fiscal-consumer-qa-20261021 --once --tries=1 --timeout=30` concluiu-a depois da suspensão, com160.1648 e a mesma versão2. Nenhuma outra fila foi consumida.
|
||||
4. Nova entrada1002.03 foi recusada: «A versão autorizada de IVA não está disponível para novas execuções. Os históricos foram preservados.» A base1002.03, data, moeda e declaração continuaram no ecrã; não houve quarta execução. Após recarga completa, recuperaram-se pelo histórico tanto o resultado calculado como o indeterminado. Ambos mostraram o snapshot original, sem alertas de inconsistência, com CSV disponível. O ficheiro não foi descarregado novamente; a implementação e as provas aceites do exportador foram reutilizadas.
|
||||
5. Conferência por leitura: exactamente3execuções da conta, todascompleted; hashes de resultado/relatório iguais nas três; zero trabalhos pendentes na fila dedicada. O relatório da execução que concluiu após suspensão é`5e416a48-db07-449b-8eae-aa51a1538f04`, SHA256`997f026665e586c662ae574fd2ff7f62e0254819adb26aea920575e47e0490a3`. A fixture permanece suspensa e a configuração local foi reposta emdesligado; os históricos ficam acessíveis.
|
||||
|
||||
Provas privadas em `outputs/simulator-continuation-20261020`: `published-consumer-tests.txt`, `published-consumer-journey-receipt.json`, `published-consumer-calculated-ui.txt/.png`, `published-consumer-suspended-ui.txt`, `published-consumer-recovered-ui.txt/.png` e `published-consumer-indeterminate-recovered-ui.txt`. O primeiro acesso ao separador antecedeu o arranque do servidor local e apresentou ligação recusada; após arranque normal prosseguiu-se. Não é evidência de falha do simulador. Não se repetiram as10páginas do PDF nativo nem o conjunto aceite de83d2f97d/13f68f1b. A aritmética do exemplo demonstra a ligação e preservação do resultado, não a aplicabilidade fiscal a qualquer operação.
|
||||
|
||||
#### Procedimento único das três operações — agora executável após decisão
|
||||
|
||||
1. **Integrar código:** a Tempo identifica a referência exacta desta candidata na branch `codex/simulator-integrated-review`. Integrar emmain apenas após decisão; o envio desencadeia disponibilização automática na homologação. Manter `INVESTMOZ_IVA_CONSUMER_ENABLED=false`; não executar fixture, comandoQA ou cadastro fiscal no deploy. Confirmar build servido e aplicação; aplicar o procedimento habitual de recarga da configuração e reinício de trabalhadores persistentes, se existirem, antes de activar o novo tipo de trabalho. Não há migration neste delta. A leitura dos snapshots deve permanecer em qualquer versão de reversão; desligar o consumidor é preferível a voltar a um build que desconheça os históricos novos.
|
||||
2. **Publicar versão real:** com autorização de escrita, backup/restauro confirmado e acção autenticada, reutilizar a fonte real aceite e os actores/papéis existentes. Cadastrar a versão fundamentada e usar `POST /api/v2/investment/admin/tax-rules/{id}/{action}`, com `version_no` e `evidence`, em `submit` → `review` → `approve` → `publish`. RegistarID e `rule_version` publicados. Não copiar a fixture/versão2/actoresUUID deste ensaio para homologação. Se a fonte já estiver cadastrada correctamente, reutilizá-la; não exigir nova certificação da credibilidade oficial. A publicação disponibiliza parâmetros naAPI existente, mas o consumidor continua desligado.
|
||||
3. **Activar consumidor:** por decisão específica da Tempo, preencher `INVESTMOZ_IVA_CONSUMER_RULE_ID=<ID real autorizado>` e `INVESTMOZ_IVA_CONSUMER_RULE_VERSION=<rule_version autorizada>`; só então definir `INVESTMOZ_IVA_CONSUMER_ENABLED=true`. Aplicar a configuração pelo procedimento operacional existente (`php artisan config:cache` quando se usar cache de configuração; recarregar processos persistentes conforme o alojamento). Confirmar `/api/v1/fiscal-consumer` e a etapa fiscal do simulador, registando decisão, commit/build, ID/versão e instante de exposição. Não usar `version_no` de concorrência como se fosse `rule_version`. O servidor recusa outra versão em vez de escolher a mais recente silenciosamente.
|
||||
|
||||
**Suspender/desactivar:** repor o interruptor emfalse e aplicar a configuração impede novas admissões; para retirar a elegibilidade da própria regra usar a transição existente `suspend`, com versão corrente/evidência e actor autorizado. Pedidos já admitidos concluem pelo snapshot; repetição idempotente recupera-os. Histórico/relatório/exportação continuam acessíveis sem novo cálculo, publicação ou activação. Retoma segue uma versão publicada elegível e activação explícita, nuncaSQL directo sobre o estado suspenso. A janela2026 mantém-se um limite de cobertura, não data de caducidade legal.
|
||||
|
||||
**Saldo:** ligação funcional do primeiro consumidor fechada em QA, pronta para revisão e decisão sobre as três operações; sem outra preparação genérica identificada. AUD-SIM-INT02 permanece parcial para cobertura fiscal integral. As estimativas anteriores não constituem horas ainda por executar deste delta já concluído. Main local continua em13f68f1b; sem merge/push, publicação real ou activação na homologação. A Tempo não conferiu os ficheiros locais nem validou juridicamente as fontes nesta execução.
|
||||
|
||||
File diff suppressed because one or more lines are too long
Reference in New Issue
Block a user