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
@@ -1197,7 +1197,7 @@ Nomes de ficheiros na coluna de implementação referem-se a `resources/js/lib/`
| V09 | PN P0073–0087 | Validação financeira | Aplicar todas as mensagens literais definidas em todos os formulários e consumidores | IMPLEMENTADO MAS NÃO VALIDADO | business-financial-plan.ts:25–34; complementary-report.ts; integral-financial-plan.tsx | 04d8db6c;4fb9296f | Mensagens locais existem; não há prova de cobertura literal integral de percentagens, datas, caixa e divergências. Validação funcional não comprova todos os textos exigidos. |
| V10 | PN P0081 | Validação financeira | Campo de prazo em dias e mensagem de intervalo 0–365 | INTEGRADO E VALIDADO | financial-plan-details.tsx; business-financial-plan.ts; financial-plan-warnings.ts | 9c34af04;19f06ddf | Campo opcional de prazo contratual em dias, persistido no snapshot 18; inteiro entre 0 e 365, com mensagem pedida para -1, 366, 30.5 e abc. Mantém-se a agenda mensal independente. Dependência indispensável do aviso exacto de crédito V08, não uma alteração da fórmula de caixa. E8: limites 0/30/90/91/365, recuperação e comparação exacta dos fluxos antes/depois. |
| V11 | PN P0083 | Validação financeira | Aviso de caixa negativa identifica o mês e valor | APROVADO E ENCERRADO EM QA | financial-plan-warnings.ts; monthly-negative-cash-warnings.test.mjs; componentes e relatório existentes | fe615e55; E16; prova-v11-caixa-mensal-20261120.json | Aceitação expressa do proprietário com base no relatório E16 do commit fe615e55, sem inspecção independente dos ficheiros locais. Cinco avisos Janeiro–Maio 2027 (-1720.00/-1340.00/-960.00/-580.00/-200.00 MZN), apesar do fecho anual +2460.00; cenário sem défices sem avisos indevidos; gravação e recuperação demonstradas em computador e móvel 390×844; seis testes específicos aprovados. Fórmulas financeiras preservadas. Encerramento exclusivamente documental, sem repetir testes ou modificar código; instalação, publicação e migrações não autorizadas. |
| V12 | PN P0085 | Validação financeira | Detectar toda a inconsistência entre tabelas, indicando tabela e campo | PARCIALMENTE DEMONSTRADO | integral-financial-report.ts; complementary-report.ts; financial-ratios-report.ts | E15; verificacao-f20-f22-v11-v12-20261120.json | E15: divergências de capital discriminado e saldos de abertura detectadas; corrigir entrada elimina a primeira. Mensagem de capital repetida nas sete tabelas centrais, sem campo exacto ou ligação de correcção. Reconciliação de pessoal já tem implementação/teste específico, não repetido. Cobertura de todas as inconsistências e indicação tabela/campo ainda não demonstradas. |
| V12 | PN P0085 | Validação financeira | Detectar toda a inconsistência entre tabelas, indicando tabela e campo | PARCIALMENTE DEMONSTRADO | financial-issue-presentation.ts; investment-report-tables.tsx; simulation-business-plan.tsx; project-dossier-document.ts | E15/E17; prova-v12-mensagens-20261120.json | E17: mensagens de capital, existências, activos, abertura e pessoal identificam tabelas/campos sem alterar detectores ou cálculos. Capital repetido nas sete tabelas e no resumo passa a aviso único; resumo genérico de abertura omitido quando há detalhe específico. Editor real QA em computador/móvel: capital 600 versus discriminação 700 e abertura 999 versus 1000, correcção e recuperação sem avisos antigos. Sete testes específicos aprovados; impressão/Word sem repetição. Mantém-se parcial: cobertura integral de inconsistências/campos não demonstrada, sem encerramento. |
| V13 | PN P0086 | Validação financeira | Lista Falta preencher com ligação directa a cada campo por corrigir | NÃO IMPLEMENTADO | integral-financial-plan.tsx; simulation-business-plan.tsx | — | Existem erros e notas; não foi encontrada implementação completa do sumário com ligações por campo pedido. |
| V14 | PN P0098 | Validação financeira | Aviso específico sobre textos opcionais em falta (concorrência/SWOT) | NÃO IMPLEMENTADO | business-plan-guidance.ts; business-plan-warnings.tsx | — | Catálogo de avisos não inclui estes textos opcionais. |
| C01 | PN P0015; ME P0115 | Portal — actividades existentes | Análise agregada privada sem divulgar empresas/contactos individuais | INTEGRADO E VALIDADO | app/Services/InvestorContext.php; componentes de consulta agregada | base bae996e1 (histórico de incorporação no documento) | E7: provas agregadas e protecções documentadas; não é publicação de listas individuais. |
@@ -1816,3 +1816,44 @@ O 503 de `/api/translate/languages` já conhecido não impediu o percurso em por
- Revisão das diferenças e hashes: motores financeiros, construtor de tabelas, fixture, componentes e fontes DOCX inalterados face a `63e211a3`; a única lógica funcional alterada é a produção de avisos. Restantes 87 linhas da matriz exactamente preservadas.
**Estado V11: INTEGRADO E VALIDADO EM QA, aguardando aceitação do proprietário; sem encerramento automático.** F20 parcial, F22 pendente e V12 parcial permanecem exactamente como em E15. P01 permanece suspenso/parcial. Próxima acção: apreciação desta prova V11; V12 continua apenas como frente recomendada, sem início autorizado.
### E17 — 20/11/2026 — V12 qualidade das mensagens de inconsistência
Referências: `fe3c229c`, E15/`63e211a3`, documentos Revisão 1 (PN XML 89/91) e autorização exclusiva para mensagens V12. V11 aprovado e encerrado preservado; F20/F22 sem alterações. Não foram acrescentados detectores, regras financeiras ou validações de negócio.
#### Defeitos demonstrados e correcção de apresentação
| Caso | Comportamento anterior | Apresentação corrigida | Evidência / limite |
| --- | --- | --- | --- |
| Capital discriminado versus capital próprio | Mesmo erro em sete tabelas e novamente no resumo inferior; indicação genérica “campos de financiamento” | Um painel com “Financiamento — Capital próprio”, identificação de Capital do proprietário, Capital do investidor e Capital adicional angariado, e indicação da secção de discriminação. Lista as sete tabelas afectadas sem repetir o erro | Editor real, testes das funções, componente real renderizado, impressão e Word; corrigir um lado elimina a mensagem |
| Saldos de abertura | Diferença 1.00 seguida de resumo genérico de períodos não reconciliados | Mensagem única “Balanço projectado / Saldos de abertura”, diferença exacta formatada e indicação de Capital e resultados anteriores e saldos patrimoniais de origem | Editor real e teste focalizado. Uma diferença agregada não permite concluir automaticamente qual saldo é o errado; a mensagem diz isso expressamente |
| Existências iniciais agregadas versus por produto | Mensagem sem localização clara do editor | Identifica Balanço / Existências iniciais e “Planear stock por produto”; pede corrigir total ou linhas | Tradução do diagnóstico existente testada; não foi feita prova individual deste caso no navegador |
| Aquisição de activos versus necessidades de arranque | Mensagem genérica de aquisições | Identifica Arranque / Aquisição de activos e “Caixa e activos necessários ao arranque”; explica a comparação entre requeridos/disponíveis e aquisições calculadas | Tradução do diagnóstico existente testada; sem alterar F16 e sem prova individual no navegador |
| Mapa de pessoal versus despesa do plano | Mensagem genérica de pressupostos | Identifica Folha salarial prevista no Mapa de pessoal, Pessoal em Lucros e perdas e Custo mensal de pessoal no editor; nomeia quantidade, remuneração mensal e meses activos e a linha de diferenças | Teste real das tabelas complementares: salário 100.01 em duas pessoas produz divergência, corrigir para 100.00 elimina-a; nenhum valor do plano sobrescrito. Sem prova individual no navegador |
A nova função `financial-issue-presentation.ts` traduz apenas diagnósticos conhecidos para rótulos existentes e agrupa mensagens iguais entre tabelas. Diagnósticos não mapeados conservam o texto original e as tabelas afectadas; não se inventa o campo responsável. O resumo genérico de períodos não reconciliados é omitido na apresentação quando já existe o diagnóstico específico de abertura. Os arrays `issues` originais, usados pelos cálculos e bloqueios dependentes, são preservados integralmente.
`InvestmentReportTables` apresenta o painel uma vez antes das tabelas. O resumo inferior de `SimulationBusinessPlan` deixa de repetir um erro já presente no relatório; mensagens locais de validação dos inputs continuam intactas. Impressão e Word usam o mesmo agrupamento por secção. Não se removem tabelas, notas, rubricas ou valores; as condições de validade e a disponibilidade de indicadores mantêm-se. A indicação “Tabelas afectadas” não significa que todas sejam a origem do erro.
#### Prova no editor real
QA `http://127.0.0.3:18723`, cookie separado `v12_messages_qa`, guarda da base `main_reference_20261104_test:55441`. Conta normal sintética ID 1406, rascunho privado `eea91578-ad9b-4979-a401-a6d1e11875a2`. Preparação pela fixture existente e serviço de rascunhos: capital próprio 600 e discriminação 700/0/0, sem dados de investidores reais. A preparação da fixture não é descrita como digitação manual inicial; login, edição, guarda e recuperação posteriores foram pelo percurso normal da aplicação.
1. Computador: plano carregado e mensagem de capital mostrada uma única vez. Os sete títulos das tabelas mantêm-se; erro genérico anterior não reaparece no resumo inferior.
2. Emulação móvel 390×844: mensagem de capital com os nomes dos campos e orientação para a secção, com quebras legíveis e sem deslocação horizontal necessária para a ler.
3. Corrigido pelo campo nativo “Capital próprio” de 600 para 700: desaparece a mensagem; guarda pelo formulário e recarga recuperam 700, discriminação 700 e ausência do aviso antigo. Não se trata de compensar dados reais: são entradas sintéticas deliberadas para verificar a resolução de uma divergência.
4. Em cenário separado no mesmo rascunho, alterado “Capital e resultados anteriores” de 1000 para 999: mensagem específica com diferença 1,00 e campos a conferir, sem o resumo genérico redundante. Conferida em móvel.
5. Reposto o campo de abertura em 1000. Após guarda automática e recarga, recuperados capital próprio 700 e capital anterior 1000, sem mensagens antigas de capital ou abertura. Leitura QA só de leitura confirma versão **5**; o único campo financeiro diferente da fixture inicial é `equity` (600→700). Nenhum outro valor foi adoptado automaticamente para ocultar a divergência.
Capturas e texto de acessibilidade foram inspeccionados na sessão de computer-use; não se entregam PNG exportados. A contagem de mensagens usa o texto apresentado, não a repetição semântica entre nós de lista e de texto da árvore de acessibilidade. O 503 conhecido de `/api/translate/languages` não impediu a prova em português e permanece fora do âmbito.
#### Testes e preservação
- Casos de `tests/frontend/financial-issue-presentation.test.mjs`: sete testes distintos aprovados em execuções focadas — capital e correcção; abertura sem atribuição falsa; pessoal e correcção; mensagens de existências/activos e diagnóstico desconhecido; componente real com painel único; impressão/Word com uma mensagem e objecto do relatório intacto.
- Depois de retirar o resumo genérico redundante de abertura, repetido apenas o caso `--test-name-pattern="opening imbalance"`: aprovado, com um único aviso. Não contá-lo como teste distinto nem repetir toda a bateria. Um sétimo teste foi acrescentado e executado separadamente para garantir que a deduplicação não oculta o erro quando o relatório tem estrutura desconhecida ou usa o exemplo anual; o resumo mantém nesses casos o diagnóstico.
- Tipos e lint focado aprovados na versão corrigida; build QA local final com saída 0. A verificação de tipos detectou uma referência colocada no componente errado durante a edição; foi corrigida antes da prova real, mantendo a validação local de MoneyInput. Nenhum erro de tipos conhecido permanece.
- Provas de cálculos já aprovadas reutilizadas; não repetidos testes de V11, F20/F22 ou auditoria geral. Fontes dos motores e avisos V11 conferidas face a `fe3c229c`, sem alterações. Rascunho V11 permanece versão 6, snapshot exacto da fixture aprovada, SHA-256 `926bc83bc227051348cd4e7df164ec7e521152510672a3c087dd7304f016ad8f`.
- Apenas a linha V12 alterada nas 88; restantes 87 exactamente preservadas, incluindo V11 aprovado/encerrado, F20 parcial, F22 pendente, P01 suspenso/parcial e aprovações financeiras anteriores.
**V12 permanece PARCIALMENTE DEMONSTRADO.** A melhoria da qualidade e deduplicação está validada no recorte descrito; não equivale à prova de detecção de todas as inconsistências nem à identificação de campo em todos os diagnósticos possíveis. Não se inventa uma causa para divergências agregadas. Sem encerramento automático ou início de nova frente. Próxima acção recomendada: apreciação deste recorte de mensagens antes de autorizar quaisquer casos adicionais. Instalação, publicação, migrações operacionais e alterações financeiras continuam não autorizadas.
@@ -0,0 +1,76 @@
{
"date": "2026-11-20",
"baseline": "fe3c229c",
"scope": [
"V12"
],
"status": "PARCIALMENTE DEMONSTRADO — mensagens corrigidas e validadas no recorte, sem cobertura integral demonstrada",
"changes": [
"Presentation-only mapping of five known financial diagnostics",
"One grouped issue across affected tables and no duplicate editor summary",
"Remove generic opening summary only when specific opening diagnostic exists",
"Same presentation in print and Word"
],
"core_financial_changes": false,
"raw_issues_mutated": false,
"real_ui": {
"url": "http://127.0.0.3:18723/simulador-fiscal?draft=eea91578-ad9b-4979-a401-a6d1e11875a2",
"qa_database": "main_reference_20261104_test",
"port": 55441,
"synthetic_actor": 1406,
"draft": "eea91578-ad9b-4979-a401-a6d1e11875a2",
"final_version": 5,
"final_snapshot_sha256": "0dae57c0bf8f99eb9803a917d228eba9cac345ee06a3e1fc09bfe26430ee579a",
"capital_case": "600 versus breakdown 700/0/0: one precise message; correction through Capital próprio to 700 removes it; save/reload confirms resolution.",
"opening_case": "Opening equity 999 instead of 1000: one precise opening message with difference 1.00; restore 1000 and reload removes it.",
"desktop": true,
"mobile_emulation": "390x844",
"evidence_kind": "Native Edge AX and screenshots inspected in tool session, not exported PNG files.",
"initial_setup": "Fixture through existing draft application service; subsequent login/edit/save/reload via normal UI.",
"final_fixture_delta": [
"equity: 600 -> 700"
]
},
"tests": {
"focused_tests_passed": 7,
"additional_focused_rerun": "opening imbalance only; passed, not a seventh distinct test",
"types": "passed after correcting misplaced reference during editing",
"focused_lint": "passed",
"final_qa_build_exit": 0,
"general_audit_repeated": false,
"execution_detail": "Initial six focused tests; rerun only opening imbalance after removing redundant summary; seventh new test run separately for unreadable-report/annual-example error visibility."
},
"limits": [
"No claim of detecting every possible inconsistency",
"Inventory and asset messages tested as mappings of existing diagnostics, without individual browser cases",
"Personnel detection and correction tested via actual complementary tables, without individual browser case",
"Unknown messages preserved; never invent an exact responsible field",
"Aggregated opening difference alone cannot identify which original balance is wrong"
],
"preservation": {
"other_matrix_rows_unchanged": 87,
"V11_status": "approved and closed unchanged",
"V11_draft_version": 6,
"V11_snapshot_sha256": "926bc83bc227051348cd4e7df164ec7e521152510672a3c087dd7304f016ad8f",
"V11_snapshot_exact": true,
"F20": "unchanged partial",
"F22": "unchanged pending",
"active_data_changes": false,
"installation": false,
"publication": false,
"migrations": false
},
"unchanged_hashes": {
"resources/js/lib/business-financial-plan.ts": "ba001c653ce23778b53ef9e818b9a9575ef0118071fcf050952c0df2e78ec565",
"resources/js/lib/integral-financial-report.ts": "e9d5dabaa7a7161486ef06c5a08ebb4d6a7ca9bbb156e2ed2b7828f187d48603",
"resources/js/lib/complementary-report.ts": "a017b6a070d7cc204f4711f2cf57b5780ca6fc197a9d8bb69d4a1da422de50af",
"resources/js/lib/financial-ratios-report.ts": "c79116a18e84696d28ecbfefe575e007ce2b1ea7d1cdbc7beb97334b729be216",
"resources/js/lib/financial-plan-warnings.ts": "9f05abd22a5fe4568bd6b34cfc57755eb121289e12ae8d4a4e2924e42040165e",
"resources/js/lib/business-plan-guidance.ts": "2b548ad3de0d45979cb12e21441d15292fdfe47f96ddecdb69fd2350cd3c73f5",
"resources/js/components/financial-plan-details.tsx": "4f48ff8cd4a4594af44c42337f17cdae06ec87ca7df4424cb84fb263123091e2",
"resources/js/components/integral-financial-plan.tsx": "6c226c67fa16640571a2d7c90582ba03e2209fcd1c7cdd3868251b81f364b6c2",
"tests/frontend/fixtures/integral-financial-plan.mjs": "e0d90ccce6fb84a9f387f3a5a2451d8c9e195207f6f3747c2800582139933cb7",
"docs/investmoz/v2/auditoria-portal/revisao-1-20261120/Mapa de erros 1 - Revisao 1.docx": "a001bdbc7f9daaa77f6e044ee6b5e5bcadbf8cb6a39c9c9c559b8fc7566e5597",
"docs/investmoz/v2/auditoria-portal/revisao-1-20261120/Plano de Negocios para inserir na simulacao fiscal - Revisao 1.docx": "919b01f42b441d8ed6b64050e558f19e0bd12596df021bc216aafceb3ff0a6ea"
}
}
@@ -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));
@@ -0,0 +1,210 @@
import assert from 'node:assert/strict';
import test from 'node:test';
import fs from 'node:fs';
import { createRequire } from 'node:module';
import { compileFunction } from 'node:vm';
import ts from 'typescript';
import React from 'react';
import { renderToStaticMarkup } from 'react-dom/server';
import JSZip from 'jszip';
import * as presentation from '../../resources/js/lib/financial-issue-presentation.ts';
import * as integral from '../../resources/js/lib/integral-financial-report.ts';
import { serializeBusinessPlanSnapshot } from '../../resources/js/lib/business-financial-plan.ts';
import { buildComplementaryTables } from '../../resources/js/lib/complementary-report.ts';
import { financialReportFixture } from './fixtures/integral-financial-plan.mjs';
import { complementaryFixture } from './fixtures/complementary-plan.mjs';
import {
createProjectDossierReport,
createProjectDossierPrintHtml,
generateProjectDossierDocx,
} from '../../resources/js/lib/project-dossier-report.ts';
const mismatch = () => ({
...financialReportFixture(12),
fundingBreakdown: {
ownerCapital: '700',
investorCapital: '0',
additionalCapital: '0',
},
});
void test('deduplication never hides a forecast error behind an unreadable report snapshot or the annual example', () => {
const plan = mismatch();
const error = integral.buildIntegralFinancialTables(plan)[0].issues[0];
assert.equal(presentation.forecastErrorShownInReport(plan, error), true);
assert.equal(
presentation.forecastErrorShownInReport(plan, 'Other error'),
false,
);
plan.reportAssumptions.startupExpenses = 'invalid structure';
assert.equal(presentation.forecastErrorShownInReport(plan, error), false);
delete plan.reportAssumptions;
plan.reportSource = 'annual_example';
assert.equal(presentation.forecastErrorShownInReport(plan, error), false);
});
void test('capital mismatch names the exact compared controls once and preserves all seven validity flags', () => {
const plan = mismatch(),
tables = integral.buildIntegralFinancialTables(plan),
before = JSON.stringify({ plan, tables });
assert.equal(tables.filter((t) => t.issues.length).length, 7);
const issues = presentation.financialIssuesForDisplay(tables);
assert.equal(issues.length, 1);
assert.equal(issues[0].tables.length, 7);
for (const field of [
'Capital próprio',
'Capital do proprietário',
'Capital do investidor',
'Capital adicional angariado',
])
assert.ok(issues[0].message.includes(field));
assert.equal(JSON.stringify({ plan, tables }), before);
plan.fundingBreakdown.ownerCapital = '600';
assert.deepEqual(
presentation.financialIssuesForDisplay(
integral.buildIntegralFinancialTables(plan),
),
[],
);
});
void test('opening imbalance identifies original fields and exact difference without guessing the responsible balance', () => {
const plan = financialReportFixture(12);
plan.reportAssumptions.openingEquity = '999';
const issues = presentation.financialIssuesForDisplay(
integral.buildIntegralFinancialTables(plan),
);
assert.equal(issues.length, 1);
const message = issues[0].message;
assert.match(message, /diferença 1,00/);
assert.match(message, /Capital e resultados anteriores/);
assert.match(message, /não permite identificar automaticamente/);
});
void test('personnel mismatch points to both tables and quantity, salary and active months; correction removes it', () => {
const { plan, draft, team } = complementaryFixture();
team[0].monthly_salary = '100.01';
draft.project_team_snapshot = JSON.stringify(team);
const tables = buildComplementaryTables(draft, plan);
const before = JSON.stringify({ plan, draft, tables });
const message = presentation
.financialIssuesForDisplay(tables)
.find((i) => i.message.includes('Mapa de pessoal')).message;
for (const field of [
'Folha salarial prevista',
'Pessoal',
'quantidade',
'remuneração mensal',
'meses activos',
])
assert.ok(message.includes(field));
assert.equal(JSON.stringify({ plan, draft, tables }), before);
team[0].monthly_salary = '100.00';
draft.project_team_snapshot = JSON.stringify(team);
assert.ok(
!presentation
.financialIssuesForDisplay(buildComplementaryTables(draft, plan))
.some((i) => i.message.includes('Mapa de pessoal')),
);
});
void test('inventory and startup messages identify their controls; unknown diagnostics remain visible without invented attribution', () => {
assert.match(
presentation.financialIssueMessage(
'A soma das existencias iniciais por produto deve coincidir com as existencias iniciais do plano.',
),
/Planear stock por produto/,
);
assert.match(
presentation.financialIssueMessage(
'As aquisições do cenário não correspondem às necessidades de activos. Confira os valores e adopte as aquisições calculadas.',
),
/Aquisição de activos/,
);
const raw = 'Diagnóstico específico não mapeado';
const tables = [
{ id: 'a', title: 'Tabela A', issues: [raw, raw] },
{ id: 'b', title: 'Tabela B', issues: [raw] },
];
assert.deepEqual(presentation.financialIssuesForDisplay(tables), [
{ message: raw, tables: ['Tabela A', 'Tabela B'] },
]);
});
void test('real table component presents one issue panel while retaining every table and calculated row', () => {
const code = ts.transpileModule(
fs.readFileSync(
new URL(
'../../resources/js/components/investment-report-tables.tsx',
import.meta.url,
),
'utf8',
),
{
compilerOptions: {
module: ts.ModuleKind.CommonJS,
target: ts.ScriptTarget.ES2022,
jsx: ts.JsxEmit.ReactJSX,
},
},
).outputText;
const module = { exports: {} },
require = createRequire(import.meta.url);
compileFunction(code, ['require', 'module', 'exports'])(
(name) =>
name === '@/lib/integral-financial-report'
? integral
: name === '@/lib/financial-issue-presentation'
? presentation
: require(name),
module,
module.exports,
);
const tables = integral.buildIntegralFinancialTables(mismatch()),
message = presentation.financialIssuesForDisplay(tables)[0].message;
const html = renderToStaticMarkup(
React.createElement(module.exports.InvestmentReportTables, { tables }),
);
assert.equal(html.split(message).length - 1, 1);
assert.equal(
(html.match(/aria-label="Dados financeiros a corrigir"/g) ?? []).length,
1,
);
assert.ok(tables.every((t) => html.includes(t.title)));
const valid = integral.buildIntegralFinancialTables(
financialReportFixture(12),
);
assert.ok(
!renderToStaticMarkup(
React.createElement(module.exports.InvestmentReportTables, {
tables: valid,
}),
).includes('Dados financeiros a corrigir'),
);
});
void test('print and Word present the same capital correction only once, without mutating report tables', async () => {
const report = createProjectDossierReport(
{
project_title: 'SINTÉTICO V12',
business_plan_snapshot: serializeBusinessPlanSnapshot(mismatch()),
},
{
selectedSections: new Set(['finance']),
generatedAt: '2026-11-20T12:00:00Z',
},
);
const before = JSON.stringify(report),
message = presentation.financialIssuesForDisplay(
report.sections.find((s) => s.id === 'finance').tables,
)[0].message;
const html = await createProjectDossierPrintHtml(report, []);
assert.equal(html.split(message).length - 1, 1);
const blob = await generateProjectDossierDocx(report, []),
zip = await JSZip.loadAsync(
blob instanceof Blob ? await blob.arrayBuffer() : blob,
),
xml = await zip.file('word/document.xml').async('string');
assert.equal(xml.split(message).length - 1, 1);
assert.equal(JSON.stringify(report), before);
});