fix: persist annual demonstration through existing simulation drafts

This commit is contained in:
2026-11-20 11:11:38 +02:00
parent 18dda022a0
commit 51d31d3790
9 changed files with 341 additions and 11 deletions
@@ -10391,3 +10391,9 @@ Vendas14.537, custos12.538, margem1.999 e folha2.100 reconciliam entre totais me
O diagnóstico inicial da fonte passou 14 testes. A conclusão de bloquear também o modelo criado pelo Codex foi revista após o proprietário exigir a sua correcção. O modelo anual editável passa a derivar recebíveis, obrigações operacionais, IVA de caixa e balanços dos mesmos dados: em 2025, obrigações 1.641,00 e capital 499.834,00 fecham activos 501.475,00; em 2027, recebíveis derivados são 771,00. Preservados os totais anuais. Não há rubrica de acerto nem financiamento confirmado inventado: os 1.825.250,00 por mobilizar são pressuposto explícito do balanço projectado, conservando disponível zero e aviso não bloqueante.
Consulta: abrir o cenário anual editável no simulador. Os três balanços e as distribuições mensais ilustrativas aparecem abaixo dos resultados. Meses usam perfil sazonal agregado, despesas fixas iguais e maiores restos em centavos; são projecções próprias, não recuperação dos meses da fonte. Montantes de IVA são editáveis; recebimentos/pagamentos inferiores ao IVA têm erro específico. Documentação detalhada e valores antes/depois no aditamento existente de apresentacao-contexto-qa-20261115.md. Referência original e histórico QA permanecem intactos e com pendências identificadas. Sem operações de base, instalação, publicação, migrações ou avanço à Etapa 2. Relatório integral continua NÃO APTO; esta correcção da Etapa 1 não constitui aceitação das onze tabelas.
### 20/11/2026 — persistência do cenário anual, encerramento ainda condicionado
O cenário anual passa a integrar o snapshot existente do plano como `annualExampleSnapshot`, identificado como demonstração sintética. Editar, aguardar a gravação do rascunho, recarregar e reabrir «Carregar cenário anual de exemplo» recupera os valores pela mesma sessão/conta e contexto. Sem sessão, o acesso depende do cookie no mesmo navegador; com conta, mantém a autorização do titular. Não cria tabelas, não substitui o plano real e não altera fórmulas financeiras. Estruturas desconhecidas são preservadas com erro de recuperação, sem substituição silenciosa.
Nove testes afectados aprovados, tipos/lint/build QA aprovados; HTTP real criou um rascunho de teste e recuperou o snapshot exactamente após novo carregamento, com 404 numa sessão sem cookie. As 92 provas financeiras anteriores não foram repetidas. QA confirmado no processo PHP em 127.0.0.3:18720. Conferência visual NÃO VERIFICADA nos dois formatos: host de navegador indisponível e controlo nativo sem geometria de entrada; não se considera o acesso inicial à página uma prova de edição/recuperação. A Etapa 1 permanece aberta apenas para essa conferência; sem Etapa 2 ou instalação. Detalhes e recibos no aditamento e pasta outputs/controlled-5f7db7cd-20261120 existentes.
@@ -631,3 +631,23 @@ O rótulo «Linhas mensais por reconciliar» continua a referir-se aos meses ori
**Âmbito:** correcção numérica da Etapa 1 demonstrada em testes; relatório integral continua NÃO APTO e instalação bloqueada. Não avançou a Etapa 2. A precisão interna e linhas omitidas do documento original continuam pendências documentais, sem bloquear esta correcção do modelo próprio.
**Verificação final:** 92 testes aprovados nas oito suites focadas (auditoria da fonte, integridade, cenário anual, interface do cenário, motor financeiro, edição, formulário e relatório do dossier). Incluem soma exacta dos meses, 36 balanços mensais e três anuais, edição de centavos, financiamento excedente, IVA recebido diferente do pago, rejeição de IVA superior à caixa e ausência de mutação dos dados. Tipos TypeScript e lint/formatação dos cinco ficheiros de aplicação/teste afectados aprovados. Compilação QA aprovada; persistem avisos existentes de dimensão dos chunks e dependência opcional de fontes. Conferência visual em navegador não executada nesta etapa; renderização dos componentes verificada pelos testes. Não foram executados testes de base de dados ou substituídos dados existentes. Evidências locais: outputs/controlled-5f7db7cd-20261120/reconciliation-tests.log e reconciliation-build.log.
### Encerramento controlado da Etapa 1 — persistência e conferência
Pedido posterior do proprietário: resolver apenas persistência e conferência visual. A demonstração passa a receber e devolver `annualExampleSnapshot` dentro do `business_plan_snapshot` já existente. O snapshot do exemplo tem versão 1 e identificação `synthetic-annual-example`; conserva rascunhos numéricos incompletos, rejeita estrutura/versão desconhecida, excesso de tamanho e campos estranhos. Se a recuperação falhar, apresenta erro sem sobrescrever o conteúdo guardado. As fórmulas e valores por omissão aprovados não foram alterados.
Não há tabela nem armazenamento paralelo: o callback do plano grava no rascunho do simulador, cuja cópia de sessão é segregada por conta e contexto/draft; a cópia do servidor usa o armazenamento cifrado e a autorização por titular ou cookie anónimo existentes. O cenário mantém identificação de dados sintéticos e projecções ilustrativas, separado dos dados reais e sem alimentar o cálculo do investimento. O limite existente de 60 KB do plano completo mantém-se. Sem sessão, a recuperação usa o mesmo navegador/cookie; não se promete acesso anónimo noutro dispositivo.
Endereço QA confirmado pela linha de execução do processo PHP: `-S 127.0.0.3:18720 -t public tools/continuity-qa-router.php`. O router exige a base isolada `continuity_20261120_test`, porta 55441. A navegação existente redirecciona `/simulador` para `/simulador-fiscal`; o último endereço também foi observado na janela Edge.
| Critério | Estado | Prova |
| --- | --- | --- |
| Gravar e recuperar edições | APROVADO | Callback real do componente → snapshot do plano → serialização da sessão e partição do rascunho → recuperação num componente novo; vendas editadas 14.537,25 conservadas. HTTP QA: POST 201, novo carregamento 200, GET current 200 e snapshot exactamente igual. |
| Isolamento e acesso | APROVADO no delta | Reutiliza serviço cifrado/autorizado sem alterações; GET do novo rascunho sem o cookie da sessão recebe 404. Nenhum dado existente substituído. |
| Reconciliação preservada | APROVADO | Resultado completo antes/depois da gravação idêntico, diferenças zero nos três anos e 36 meses do cenário editado; previsão do investimento real permanece idêntica. Não repetidos os 92 testes financeiros. |
| Computador | NÃO VERIFICADO | Janela QA e URL observados; após recarregar, a tentativa de actuar num índice antigo foi recusada. Renovada a árvore, o clique no campo actual falhou com `coordinate input geometry is unavailable`. Não foi possível editar/gravar/conferir o cenário visualmente. |
| Telemóvel | NÃO VERIFICADO | Host de navegador indisponível (`The browser access host is unavailable`); controlo nativo sem geometria de entrada, não permite concluir configuração e interacção num viewport móvel. Não se declara conferência responsiva. |
Nove testes novos/afectados dos ficheiros `business-plan-guidance-ui.test.mjs` e `business-plan-editing.test.mjs` aprovados, incluindo três regressões de persistência, isolamento do cálculo e protecção de recuperação. Tipos, lint/formatação e compilação QA aprovados. A primeira execução do teste HTTP falhou no cliente `fetch` do Node (assertion interna Undici `Parser.finish`, sem conclusão aplicável ao produto); repetição com o módulo HTTP nativo passou. A primeira execução de regressão usava uma fixture sem produto; corrigida a fixture para um plano válido, testes aprovados. Não se enfraqueceram verificações.
Provas locais em `outputs/controlled-5f7db7cd-20261120/`: `example-persistence-tests.log`, `example-persistence-build.log`, `example-persistence-http.mjs` e `example-persistence-http.json`. Cookies/credenciais não foram registados. O HTTP criou apenas um novo rascunho sintético de teste, sem reconstruir o QA anterior. Estado: persistência aprovada; encerramento da Etapa 1 pendente exclusivamente da conferência visual em computador e telemóvel. Relatório integral NÃO APTO; sem Etapa 2, instalação, publicação ou migrações.
File diff suppressed because one or more lines are too long
@@ -1,7 +1,8 @@
import { useState } from 'react';
import {
calculateAnnualReferencePlan,
newAnnualReferencePlan,
restoreAnnualExampleSnapshot,
serializeAnnualExampleSnapshot,
type AnnualReferencePlan,
} from '@/lib/business-plan-guidance';
import { businessPlanNumberError } from '@/lib/business-financial-plan';
@@ -59,10 +60,29 @@ function ExampleNumber({
</label>
);
}
export function SimulationAnnualExample({ currency }: { currency: string }) {
const [plan, setPlan] = useState<AnnualReferencePlan>(
newAnnualReferencePlan,
);
export function SimulationAnnualExample({
currency,
snapshot,
onSnapshotChange,
}: {
currency: string;
snapshot?: string;
onSnapshotChange?: (snapshot: string) => void;
}) {
const recovered = restoreAnnualExampleSnapshot(snapshot);
if (snapshot && !recovered)
return (
<p role="alert">
Não foi possível recuperar o cenário de exemplo. O conteúdo
guardado foi preservado; não será substituído.
</p>
);
const plan = recovered ?? newAnnualReferencePlan();
const setPlan = (
update: (previous: AnnualReferencePlan) => AnnualReferencePlan,
) => {
onSnapshotChange?.(serializeAnnualExampleSnapshot(update(plan)));
};
let result: ReturnType<typeof calculateAnnualReferencePlan> | undefined;
let error = '';
try {
@@ -89,10 +109,13 @@ export function SimulationAnnualExample({ currency }: { currency: string }) {
Cenário anual de exemplo — editável
</h4>
<p className="text-sm">
Valores fornecidos no plano de referência. Moeda de
apresentação: {currency || 'por seleccionar no plano'}. As
edições deste ensaio ficam nesta demonstração; os dados do
investimento continuam no seu formulário.
Dados sintéticos de demonstração, com totais do plano de
referência e projecções ilustrativas. Moeda de apresentação:{' '}
{currency || 'por seleccionar no plano'}. As edições deste
ensaio acompanham o rascunho do simulador numa secção separada.
Sem sessão, retome no mesmo navegador; com sessão autenticada,
utilize o rascunho da sua conta para retomar noutro dispositivo.
Estes valores não substituem os dados reais do investimento.
</p>
<p className="rounded border border-amber-400 p-3 text-sm">
Linhas mensais por reconciliar. Conservam-se os totais anuais
@@ -929,7 +929,15 @@ export function SimulationBusinessPlan({
? 'Fechar cenário de exemplo'
: 'Carregar cenário anual de exemplo'}
</button>
{showExample && <SimulationAnnualExample currency={currency} />}
{showExample && (
<SimulationAnnualExample
currency={currency}
snapshot={plan.annualExampleSnapshot}
onSnapshotChange={(annualExampleSnapshot) =>
savePlan({ ...plan, annualExampleSnapshot })
}
/>
)}
<div className="my-3 flex flex-wrap items-end gap-3 rounded border p-3">
<label className="grid gap-1 text-sm">
Importar plano financeiro InvestMoz (.json, até 60 KB)
@@ -82,6 +82,8 @@ function validCurrency(value: string): boolean {
}
export type BusinessFinancialPlanInput = {
/** Synthetic annual demonstration; excluded from investor forecast inputs. */
annualExampleSnapshot?: string;
currency: string;
annualGrowthPercent?: string;
presentationCurrency?: string;
@@ -201,6 +201,88 @@ export function newAnnualReferencePlan(): AnnualReferencePlan {
};
}
/** Preserve incomplete numeric drafts as entered, but accept only the example's schema. */
export function restoreAnnualExampleSnapshot(
snapshot?: string,
): AnnualReferencePlan | null {
if (!snapshot || snapshot.length > 12000) return null;
try {
const decoded = JSON.parse(snapshot);
if (
decoded.version !== 1 ||
decoded.kind !== 'synthetic-annual-example'
)
return null;
const plan = decoded.plan;
const template = newAnnualReferencePlan();
const numericDraft = (value: unknown) =>
typeof value === 'string' && value.length <= 40;
for (const key of [
'openingCash',
'otherCurrentAssets',
'longTermAssets',
'ownerCapital',
'investorCapital',
'loans',
'additionalMoney',
] as const)
if (!numericDraft(plan[key])) return null;
if (
!Array.isArray(plan.startupExpenses) ||
plan.startupExpenses.length !== template.startupExpenses.length ||
plan.startupExpenses.some(
(row: { label: unknown; amount: unknown }, i: number) =>
row.label !== template.startupExpenses[i].label ||
!numericDraft(row.amount),
)
)
return null;
if (
!Array.isArray(plan.years) ||
plan.years.length !== template.years.length ||
plan.years.some(
(row: Record<string, unknown>, i: number) =>
row.year !== template.years[i].year ||
Object.keys(template.years[i]).some(
(key) => key !== 'year' && !numericDraft(row[key]),
),
)
)
return null;
// Do not accept unrelated fields or investor data into this example.
if (
JSON.stringify(Object.keys(plan).sort()) !==
JSON.stringify(Object.keys(template).sort()) ||
plan.years.some(
(row: Record<string, unknown>, i: number) =>
JSON.stringify(Object.keys(row).sort()) !==
JSON.stringify(Object.keys(template.years[i]).sort()),
) ||
plan.startupExpenses.some(
(row: Record<string, unknown>) =>
Object.keys(row).sort().join(',') !== 'amount,label',
)
)
return null;
return plan as AnnualReferencePlan;
} catch {
return null;
}
}
export function serializeAnnualExampleSnapshot(
plan: AnnualReferencePlan,
): string {
const snapshot = JSON.stringify({
version: 1,
kind: 'synthetic-annual-example',
plan,
});
if (!restoreAnnualExampleSnapshot(snapshot))
throw new Error('Não foi possível guardar o cenário de exemplo.');
return snapshot;
}
function money(value: string): bigint {
if (value.length > 40 || !/^\d+(?:\.\d{1,2})?$/.test(value.trim()))
throw new Error(
@@ -6,6 +6,10 @@ import { compileFunction } from 'node:vm';
import ts from 'typescript';
import React from 'react';
import * as business from '../../resources/js/lib/business-financial-plan.ts';
import {
newAnnualReferencePlan,
serializeAnnualExampleSnapshot,
} from '../../resources/js/lib/business-plan-guidance.ts';
import * as contract from '../../resources/js/lib/simulation-contract.ts';
import * as bridge from '../../resources/js/lib/financial-fiscal-bridge.ts';
import { validateSimulationDraft } from '../../resources/js/lib/simulation-form.ts';
@@ -140,9 +144,40 @@ function editor(initialSnapshot) {
render();
},
snapshot: () => snapshot,
example() {
const toggle = walk(
tree,
(node) =>
node.type === 'button' &&
React.Children.toArray(node.props.children).some(
(child) =>
child === 'Carregar cenário anual de exemplo',
),
);
if (toggle) {
toggle.props.onClick();
render();
}
return walk(
tree,
(node) => typeof node.props?.onSnapshotChange === 'function',
)?.props;
},
};
}
void test('annual example snapshot is saved through the existing parent callback and recovered by a fresh editor', () => {
const form = editor();
const exampleSnapshot = serializeAnnualExampleSnapshot(
newAnnualReferencePlan(),
);
form.example().onSnapshotChange(exampleSnapshot);
const recovered = editor(form.snapshot());
assert.equal(recovered.example().snapshot, exampleSnapshot);
recovered.edit('Preço por unidade', '250.50');
assert.equal(recovered.example().snapshot, exampleSnapshot);
});
void test('monthly units, unit price, variable cost and operating expenses remain editable after snapshot echo', () => {
const form = editor();
for (const label of [
@@ -133,3 +133,157 @@ void test('annual example renders expected results and source gaps without block
assert.doesNotMatch(html, /role="alert"|aria-invalid="true"|disabled=/);
assert.match(html.replace(/[\s\u00a0\u202f]/g, ''), /1325000[.,]00/);
});
void test('annual example edits survive parent snapshot, draft storage, reload and reopening without changing investor forecast', async () => {
const form = await import('../../resources/js/lib/simulation-form.ts');
const { SimulationAnnualExample } = load('simulation-annual-example', {
'@/lib/business-plan-guidance': guidance,
'@/lib/business-financial-plan': business,
'./business-plan-warnings': { BusinessPlanWarnings: () => null },
});
const input = {
currency: 'MZN',
openingCash: '0',
assetInvestment: '0',
products: [
{
label: 'Serviço de teste',
monthlyUnits: '1',
unitPrice: '100',
unitVariableCost: '40',
},
],
...Object.fromEntries(
[
'monthlyCollections',
'monthlyVariableCostPayments',
'monthlyInventoryPurchases',
'monthlyOperatingExpenses',
'monthlyOperatingPayments',
'monthlyPayrollExpense',
'monthlyPayrollPayments',
'inventory',
'receivables',
'payables',
'equity',
'shareholderLoans',
'bankLoanProceeds',
'grants',
'assetDepreciation',
'monthlyInterestExpense',
'monthlyInterestPayment',
'monthlyPrincipalRepayment',
].map((key) => [key, '0']),
),
depreciationLifeMonths: 60,
periods: 12,
};
const investorBefore = business.forecastBusinessPlan(input);
let snapshot;
const render = () =>
SimulationAnnualExample({
currency: 'MZN',
snapshot,
onSnapshotChange: (value) => {
snapshot = value;
},
});
const field = (tree, label) =>
nodes(tree).find(
(node) =>
node.props?.label === label &&
typeof node.props.onChange === 'function',
);
field(render(), 'Vendas previstas').props.onChange('14537.25');
const edited = guidance.restoreAnnualExampleSnapshot(snapshot);
assert.equal(edited.years[0].sales, '14537.25');
const before = guidance.calculateAnnualReferencePlan(edited);
const saved = {
purpose: 'simulate_only',
business_plan_snapshot: business.serializeBusinessPlanSnapshot({
...input,
annualExampleSnapshot: snapshot,
}),
};
const browserCopy = JSON.parse(
JSON.stringify(form.getAutosaveSnapshot(saved)),
);
const serverCopy = JSON.parse(
JSON.stringify(form.partitionSimulationDraft(saved, false)),
);
for (const recoveredDraft of [
browserCopy,
form.restoreSimulationDraft(serverCopy.economic_snapshot, {}),
]) {
const investorPlan = business.restoreBusinessPlanSnapshot(
recoveredDraft.business_plan_snapshot,
);
assert.ok(investorPlan);
snapshot = investorPlan.annualExampleSnapshot;
assert.equal(
field(render(), 'Vendas previstas').props.value,
'14537.25',
);
const after = guidance.calculateAnnualReferencePlan(
guidance.restoreAnnualExampleSnapshot(snapshot),
);
assert.deepEqual(after, before);
assert.ok(
after.years.every(
(year) =>
year.balanceDifference === '0.00' &&
year.illustrativeMonths.every(
(month) => month.balanceDifference === '0.00',
),
),
);
assert.deepEqual(
business.forecastBusinessPlan(investorPlan),
investorBefore,
);
}
field(render(), 'Vendas previstas').props.onChange('');
assert.equal(
guidance.restoreAnnualExampleSnapshot(snapshot).years[0].sales,
'',
);
assert.equal(field(render(), 'Vendas previstas').props.value, '');
assert.throws(
() =>
guidance.calculateAnnualReferencePlan(
guidance.restoreAnnualExampleSnapshot(snapshot),
),
/Preencha/,
);
});
void test('annual example refuses unknown storage versions, extra investor fields and oversized snapshots without overwriting them', () => {
const valid = guidance.serializeAnnualExampleSnapshot(
guidance.newAnnualReferencePlan(),
);
for (const source of [
'{',
'x'.repeat(12001),
valid.replace('"version":1', '"version":2'),
valid.replace('"openingCash"', '"investorName"'),
]) {
assert.equal(guidance.restoreAnnualExampleSnapshot(source), null);
const { SimulationAnnualExample } = load('simulation-annual-example', {
'@/lib/business-plan-guidance': guidance,
'@/lib/business-financial-plan': business,
'./business-plan-warnings': { BusinessPlanWarnings: () => null },
});
let overwritten = false;
const html = renderToStaticMarkup(
SimulationAnnualExample({
currency: 'MZN',
snapshot: source,
onSnapshotChange: () => {
overwritten = true;
},
}),
);
assert.match(html, /conteúdo guardado foi preservado/);
assert.equal(overwritten, false);
}
});