Files
Investidor-V2/resources/js/lib/financial-issue-presentation.ts
T

116 lines
6.8 KiB
TypeScript

import {
buildIntegralFinancialTables,
displayReportMoney,
isReportAssumptions,
type InvestmentReportTable,
} from './integral-financial-report.ts';
import type { BusinessFinancialPlanInput } from './business-financial-plan.ts';
import { calculateStartupAssetRequirements } from './startup-asset-requirements.ts';
/** The local startup editor owns this error when report tables are unavailable. */
export function startupErrorMessage(plan: BusinessFinancialPlanInput): string {
if (plan.startupAssetRequirements)
try {
calculateStartupAssetRequirements(plan);
} catch (cause) {
return cause instanceof Error
? cause.message
: 'Confira os dados de arranque.';
}
return '';
}
/** Do not hide a forecast error when the report editor itself cannot show the tables. */
export function forecastErrorShownInReport(
plan: BusinessFinancialPlanInput,
error: string,
) {
return (
plan.reportSource !== 'annual_example' &&
(!plan.reportAssumptions ||
isReportAssumptions(plan.reportAssumptions)) &&
buildIntegralFinancialTables(plan).some((table) =>
table.issues.includes(error),
)
);
}
/** 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.'
)
return 'Financiamento — Capital próprio: este valor não coincide com a soma de Capital do proprietário, Capital do investidor e Capital adicional angariado. Corrija o Capital próprio ou a discriminação em «Crescimento, despesas discriminadas, capital e dividendos».';
if (
issue ===
'A soma das existencias iniciais por produto deve coincidir com as existencias iniciais do plano.'
)
return 'Balanço / Existências iniciais: este valor não coincide com a soma das existências iniciais por produto em «Planear stock por produto». Corrija o total do plano ou as linhas dos produtos.';
if (
issue ===
'As aquisições do cenário não correspondem às necessidades de activos. Confira os valores e adopte as aquisições calculadas.'
)
return 'Arranque / Aquisição de activos: este valor não coincide com as aquisições calculadas em «Caixa e activos necessários ao arranque». Confira os activos requeridos e disponíveis e adopte as aquisições calculadas, ou corrija os pressupostos.';
const opening =
/^Saldos de abertura não reconciliados: diferença (-?\d+\.\d{2})\./.exec(
issue,
);
if (opening)
return `Balanço projectado / Saldos de abertura: diferença ${displayReportMoney(opening[1])}. Confira «Capital e resultados anteriores» face aos saldos anteriores de caixa, activos, existências, valores a receber e valores a pagar. A diferença não permite identificar automaticamente qual saldo está errado; corrija os campos de origem, sem compensação automática.`;
if (
issue ===
'O mapa de pessoal diverge da despesa de pessoal do plano. Reveja os pressupostos; nenhum valor financeiro foi sobrescrito.'
)
return 'Mapa de pessoal / Folha salarial prevista: este valor não coincide com «Pessoal» em Lucros e perdas («Custo mensal de pessoal» no editor). Confira quantidade, remuneração mensal e meses activos de cada função, ou a despesa de pessoal do plano. Consulte a linha «Diferença face à despesa de pessoal no plano»; nenhum valor financeiro foi sobrescrito.';
return issue;
}
/** Group identical issues across tables; callers keep the original issues for validity checks. */
export function financialIssuesForDisplay(tables: InvestmentReportTable[]) {
const groups = new Map<string, { message: string; tables: string[] }>();
for (const table of tables) {
for (const issue of table.issues) {
if (
issue ===
'Existem períodos não reconciliados; reveja as rubricas indicadas.' &&
table.issues.some((detail) =>
detail.startsWith(
'Saldos de abertura não reconciliados: diferença ',
),
)
)
continue;
const message = financialIssueMessage(issue);
const group = groups.get(message) ?? { message, tables: [] };
if (!group.tables.includes(table.title))
group.tables.push(table.title);
groups.set(message, group);
}
}
return [...groups.values()];
}