116 lines
6.8 KiB
TypeScript
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()];
|
|
}
|