fix(v12): clarify remaining financial diagnostics and preserve editable recovery

This commit is contained in:
2026-11-20 23:40:10 +02:00
parent f81306f1d6
commit 64601256d5
8 changed files with 325 additions and 17 deletions
@@ -1197,7 +1197,7 @@ Nomes de ficheiros na coluna de implementação referem-se a `resources/js/lib/`
| V09 | PN P0073–0087 | Validação financeira | Aplicar todas as mensagens literais definidas em todos os formulários e consumidores | IMPLEMENTADO MAS NÃO VALIDADO | business-financial-plan.ts:25–34; complementary-report.ts; integral-financial-plan.tsx | 04d8db6c;4fb9296f | Mensagens locais existem; não há prova de cobertura literal integral de percentagens, datas, caixa e divergências. Validação funcional não comprova todos os textos exigidos. |
| V10 | PN P0081 | Validação financeira | Campo de prazo em dias e mensagem de intervalo 0–365 | INTEGRADO E VALIDADO | financial-plan-details.tsx; business-financial-plan.ts; financial-plan-warnings.ts | 9c34af04;19f06ddf | Campo opcional de prazo contratual em dias, persistido no snapshot 18; inteiro entre 0 e 365, com mensagem pedida para -1, 366, 30.5 e abc. Mantém-se a agenda mensal independente. Dependência indispensável do aviso exacto de crédito V08, não uma alteração da fórmula de caixa. E8: limites 0/30/90/91/365, recuperação e comparação exacta dos fluxos antes/depois. |
| V11 | PN P0083 | Validação financeira | Aviso de caixa negativa identifica o mês e valor | APROVADO E ENCERRADO EM QA | financial-plan-warnings.ts; monthly-negative-cash-warnings.test.mjs; componentes e relatório existentes | fe615e55; E16; prova-v11-caixa-mensal-20261120.json | Aceitação expressa do proprietário com base no relatório E16 do commit fe615e55, sem inspecção independente dos ficheiros locais. Cinco avisos Janeiro–Maio 2027 (-1720.00/-1340.00/-960.00/-580.00/-200.00 MZN), apesar do fecho anual +2460.00; cenário sem défices sem avisos indevidos; gravação e recuperação demonstradas em computador e móvel 390×844; seis testes específicos aprovados. Fórmulas financeiras preservadas. Encerramento exclusivamente documental, sem repetir testes ou modificar código; instalação, publicação e migrações não autorizadas. |
| V12 | PN P0085 | Validação financeira | Detectar toda a inconsistência entre tabelas, indicando tabela e campo | PARCIALMENTE DEMONSTRADO | financial-issue-presentation.ts; investment-report-tables.tsx; simulation-business-plan.tsx; startup-asset-requirements.tsx; integral-financial-plan.tsx; integral-financial-report.ts; business-financial-plan.ts; project-dossier-document.ts | 4ef5f58e; 74ba0bd0; E17/E18/E19/E20; prova-v12-editor-d1-d2-d3-20261120.json | Correcções técnicas D1/D2/D3 aceites no âmbito dos testes. E20 concluiu a prova real das três mensagens em computador e emulação móvel 390x844, correcção, remoção e recuperação do mesmo rascunho, iniciado na versão 12; D1 recuperado na versão 17, D2 na 24. D1/D3 continuam a impedir cálculo inválido; D2 conserva o diagnóstico não bloqueante existente. Nenhum código ou teste alterado/repetido nesta conferência. D1/D2/D3 propostos para aceitação individual; V12 permanece aberto porque os restantes limites de cobertura de mensagens de E18 não foram demonstrados neste recorte. Restantes 87 linhas preservadas. |
| V12 | PN P0085 | Validação financeira | Detectar toda a inconsistência entre tabelas, indicando tabela e campo | PARCIALMENTE DEMONSTRADO | financial-issue-presentation.ts; financial-ratios-report.ts; integral-financial-report.ts; business-financial-plan.ts; componentes existentes do editor e relatório | 4ef5f58e; 74ba0bd0; f81306f1; E17–E21; prova-v12-mensagens-restantes-20261120.json | D1/D2/D3 aceites individualmente pelo proprietário, sem repetição. E21 demonstra aquisições, existências iniciais, falta de stock/reconciliação, impostos mensais, parcelas de abertura, recuperação de vendas, preços mensais e classificação corrente/rácio dependente, em computador e emulação móvel. Corrigidos apenas diagnósticos reproduzidos e recuperação editável de meses duplicados; rejeição financeira preservada. Gravação/recuperação no rascunho sintético existente, versão 79. Cinco testes focados e um teste directamente afectado aprovados; fórmulas preservadas. V12 permanece parcialmente validado e aberto: resolução da divergência de moeda do pessoal e ramos estruturais/agendas não percorridos conservam os limites exactos de E21. Restantes 87 linhas preservadas. |
| V13 | PN P0086 | Validação financeira | Lista Falta preencher com ligação directa a cada campo por corrigir | NÃO IMPLEMENTADO | integral-financial-plan.tsx; simulation-business-plan.tsx | — | Existem erros e notas; não foi encontrada implementação completa do sumário com ligações por campo pedido. |
| V14 | PN P0098 | Validação financeira | Aviso específico sobre textos opcionais em falta (concorrência/SWOT) | NÃO IMPLEMENTADO | business-plan-guidance.ts; business-plan-warnings.tsx | — | Catálogo de avisos não inclui estes textos opcionais. |
| C01 | PN P0015; ME P0115 | Portal — actividades existentes | Análise agregada privada sem divulgar empresas/contactos individuais | INTEGRADO E VALIDADO | app/Services/InvestorContext.php; componentes de consulta agregada | base bae996e1 (histórico de incorporação no documento) | E7: provas agregadas e protecções documentadas; não é publicação de listas individuais. |
@@ -1952,4 +1952,35 @@ D2 mantém a semântica anterior de diagnóstico do relatório: não se criou ne
Reutilizados os quatro testes focados e a comparação numérica de seis cenários de `74ba0bd0`, sem nova execução. Nenhuma alteração de código funcional ou da instalação de tradução. V11, F20/F22, originais e restantes aprovações preservados; só os dados sintéticos do rascunho foram editados pela aplicação.
**Classificação fundamentada:** o recorte D1/D2/D3 ficou funcionalmente demonstrado. V12 mantém-se **parcialmente validado — aberto**, sem presumir aprovação global. E18 ainda contém limites de prova fora destas três lacunas: mensagens de divergência das aquisições e de existências iniciais por produto; reconciliação por período/falta de stock; omissões de agendas/modos de compras; parcelas de abertura, além dos limites documentados de mensagens de moeda/rácios. Esta lista reutiliza E18, não constitui auditoria nova, defeitos adicionais confirmados ou autorização para iniciar outra frente. Uma decisão sobre a suficiência dessas provas existentes deve ser específica; as provas D1/D2/D3 não precisam de ser repetidas.
**Classificação fundamentada:** o recorte D1/D2/D3 ficou funcionalmente demonstrado. V12 mantém-se **parcialmente validado — aberto**, sem presumir aprovação global. E18 ainda contém limites de prova fora destas três lacunas: mensagens de divergência das aquisições e de existências iniciais por produto; reconciliação por período/falta de stock; omissões de agendas/modos de compras; parcelas de abertura, além dos limites documentados de mensagens de moeda/rácios. Esta lista reutiliza E18, não constitui auditoria nova, defeitos adicionais confirmados ou autorização para iniciar outra frente. Uma decisão sobre a suficiência dessas provas existentes deve ser específica; as provas D1/D2/D3 não precisam de ser repetidas.
## E21 — V12: mensagens restantes no editor — 20/11/2026
Base `f81306f1`, quadro E18 e requisitos Revisão 1. D1/D2/D3 foram aceites individualmente pelo proprietário e não foram reabertos. Usados apenas o QA isolado `http://127.0.0.3:18724`, conta normal sintética 1407 e rascunho existente `af6686b4-f210-4203-9ef1-0d85537426ae`. Tradução respondeu HTTP 200 no início; nenhuma intervenção no LibreTranslate. Reutilizados os ficheiros sintéticos D1/D3 existentes pelo importador normal, sem recriar as seis referências financeiras ou executar a auditoria geral. As entradas desta prova são pressupostos sintéticos, sem dados reais ou taxas legais presumidas.
| Mensagem/regra de E18 | Ensaio e resultado individual | Alteração necessária |
| --- | --- | --- |
| Aquisições versus necessidades | 500 versus 600: aviso nomeia Aquisição de activos e necessidades; resultado/CSV inválido impedido. Repor 600 remove aviso e devolve resultados. Computador, 390x844 e recuperação móvel conferidos | Nenhuma |
| Existências iniciais versus produtos | Total 1 versus soma 0: aviso identifica total e stock por produto. Repor 0 remove aviso, recupera resultados; invalidade impede previsão/CSV | Nenhuma |
| Stock insuficiente e reconciliação por período | Unidades mensais 10, encomenda 200, custo unitário 40: faltas nos meses 1/2 e diferença do balanço. Mensagens passam a indicar Existências, campos do stock, mês e linha Diferença do balanço. Repor unidades 0 remove os três avisos. Sem reduzir vendas ou compensar diferenças | Só apresentação; `issues` e linhas de origem conservados |
| Impostos por mês | Imposto reconhecido do mês 2 vazio; pagamento do mês 2 vazio e -1: diagnóstico anteriormente genérico, agora campo/mês e correcção exactos. Repor 30/20 remove avisos e recupera tabelas. A rejeição é das tabelas fiscais dependentes; não se criou bloqueio global da previsão base/CSV | Só mensagens dos mesmos ramos de conversão e negatividade |
| Parcelas de recebíveis e valores a pagar de abertura | Em cada agenda, 60% + 50% rejeitado. Mensagem nomeia agenda e campos Percentagem do saldo inicial; 60% + 40% remove aviso e recupera resultados/CSV. Saldos iniciais sintéticos 0: ensaio da distribuição, não prova de recebimento/pagamento real | Só apresentação |
| Recuperação de vendas vencidas | Duas linhas mês 1/1 e percentagens 0: rejeição mantida. Antes, recuperação editável recusava o snapshot e o editor ficava visualmente vazio; recibo versão 49 demonstra dados completos ainda guardados. Corrigida apenas restauração editável para permitir corrigir o mês duplicado. Após recarregar, mensagem e todos os dados recuperados; mudar segunda linha para mês 2 elimina aviso e devolve resultados/CSV | Guarda de edição; restauração estrita e previsão continuam a rejeitar duplicação |
| Preço por mês | Preço do produto 1, mês 2 vazio: aviso existente identifica campo/mês, mais indicação local; previsão/CSV impedidos. Repor 100 elimina aviso. Recuperação final conserva 100 | Nenhuma |
| Classificação corrente | Activo corrente mês 1 = 999999, restantes declarados 0: aviso genérico reproduzido. Corrigido diagnóstico por campo e mês, sem alterar limite ou fórmula. Passivo 999999 verificado separadamente; vazio identifica preenchimento. Repor 0 remove aviso. Sem mensagens duplicadas entre mês e resumo anual | Só diagnóstico; Set elimina a repetição anual do mesmo campo/mês |
| Rácios dependentes do balanço | Mesma falta de stock, unidades 10: mensagem existente identifica Balanço e períodos 2027-01, 2027-02 e ano parcial; indicadores dependentes ficam por determinar. Corrigir unidades para 0 elimina mensagem. Classificação válida não compensa o balanço | Nenhuma |
| Compras agregadas versus stock por produto | Informação preventiva visível nos dois formatos: compras agregadas inactivas enquanto o stock estiver por produto. Controlos existentes desactivam os modos incompatíveis; reutilizada rejeição por teste E18. Não foi forçado um snapshot incoerente para simular acesso normal impossível | Sem alteração; limite do ramo legado mantido abaixo |
Os casos da tabela foram observados no editor em computador e emulação Edge 390x844; não se declara dispositivo físico. Nas mensagens longas foi conferida a leitura por deslocação vertical. Capturas e acessibilidade constam da transcrição, sem alegar PNG exportado. Nos avisos de falta de stock e rácios, rejeição significa não apresentar o indicador dependente como válido: são diagnósticos não bloqueantes da previsão, como antes. Guardar um rascunho inválido editável não equivale a aceitar financeiramente as entradas.
Gravação/recuperação: versão 49 conserva o cenário inválido completo; versão 61 conserva correcções de stock, impostos, parcelas 60/40 e recuperações nos meses 1/2. Recarregamento final móvel recupera o mesmo plano e preço mensal 100. Leitura protegida e apenas de consulta confirma versão 79, hash `2b51a000d2406489ffb82425ca2f22c6b0f7053589d1f2c1ba75716d7b7573c7`, classificação corrente 0/0 em ambos os meses e unidades 0. O original sintético versão 12 e provas anteriores permanecem preservados nos artefactos existentes. Recibo versionado: `prova-v12-mensagens-restantes-20261120.json`.
Verificação proporcional: cinco testes focados em `v12-remaining-messages.test.mjs` aprovados; um teste directamente afectado em `financial-ratios-report.test.mjs` aprovado, agora verifica 24 mensagens distintas para 12 meses com dois campos em falta, sem apagar o rácio anterior válido. Tipos e lint dos ficheiros alterados aprovados. Compilação QA gerou o manifesto/activos e registou «built in 26.03s»; a sessão PowerShell terminou com estado 1 e capturou avisos em stderr (fontaine opcional, dimensão de chunks/tempos), sem erro de compilação no registo; o código individual de saída do npm não foi recolhido separadamente. Não foi reinstalado pacote nem repetida a compilação para ocultar o estado do invólucro. Primeira chamada npm/npx.ps1 foi recusada pela política de scripts; usados os executáveis .cmd existentes, sem alterar a política. A primeira regressão nova detectou uma referência local incorrecta `editable`, corrigida para `options.editable` e abrangida pelo teste aprovado. Sem alteração de fórmulas, valores calculados, movimentos ou regras financeiras; reutilizadas as provas numéricas anteriores.
**Limites exactos de cobertura, sem presumir novos defeitos:**
- Moeda do mapa de pessoal versus plano: E3/E18 já provam comparação e ausência de conversão automática; não se demonstrou nesta execução a mensagem e resolução no editor actual. A aprovação V10 permanece intacta.
- Agendas de quantidades, custos, pagamentos manuais e compras agregadas: leitura confirma mensagens por rubrica/mês e testes temporais existentes; a prova nova por célula abrangeu preço e impostos, não todos esses ramos. Não equiparar uma família testada a todos os controlos percorridos.
- Agendas com comprimento incompatível, meses fora do horizonte e modos de compras incompatíveis por importação: guardas/testes existentes preservados; não foram criados ficheiros malformados nem forçados valores inacessíveis nos selectores normais. A prevenção normal de modos foi observada, mas não substitui a prova de cada mensagem de rejeição da importação.
**Classificação: V12 PARCIALMENTE VALIDADO — ABERTO.** Os casos individuais acima ficam propostos para aceitação, com os limites expressos. Nenhuma mensagem obrigatória sem prova foi declarada concluída. Próximo recorte recomendado: apenas os ramos enumerados, reutilizando os cenários disponíveis; não repetir aquisições, existências, D1/D2/D3 ou os ensaios concluídos sem regressão. V11, F20/F22 e todas as restantes 87 linhas mantidos. Sem instalação, publicação, migrações ou alterações de fontes/dados activos.
@@ -0,0 +1,59 @@
{
"date_local": "2026-11-20",
"baseline_commit": "f81306f1",
"scope": "V12 remaining messages only; D1/D2/D3 accepted and not reopened",
"qa": {
"url": "http://127.0.0.3:18724",
"database": "main_reference_20261104_test:55441",
"actor": 1407,
"draft": "af6686b4-f210-4203-9ef1-0d85537426ae",
"translation_initial_status": 200,
"desktop": true,
"mobile": "Edge emulation 390x844, not physical"
},
"saved": {
"invalid_version": 49,
"invalid_hash": "1ad02166b45c7a16fa553bedb8c5670fd9c0013fa8afd07d3245555762df4a4e",
"final_version": 79,
"final_hash": "2b51a000d2406489ffb82425ca2f22c6b0f7053589d1f2c1ba75716d7b7573c7"
},
"matrix": {
"count": 88,
"changed": [
"V12"
],
"other_rows_preserved": 87
},
"verification": {
"focused_tests": 5,
"affected_existing_tests": 1,
"types": "passed",
"lint": "passed",
"qa_bundle": "built in 26.03s, manifest generated; PowerShell wrapper status 1 with captured stderr warnings",
"financial_scenarios": "prior accepted evidence reused, not rerun"
},
"individual_evidence": "See E21 individual table and CUA transcript; screenshots not exported as PNG",
"remaining": [
"personnel/project currency mismatch message and resolution in current editor",
"other schedule cells: quantities, variable costs, manual payments, aggregate purchases",
"structural import guards: schedule length, out-of-horizon months, incompatible purchase modes"
],
"classification": "V12 partially validated, open",
"preserved": [
"D1",
"D2",
"D3",
"V11",
"F20",
"F22",
"financial formulas",
"original sources",
"active data",
"LibreTranslate installation"
],
"operations": {
"installs": false,
"publication": false,
"migrations": false
}
}
+1 -1
View File
@@ -636,7 +636,7 @@ export function restoreBusinessPlanSnapshot(
entry.month < 1 ||
entry.month > 60 ||
typeof entry.percent !== 'string' ||
months.has(entry.month)
(!options.editable && months.has(entry.month))
)
return null;
months.add(entry.month);
@@ -37,6 +37,29 @@ export function forecastErrorShownInReport(
/** Presentation only: preserve the validation result, source issue and every financial value. */
export function financialIssueMessage(issue: string): string {
const shortage =
/^Mês (\d+): existências insuficientes para as vendas declaradas\.$/.exec(
issue,
);
if (shortage)
return `Balanço Projectado / Existências — mês ${shortage[1]}: stock insuficiente para as vendas declaradas. Confira «Existências iniciais», «Encomenda», «Prazo de recepcao» e «Unidades por mes» em «Planear stock por produto», ou as compras agregadas quando esse for o modo escolhido. Consulte a falta por produto no mapa de existências e corrija os pressupostos; as vendas não são reduzidas automaticamente.`;
if (
issue ===
'Existem períodos não reconciliados; reveja as rubricas indicadas.'
)
return 'Balanço Projectado / Diferença do balanço: existem períodos não reconciliados. Consulte os meses desta linha e os diagnósticos específicos apresentados, incluindo existências, depreciação e dívida. Corrija os campos de origem indicados; a diferença, por si só, não identifica um único campo errado e não é compensada automaticamente.';
if (
issue ===
'A soma das cobranças declaradas de recebíveis de abertura não pode exceder 100%.'
)
return 'Fluxo de Caixa / Parcelas adicionais de recebíveis de abertura: a soma excede 100%. Corrija os campos «Percentagem do saldo inicial» das parcelas; inclua também a percentagem da cobrança única, se seleccionada. Não altere o saldo inicial apenas para fazer coincidir a distribuição.';
if (
issue ===
'A soma das liquidações declaradas de valores a pagar não pode exceder 100%.'
)
return 'Fluxo de Caixa / Liquidação de valores a pagar de abertura: a soma excede 100%. Corrija os campos «Percentagem do saldo inicial» dos pagamentos; o total não pode exceder 100%.';
if (issue === 'Cada recuperação deve ter um mês único dentro do horizonte.')
return 'Fluxo de Caixa / Recuperação de vendas vencidas: confira os campos «Mês». Cada recuperação deve ter um mês diferente, dentro do horizonte do plano. Corrija o mês repetido ou remova a linha duplicada; as percentagens são aplicadas ao saldo vencido, não somadas como parcelas do saldo inicial.';
if (
issue ===
'O capital discriminado não corresponde ao capital introduzido. Confira os campos de financiamento.'
+18 -7
View File
@@ -69,8 +69,8 @@ export function buildFinancialRatiosTable(
) as Record<string, string[]>;
const periods = plan.periods ?? 12,
settings = plan.ratioCurrentBalances;
const blockedPeriods: string[] = [],
unclassifiedPeriods: string[] = [];
const blockedPeriods: string[] = [];
const classificationIssues = new Set<string>();
const settingsValid =
settings &&
Array.isArray(settings.assetsByMonth) &&
@@ -138,7 +138,21 @@ export function buildFinancialRatiosTable(
: unknown,
);
if (!consistent) blockedPeriods.push(headers[i + 1]);
if (!validCurrent) unclassifiedPeriods.push(headers[i + 1]);
if (!validCurrent) {
for (const [label, value, total] of [
['Activo corrente', currentAssets, assets],
['Passivo corrente', currentLiabilities, liabilities],
] as const) {
if (value === null)
classificationIssues.add(
`Rácios financeiros / ${label} — mês ${end + 1}: preencha um montante não negativo com até duas casas decimais; indique zero apenas quando aplicável.`,
);
else if (total !== null && value > total)
classificationIssues.add(
`Rácios financeiros / ${label} — mês ${end + 1}: o montante excede o total correspondente do balanço. Corrija este campo de classificação; não altere o balanço para acomodar a classificação.`,
);
}
}
if (capital !== null && capital < 0n)
result.notes.push(
`${headers[i + 1]}: capital negativo; o retorno conserva o sinal matemático e exige interpretação desta situação.`,
@@ -149,10 +163,7 @@ export function buildFinancialRatiosTable(
result.issues.push(
`Balanço inconsistente ou indeterminado: liquidez, endividamento e retorno do capital não calculados em ${blockedPeriods.join(', ')}.`,
);
if (unclassifiedPeriods.length)
result.issues.push(
`Para determinar a liquidez, classifique activo e passivo correntes dentro dos totais do balanço. Períodos por completar ou corrigir: ${unclassifiedPeriods.join(', ')}.`,
);
result.issues.push(...classificationIssues);
if (!sales || sales.issues.length)
result.issues.push(
'Vendas indeterminadas: crescimento e margem não calculados.',
+19 -6
View File
@@ -183,22 +183,35 @@ export function buildIntegralFinancialTables(
return total + cents(row.amount);
}, 0n);
const count = result.rows.length;
const schedule = (values: string[]) => {
const schedule = (values: string[], field: string) => {
if (!Array.isArray(values) || values.length !== count)
throw new Error(
'Preencha imposto estimado e pagamento fiscal para cada mês, incluindo zero quando aplicável.',
);
return values.map((value) => {
const amount = cents(value);
return values.map((value, month) => {
let amount: bigint;
try {
amount = cents(value);
} catch {
throw new Error(
`Impostos por mês — ${field}, mês ${month + 1}: preencha este campo com um montante até duas casas decimais; indique zero apenas quando aplicável.`,
);
}
if (amount < 0n)
throw new Error(
'Os impostos estimados não podem ser negativos.',
`Impostos por mês — ${field}, mês ${month + 1}: o montante não pode ser negativo. Corrija este campo.`,
);
return amount;
});
};
const taxExpenses = schedule(a.taxExpenseByMonth),
taxPayments = schedule(a.taxPaymentByMonth);
const taxExpenses = schedule(
a.taxExpenseByMonth,
'Imposto reconhecido',
),
taxPayments = schedule(
a.taxPaymentByMonth,
'Pagamento fiscal previsto',
);
if (!a.taxSource.trim())
throw new Error(
'Indique a fonte ou o pressuposto fiscal, incluindo quando não prevê imposto.',
@@ -39,7 +39,13 @@ void test('a missing classification in later months does not erase an available
const table = buildFinancialRatiosTable(plan, source);
assert.equal(get(table, 'Liquidez corrente')[1], '118,00×');
assert.equal(get(table, 'Liquidez corrente')[2], 'Por determinar');
assert.equal(table.issues.length, 1);
assert.equal(table.issues.length, 24);
assert.equal(new Set(table.issues).size, 24);
assert.ok(
table.issues.every((issue) =>
/corrente — mês (?:[2-9]|1[0-3]):/.test(issue),
),
);
});
void test('annual comparison uses two complete years and permits growth above 100 percent', () => {
@@ -0,0 +1,165 @@
import test from 'node:test';
import assert from 'node:assert/strict';
import { financialReportFixture } from './fixtures/integral-financial-plan.mjs';
import { buildIntegralFinancialTables } from '../../resources/js/lib/integral-financial-report.ts';
import { buildFinancialRatiosTable } from '../../resources/js/lib/financial-ratios-report.ts';
import {
financialIssueMessage,
financialIssuesForDisplay,
} from '../../resources/js/lib/financial-issue-presentation.ts';
import {
serializeBusinessPlanSnapshot,
restoreBusinessPlanSnapshot,
forecastBusinessPlan,
} from '../../resources/js/lib/business-financial-plan.ts';
test('V12: current classification identifies each invalid field once without changing ratio rows or statements', () => {
const plan = financialReportFixture(2);
const source = buildIntegralFinancialTables(plan);
const original = structuredClone(source);
plan.ratioCurrentBalances = {
assetsByMonth: ['0', '0'],
liabilitiesByMonth: ['0', '0'],
};
const valid = buildFinancialRatiosTable(plan, source);
for (const [key, label] of [
['assetsByMonth', 'Activo corrente'],
['liabilitiesByMonth', 'Passivo corrente'],
]) {
for (const value of ['', '999999']) {
plan.ratioCurrentBalances[key][0] = value;
const table = buildFinancialRatiosTable(plan, source);
assert.equal(table.issues.length, 1);
assert.ok(table.issues[0].includes(label + ' — mês 1:'));
assert.match(
table.issues[0],
value === '' ? /preencha um montante/ : /excede o total/,
);
assert.equal(
table.rows.find((row) => row[0] === 'Liquidez corrente')[1],
'Por determinar',
);
}
plan.ratioCurrentBalances[key][0] = '0';
assert.deepEqual(buildFinancialRatiosTable(plan, source), valid);
}
assert.deepEqual(source, original);
});
test('V12: missing or negative tax cells identify exact field and month; correction removes diagnostic', () => {
const plan = financialReportFixture(2);
const valid = buildIntegralFinancialTables(plan);
for (const [key, label, original] of [
['taxExpenseByMonth', 'Imposto reconhecido', '30'],
['taxPaymentByMonth', 'Pagamento fiscal previsto', '20'],
]) {
for (const value of ['', '-1']) {
plan.reportAssumptions[key][1] = value;
const issues = financialIssuesForDisplay(
buildIntegralFinancialTables(plan),
);
assert.equal(issues.length, 1);
assert.ok(issues[0].message.includes(label + ', mês 2'));
assert.match(
issues[0].message,
value === '' ? /preencha este campo/ : /não pode ser negativo/,
);
}
plan.reportAssumptions[key][1] = original;
assert.deepEqual(buildIntegralFinancialTables(plan), valid);
}
});
test('V12: stock and period reconciliation messages identify original controls without altering issues or rows', () => {
const raw = [
'Mês 2: existências insuficientes para as vendas declaradas.',
'Existem períodos não reconciliados; reveja as rubricas indicadas.',
];
const tables = [
{
id: 'balance',
title: 'Balanço Projectado',
issues: raw,
rows: [['Diferença do balanço', '-200.00']],
},
];
const before = JSON.stringify(tables);
const messages = financialIssuesForDisplay(tables);
assert.equal(messages.length, 2);
for (const field of [
'mês 2',
'Existências iniciais',
'Encomenda',
'Unidades por mes',
])
assert.ok(messages[0].message.includes(field));
assert.match(messages[1].message, /Diferença do balanço/);
assert.match(messages[1].message, /não identifica um único campo errado/);
assert.equal(JSON.stringify(tables), before);
});
test('V12: opening installment overflow names the right percentage fields and never attributes a false unique culprit', () => {
for (const [kind, text] of [
[
'receivables',
'A soma das cobranças declaradas de recebíveis de abertura não pode exceder 100%.',
],
[
'payables',
'A soma das liquidações declaradas de valores a pagar não pode exceder 100%.',
],
]) {
const message = financialIssueMessage(text);
assert.match(message, /Fluxo de Caixa/);
assert.match(message, /Percentagem do saldo inicial/);
assert.match(
message,
kind === 'receivables' ? /recebíveis/ : /valores a pagar/,
);
const plan = financialReportFixture(2);
const key =
kind === 'receivables'
? 'openingReceivablesInstallments'
: 'openingPayablesInstallments';
plan[key] = [
{ month: 1, percent: '60' },
{ month: 2, percent: '50' },
];
assert.throws(
() => forecastBusinessPlan(plan),
/não pode exceder 100%/,
);
plan[key][1].percent = '40';
assert.doesNotThrow(() => forecastBusinessPlan(plan));
}
});
test('V12 regression: duplicate recovery months remain editable without blanking a saved plan; strict restore and forecast still reject', () => {
const plan = financialReportFixture(2);
plan.salesRecoverySchedule = [
{ month: 1, percent: '0' },
{ month: 1, percent: '0' },
];
const snapshot = serializeBusinessPlanSnapshot(plan);
assert.equal(restoreBusinessPlanSnapshot(snapshot), null);
const editable = restoreBusinessPlanSnapshot(snapshot, { editable: true });
assert.ok(editable);
assert.equal(editable.products[0].unitPrice, '100');
assert.deepEqual(
editable.salesRecoverySchedule,
plan.salesRecoverySchedule,
);
assert.throws(() => forecastBusinessPlan(editable), /mês único/);
assert.match(
financialIssueMessage(
'Cada recuperação deve ter um mês único dentro do horizonte.',
),
/campos «Mês»/,
);
editable.salesRecoverySchedule[1].month = 2;
const recovered = restoreBusinessPlanSnapshot(
serializeBusinessPlanSnapshot(editable),
);
assert.ok(recovered);
assert.doesNotThrow(() => forecastBusinessPlan(recovered));
});