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 638dc1fb..0535cfb3 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 | financial-issue-presentation.ts; investment-report-tables.tsx; simulation-business-plan.tsx; startup-asset-requirements.tsx; integral-financial-plan.tsx; integral-financial-report.ts; business-financial-plan.ts; project-dossier-document.ts | 4ef5f58e; 74ba0bd0; E17/E18/E19/E20; prova-v12-editor-d1-d2-d3-20261120.json | Correcções técnicas D1/D2/D3 aceites no âmbito dos testes. E20 concluiu a prova real das três mensagens em computador e emulação móvel 390x844, correcção, remoção e recuperação do mesmo rascunho, iniciado na versão 12; D1 recuperado na versão 17, D2 na 24. D1/D3 continuam a impedir cálculo inválido; D2 conserva o diagnóstico não bloqueante existente. Nenhum código ou teste alterado/repetido nesta conferência. D1/D2/D3 propostos para aceitação individual; V12 permanece aberto porque os restantes limites de cobertura de mensagens de E18 não foram demonstrados neste recorte. Restantes 87 linhas preservadas. | +| V12 | PN P0085 | Validação financeira | Detectar toda a inconsistência entre tabelas, indicando tabela e campo | PARCIALMENTE DEMONSTRADO | financial-issue-presentation.ts; financial-ratios-report.ts; integral-financial-report.ts; business-financial-plan.ts; componentes existentes do editor e relatório | 4ef5f58e; 74ba0bd0; f81306f1; E17–E21; prova-v12-mensagens-restantes-20261120.json | D1/D2/D3 aceites individualmente pelo proprietário, sem repetição. E21 demonstra aquisições, existências iniciais, falta de stock/reconciliação, impostos mensais, parcelas de abertura, recuperação de vendas, preços mensais e classificação corrente/rácio dependente, em computador e emulação móvel. Corrigidos apenas diagnósticos reproduzidos e recuperação editável de meses duplicados; rejeição financeira preservada. Gravação/recuperação no rascunho sintético existente, versão 79. Cinco testes focados e um teste directamente afectado aprovados; fórmulas preservadas. V12 permanece parcialmente validado e aberto: resolução da divergência de moeda do pessoal e ramos estruturais/agendas não percorridos conservam os limites exactos de E21. Restantes 87 linhas preservadas. | | 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. | @@ -1952,4 +1952,35 @@ D2 mantém a semântica anterior de diagnóstico do relatório: não se criou ne Reutilizados os quatro testes focados e a comparação numérica de seis cenários de `74ba0bd0`, sem nova execução. Nenhuma alteração de código funcional ou da instalação de tradução. V11, F20/F22, originais e restantes aprovações preservados; só os dados sintéticos do rascunho foram editados pela aplicação. -**Classificação fundamentada:** o recorte D1/D2/D3 ficou funcionalmente demonstrado. V12 mantém-se **parcialmente validado — aberto**, sem presumir aprovação global. E18 ainda contém limites de prova fora destas três lacunas: mensagens de divergência das aquisições e de existências iniciais por produto; reconciliação por período/falta de stock; omissões de agendas/modos de compras; parcelas de abertura, além dos limites documentados de mensagens de moeda/rácios. Esta lista reutiliza E18, não constitui auditoria nova, defeitos adicionais confirmados ou autorização para iniciar outra frente. Uma decisão sobre a suficiência dessas provas existentes deve ser específica; as provas D1/D2/D3 não precisam de ser repetidas. \ No newline at end of file +**Classificação fundamentada:** o recorte D1/D2/D3 ficou funcionalmente demonstrado. V12 mantém-se **parcialmente validado — aberto**, sem presumir aprovação global. E18 ainda contém limites de prova fora destas três lacunas: mensagens de divergência das aquisições e de existências iniciais por produto; reconciliação por período/falta de stock; omissões de agendas/modos de compras; parcelas de abertura, além dos limites documentados de mensagens de moeda/rácios. Esta lista reutiliza E18, não constitui auditoria nova, defeitos adicionais confirmados ou autorização para iniciar outra frente. Uma decisão sobre a suficiência dessas provas existentes deve ser específica; as provas D1/D2/D3 não precisam de ser repetidas. + +## E21 — V12: mensagens restantes no editor — 20/11/2026 + +Base `f81306f1`, quadro E18 e requisitos Revisão 1. D1/D2/D3 foram aceites individualmente pelo proprietário e não foram reabertos. Usados apenas o QA isolado `http://127.0.0.3:18724`, conta normal sintética 1407 e rascunho existente `af6686b4-f210-4203-9ef1-0d85537426ae`. Tradução respondeu HTTP 200 no início; nenhuma intervenção no LibreTranslate. Reutilizados os ficheiros sintéticos D1/D3 existentes pelo importador normal, sem recriar as seis referências financeiras ou executar a auditoria geral. As entradas desta prova são pressupostos sintéticos, sem dados reais ou taxas legais presumidas. + +| Mensagem/regra de E18 | Ensaio e resultado individual | Alteração necessária | +| --- | --- | --- | +| Aquisições versus necessidades | 500 versus 600: aviso nomeia Aquisição de activos e necessidades; resultado/CSV inválido impedido. Repor 600 remove aviso e devolve resultados. Computador, 390x844 e recuperação móvel conferidos | Nenhuma | +| Existências iniciais versus produtos | Total 1 versus soma 0: aviso identifica total e stock por produto. Repor 0 remove aviso, recupera resultados; invalidade impede previsão/CSV | Nenhuma | +| Stock insuficiente e reconciliação por período | Unidades mensais 10, encomenda 200, custo unitário 40: faltas nos meses 1/2 e diferença do balanço. Mensagens passam a indicar Existências, campos do stock, mês e linha Diferença do balanço. Repor unidades 0 remove os três avisos. Sem reduzir vendas ou compensar diferenças | Só apresentação; `issues` e linhas de origem conservados | +| Impostos por mês | Imposto reconhecido do mês 2 vazio; pagamento do mês 2 vazio e -1: diagnóstico anteriormente genérico, agora campo/mês e correcção exactos. Repor 30/20 remove avisos e recupera tabelas. A rejeição é das tabelas fiscais dependentes; não se criou bloqueio global da previsão base/CSV | Só mensagens dos mesmos ramos de conversão e negatividade | +| Parcelas de recebíveis e valores a pagar de abertura | Em cada agenda, 60% + 50% rejeitado. Mensagem nomeia agenda e campos Percentagem do saldo inicial; 60% + 40% remove aviso e recupera resultados/CSV. Saldos iniciais sintéticos 0: ensaio da distribuição, não prova de recebimento/pagamento real | Só apresentação | +| Recuperação de vendas vencidas | Duas linhas mês 1/1 e percentagens 0: rejeição mantida. Antes, recuperação editável recusava o snapshot e o editor ficava visualmente vazio; recibo versão 49 demonstra dados completos ainda guardados. Corrigida apenas restauração editável para permitir corrigir o mês duplicado. Após recarregar, mensagem e todos os dados recuperados; mudar segunda linha para mês 2 elimina aviso e devolve resultados/CSV | Guarda de edição; restauração estrita e previsão continuam a rejeitar duplicação | +| Preço por mês | Preço do produto 1, mês 2 vazio: aviso existente identifica campo/mês, mais indicação local; previsão/CSV impedidos. Repor 100 elimina aviso. Recuperação final conserva 100 | Nenhuma | +| Classificação corrente | Activo corrente mês 1 = 999999, restantes declarados 0: aviso genérico reproduzido. Corrigido diagnóstico por campo e mês, sem alterar limite ou fórmula. Passivo 999999 verificado separadamente; vazio identifica preenchimento. Repor 0 remove aviso. Sem mensagens duplicadas entre mês e resumo anual | Só diagnóstico; Set elimina a repetição anual do mesmo campo/mês | +| Rácios dependentes do balanço | Mesma falta de stock, unidades 10: mensagem existente identifica Balanço e períodos 2027-01, 2027-02 e ano parcial; indicadores dependentes ficam por determinar. Corrigir unidades para 0 elimina mensagem. Classificação válida não compensa o balanço | Nenhuma | +| Compras agregadas versus stock por produto | Informação preventiva visível nos dois formatos: compras agregadas inactivas enquanto o stock estiver por produto. Controlos existentes desactivam os modos incompatíveis; reutilizada rejeição por teste E18. Não foi forçado um snapshot incoerente para simular acesso normal impossível | Sem alteração; limite do ramo legado mantido abaixo | + +Os casos da tabela foram observados no editor em computador e emulação Edge 390x844; não se declara dispositivo físico. Nas mensagens longas foi conferida a leitura por deslocação vertical. Capturas e acessibilidade constam da transcrição, sem alegar PNG exportado. Nos avisos de falta de stock e rácios, rejeição significa não apresentar o indicador dependente como válido: são diagnósticos não bloqueantes da previsão, como antes. Guardar um rascunho inválido editável não equivale a aceitar financeiramente as entradas. + +Gravação/recuperação: versão 49 conserva o cenário inválido completo; versão 61 conserva correcções de stock, impostos, parcelas 60/40 e recuperações nos meses 1/2. Recarregamento final móvel recupera o mesmo plano e preço mensal 100. Leitura protegida e apenas de consulta confirma versão 79, hash `2b51a000d2406489ffb82425ca2f22c6b0f7053589d1f2c1ba75716d7b7573c7`, classificação corrente 0/0 em ambos os meses e unidades 0. O original sintético versão 12 e provas anteriores permanecem preservados nos artefactos existentes. Recibo versionado: `prova-v12-mensagens-restantes-20261120.json`. + +Verificação proporcional: cinco testes focados em `v12-remaining-messages.test.mjs` aprovados; um teste directamente afectado em `financial-ratios-report.test.mjs` aprovado, agora verifica 24 mensagens distintas para 12 meses com dois campos em falta, sem apagar o rácio anterior válido. Tipos e lint dos ficheiros alterados aprovados. Compilação QA gerou o manifesto/activos e registou «built in 26.03s»; a sessão PowerShell terminou com estado 1 e capturou avisos em stderr (fontaine opcional, dimensão de chunks/tempos), sem erro de compilação no registo; o código individual de saída do npm não foi recolhido separadamente. Não foi reinstalado pacote nem repetida a compilação para ocultar o estado do invólucro. Primeira chamada npm/npx.ps1 foi recusada pela política de scripts; usados os executáveis .cmd existentes, sem alterar a política. A primeira regressão nova detectou uma referência local incorrecta `editable`, corrigida para `options.editable` e abrangida pelo teste aprovado. Sem alteração de fórmulas, valores calculados, movimentos ou regras financeiras; reutilizadas as provas numéricas anteriores. + +**Limites exactos de cobertura, sem presumir novos defeitos:** + +- Moeda do mapa de pessoal versus plano: E3/E18 já provam comparação e ausência de conversão automática; não se demonstrou nesta execução a mensagem e resolução no editor actual. A aprovação V10 permanece intacta. +- Agendas de quantidades, custos, pagamentos manuais e compras agregadas: leitura confirma mensagens por rubrica/mês e testes temporais existentes; a prova nova por célula abrangeu preço e impostos, não todos esses ramos. Não equiparar uma família testada a todos os controlos percorridos. +- Agendas com comprimento incompatível, meses fora do horizonte e modos de compras incompatíveis por importação: guardas/testes existentes preservados; não foram criados ficheiros malformados nem forçados valores inacessíveis nos selectores normais. A prevenção normal de modos foi observada, mas não substitui a prova de cada mensagem de rejeição da importação. + +**Classificação: V12 PARCIALMENTE VALIDADO — ABERTO.** Os casos individuais acima ficam propostos para aceitação, com os limites expressos. Nenhuma mensagem obrigatória sem prova foi declarada concluída. Próximo recorte recomendado: apenas os ramos enumerados, reutilizando os cenários disponíveis; não repetir aquisições, existências, D1/D2/D3 ou os ensaios concluídos sem regressão. V11, F20/F22 e todas as restantes 87 linhas mantidos. Sem instalação, publicação, migrações ou alterações de fontes/dados activos. diff --git a/docs/investmoz/v2/auditoria-portal/prova-v12-mensagens-restantes-20261120.json b/docs/investmoz/v2/auditoria-portal/prova-v12-mensagens-restantes-20261120.json new file mode 100644 index 00000000..c9798510 --- /dev/null +++ b/docs/investmoz/v2/auditoria-portal/prova-v12-mensagens-restantes-20261120.json @@ -0,0 +1,59 @@ +{ + "date_local": "2026-11-20", + "baseline_commit": "f81306f1", + "scope": "V12 remaining messages only; D1/D2/D3 accepted and not reopened", + "qa": { + "url": "http://127.0.0.3:18724", + "database": "main_reference_20261104_test:55441", + "actor": 1407, + "draft": "af6686b4-f210-4203-9ef1-0d85537426ae", + "translation_initial_status": 200, + "desktop": true, + "mobile": "Edge emulation 390x844, not physical" + }, + "saved": { + "invalid_version": 49, + "invalid_hash": "1ad02166b45c7a16fa553bedb8c5670fd9c0013fa8afd07d3245555762df4a4e", + "final_version": 79, + "final_hash": "2b51a000d2406489ffb82425ca2f22c6b0f7053589d1f2c1ba75716d7b7573c7" + }, + "matrix": { + "count": 88, + "changed": [ + "V12" + ], + "other_rows_preserved": 87 + }, + "verification": { + "focused_tests": 5, + "affected_existing_tests": 1, + "types": "passed", + "lint": "passed", + "qa_bundle": "built in 26.03s, manifest generated; PowerShell wrapper status 1 with captured stderr warnings", + "financial_scenarios": "prior accepted evidence reused, not rerun" + }, + "individual_evidence": "See E21 individual table and CUA transcript; screenshots not exported as PNG", + "remaining": [ + "personnel/project currency mismatch message and resolution in current editor", + "other schedule cells: quantities, variable costs, manual payments, aggregate purchases", + "structural import guards: schedule length, out-of-horizon months, incompatible purchase modes" + ], + "classification": "V12 partially validated, open", + "preserved": [ + "D1", + "D2", + "D3", + "V11", + "F20", + "F22", + "financial formulas", + "original sources", + "active data", + "LibreTranslate installation" + ], + "operations": { + "installs": false, + "publication": false, + "migrations": false + } +} diff --git a/resources/js/lib/business-financial-plan.ts b/resources/js/lib/business-financial-plan.ts index f5a35897..e1f881f8 100644 --- a/resources/js/lib/business-financial-plan.ts +++ b/resources/js/lib/business-financial-plan.ts @@ -636,7 +636,7 @@ export function restoreBusinessPlanSnapshot( entry.month < 1 || entry.month > 60 || typeof entry.percent !== 'string' || - months.has(entry.month) + (!options.editable && months.has(entry.month)) ) return null; months.add(entry.month); diff --git a/resources/js/lib/financial-issue-presentation.ts b/resources/js/lib/financial-issue-presentation.ts index 4bc3d431..114cf352 100644 --- a/resources/js/lib/financial-issue-presentation.ts +++ b/resources/js/lib/financial-issue-presentation.ts @@ -37,6 +37,29 @@ export function forecastErrorShownInReport( /** Presentation only: preserve the validation result, source issue and every financial value. */ export function financialIssueMessage(issue: string): string { + const shortage = + /^Mês (\d+): existências insuficientes para as vendas declaradas\.$/.exec( + issue, + ); + if (shortage) + return `Balanço Projectado / Existências — mês ${shortage[1]}: stock insuficiente para as vendas declaradas. Confira «Existências iniciais», «Encomenda», «Prazo de recepcao» e «Unidades por mes» em «Planear stock por produto», ou as compras agregadas quando esse for o modo escolhido. Consulte a falta por produto no mapa de existências e corrija os pressupostos; as vendas não são reduzidas automaticamente.`; + if ( + issue === + 'Existem períodos não reconciliados; reveja as rubricas indicadas.' + ) + return 'Balanço Projectado / Diferença do balanço: existem períodos não reconciliados. Consulte os meses desta linha e os diagnósticos específicos apresentados, incluindo existências, depreciação e dívida. Corrija os campos de origem indicados; a diferença, por si só, não identifica um único campo errado e não é compensada automaticamente.'; + if ( + issue === + 'A soma das cobranças declaradas de recebíveis de abertura não pode exceder 100%.' + ) + return 'Fluxo de Caixa / Parcelas adicionais de recebíveis de abertura: a soma excede 100%. Corrija os campos «Percentagem do saldo inicial» das parcelas; inclua também a percentagem da cobrança única, se seleccionada. Não altere o saldo inicial apenas para fazer coincidir a distribuição.'; + if ( + issue === + 'A soma das liquidações declaradas de valores a pagar não pode exceder 100%.' + ) + return 'Fluxo de Caixa / Liquidação de valores a pagar de abertura: a soma excede 100%. Corrija os campos «Percentagem do saldo inicial» dos pagamentos; o total não pode exceder 100%.'; + if (issue === 'Cada recuperação deve ter um mês único dentro do horizonte.') + return 'Fluxo de Caixa / Recuperação de vendas vencidas: confira os campos «Mês». Cada recuperação deve ter um mês diferente, dentro do horizonte do plano. Corrija o mês repetido ou remova a linha duplicada; as percentagens são aplicadas ao saldo vencido, não somadas como parcelas do saldo inicial.'; if ( issue === 'O capital discriminado não corresponde ao capital introduzido. Confira os campos de financiamento.' diff --git a/resources/js/lib/financial-ratios-report.ts b/resources/js/lib/financial-ratios-report.ts index 83d06ea5..d91f6c81 100644 --- a/resources/js/lib/financial-ratios-report.ts +++ b/resources/js/lib/financial-ratios-report.ts @@ -69,8 +69,8 @@ export function buildFinancialRatiosTable( ) as Record; const periods = plan.periods ?? 12, settings = plan.ratioCurrentBalances; - const blockedPeriods: string[] = [], - unclassifiedPeriods: string[] = []; + const blockedPeriods: string[] = []; + const classificationIssues = new Set(); const settingsValid = settings && Array.isArray(settings.assetsByMonth) && @@ -138,7 +138,21 @@ export function buildFinancialRatiosTable( : unknown, ); if (!consistent) blockedPeriods.push(headers[i + 1]); - if (!validCurrent) unclassifiedPeriods.push(headers[i + 1]); + if (!validCurrent) { + for (const [label, value, total] of [ + ['Activo corrente', currentAssets, assets], + ['Passivo corrente', currentLiabilities, liabilities], + ] as const) { + if (value === null) + classificationIssues.add( + `Rácios financeiros / ${label} — mês ${end + 1}: preencha um montante não negativo com até duas casas decimais; indique zero apenas quando aplicável.`, + ); + else if (total !== null && value > total) + classificationIssues.add( + `Rácios financeiros / ${label} — mês ${end + 1}: o montante excede o total correspondente do balanço. Corrija este campo de classificação; não altere o balanço para acomodar a classificação.`, + ); + } + } if (capital !== null && capital < 0n) result.notes.push( `${headers[i + 1]}: capital negativo; o retorno conserva o sinal matemático e exige interpretação desta situação.`, @@ -149,10 +163,7 @@ export function buildFinancialRatiosTable( result.issues.push( `Balanço inconsistente ou indeterminado: liquidez, endividamento e retorno do capital não calculados em ${blockedPeriods.join(', ')}.`, ); - if (unclassifiedPeriods.length) - result.issues.push( - `Para determinar a liquidez, classifique activo e passivo correntes dentro dos totais do balanço. Períodos por completar ou corrigir: ${unclassifiedPeriods.join(', ')}.`, - ); + result.issues.push(...classificationIssues); if (!sales || sales.issues.length) result.issues.push( 'Vendas indeterminadas: crescimento e margem não calculados.', diff --git a/resources/js/lib/integral-financial-report.ts b/resources/js/lib/integral-financial-report.ts index cd47d036..374794b9 100644 --- a/resources/js/lib/integral-financial-report.ts +++ b/resources/js/lib/integral-financial-report.ts @@ -183,22 +183,35 @@ export function buildIntegralFinancialTables( return total + cents(row.amount); }, 0n); const count = result.rows.length; - const schedule = (values: string[]) => { + const schedule = (values: string[], field: string) => { if (!Array.isArray(values) || values.length !== count) throw new Error( 'Preencha imposto estimado e pagamento fiscal para cada mês, incluindo zero quando aplicável.', ); - return values.map((value) => { - const amount = cents(value); + return values.map((value, month) => { + let amount: bigint; + try { + amount = cents(value); + } catch { + throw new Error( + `Impostos por mês — ${field}, mês ${month + 1}: preencha este campo com um montante até duas casas decimais; indique zero apenas quando aplicável.`, + ); + } if (amount < 0n) throw new Error( - 'Os impostos estimados não podem ser negativos.', + `Impostos por mês — ${field}, mês ${month + 1}: o montante não pode ser negativo. Corrija este campo.`, ); return amount; }); }; - const taxExpenses = schedule(a.taxExpenseByMonth), - taxPayments = schedule(a.taxPaymentByMonth); + const taxExpenses = schedule( + a.taxExpenseByMonth, + 'Imposto reconhecido', + ), + taxPayments = schedule( + a.taxPaymentByMonth, + 'Pagamento fiscal previsto', + ); if (!a.taxSource.trim()) throw new Error( 'Indique a fonte ou o pressuposto fiscal, incluindo quando não prevê imposto.', diff --git a/tests/frontend/financial-ratios-report.test.mjs b/tests/frontend/financial-ratios-report.test.mjs index e86ffc48..36c1ec03 100644 --- a/tests/frontend/financial-ratios-report.test.mjs +++ b/tests/frontend/financial-ratios-report.test.mjs @@ -39,7 +39,13 @@ void test('a missing classification in later months does not erase an available const table = buildFinancialRatiosTable(plan, source); assert.equal(get(table, 'Liquidez corrente')[1], '118,00×'); assert.equal(get(table, 'Liquidez corrente')[2], 'Por determinar'); - assert.equal(table.issues.length, 1); + assert.equal(table.issues.length, 24); + assert.equal(new Set(table.issues).size, 24); + assert.ok( + table.issues.every((issue) => + /corrente — mês (?:[2-9]|1[0-3]):/.test(issue), + ), + ); }); void test('annual comparison uses two complete years and permits growth above 100 percent', () => { diff --git a/tests/frontend/v12-remaining-messages.test.mjs b/tests/frontend/v12-remaining-messages.test.mjs new file mode 100644 index 00000000..d7f15f4f --- /dev/null +++ b/tests/frontend/v12-remaining-messages.test.mjs @@ -0,0 +1,165 @@ +import test from 'node:test'; +import assert from 'node:assert/strict'; +import { financialReportFixture } from './fixtures/integral-financial-plan.mjs'; +import { buildIntegralFinancialTables } from '../../resources/js/lib/integral-financial-report.ts'; +import { buildFinancialRatiosTable } from '../../resources/js/lib/financial-ratios-report.ts'; +import { + financialIssueMessage, + financialIssuesForDisplay, +} from '../../resources/js/lib/financial-issue-presentation.ts'; +import { + serializeBusinessPlanSnapshot, + restoreBusinessPlanSnapshot, + forecastBusinessPlan, +} from '../../resources/js/lib/business-financial-plan.ts'; + +test('V12: current classification identifies each invalid field once without changing ratio rows or statements', () => { + const plan = financialReportFixture(2); + const source = buildIntegralFinancialTables(plan); + const original = structuredClone(source); + plan.ratioCurrentBalances = { + assetsByMonth: ['0', '0'], + liabilitiesByMonth: ['0', '0'], + }; + const valid = buildFinancialRatiosTable(plan, source); + for (const [key, label] of [ + ['assetsByMonth', 'Activo corrente'], + ['liabilitiesByMonth', 'Passivo corrente'], + ]) { + for (const value of ['', '999999']) { + plan.ratioCurrentBalances[key][0] = value; + const table = buildFinancialRatiosTable(plan, source); + assert.equal(table.issues.length, 1); + assert.ok(table.issues[0].includes(label + ' — mês 1:')); + assert.match( + table.issues[0], + value === '' ? /preencha um montante/ : /excede o total/, + ); + assert.equal( + table.rows.find((row) => row[0] === 'Liquidez corrente')[1], + 'Por determinar', + ); + } + plan.ratioCurrentBalances[key][0] = '0'; + assert.deepEqual(buildFinancialRatiosTable(plan, source), valid); + } + assert.deepEqual(source, original); +}); + +test('V12: missing or negative tax cells identify exact field and month; correction removes diagnostic', () => { + const plan = financialReportFixture(2); + const valid = buildIntegralFinancialTables(plan); + for (const [key, label, original] of [ + ['taxExpenseByMonth', 'Imposto reconhecido', '30'], + ['taxPaymentByMonth', 'Pagamento fiscal previsto', '20'], + ]) { + for (const value of ['', '-1']) { + plan.reportAssumptions[key][1] = value; + const issues = financialIssuesForDisplay( + buildIntegralFinancialTables(plan), + ); + assert.equal(issues.length, 1); + assert.ok(issues[0].message.includes(label + ', mês 2')); + assert.match( + issues[0].message, + value === '' ? /preencha este campo/ : /não pode ser negativo/, + ); + } + plan.reportAssumptions[key][1] = original; + assert.deepEqual(buildIntegralFinancialTables(plan), valid); + } +}); + +test('V12: stock and period reconciliation messages identify original controls without altering issues or rows', () => { + const raw = [ + 'Mês 2: existências insuficientes para as vendas declaradas.', + 'Existem períodos não reconciliados; reveja as rubricas indicadas.', + ]; + const tables = [ + { + id: 'balance', + title: 'Balanço Projectado', + issues: raw, + rows: [['Diferença do balanço', '-200.00']], + }, + ]; + const before = JSON.stringify(tables); + const messages = financialIssuesForDisplay(tables); + assert.equal(messages.length, 2); + for (const field of [ + 'mês 2', + 'Existências iniciais', + 'Encomenda', + 'Unidades por mes', + ]) + assert.ok(messages[0].message.includes(field)); + assert.match(messages[1].message, /Diferença do balanço/); + assert.match(messages[1].message, /não identifica um único campo errado/); + assert.equal(JSON.stringify(tables), before); +}); + +test('V12: opening installment overflow names the right percentage fields and never attributes a false unique culprit', () => { + for (const [kind, text] of [ + [ + 'receivables', + 'A soma das cobranças declaradas de recebíveis de abertura não pode exceder 100%.', + ], + [ + 'payables', + 'A soma das liquidações declaradas de valores a pagar não pode exceder 100%.', + ], + ]) { + const message = financialIssueMessage(text); + assert.match(message, /Fluxo de Caixa/); + assert.match(message, /Percentagem do saldo inicial/); + assert.match( + message, + kind === 'receivables' ? /recebíveis/ : /valores a pagar/, + ); + const plan = financialReportFixture(2); + const key = + kind === 'receivables' + ? 'openingReceivablesInstallments' + : 'openingPayablesInstallments'; + plan[key] = [ + { month: 1, percent: '60' }, + { month: 2, percent: '50' }, + ]; + assert.throws( + () => forecastBusinessPlan(plan), + /não pode exceder 100%/, + ); + plan[key][1].percent = '40'; + assert.doesNotThrow(() => forecastBusinessPlan(plan)); + } +}); + +test('V12 regression: duplicate recovery months remain editable without blanking a saved plan; strict restore and forecast still reject', () => { + const plan = financialReportFixture(2); + plan.salesRecoverySchedule = [ + { month: 1, percent: '0' }, + { month: 1, percent: '0' }, + ]; + const snapshot = serializeBusinessPlanSnapshot(plan); + assert.equal(restoreBusinessPlanSnapshot(snapshot), null); + const editable = restoreBusinessPlanSnapshot(snapshot, { editable: true }); + assert.ok(editable); + assert.equal(editable.products[0].unitPrice, '100'); + assert.deepEqual( + editable.salesRecoverySchedule, + plan.salesRecoverySchedule, + ); + assert.throws(() => forecastBusinessPlan(editable), /mês único/); + assert.match( + financialIssueMessage( + 'Cada recuperação deve ter um mês único dentro do horizonte.', + ), + /campos «Mês»/, + ); + editable.salesRecoverySchedule[1].month = 2; + const recovered = restoreBusinessPlanSnapshot( + serializeBusinessPlanSnapshot(editable), + ); + assert.ok(recovered); + assert.doesNotThrow(() => forecastBusinessPlan(recovered)); +});