166 lines
7.6 KiB
TypeScript
166 lines
7.6 KiB
TypeScript
import type { BusinessFinancialPlanInput } from './business-financial-plan.ts';
|
||
import {
|
||
buildIntegralFinancialTables,
|
||
type InvestmentReportTable,
|
||
} from './integral-financial-report.ts';
|
||
|
||
const unknown = 'Por determinar';
|
||
const cents = (value: string | undefined): bigint | null => {
|
||
if (typeof value !== 'string' || !value || !/^-?\d+\.\d{2}$/.test(value))
|
||
return null;
|
||
const [a, b] = value.replace('-', '').split('.');
|
||
return (BigInt(a) * 100n + BigInt(b)) * (value.startsWith('-') ? -1n : 1n);
|
||
};
|
||
const declaration = (value: string | undefined) => {
|
||
if (
|
||
typeof value !== 'string' ||
|
||
!value ||
|
||
!/^\d+(?:\.\d{1,2})?$/.test(value)
|
||
)
|
||
return null;
|
||
const [a, b = ''] = value.split('.');
|
||
return BigInt(a) * 100n + BigInt(b.padEnd(2, '0'));
|
||
};
|
||
/** Approved formulas, rounded only for display; exact statement cents remain unchanged. */
|
||
function quotient(n: bigint | null, d: bigint | null, percent: boolean) {
|
||
if (n === null || d === null || d === 0n) return unknown;
|
||
const sign = n < 0n !== d < 0n ? '-' : '';
|
||
const numerator = (n < 0n ? -n : n) * (percent ? 10000n : 100n),
|
||
denominator = d < 0n ? -d : d;
|
||
const rounded = (numerator + denominator / 2n) / denominator;
|
||
return `${rounded === 0n ? '' : sign}${rounded / 100n},${String(rounded % 100n).padStart(2, '0')}${percent ? '%' : '×'}`;
|
||
}
|
||
|
||
export function buildFinancialRatiosTable(
|
||
plan: BusinessFinancialPlanInput,
|
||
source = buildIntegralFinancialTables(plan),
|
||
): InvestmentReportTable {
|
||
const balance = source.find((t) => t.id === 'balance'),
|
||
sales = source.find((t) => t.id === 'sales'),
|
||
profit = source.find((t) => t.id === 'profit-loss');
|
||
const headers = balance?.headers.length
|
||
? balance.headers
|
||
: (sales?.headers ?? ['Indicador']);
|
||
const result: InvestmentReportTable = {
|
||
id: 'ratios',
|
||
title: 'Rácios financeiros',
|
||
headers: ['Indicador', ...headers.slice(1)],
|
||
rows: [],
|
||
issues: [],
|
||
notes: [
|
||
'Projecções derivadas das mesmas demonstrações; não são indicadores realizados. Fórmulas aprovadas: crescimento = vendas/vendas anteriores − 1; liquidez = activo corrente/passivo corrente; endividamento = passivo/activo; margem líquida = lucro líquido/vendas; retorno do capital = lucro líquido/capital e resultados de fecho.',
|
||
'Fluxos anuais são as somas do ano; saldos anuais são os de fecho. Rácios anuais são recalculados, nunca somados ou promediados. Anos parciais não são anualizados; crescimento exige períodos de igual duração. Primeiro período, dados ausentes e denominador zero permanecem por determinar.',
|
||
'Activo e passivo correntes são montantes declarados para classificação, não novos movimentos. Não se presumem vencimentos dos empréstimos, outros activos ou subvenções. Inconsistências no balanço bloqueiam os indicadores que dele dependem, sem bloquear os que dependem apenas de vendas/resultados válidos.',
|
||
],
|
||
};
|
||
const cell = (
|
||
t: InvestmentReportTable | undefined,
|
||
label: string,
|
||
i: number,
|
||
) => cents(t?.rows.find((r) => r[0] === label)?.[i + 1]);
|
||
const rows = Object.fromEntries(
|
||
[
|
||
'Crescimento das vendas',
|
||
'Liquidez corrente',
|
||
'Endividamento (passivo/activo)',
|
||
'Margem líquida',
|
||
'Retorno do capital',
|
||
].map((k) => [k, [k]]),
|
||
) as Record<string, string[]>;
|
||
const periods = plan.periods ?? 12,
|
||
settings = plan.ratioCurrentBalances;
|
||
const blockedPeriods: string[] = [],
|
||
unclassifiedPeriods: string[] = [];
|
||
const settingsValid =
|
||
settings &&
|
||
Array.isArray(settings.assetsByMonth) &&
|
||
Array.isArray(settings.liabilitiesByMonth);
|
||
for (let i = 0; i < headers.length - 1; i++) {
|
||
const yearIndex = i - periods,
|
||
end = i < periods ? i : Math.min(periods, (yearIndex + 1) * 12) - 1;
|
||
const length = i < periods ? 1 : Math.min(12, periods - yearIndex * 12);
|
||
const previous =
|
||
i < periods ? (i === 0 ? -1 : i - 1) : yearIndex === 0 ? -1 : i - 1;
|
||
const previousLength = i < periods ? 1 : 12;
|
||
const revenue = cell(sales, 'Vendas totais', i),
|
||
net = cell(profit, 'Lucro líquido', i);
|
||
const salesValid = !!sales && !sales.issues.length;
|
||
const profitValid = !!profit && !profit.issues.length;
|
||
const prior =
|
||
previous < 0 ? null : cell(sales, 'Vendas totais', previous);
|
||
rows['Crescimento das vendas'].push(
|
||
salesValid &&
|
||
length === previousLength &&
|
||
prior !== null &&
|
||
prior > 0n &&
|
||
revenue !== null
|
||
? quotient(revenue - prior, prior, true)
|
||
: unknown,
|
||
);
|
||
rows['Margem líquida'].push(
|
||
salesValid && profitValid ? quotient(net, revenue, true) : unknown,
|
||
);
|
||
const assets = cell(balance, 'Total do activo', i),
|
||
liabilities = cell(balance, 'Total do passivo', i),
|
||
capital = cell(balance, 'Capital e resultados', i);
|
||
const consistent =
|
||
!!balance &&
|
||
!balance.issues.length &&
|
||
cell(balance, 'Diferença do balanço', i) === 0n &&
|
||
assets !== null &&
|
||
liabilities !== null &&
|
||
capital !== null &&
|
||
assets - liabilities - capital === 0n;
|
||
rows['Endividamento (passivo/activo)'].push(
|
||
consistent && assets! > 0n
|
||
? quotient(liabilities, assets, true)
|
||
: unknown,
|
||
);
|
||
rows['Retorno do capital'].push(
|
||
consistent && profitValid ? quotient(net, capital, true) : unknown,
|
||
);
|
||
const currentAssets = settingsValid
|
||
? declaration(settings.assetsByMonth[end])
|
||
: null,
|
||
currentLiabilities = settingsValid
|
||
? declaration(settings.liabilitiesByMonth[end])
|
||
: null;
|
||
const validCurrent =
|
||
currentAssets !== null &&
|
||
currentLiabilities !== null &&
|
||
assets !== null &&
|
||
liabilities !== null &&
|
||
currentAssets <= assets &&
|
||
currentLiabilities <= liabilities;
|
||
rows['Liquidez corrente'].push(
|
||
consistent && validCurrent
|
||
? quotient(currentAssets, currentLiabilities, false)
|
||
: unknown,
|
||
);
|
||
if (!consistent) blockedPeriods.push(headers[i + 1]);
|
||
if (!validCurrent) unclassifiedPeriods.push(headers[i + 1]);
|
||
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.`,
|
||
);
|
||
}
|
||
result.rows = Object.values(rows);
|
||
if (blockedPeriods.length)
|
||
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(', ')}.`,
|
||
);
|
||
if (!sales || sales.issues.length)
|
||
result.issues.push(
|
||
'Vendas indeterminadas: crescimento e margem não calculados.',
|
||
);
|
||
if (!profit || profit.issues.length)
|
||
result.issues.push(
|
||
'Resultados indeterminados: margem e retorno do capital não calculados.',
|
||
);
|
||
return result;
|
||
}
|