fix(qa): clarify and deduplicate V12 financial inconsistency messages
This commit is contained in:
@@ -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()];
|
||||
}
|
||||
@@ -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);
|
||||
});
|
||||
Reference in New Issue
Block a user