feat(qa): integrate financial ratios with accounting consistency guards
This commit is contained in:
@@ -10435,3 +10435,9 @@ Sete testes novos, integração HTTP201/200/422/404, tipos/lint/Pint e buildQA a
|
||||
### Encerramento formal do Pacote 2 — aceitação do proprietário
|
||||
|
||||
Pacote 2 da Etapa 2 APROVADO E ENCERRADO EM QA, com referência `4fb9296f`. Análise de Mercado, Marcos, Pessoal, persistência, reconciliação mensal/anual e exportações aprovados. Aceitação baseada nas evidências comunicadas, sem inspecção directa dos ficheiros locais pelo proprietário; nenhuma pendência ou regressão reportada no pacote. Relatório integral de onze tabelas NÃO APTO; Pacote 3 NÃO INICIADO; instalação e publicação NÃO AUTORIZADAS. Preservados os encerramentos da Etapa 1 e do Pacote 1. Actualizadas somente documentação e matriz existentes; sem alterações funcionais, testes ou início de outro pacote.
|
||||
|
||||
### Pacote3 — Rácios financeiros implementados em QA
|
||||
|
||||
Base `a90c8ef2`: cinco rácios mensais/anuais integrados como11.ªtabela, usando os mesmos saldos/resultados aprovados. Fórmulas anteriores preservadas; apresentação arredonda apenas no fim. Classificação corrente opcional por mês no snapshot existente, sem presumir vencimentos. Balanços inconsistentes bloqueiam liquidez/endividamento/retorno; dados em falta e denominadores zero permanecem por determinar. Anos parciais não são anualizados; crescimento150% não bloqueia. Sem alterações financeiras dos pacotes aceites.
|
||||
|
||||
Seis testes novos e um teste de integração afectado aprovados; tipos/lint/buildQA aprovados. UI1440×1000/390×844, edição/gravação/recuperação1180,25 e bloqueio da liquidez por falta de classificação demonstrados. Word e impressão com2páginas cada conferidos integralmente. Provas e hashes em `outputs/controlled-5f7db7cd-20261120/package3/acceptance.json`; matriz individual no aditamento existente. Resultado técnico APTO em QA, por aceitar pelo proprietário. Relatório integral NÃO APTO até consolidação/CAE; Pacotes4e5 não iniciados nesta execução. Sem instalação/publicação/migrações; encerramentos anteriores preservados.
|
||||
|
||||
@@ -862,3 +862,40 @@ Pendências concretas do Pacote2: nenhuma identificada nos critérios acima; ace
|
||||
| Instalação e publicação | NÃO AUTORIZADAS |
|
||||
|
||||
Este registo substitui o estado técnico «por aceitar» pela aceitação expressa, preservando o histórico e as provas. Etapa 1 e Pacote 1 continuam aprovados e encerrados. A consolidação final e a classificação CAE permanecem pendentes; histórico QA perdido e tradução HTTP 503 mantêm-se independentes. Execução exclusivamente documental, sem código funcional, repetição de testes ou início de outros pacotes. A prioridade recomendada para Rácios não autoriza o seu início nesta execução.
|
||||
|
||||
### Pacote 3 — Rácios financeiros em QA
|
||||
|
||||
Base: encerramento do Pacote2 `a90c8ef2`. Pedido posterior do proprietário para completar a tabela de rácios. **Resultado técnico: APTO em QA, por aceitar pelo proprietário.** As onze tabelas estão agora integradas no modelo de relatório; o relatório integral continua NÃO APTO até à conferência consolidada e ao trabalho CAE. Esta execução não iniciou os Pacotes4ou5.
|
||||
|
||||
As cinco fórmulas previamente existentes em `business-plan-guidance.ts` foram respeitadas e permanecem inalteradas. A nova apresentação reutiliza os valores exactos das sete tabelas financeiras aprovadas, com divisão em inteiros/centavos e arredondamento apenas na apresentação final. Não altera receitas, impostos, resultados, balanços ou classificações anteriores.
|
||||
|
||||
| Indicador | Fórmula / unidade | Dependência e estado indeterminado | Prova sintética |
|
||||
| --- | --- | --- | --- |
|
||||
| Crescimento das vendas | Vendas/vendas anteriores−1; percentagem | Vendas válidas e períodos com igual duração; primeiro período e base anterior zero ficam por determinar | Meses constantes0,00%; cenário de dois anos completos com crescimento150,00% permitido; ano parcial não comparado ao ano completo |
|
||||
| Liquidez corrente | Activo corrente/passivo corrente; múltiplo | Balanço reconciliado, classificação declarada válida dentro dos totais e passivo corrente não nulo | Janeiro118,00×; ano2027:35,50×; classificação em falta num mês bloqueia apenas essa liquidez |
|
||||
| Endividamento | Total do passivo/total do activo; percentagem | Balanço reconciliado e activo positivo | Janeiro0,56%; ano2027:2,53% |
|
||||
| Margem líquida | Lucro líquido/vendas; percentagem | Resultados e vendas determinados; vendas não nulas | Mensal e anual26,00%; não é soma das percentagens mensais |
|
||||
| Retorno do capital | Lucro líquido/capital e resultados de fecho; percentagem | Balanço reconciliado, resultado determinado e capital não nulo; capital negativo explicitamente sinalizado | Janeiro14,77%; ano2027:67,53%; ano parcial5,33%, sem anualização |
|
||||
|
||||
A classificação corrente não estava documentada nos saldos existentes. Foi acrescentada recolha opcional dos dois totais por mês, exclusivamente para liquidez, em `ratioCurrentBalances` do `business_plan_snapshot` cifrado já existente. Não se inventam vencimentos nem se classificam automaticamente empréstimos, subvenções ou outros activos. A classificação não cria movimentos nem altera o balanço; pode ser completada mês a mês, conservando valores guardados fora do horizonte actualmente visível. Estruturas desconhecidas permanecem preservadas. Não há tabela de base de dados, armazenamento paralelo, migração, permissão ou serviço novo.
|
||||
|
||||
Bloqueios demonstrados: diferença de balanço0,01, rubricas/saldos indeterminados ou inconsistências sinalizadas no balanço suspendem liquidez, endividamento e retorno do capital. Um resultado indeterminado suspende margem e retorno. Indicadores independentes de uma falha conservam-se quando os seus próprios dados são válidos. Denominador zero nunca se converte em rácio zero. Os avisos são agrupados por causa/períodos, sem repetir a mesma instrução em cada linha. Financiamento insuficiente e crescimento superior a100% continuam não bloqueantes; não foram alteradas as regras aprovadas.
|
||||
|
||||
**Verificação:** seis testes novos em `financial-ratios-report.test.mjs`, todos aprovados: equivalência das fórmulas, agregação anual, crescimento150%, períodos parciais, balanço incoerente, dados em falta, denominadores zero, classificação inválida/malformada, classificação parcial, preservação dos inputs e persistência/exportações. Executado somente o teste de integração afectado do Pacote2, actualizado de10para11tabelas, aprovado. Tipos, lint/formatação e buildQA finais aprovados. Não repetidas as baterias da Etapa1 ou do Pacote1, nem os restantes testes do Pacote2. Avisos preexistentes de fonte opcional e chunks mantidos; build com código0.
|
||||
|
||||
Conferência funcional via Playwright/Chromium já instalados no QA `http://127.0.0.3:18720/simulador-fiscal`: em1440×1000 e390×844, criação201, edição/gravação200 e recuperação real da classificação1180,25, tanto no pedido/API como no campo após recarregamento. A divisão desta classificação por10,00 é apresentada como118,03×; nenhuma rubrica do balanço foi alterada. Apagar a classificação apresenta «Por determinar» na liquidez. Sem erros JavaScript ou transbordo da página; colunas anuais acessíveis por deslocamento interno. O painel de ajuda reaberto após recarregar foi fechado pelo controlo normal antes de continuar; sem cliques forçados, contorno de segurança ou alteração da interface.
|
||||
|
||||
| Prova visual | Estado | Artefacto em `outputs/controlled-5f7db7cd-20261120/package3/` |
|
||||
| --- | --- | --- |
|
||||
| Computador1440×1000, primeiros meses e anos | APROVADO | `1440-left.png`, `1440-right.png` |
|
||||
| Telemóvel390×844, tabela, cabeçalhos e notas ao deslocar | APROVADO | `390-left.png`, `390-right.png`, `mobile-viewport-{left,right,notes}.png` |
|
||||
| Word página1 | APROVADO: identificação sintética, fórmulas e primeiros meses | `word-1.png` |
|
||||
| Word página2 | APROVADO: continuação Maio–Dezembro, ano completo e parcial | `word-2.png` |
|
||||
| Impressão página1 | APROVADO: pressupostos e início da tabela | `print-1.png` |
|
||||
| Impressão página2 | APROVADO: continuações e rácios anuais | `print-2.png` |
|
||||
|
||||
Word aberto na aplicação nativa e convertido localmente para PDF; impressão pelo mecanismo HTML existente. As duas páginas de cada exportação foram rasterizadas com Poppler e examinadas, sem cortes de conteúdo ou sobreposições. Os artefactos são um recorte explícito da tabela de rácios para QA, não a validação consolidada do Pacote4. Todas as células do DOCX estão presentes no PDF Word. [Recibo e hashes](../../../../outputs/controlled-5f7db7cd-20261120/package3/acceptance.json), [Word](../../../../outputs/controlled-5f7db7cd-20261120/package3/report.docx), [PDF Word](../../../../outputs/controlled-5f7db7cd-20261120/package3/report.pdf), [PDF de impressão](../../../../outputs/controlled-5f7db7cd-20261120/package3/report-print.pdf).
|
||||
|
||||
Ficheiros: novos `financial-ratios-report.ts`, `financial-ratios-plan.tsx` e teste específico; extensão apenas de tipo no plano, ligação no componente financeiro e na secção financeira do dossier; uma expectativa do teste de integração passou a11tabelas. Documentação/manual/matriz existentes actualizados. Nenhuma alteração às cinco fórmulas anteriores, ao motor financeiro ou às sete demonstrações aprovadas.
|
||||
|
||||
Pendências do Pacote3: nenhuma identificada nos critérios acima; aceitação formal pelo proprietário pendente. Conferência consolidada e CAE continuam por executar. Etapa1/Pacotes1e2 encerrados preservados; histórico QA perdido e tradução503 independentes. Sem instalação, publicação ou migrações operacionais. Próxima tarefa recomendada: aceitar o Pacote3 e decidir a conferência consolidada, sem a iniciar nesta execução.
|
||||
|
||||
File diff suppressed because one or more lines are too long
@@ -0,0 +1,92 @@
|
||||
import type { BusinessFinancialPlanInput } from '@/lib/business-financial-plan';
|
||||
import { buildFinancialRatiosTable } from '@/lib/financial-ratios-report';
|
||||
import { InvestmentReportTables } from './investment-report-tables';
|
||||
export function FinancialRatiosPlan({
|
||||
plan,
|
||||
onChange,
|
||||
}: {
|
||||
plan: BusinessFinancialPlanInput;
|
||||
onChange: (p: BusinessFinancialPlanInput) => void;
|
||||
}) {
|
||||
const periods = plan.periods ?? 12,
|
||||
s = plan.ratioCurrentBalances;
|
||||
if (
|
||||
s &&
|
||||
(!Array.isArray(s.assetsByMonth) ||
|
||||
!Array.isArray(s.liabilitiesByMonth) ||
|
||||
s.assetsByMonth.some((x) => typeof x !== 'string') ||
|
||||
s.liabilitiesByMonth.some((x) => typeof x !== 'string'))
|
||||
)
|
||||
return (
|
||||
<p role="alert">
|
||||
A classificação corrente guardada tem uma estrutura
|
||||
desconhecida. O original foi preservado.
|
||||
</p>
|
||||
);
|
||||
const save = (
|
||||
key: 'assetsByMonth' | 'liabilitiesByMonth',
|
||||
index: number,
|
||||
value: string,
|
||||
) =>
|
||||
onChange({
|
||||
...plan,
|
||||
ratioCurrentBalances: {
|
||||
assetsByMonth: s?.assetsByMonth ?? Array(periods).fill(''),
|
||||
liabilitiesByMonth:
|
||||
s?.liabilitiesByMonth ?? Array(periods).fill(''),
|
||||
[key]: Array.from(
|
||||
{ length: Math.max(periods, s?.[key].length ?? 0) },
|
||||
(_, i) => (i === index ? value : (s?.[key][i] ?? '')),
|
||||
),
|
||||
},
|
||||
});
|
||||
return (
|
||||
<details className="my-4 rounded border p-3">
|
||||
<summary>Rácios financeiros e classificação corrente</summary>
|
||||
<p className="my-2 text-sm">
|
||||
Para a liquidez, declare os totais classificados como activo e
|
||||
passivo correntes no fecho de cada mês, segundo os vencimentos
|
||||
aplicáveis. Não alteram o balanço. Vazio permanece por
|
||||
determinar; zero só quando aplicável. Os restantes rácios
|
||||
utilizam as demonstrações já guardadas.
|
||||
</p>
|
||||
<details>
|
||||
<summary>Classificar saldos correntes para liquidez</summary>
|
||||
{Array.from({ length: periods }, (_, i) => (
|
||||
<fieldset
|
||||
key={i}
|
||||
className="my-2 grid gap-2 rounded border p-2 sm:grid-cols-2"
|
||||
>
|
||||
<legend>Mês {i + 1}</legend>
|
||||
{(['assetsByMonth', 'liabilitiesByMonth'] as const).map(
|
||||
(key) => (
|
||||
<label
|
||||
key={key}
|
||||
className="grid min-w-0 gap-1 text-sm"
|
||||
>
|
||||
{key === 'assetsByMonth'
|
||||
? 'Activo corrente'
|
||||
: 'Passivo corrente'}{' '}
|
||||
— mês {i + 1}
|
||||
<input
|
||||
className="min-w-0 rounded border p-2"
|
||||
type="number"
|
||||
min="0"
|
||||
step="0.01"
|
||||
value={s?.[key][i] ?? ''}
|
||||
onChange={(e) =>
|
||||
save(key, i, e.target.value)
|
||||
}
|
||||
/>
|
||||
</label>
|
||||
),
|
||||
)}
|
||||
</fieldset>
|
||||
))}
|
||||
</details>
|
||||
<InvestmentReportTables
|
||||
tables={[buildFinancialRatiosTable(plan)]}
|
||||
/>
|
||||
</details>
|
||||
);
|
||||
}
|
||||
@@ -22,6 +22,7 @@ import { BusinessPlanWarnings } from '@/components/business-plan-warnings';
|
||||
import { SimulationAnnualExample } from '@/components/simulation-annual-example';
|
||||
import { IntegralFinancialPlan } from '@/components/integral-financial-plan';
|
||||
import { MarketAnalysisPlan } from '@/components/market-analysis-plan';
|
||||
import { FinancialRatiosPlan } from '@/components/financial-ratios-plan';
|
||||
|
||||
const emptyPlan: BusinessFinancialPlanInput = {
|
||||
currency: '',
|
||||
@@ -942,6 +943,7 @@ export function SimulationBusinessPlan({
|
||||
)}
|
||||
<IntegralFinancialPlan plan={plan} onChange={savePlan} />
|
||||
<MarketAnalysisPlan plan={plan} onChange={savePlan} />
|
||||
<FinancialRatiosPlan plan={plan} onChange={savePlan} />
|
||||
<div className="my-3 flex flex-wrap items-end gap-3 rounded border p-3">
|
||||
<label className="grid gap-1 text-sm">
|
||||
Importar plano financeiro InvestMoz (.json, até 60 KB)
|
||||
|
||||
@@ -82,6 +82,10 @@ function validCurrency(value: string): boolean {
|
||||
}
|
||||
|
||||
export type BusinessFinancialPlanInput = {
|
||||
ratioCurrentBalances?: {
|
||||
assetsByMonth: string[];
|
||||
liabilitiesByMonth: string[];
|
||||
};
|
||||
marketAnalysis?: {
|
||||
baseYear: string;
|
||||
years: string;
|
||||
|
||||
@@ -0,0 +1,165 @@
|
||||
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;
|
||||
}
|
||||
@@ -1,5 +1,6 @@
|
||||
import { displayValue } from './display-value.ts';
|
||||
import { buildComplementaryTables } from './complementary-report.ts';
|
||||
import { buildFinancialRatiosTable } from './financial-ratios-report.ts';
|
||||
import {
|
||||
buildIntegralFinancialTables,
|
||||
displayReportMoney,
|
||||
@@ -531,6 +532,9 @@ function makeSections(
|
||||
}
|
||||
if (finance && financialPlan?.reportAssumptions) {
|
||||
finance.tables = buildIntegralFinancialTables(financialPlan);
|
||||
finance.tables.push(
|
||||
buildFinancialRatiosTable(financialPlan, finance.tables),
|
||||
);
|
||||
const periods = financialPlan.periods ?? 12;
|
||||
const cell = (id: string, label: string) =>
|
||||
finance.tables
|
||||
|
||||
@@ -183,7 +183,7 @@ void test('economic draft roundtrip and existing Word/print exports include thre
|
||||
const report = createProjectDossierReport(draft, {
|
||||
selectedSections: new Set(['market', 'team', 'execution', 'finance']),
|
||||
});
|
||||
assert.equal(report.sections.flatMap((s) => s.tables ?? []).length, 10);
|
||||
assert.equal(report.sections.flatMap((s) => s.tables ?? []).length, 11);
|
||||
const html = await createProjectDossierPrintHtml(report, []);
|
||||
for (const title of ['Análise de Mercado', 'Marcos', 'Pessoal'])
|
||||
assert.ok(html.includes(title));
|
||||
|
||||
@@ -0,0 +1,164 @@
|
||||
import test from 'node:test';
|
||||
import assert from 'node:assert/strict';
|
||||
import JSZip from 'jszip';
|
||||
import { financialReportFixture } from './fixtures/integral-financial-plan.mjs';
|
||||
import { buildFinancialRatiosTable } from '../../resources/js/lib/financial-ratios-report.ts';
|
||||
import { buildIntegralFinancialTables } from '../../resources/js/lib/integral-financial-report.ts';
|
||||
import {
|
||||
serializeBusinessPlanSnapshot,
|
||||
restoreBusinessPlanSnapshot,
|
||||
} from '../../resources/js/lib/business-financial-plan.ts';
|
||||
import { calculateDecisionRatios } from '../../resources/js/lib/business-plan-guidance.ts';
|
||||
import {
|
||||
createProjectDossierReport,
|
||||
createProjectDossierPrintHtml,
|
||||
generateProjectDossierDocx,
|
||||
} from '../../resources/js/lib/project-dossier-report.ts';
|
||||
const fixture = () => {
|
||||
const plan = financialReportFixture(13),
|
||||
source = buildIntegralFinancialTables(plan),
|
||||
b = source.find((t) => t.id === 'balance');
|
||||
plan.ratioCurrentBalances = {
|
||||
assetsByMonth: b.rows
|
||||
.find((r) => r[0] === 'Caixa líquida')
|
||||
.slice(1, 14),
|
||||
liabilitiesByMonth: b.rows
|
||||
.find((r) => r[0] === 'Total do passivo')
|
||||
.slice(1, 14),
|
||||
};
|
||||
return { plan, source };
|
||||
};
|
||||
const get = (t, label) => t.rows.find((r) => r[0] === label);
|
||||
|
||||
void test('a missing classification in later months does not erase an available earlier liquidity ratio', () => {
|
||||
const { plan, source } = fixture();
|
||||
plan.ratioCurrentBalances = {
|
||||
assetsByMonth: ['1180'],
|
||||
liabilitiesByMonth: ['10'],
|
||||
};
|
||||
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);
|
||||
});
|
||||
|
||||
void test('annual comparison uses two complete years and permits growth above 100 percent', () => {
|
||||
const plan = financialReportFixture(24);
|
||||
plan.products[0].monthlyUnitsByPeriod = [
|
||||
...Array(12).fill('10'),
|
||||
...Array(12).fill('25'),
|
||||
];
|
||||
const table = buildFinancialRatiosTable(plan);
|
||||
assert.equal(get(table, 'Crescimento das vendas').at(-1), '150,00%');
|
||||
assert.equal(get(table, 'Crescimento das vendas')[13], '150,00%');
|
||||
});
|
||||
void test('approved formulas are presented from the same monthly and annual statements, without summing ratios', () => {
|
||||
const { plan, source } = fixture();
|
||||
const t = buildFinancialRatiosTable(plan, source);
|
||||
assert.equal(t.issues.length, 0);
|
||||
const approved = calculateDecisionRatios(
|
||||
{
|
||||
cash: '1180',
|
||||
receivables: '0',
|
||||
inventory: '0',
|
||||
otherCurrentAssets: '0',
|
||||
longTermAssets: '590',
|
||||
accumulatedDepreciation: '0',
|
||||
currentLiabilities: '10',
|
||||
longTermLiabilities: '0',
|
||||
paidCapital: '1600',
|
||||
retainedResults: '-100',
|
||||
periodResult: '260',
|
||||
},
|
||||
'1000',
|
||||
);
|
||||
assert.equal(
|
||||
get(t, 'Liquidez corrente')[1],
|
||||
approved.currentLiquidity.toFixed(2).replace('.', ',') + '×',
|
||||
);
|
||||
assert.equal(
|
||||
get(t, 'Endividamento (passivo/activo)')[1],
|
||||
(approved.debtAssets * 100).toFixed(2).replace('.', ',') + '%',
|
||||
);
|
||||
assert.equal(get(t, 'Margem líquida')[1], '26,00%');
|
||||
assert.equal(get(t, 'Retorno do capital')[1], '14,77%');
|
||||
assert.equal(get(t, 'Margem líquida')[14], '26,00%');
|
||||
assert.equal(get(t, 'Retorno do capital')[14], '67,53%');
|
||||
assert.equal(get(t, 'Liquidez corrente')[14], '35,50×');
|
||||
assert.equal(get(t, 'Crescimento das vendas')[1], 'Por determinar');
|
||||
assert.equal(get(t, 'Crescimento das vendas')[2], '0,00%');
|
||||
assert.equal(get(t, 'Crescimento das vendas').at(-1), 'Por determinar');
|
||||
});
|
||||
void test('inconsistent balance blocks only dependent indicators; missing liquidity does not invent maturity', () => {
|
||||
const { plan, source } = fixture();
|
||||
delete plan.ratioCurrentBalances;
|
||||
let t = buildFinancialRatiosTable(plan, source);
|
||||
assert.equal(get(t, 'Liquidez corrente')[1], 'Por determinar');
|
||||
assert.equal(get(t, 'Margem líquida')[1], '26,00%');
|
||||
assert.equal(get(t, 'Retorno do capital')[1], '14,77%');
|
||||
source
|
||||
.find((t) => t.id === 'balance')
|
||||
.rows.find((r) => r[0] === 'Diferença do balanço')[1] = '0.01';
|
||||
t = buildFinancialRatiosTable(plan, source);
|
||||
assert.equal(get(t, 'Retorno do capital')[1], 'Por determinar');
|
||||
assert.equal(get(t, 'Endividamento (passivo/activo)')[1], 'Por determinar');
|
||||
assert.equal(get(t, 'Margem líquida')[1], '26,00%');
|
||||
assert.equal(get(t, 'Crescimento das vendas')[2], '0,00%');
|
||||
source
|
||||
.find((t) => t.id === 'profit-loss')
|
||||
.issues.push('Imposto indeterminado');
|
||||
assert.equal(
|
||||
get(buildFinancialRatiosTable(plan, source), 'Margem líquida')[1],
|
||||
'Por determinar',
|
||||
);
|
||||
});
|
||||
void test('zero denominators, invalid classification and malformed snapshots remain indeterminate; inputs unchanged', () => {
|
||||
const { plan, source } = fixture();
|
||||
const before = JSON.stringify(source);
|
||||
plan.ratioCurrentBalances.assetsByMonth[0] = '999999';
|
||||
let t = buildFinancialRatiosTable(plan, source);
|
||||
assert.equal(get(t, 'Liquidez corrente')[1], 'Por determinar');
|
||||
assert.equal(JSON.stringify(source), before);
|
||||
plan.ratioCurrentBalances.assetsByMonth[0] = '1180';
|
||||
plan.ratioCurrentBalances.liabilitiesByMonth[0] = '0';
|
||||
assert.equal(
|
||||
get(buildFinancialRatiosTable(plan, source), 'Liquidez corrente')[1],
|
||||
'Por determinar',
|
||||
);
|
||||
plan.ratioCurrentBalances.assetsByMonth[0] = { bad: true };
|
||||
assert.doesNotThrow(() => buildFinancialRatiosTable(plan, source));
|
||||
source
|
||||
.find((t) => t.id === 'sales')
|
||||
.rows.find((r) => r[0] === 'Vendas totais')[1] = '0.00';
|
||||
t = buildFinancialRatiosTable(plan, source);
|
||||
assert.equal(get(t, 'Margem líquida')[1], 'Por determinar');
|
||||
assert.equal(get(t, 'Crescimento das vendas')[2], 'Por determinar');
|
||||
});
|
||||
void test('ratio classifications persist in the existing snapshot and export as the final financial table', async () => {
|
||||
const { plan } = fixture(),
|
||||
snapshot = serializeBusinessPlanSnapshot(plan),
|
||||
recovered = restoreBusinessPlanSnapshot(snapshot);
|
||||
assert.deepEqual(recovered.ratioCurrentBalances, plan.ratioCurrentBalances);
|
||||
assert.deepEqual(
|
||||
buildFinancialRatiosTable(recovered),
|
||||
buildFinancialRatiosTable(plan),
|
||||
);
|
||||
const report = createProjectDossierReport(
|
||||
{ business_plan_snapshot: snapshot },
|
||||
{ selectedSections: new Set(['finance']) },
|
||||
);
|
||||
assert.equal(report.sections[0].tables.length, 8);
|
||||
assert.equal(report.sections[0].tables.at(-1).id, 'ratios');
|
||||
assert.match(
|
||||
await createProjectDossierPrintHtml(report, []),
|
||||
/Rácios financeiros/,
|
||||
);
|
||||
const doc = await generateProjectDossierDocx(report, []),
|
||||
zip = await JSZip.loadAsync(
|
||||
doc instanceof Blob ? await doc.arrayBuffer() : doc,
|
||||
);
|
||||
assert.match(
|
||||
await zip.file('word/document.xml').async('string'),
|
||||
/Rácios financeiros/,
|
||||
);
|
||||
});
|
||||
Reference in New Issue
Block a user