fix(qa): identify every negative cash month in V11 warnings

This commit is contained in:
2026-11-20 21:38:39 +02:00
parent 63e211a36b
commit fe615e5572
4 changed files with 278 additions and 3 deletions
@@ -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.
@@ -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"
}
}
+41 -2
View File
@@ -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) {
@@ -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),
),
);
}
});