fix(v12): clarify remaining financial diagnostics and preserve editable recovery
This commit is contained in:
@@ -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
|
||||
}
|
||||
}
|
||||
@@ -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.'
|
||||
|
||||
@@ -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.',
|
||||
|
||||
@@ -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));
|
||||
});
|
||||
Reference in New Issue
Block a user