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 660845b7..754d0916 100644 --- a/docs/investmoz/v2/auditoria-portal/apresentacao-contexto-qa-20261115.md +++ b/docs/investmoz/v2/auditoria-portal/apresentacao-contexto-qa-20261115.md @@ -1196,7 +1196,7 @@ Nomes de ficheiros na coluna de implementação referem-se a `resources/js/lib/` | V08 | PN P0090–0097 | Validação financeira | Avisos de prejuízo, margem baixa, equilíbrio, caixa, crescimento, crédito longo, endividamento e ausência de capital | INTEGRADO E VALIDADO | financial-plan-warnings.ts; integral-financial-plan.tsx; project-dossier-report.ts; financial-plan-details.tsx | 9c34af04;19f06ddf | Avisos de perda, margem, equilíbrio, caixa, crescimento, prazo, dívida e capital ligados às mesmas demonstrações e exportados no relatório. Prazo contratual recolhido em dias: 90 não avisa, 91 avisa; não se convertem meses em dias nem se altera a tesouraria. Dados ausentes não são presumidos. E8: 37 testes afectados, nove novos; prévia de UI e HTTP com prazo 91 recuperado. | | 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 | PENDENTE COM CAUSA IDENTIFICADA | integral-financial-report.ts; business-plan-guidance.ts | E15; verificacao-f20-f22-v11-v12-20261120.json | E15: cenário sintético com caixa negativa de Janeiro a Maio de 2027, de -1720.00 a -200.00 MZN, e fecho anual +2460.00 MZN. Valores preservados, mas avisos não identificam os meses/valores negativos; helper consulta fecho anual. Falha demonstrada no motor de avisos e relatório gerado, sem correcção nesta execução. | +| V11 | PN P0083 | Validação financeira | Aviso de caixa negativa identifica o mês e valor | INTEGRADO E VALIDADO | financial-plan-warnings.ts; monthly-negative-cash-warnings.test.mjs; componentes e relatório existentes | E16; prova-v11-caixa-mensal-20261120.json | E16: cinco avisos mensais Janeiro–Maio 2027, valores -1720.00/-1340.00/-960.00/-580.00/-200.00 MZN, com ano +2460.00. Editor real QA: cenário sem défices sem avisos, guarda e recarga; E15 reposto, guardado e recuperado em computador e móvel 390×844. Rascunho final v6 idêntico à fixture. Quatro regressões e dois testes relacionados aprovados. Sem alterar fórmulas; aguarda aceitação, sem encerramento automático. | | 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. | | 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. | @@ -1772,3 +1772,47 @@ Instalação, publicação e alterações funcionais não autorizadas nesta exec #### Preservação documental Actualizadas apenas F20/F22/V11/V12, esta secção e o recibo específico. Restantes 84 linhas exactamente como em `9932e05c`, incluindo P01/P02, F16/F31-A e F31-B documental. Código, fórmulas e fixture inalterados, verificados face à referência com normalização de CRLF/LF no texto. Nenhuma alteração de fonte original ou dado activo, instalação, publicação, migração, compilação ou auditoria geral. + + +### E16 — 20/11/2026 — V11 avisos mensais de caixa negativa + +Referência `63e211a3`/E15, Revisão 1 e autorização exclusiva V11. Corrigido somente `financial-plan-warnings.ts`: lê a linha “Caixa final” da tabela de fluxo de caixa já calculada, percorre apenas as colunas mensais do horizonte, identifica valores estritamente negativos e usa o calendário dos cabeçalhos. Cada aviso indica mês, ano, valor e moeda; não se acrescentam avisos em tabelas individuais. Os avisos anuais existentes permanecem, sem substituir os mensais. A verificação do sinal usa o valor decimal exacto, sem arredondar o saldo; não se calculam novos fluxos, juros, empréstimos ou compensações. + +O editor e o relatório do dossier já consomem o mesmo helper. Não foi necessário alterar componentes, motores de previsão, construção de tabelas ou exportadores. Valores indeterminados, zero, zero negativo e tabelas com entradas inválidas não originam défices inventados. Colunas de resumo anual não geram avisos mensais duplicados. Avisos são não bloqueantes e conservam os controlos existentes de dispensa. + +#### Correspondência exacta com E15 + +| Mês | Caixa final preservada (MZN) | Aviso observado no editor após recuperação | +| --- | --- | --- | +| Janeiro de 2027 | -1720.00 | Janeiro de 2027: -1 720,00 MZN | +| Fevereiro de 2027 | -1340.00 | Fevereiro de 2027: -1 340,00 MZN | +| Março de 2027 | -960.00 | Março de 2027: -960,00 MZN | +| Abril de 2027 | -580.00 | Abril de 2027: -580,00 MZN | +| Maio de 2027 | -200.00 | Maio de 2027: -200,00 MZN | +| Fecho anual 2027 | +2460.00 | O saldo anual positivo não omite os cinco avisos | + +Os restantes sete meses não recebem aviso de caixa negativa. A mensagem segue o requisito PN XML 87: “O saldo de caixa fica negativo em [mês/ano]: [valor/moeda]. Reveja os pagamentos, os prazos de crédito ou o financiamento.” O aviso de falta de financiamento de 100.00 MZN já existente no cenário é distinto, não um sexto mês negativo. + +#### Prova no editor real e persistência + +Aplicação real em `http://127.0.0.3:18722`, mesmo worktree, build QA local e guarda contra qualquer base/porta diferente de `main_reference_20261104_test:55441`. Cookie QA separado `v11_monthly_qa`. Nenhuma instalação/publicação operacional ou migração. Conta normal de investidor sintético ID 1405, sem concessão de permissões; rascunho privado `92756b14-1727-4760-998e-5b8489d7517d`. + +A fixture E15 foi preparada pelo serviço existente de rascunhos, em conta nova de ensaio: `financialReportFixture(12)`, apenas pagamentos operacionais por mês `['3000', '0', ...]`, todos os pressupostos identificados como sintéticos. Esta preparação não é apresentada como entrada manual inicial pela interface. Depois, login normal pelo navegador, recuperação pelo URL do rascunho e inspecção do plano financeiro real na etapa Investimento e financiamento. + +1. No computador, o plano mostrou os cinco meses e valores acima. +2. Pelo campo normal “Pagamento de despesas operacionais — mês 1”, alterado 3000 para 0, mantendo os restantes onze em zero: os cinco avisos desapareceram. Accionada a opção “Guardar e continuar mais tarde”; apareceu confirmação de dossier guardado no espaço privado. Após recarga, recuperado o primeiro pagamento 0 e ausência de avisos mensais indevidos. +3. Pelo mesmo editor, reposto 3000, guardado e recarregado: recuperados cinco avisos e a parcela 3000, com os valores E15. +4. Durante a manipulação da vista móvel, o cenário de ensaio ficou num estado de entrada incompleta. Foi reposto pelo importador normal com `e15-plan.json`, exportado da fixture exacta, sem correcção de código ou intervenção em dados reais. A conferência foi retomada sobre o snapshot reposto; não se conta o estado incompleto como prova de sucesso. Não se atribui a V11 uma causa de navegação não delimitada nesta execução. +5. Emulação móvel 390×844: inspeccionados Janeiro a Maio, texto legível com quebras e sem deslocação horizontal necessária para ler os avisos. Recarga em móvel, recuperação e nova conferência das cinco mensagens. As capturas foram inspeccionadas na sessão de computer-use; não são ficheiros PNG exportados neste commit. +6. Leitura administrativa em transacção só de leitura, com a mesma identidade e guarda QA: rascunho final versão **6**, snapshot exactamente igual à fixture, SHA-256 `926bc83bc227051348cd4e7df164ec7e521152510672a3c087dd7304f016ad8f`. Nenhum movimento fictício usado para eliminar défices; o ensaio sem défice e a reposição foram alterações deliberadas e reversíveis de dados sintéticos. + +O 503 de `/api/translate/languages` já conhecido não impediu o percurso em português e não foi alterado. A prova cobre o rascunho financeiro privado e os avisos; não certifica submissão fiscal, pagamentos ou financiamento realizado. + +#### Testes directamente afectados + +- `node --test tests/frontend/monthly-negative-cash-warnings.test.mjs`: quatro testes aprovados — E15/cinco avisos, não negativos/indeterminados, sessenta meses negativos com mudança de ano, e cada aviso uma vez no relatório sem duplicação nas tabelas. Preservação exacta dos inputs e tabelas, incluindo recuperação do snapshot. +- `node --test --test-name-pattern="financial warnings|credit warning" tests/frontend/financial-plan-pending-requirements.test.mjs`: dois testes relacionados aprovados. Não repetida a suite inteira. +- `npm.cmd run types:check`: aprovado. Lint focado no helper e novo teste: aprovado após explicitar `void` nas promessas do test runner, sem alteração dos cenários. Compilação QA local (`INVESTMOZ_QA_BUILD=1`): saída 0. Sem instalação de dependências. +- 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. diff --git a/docs/investmoz/v2/auditoria-portal/prova-v11-caixa-mensal-20261120.json b/docs/investmoz/v2/auditoria-portal/prova-v11-caixa-mensal-20261120.json new file mode 100644 index 00000000..939f867c --- /dev/null +++ b/docs/investmoz/v2/auditoria-portal/prova-v11-caixa-mensal-20261120.json @@ -0,0 +1,82 @@ +{ + "date": "2026-11-20", + "baseline": "63e211a3", + "scope": [ + "V11" + ], + "status": "INTEGRADO E VALIDADO EM QA — AGUARDA ACEITAÇÃO", + "logic_changed": [ + "resources/js/lib/financial-plan-warnings.ts" + ], + "formula_changes": false, + "monthly_results": [ + { + "period": "2027-01", + "value": "-1720.00" + }, + { + "period": "2027-02", + "value": "-1340.00" + }, + { + "period": "2027-03", + "value": "-960.00" + }, + { + "period": "2027-04", + "value": "-580.00" + }, + { + "period": "2027-05", + "value": "-200.00" + } + ], + "annual_closing": "2460.00", + "currency": "MZN", + "tests": { + "new_regression_tests": 4, + "related_filtered_tests": 2, + "types": "passed", + "focused_lint": "passed", + "qa_build_exit": 0 + }, + "real_ui": { + "url": "http://127.0.0.3:18722/simulador-fiscal?draft=92756b14-1727-4760-998e-5b8489d7517d", + "database": "main_reference_20261104_test", + "port": 55441, + "synthetic_actor": 1405, + "initial_setup": "Fixture prepared via existing application draft service, not claimed as manual initial entry. Normal browser login, editing, save and reload thereafter.", + "desktop": "Five exact warnings; edit first monthly operating payment 3000→0, no deficit warnings; save and reload 0; restore 3000, save and reload five exact warnings.", + "mobile": "390x844, all five warnings inspected; reload and recovery inspected again.", + "trial_interruption": "During mobile interaction, synthetic plan reached incomplete-input state. Restored exact fixture via normal JSON importer; final saved snapshot exact and successful mobile reload repeated. No claim about an unrelated navigation cause.", + "evidence_kind": "Native Edge accessibility text and screenshots inspected in computer-use session; no exported PNG files.", + "draft": "92756b14-1727-4760-998e-5b8489d7517d", + "final_version": 6, + "snapshot_exact_fixture": true, + "snapshot_sha256": "926bc83bc227051348cd4e7df164ec7e521152510672a3c087dd7304f016ad8f" + }, + "preservation": { + "other_matrix_rows_unchanged": 87, + "F20": "unchanged partial", + "F22": "unchanged pending", + "V12": "unchanged partial", + "P01": "unchanged partial; interventions suspended", + "active_data_writes": false, + "installation": false, + "publication": false, + "migration": false + }, + "unchanged_source_hashes": { + "resources/js/lib/business-financial-plan.ts": "ba001c653ce23778b53ef9e818b9a9575ef0118071fcf050952c0df2e78ec565", + "resources/js/lib/integral-financial-report.ts": "e9d5dabaa7a7161486ef06c5a08ebb4d6a7ca9bbb156e2ed2b7828f187d48603", + "resources/js/lib/business-plan-guidance.ts": "2b548ad3de0d45979cb12e21441d15292fdfe47f96ddecdb69fd2350cd3c73f5", + "resources/js/lib/project-dossier-report.ts": "2e2b6fb5965e4e3540dc513935fdcd7bc6985a1b292271b5167c8e97e5290569", + "resources/js/lib/complementary-report.ts": "a017b6a070d7cc204f4711f2cf57b5780ca6fc197a9d8bb69d4a1da422de50af", + "resources/js/components/integral-financial-plan.tsx": "6c226c67fa16640571a2d7c90582ba03e2209fcd1c7cdd3868251b81f364b6c2", + "resources/js/components/simulation-business-plan.tsx": "cc793dd612ebdc77936d185d9a03b08e731309b70ae7922cb4ebea3520a9473c", + "resources/js/components/business-plan-warnings.tsx": "b126fa0b7b8436a0cbf00c8d0fb885a7f49d3a5c6d1c9efdce4555bca6aad5f2", + "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/lib/financial-plan-warnings.ts b/resources/js/lib/financial-plan-warnings.ts index a78f9f9f..6b02232f 100644 --- a/resources/js/lib/financial-plan-warnings.ts +++ b/resources/js/lib/financial-plan-warnings.ts @@ -3,7 +3,10 @@ import { businessPlanWarnings, type PlanWarningMetrics, } from './business-plan-guidance.ts'; -import type { InvestmentReportTable } from './integral-financial-report.ts'; +import { + displayReportMoney, + type InvestmentReportTable, +} from './integral-financial-report.ts'; /** Only use determined values from the same tables/version, never replace missing amounts by zero. */ export function financialPlanWarningMetrics( @@ -83,7 +86,7 @@ export function financialPlanWarnings( plan: BusinessFinancialPlanInput, tables: InvestmentReportTable[], ) { - return financialPlanWarningMetrics(plan, tables).flatMap( + const annualWarnings = financialPlanWarningMetrics(plan, tables).flatMap( ({ year, metrics, count }) => { // The warning helper compares a full year's sales to a monthly threshold. const adjusted = { @@ -113,6 +116,42 @@ export function financialPlanWarnings( return warnings; }, ); + const cashflow = tables.find((table) => table.id === 'cashflow'); + const closing = cashflow?.rows.find((row) => row[0] === 'Caixa final'); + if (!cashflow || cashflow.issues.length || !closing) return annualWarnings; + const months = [ + 'Janeiro', + 'Fevereiro', + 'Março', + 'Abril', + 'Maio', + 'Junho', + 'Julho', + 'Agosto', + 'Setembro', + 'Outubro', + 'Novembro', + 'Dezembro', + ]; + const monthlyWarnings = closing + .slice(1, (plan.periods ?? 12) + 1) + .flatMap((value, index) => { + const period = cashflow.headers[index + 1]; + const calendar = /^(\d{4})-(0[1-9]|1[0-2])$/.exec(period ?? ''); + if ( + !calendar || + !/^-\d+\.\d{2}$/.test(value) || + BigInt(value.replace('.', '')) >= 0n + ) + return []; + return [ + { + id: `cash-negative-${period}`, + message: `O saldo de caixa fica negativo em ${months[Number(calendar[2]) - 1]} de ${calendar[1]}: ${displayReportMoney(value)} ${plan.currency}. Reveja os pagamentos, os prazos de crédito ou o financiamento.`, + }, + ]; + }); + return [...annualWarnings, ...monthlyWarnings]; } function inputCreditDays(value: string | undefined) { diff --git a/tests/frontend/monthly-negative-cash-warnings.test.mjs b/tests/frontend/monthly-negative-cash-warnings.test.mjs new file mode 100644 index 00000000..788a0a82 --- /dev/null +++ b/tests/frontend/monthly-negative-cash-warnings.test.mjs @@ -0,0 +1,110 @@ +import assert from 'node:assert/strict'; +import test from 'node:test'; +import { financialReportFixture } from './fixtures/integral-financial-plan.mjs'; +import { buildIntegralFinancialTables } from '../../resources/js/lib/integral-financial-report.ts'; +import { financialPlanWarnings } from '../../resources/js/lib/financial-plan-warnings.ts'; +import { + serializeBusinessPlanSnapshot, + restoreBusinessPlanSnapshot, +} from '../../resources/js/lib/business-financial-plan.ts'; +import { createProjectDossierReport } from '../../resources/js/lib/project-dossier-report.ts'; + +const monthly = (plan, tables = buildIntegralFinancialTables(plan)) => + financialPlanWarnings(plan, tables).filter((w) => + w.id.startsWith('cash-negative-'), + ); +const e15 = () => { + const plan = financialReportFixture(12); + plan.monthlyOperatingPaymentsByPeriod = ['3000', ...Array(11).fill('0')]; + return plan; +}; + +void test('E15: exactly five monthly deficits remain visible despite a positive annual closing, without changing tables or inputs', () => { + const plan = e15(), + tables = buildIntegralFinancialTables(plan); + const before = JSON.stringify({ plan, tables }); + const warnings = monthly(plan, tables); + const expected = [ + ['2027-01', 'Janeiro', '-1 720,00'], + ['2027-02', 'Fevereiro', '-1 340,00'], + ['2027-03', 'Março', '-960,00'], + ['2027-04', 'Abril', '-580,00'], + ['2027-05', 'Maio', '-200,00'], + ]; + assert.deepEqual( + warnings.map((w) => w.id), + expected.map(([date]) => `cash-negative-${date}`), + ); + expected.forEach(([, month, value], index) => { + assert.ok( + warnings[index].message.includes(`${month} de 2027: ${value} MZN`), + ); + }); + assert.equal( + tables + .find((t) => t.id === 'cashflow') + .rows.find((r) => r[0] === 'Caixa final')[13], + '2460.00', + ); + assert.equal(JSON.stringify({ plan, tables }), before); + assert.deepEqual( + monthly( + restoreBusinessPlanSnapshot(serializeBusinessPlanSnapshot(plan)), + ), + warnings, + ); +}); + +void test('nonnegative, zero, undetermined and invalid cash balances do not invent monthly deficits or dates', () => { + const plan = financialReportFixture(12); + assert.deepEqual(monthly(plan), []); + const tables = buildIntegralFinancialTables(plan); + const row = tables + .find((t) => t.id === 'cashflow') + .rows.find((r) => r[0] === 'Caixa final'); + row[1] = '0.00'; + row[2] = '-0.00'; + row[3] = 'Por determinar'; + assert.deepEqual(monthly(plan, tables), []); + const invalid = e15(); + invalid.reportAssumptions.taxSource = ''; + assert.deepEqual(monthly(invalid), []); +}); + +void test('all sixty negative months use the calendar headers once, excluding annual summary columns', () => { + const plan = financialReportFixture(60); + plan.monthlyOperatingPayments = '2000'; + const warnings = monthly(plan); + assert.equal(warnings.length, 60); + assert.equal(new Set(warnings.map((w) => w.id)).size, 60); + assert.match(warnings[0].message, /Janeiro de 2027/); + assert.match(warnings[12].message, /Janeiro de 2028/); + assert.match(warnings[59].message, /Dezembro de 2031/); +}); + +void test('dossier report includes each monthly warning once, without copying it into individual tables', () => { + const plan = e15(); + const report = createProjectDossierReport( + { + project_title: 'SINTÉTICO V11', + business_plan_snapshot: serializeBusinessPlanSnapshot(plan), + }, + { + selectedSections: new Set(['finance']), + generatedAt: '2026-11-20T12:00:00Z', + }, + ); + const section = report.sections.find((s) => s.id === 'finance'); + for (const warning of monthly(plan)) { + assert.equal( + section.paragraphs.filter((p) => p.includes(warning.message)) + .length, + 1, + ); + assert.ok( + section.tables.every( + (t) => !JSON.stringify(t).includes(warning.message), + ), + ); + } +});