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
+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.',