diff --git a/docs/investmoz/v2/auditoria-portal/apresentacao-contexto-qa-20261115.md b/docs/investmoz/v2/auditoria-portal/apresentacao-contexto-qa-20261115.md index 5d68c49b..3746a835 100644 --- a/docs/investmoz/v2/auditoria-portal/apresentacao-contexto-qa-20261115.md +++ b/docs/investmoz/v2/auditoria-portal/apresentacao-contexto-qa-20261115.md @@ -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. diff --git a/docs/investmoz/v2/auditoria-portal/prova-v12-mensagens-20261120.json b/docs/investmoz/v2/auditoria-portal/prova-v12-mensagens-20261120.json new file mode 100644 index 00000000..545a4fe2 --- /dev/null +++ b/docs/investmoz/v2/auditoria-portal/prova-v12-mensagens-20261120.json @@ -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" + } +} diff --git a/resources/js/components/investment-report-tables.tsx b/resources/js/components/investment-report-tables.tsx index 4f6265ff..38a4d894 100644 --- a/resources/js/components/investment-report-tables.tsx +++ b/resources/js/components/investment-report-tables.tsx @@ -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 (
+ {issues.length > 0 && ( + + )} {tables.map((table) => (

{table.title}

- {table.issues.length > 0 && ( - - )} {table.rows.length > 0 && (
- {error && ( + {error && !forecastErrorShownInReport(plan, error) && (

{error}

diff --git a/resources/js/lib/financial-issue-presentation.ts b/resources/js/lib/financial-issue-presentation.ts new file mode 100644 index 00000000..bb5ff7f6 --- /dev/null +++ b/resources/js/lib/financial-issue-presentation.ts @@ -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(); + 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()]; +} diff --git a/resources/js/lib/project-dossier-document.ts b/resources/js/lib/project-dossier-document.ts index 09c7cdcb..941353bc 100644 --- a/resources/js/lib/project-dossier-document.ts +++ b/resources/js/lib/project-dossier-document.ts @@ -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(`

${escapeHtml(issue.message)}

`); + content.push( + `

Tabelas afectadas: ${escapeHtml(issue.tables.join('; '))}.

`, + ); + } for (const entry of section.tables ?? []) { content.push(`

${escapeHtml(entry.title)}

`); - for (const note of [...entry.issues, ...entry.notes]) + for (const note of entry.notes) content.push(`

${escapeHtml(note)}

`); for (const slice of investmentReportTableSlices(entry)) content.push(htmlTable(slice.headers, slice.rows)); diff --git a/tests/frontend/financial-issue-presentation.test.mjs b/tests/frontend/financial-issue-presentation.test.mjs new file mode 100644 index 00000000..00c2bfe8 --- /dev/null +++ b/tests/frontend/financial-issue-presentation.test.mjs @@ -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); +});