fix(qa): clarify and deduplicate V12 financial inconsistency messages

This commit is contained in:
2026-11-20 21:54:16 +02:00
parent fe3c229ca9
commit 4ef5f58e97
7 changed files with 451 additions and 11 deletions
@@ -2,24 +2,40 @@ import {
displayReportMoney,
type InvestmentReportTable,
} from '@/lib/integral-financial-report';
import { financialIssuesForDisplay } from '@/lib/financial-issue-presentation';
export function InvestmentReportTables({
tables,
}: {
tables: InvestmentReportTable[];
}) {
const issues = financialIssuesForDisplay(tables);
return (
<div className="space-y-5">
{issues.length > 0 && (
<aside
aria-label="Dados financeiros a corrigir"
className="space-y-2 rounded border border-amber-400 bg-amber-50 p-3 text-sm"
>
<h4 className="font-semibold">
Confira os dados de origem
</h4>
<ul className="list-disc space-y-2 pl-5">
{issues.map((issue) => (
<li key={issue.message}>
<p>{issue.message}</p>
<p className="text-xs">
Tabelas afectadas: {issue.tables.join('; ')}
.
</p>
</li>
))}
</ul>
</aside>
)}
{tables.map((table) => (
<section key={table.id} aria-label={table.title}>
<h4 className="font-semibold">{table.title}</h4>
{table.issues.length > 0 && (
<ul className="list-disc pl-5 text-amber-900">
{[...new Set(table.issues)].map((issue) => (
<li key={issue}>{issue}</li>
))}
</ul>
)}
{table.rows.length > 0 && (
<div
className="overflow-x-auto"
@@ -26,6 +26,7 @@ import { FinancialRatiosPlan } from '@/components/financial-ratios-plan';
import { PlanEconomicClassification } from '@/components/plan-economic-classification';
import { FinancialPlanDetails } from '@/components/financial-plan-details';
import { StartupAssetRequirements } from '@/components/startup-asset-requirements';
import { forecastErrorShownInReport } from '@/lib/financial-issue-presentation';
const emptyPlan: BusinessFinancialPlanInput = {
currency: '',
@@ -2531,7 +2532,7 @@ export function SimulationBusinessPlan({
)}
</details>
{error && (
{error && !forecastErrorShownInReport(plan, error) && (
<p role="alert" className="my-3 text-sm text-red-800">
{error}
</p>
@@ -0,0 +1,78 @@
import {
buildIntegralFinancialTables,
displayReportMoney,
isReportAssumptions,
type InvestmentReportTable,
} from './integral-financial-report.ts';
import type { BusinessFinancialPlanInput } from './business-financial-plan.ts';
/** 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 {
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()];
}
+20 -2
View File
@@ -16,6 +16,7 @@ import {
TextRun,
WidthType,
} from 'docx';
import { financialIssuesForDisplay } from './financial-issue-presentation.ts';
import JSZip from 'jszip';
import { investmentReportTableSlices } from './integral-financial-report.ts';
import {
@@ -451,6 +452,17 @@ export async function generateProjectDossierDocx(
);
const table = sectionTable(section);
if (table) children.push(table);
for (const issue of financialIssuesForDisplay(section.tables ?? [])) {
children.push(
new Paragraph({ text: issue.message, keepNext: true }),
);
children.push(
new Paragraph({
text: `Tabelas afectadas: ${issue.tables.join('; ')}.`,
keepNext: true,
}),
);
}
for (const entry of section.tables ?? []) {
children.push(
new Paragraph({
@@ -459,7 +471,7 @@ export async function generateProjectDossierDocx(
keepNext: true,
}),
);
for (const note of [...entry.issues, ...entry.notes])
for (const note of entry.notes)
children.push(new Paragraph({ text: note, keepNext: true }));
for (const slice of investmentReportTableSlices(entry)) {
// Word merges adjacent tables and then repeats the first
@@ -640,9 +652,15 @@ export async function createProjectDossierPrintHtml(
]),
),
);
for (const issue of financialIssuesForDisplay(section.tables ?? [])) {
content.push(`<p>${escapeHtml(issue.message)}</p>`);
content.push(
`<p>Tabelas afectadas: ${escapeHtml(issue.tables.join('; '))}.</p>`,
);
}
for (const entry of section.tables ?? []) {
content.push(`<h3>${escapeHtml(entry.title)}</h3>`);
for (const note of [...entry.issues, ...entry.notes])
for (const note of entry.notes)
content.push(`<p>${escapeHtml(note)}</p>`);
for (const slice of investmentReportTableSlices(entry))
content.push(htmlTable(slice.headers, slice.rows));