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 b0edf17c..6bfbee2f 100644 --- a/docs/investmoz/v2/auditoria-portal/apresentacao-contexto-qa-20261115.md +++ b/docs/investmoz/v2/auditoria-portal/apresentacao-contexto-qa-20261115.md @@ -1173,7 +1173,7 @@ Nomes de ficheiros na coluna de implementação referem-se a `resources/js/lib/` | F17 | PN P0052 | Relatório financeiro | Calcular automaticamente vendas dos anos seguintes a partir do crescimento esperado | INTEGRADO E VALIDADO | business-financial-plan.ts; financial-plan-details.tsx; simulation-business-plan.tsx | 9c34af04 | Opt-in explícito de crescimento composto das quantidades após cada 12 meses; agendas mensais explícitas prevalecem, preços/custos unitários mantêm-se. Nove regressões novas e integrações afectadas: 37 testes aprovados; E8. Sem activação automática nos planos anteriores. | | F18 | PN P0055 | Relatório financeiro | Separar capital do proprietário, do investidor e dinheiro adicional angariado no plano geral | INTEGRADO E VALIDADO | financial-plan-details.tsx; business-financial-plan.ts; integral-financial-report.ts | 9c34af04 | Proprietário, investidor e capital adicional discriminados; soma exacta ao centavo actualiza equity e divergências são recusadas no cálculo. Empréstimos/suprimentos/subvenções conservam tipos próprios. Capital adicional é contribuição de capital expressamente indicada, não receita ou dívida inferida. E8: UI real, roundtrip, HTTP e exportações. | | F19 | PN P0057 | Relatório financeiro | Recolher rendas, seguros, utilidades e marketing separadamente nas despesas correntes | INTEGRADO E VALIDADO | financial-plan-details.tsx; business-financial-plan.ts; integral-financial-report.ts | 9c34af04 | Rendas, seguros, utilidades, marketing e outras despesas discriminadas substituem o agregado reconhecido, sem dupla contagem ou alteração dos pagamentos. Juros e depreciação conservam campos próprios. Agregado/agenda anteriores preservados e ocultados enquanto as linhas são usadas. E8: totais mensais/anuais, cenários e saldos reconciliados. | -| F20 | PN P0058; ME P0143/P0163 | Relatório financeiro | Prazos de recebimento/pagamento: cobrança e compras diferidas | PARCIALMENTE DEMONSTRADO | business-financial-plan.ts; simulation-business-plan.tsx | E15/E23/E24; verificacao-f20-f22-v11-v12-20261120.json; referência 8a35dd0e | E24 valida por leitura a compatibilidade das convenções propostas: data económica distinta da caixa, dias de calendário, prazo zero no próprio dia, caixa no mês do vencimento e modos sem duplicação por operação. O modelo actual usa índices mensais, sem data diária de origem; creditTermDays 0–365 apenas valida/avisa. Antes de implementar, fechar granularidade/datas das coortes, aquisição versus recepção/adiantamentos, abrangência/parcelas e aplicação dos 36 meses sem truncar horizontes existentes de 1–60. Proposta técnica, impactos e aceitação futura registados; estado parcial mantido. Sem código, dados, fórmulas ou testes alterados/executados. F22 e aprovações V11/V12 preservados. | +| F20 | PN P0058; ME P0143/P0163 | Relatório financeiro | Prazos de recebimento/pagamento: cobrança e compras diferidas | PARCIALMENTE DEMONSTRADO | business-financial-plan.ts; financial-day-terms.ts; financial-day-terms.tsx; simulation-business-plan.tsx | E15/E23/E24/E25; e25-f20-a-20261121/functional-receipt.json; e25-f20-a-20261121/verification.json | F20-A integrado e validado em QA no recorte sem adiantamentos, proposto para aceitação do proprietário. Adesão explícita por agenda; dias de calendário, datas individuais ou coortes no último dia identificadas como aproximação; caixa no vencimento; exclusão de antecipações/datas insuficientes; parcelas sem duplicação; horizonte 1–60 e vencimentos posteriores identificados. Snapshot 20 opcional; planos anteriores e agendas manuais conservados, outras receitas independentes preservadas. Provas reais de activação, gravação e recuperação exacta em computador/emulação móvel. 15 testes anteriores reutilizados, seis cenários antigos preservados e regressão adicional aprovada. F20 global mantém-se parcial: F20-B suspenso para validação contabilística; F22 separado; V11/V12 e restantes 87 linhas preservados. Sem instalação, publicação ou migrações. | | F21 | PN P0058 | Relatório financeiro | Dividendos como entrada própria e movimento derivado de caixa/capital | INTEGRADO E VALIDADO | financial-plan-details.tsx; business-financial-plan.ts; integral-financial-report.ts; project-dossier-report.ts | 9c34af04 | Dividendos mensais declarados reduzem caixa e capital, sem reduzir o lucro; não são execução de pagamentos ou autorização jurídica. Reconciliação em 13 meses e dois anos, validação de negativos/agendas incompletas, recuperação, CSV e Word/impressão. E8. | | F22 | PN P0058 | Relatório financeiro | Novos empréstimos e compras de activos ao longo dos períodos | PENDENTE COM CAUSA IDENTIFICADA | business-financial-plan.ts; integral-financial-report.ts | E15/E23; verificacao-f20-f22-v11-v12-20261120.json; referência 50b95936 | E23 confirma a ausência de novos desembolsos/aquisições por período no contrato/editor/relatório inspeccionados. Financiamento e activos iniciais preservados; reembolsos e mercadorias não substituem estes movimentos. Antes de implementar, fechar reconhecimento/pagamento dos activos, início/base/vida útil da depreciação e efeitos na dívida/juros/reembolso, sem inferir condições bancárias. Documentos Revisão 1 conferidos; sem alteração funcional ou novos testes. Pendente com causa identificada. | | F23 | PN P0043/P0117–0150 | Relatório financeiro | Resumo executivo com objectivos, missão e chaves para o sucesso | IMPLEMENTADO MAS NÃO VALIDADO | project-dossier-report.ts:223–245 | 93fc837a (consolidação) | Resumo existente usa project_summary, problema, proposta de valor e clientes. Não demonstra os três conteúdos expressamente pedidos; não confundir título Resumo executivo com cumprimento integral. | @@ -2205,3 +2205,38 @@ A validação contabilística aqui referida é **específica destes tratamentos | Preservação e utilização real | Planos antigos sem optar por dias conservam resultados; relatório/exportações e computador/móvel correspondem às mesmas agendas; avisos V11 reflectem apenas os novos saldos calculados | **Versão consolidada para decisão:** nove convenções propostas, com último dia do mês explicitamente classificado como aproximação ainda por confirmar. F20 permanece **PARCIALMENTE DEMONSTRADO**; implementação suspensa até confirmação da convenção e do tratamento das operações/parcelas. Próxima acção recomendada: decisão expressa sobre os três pontos da secção 4 e posterior autorização delimitada de implementação. Nenhum código, dado, cálculo ou teste foi alterado/executado, nem houve instalação, publicação, migração ou avanço para F22. Nesta consolidação apenas a proposta E24 foi revista; todas as 88 linhas da matriz, incluindo F20, F22, V11 e V12, permanecem exactamente iguais. + + +## E25 — F20-A: implementação delimitada e prova funcional em QA — 21/11/2026 + +Referências E23/E24 versão 2, Revisão 1 e autorização expressa de F20-A sem adiantamentos. Retomadas as alterações locais existentes no worktree QA, sem reiniciar o desenvolvimento. **F20-A: INTEGRADO E VALIDADO EM QA, PROPOSTO PARA ACEITAÇÃO DO PROPRIETÁRIO. F20 global: PARCIALMENTE DEMONSTRADO**, enquanto F20-B aguarda validação contabilística. Esta entrega não encerra F20 nem altera F22, V11/V12 ou as restantes 87 linhas. + +### Âmbito implementado e preservação + +Contrato opcional `dayTerms`, snapshot 20, com adesão explícita por agenda: vendas/prestações, mercadorias efectivamente recebidas e serviços adquiridos reconhecidos. O modo substitui a agenda de caixa correspondente, sem apagar os valores manuais; saldos de abertura, salários, impostos, juros, empréstimos e novos activos mantêm contratos próprios. O modo de serviços abrange o total operacional e só deve ser escolhido se todo esse total corresponder a serviços elegíveis. Outras receitas manuais explicitamente classificadas mantêm-se activas e separadas das cobranças das vendas. + +Cada parcela identifica origem, tipo, mês económico, montante, reconhecimento e evento de origem do prazo. Datas individuais prevalecem quando escolhidas; a escolha mensal usa o último dia do mês e identifica o vencimento como aproximação. Contagem civil em dias de calendário, prazo inteiro 0–365, zero no próprio dia; vazio não é zero. Parcelas duplicadas e distribuições que não reconciliam com o valor reconhecido são rejeitadas. Uma data insuficiente ou vencimento anterior ao reconhecimento bloqueia o cálculo automático da agenda, com diagnóstico explícito; não converte a operação em pagamento normal. Datas de factura/contrato não são confundidas com recepção. Vencimentos posteriores ao horizonte 1–60 não entram artificialmente no último mês; mantêm data, montante e saldo por liquidar. + +Sem `dayTerms` activo conserva-se o percurso de cálculo anterior. Snapshots antigos não são migrados nem activados automaticamente. Reutilizadas as provas aceites dos seis cenários D1/D2/D3/depreciação/reembolso/ambos: resultados e campos não diagnósticos das tabelas idênticos às referências. O novo modo apenas altera as agendas optadas; não altera fórmulas de reconhecimento económico, depreciação, juros, impostos ou financiamento. + +### Conferência na aplicação real + +Playwright e Chromium já instalados no runtime, conforme os precedentes locais em `tools/investmoz-v2-draft-save-browser.cjs`. Não foi repetido o controlo interactivo que bloqueou. Navegação/pedidos de página limitados à origem `http://127.0.0.3:18724`; autenticação normal de conta sintética, sem atalhos. Router existente confere a base QA `main_reference_20261104_test:55441`. Rascunho isolado `9a53831b-c54d-4fa4-a399-848b29000cfa`, recuperado sem recriação; rascunho de V12 e planos antigos não alterados. + +| Critério | Evidência individual | +| --- | --- | +| Adesão explícita | Três agendas inicialmente manuais; uma confirmação recusada conservou o modo manual; três confirmações aceites activaram vendas, compras e serviços. Mensagens dos diálogos em `functional-receipt.json`; pressupostos anteriores à activação em `before-activation.json` | +| Prazos e caixa | Coortes de Janeiro de 2027, 30 dias: reconhecimento/origem aproximados em 31/01 e vencimento 02/03. Recebimentos 1.000, compras 400 e serviços 100 apenas em Março. Prazo zero de vendas demonstrado no editor: vencimento 31/01, caixa no mês 1; depois reposto 30 dias | +| Antecipações e datas insuficientes | Evento contratual em 01/01 com prazo zero, reconhecimento em 31/01: rejeitado, mesmo sendo o mesmo mês. Origem por confirmar: diagnóstico específico, sem agenda automática. Após correcção, mensagens desapareceram e os vencimentos regressaram | +| Reconciliação e ausência de duplicação | Tabelas reais em `desktop-tables.json`: recebíveis 1.000/1.000/0; obrigações 500/500/0; diferença de balanço zero em cada mês e no agregado. Cobrança manual de vendas 777 conservada no snapshot, inactiva no modo automático | +| Gravação e recuperação | Snapshot do servidor na versão 5 exactamente igual ao JSON exportado. Novos contextos autenticados sem armazenamento local recuperaram o mesmo contrato por GET HTTP 200, em computador e emulação móvel. Os restantes pressupostos financeiros e manuais são idênticos aos anteriores à activação | +| Apresentação | Capturas revistas em 1440×1000 e 390×844; editor dentro da largura disponível e parcelas/vencimentos legíveis. Painel de ajuda fechado pelo controlo normal quando sobrepunha a zona de trabalho. Emulação móvel, não ensaio num aparelho físico | +| Correcção delimitada na revisão final | Reproduzida a supressão indevida de outras receitas independentes pelo novo modo. Corrigida apenas a selecção da agenda activa, restaurando o reconhecimento já existente dessas receitas. Novo teste falhou antes e passou depois; editor confirmou 100 por mês de outras receitas, cobranças totais 100/100/1.100 e balanço reconciliado. Repuseram-se os dados sintéticos originais após esta prova | + +### Verificações e limites + +Reutilizados os 15 testes aprovados na implementação anterior: seis específicos de F20-A e nove dos contratos financeiros afectados. Não repetida a auditoria nem a bateria geral. Nesta retoma, executado um teste focado após a conclusão do CSV e, por causa da falha concreta identificada, o novo teste de receitas independentes e o teste directamente afectado de substituição/reconciliação/exportação: ambos aprovados. Total de casos distintos com prova: 16. Limites de calendário, transição anual/bissexto, duplicação e horizontes 1/60 conservam as provas específicas anteriores. Tipos já aprovados, lint final dos ficheiros afectados e compilação final isolada de QA aprovados. Avisos de fontaine opcional, tamanho de chunks e tempos de plugins permanecem avisos de compilação; não houve instalação para os eliminar. + +As primeiras tentativas Playwright expuseram problemas do ensaio, não falhas financeiras: a página pública não redirecciona para login, selectores inadequados, espera por uma nova escrita quando o estado já estava guardado e sobreposição do painel de ajuda. Corrigido o mecanismo de prova com autenticação explícita, selectores semânticos, comparação do snapshot persistido e fecho normal da ajuda. Sem contornar autenticação, RLS ou restrições de segurança. + +Recibos e imagens: [pasta E25](e25-f20-a-20261121/verification.json), com hashes individuais; [prova funcional](e25-f20-a-20261121/functional-receipt.json). Sessões, cookies e credenciais não versionados. Scripts internos recuperáveis em `outputs/v12-d1-d2-d3-20261120/f20-{browser,recovery,optin}.cjs`; não requerem instalar Playwright. Limites: máximo 240 parcelas e limite existente de 60 KB por snapshot; selecção manual/automática por agenda completa. F20-B e F22 continuam suspensos; nenhuma aprovação anterior reaberta. Sem instalação, publicação, migração ou alteração de dados activos. diff --git a/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/before-activation.json b/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/before-activation.json new file mode 100644 index 00000000..affa03c8 --- /dev/null +++ b/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/before-activation.json @@ -0,0 +1 @@ +{"version":20,"plan":{"currency":"MZN","openingCash":"1000","assetInvestment":"600","equity":"600","products":[{"label":"Serviço sintético F20-A","monthlyUnits":"0","unitPrice":"1000","unitVariableCost":"0","monthlyUnitsByPeriod":["1","0","0"]}],"depreciationLifeMonths":60,"periods":3,"monthlyCollections":"777","monthlyVariableCostPayments":"400","monthlyInventoryPurchases":"400","monthlyOperatingExpenses":"100","monthlyOperatingPayments":"100","monthlyPayrollExpense":"0","monthlyPayrollPayments":"0","inventory":"0","receivables":"0","payables":"0","shareholderLoans":"0","bankLoanProceeds":"0","grants":"0","assetDepreciation":"600","monthlyInterestExpense":"0","monthlyInterestPayment":"0","monthlyPrincipalRepayment":"0","salesCollectionLagMonths":0,"salesCollectionPercent":"100","openingReceivablesCollectionPercent":"0","reportAssumptions":{"startYear":"2027","openingFixedAssets":"0","openingOtherAssets":"0","openingEquity":"1000","startupExpenses":[{"label":"Constituição","amount":"100"}],"taxExpenseByMonth":["30","30","30"],"taxPaymentByMonth":["20","20","20"],"taxSource":"Hipótese sintética de teste; não é taxa legal","grantsTreatment":"","manualCollectionsKind":"sales"},"useInventoryPurchaseSchedule":true,"inventoryPurchaseSchedule":[{"amount":"400","leadMonths":0},{"amount":"0","leadMonths":0},{"amount":"0","leadMonths":0}],"monthlyOperatingExpensesByPeriod":["100","0","0"],"dayTerms":{"sales":false,"purchases":false,"services":false,"operations":[{"kind":"sales","month":1,"originId":"sales-1","parcelId":"1","amount":"1000","termDays":"30","recognitionBasis":"monthly","recognitionDate":"","originBasis":"recognition","originDate":""},{"kind":"purchases","month":1,"originId":"purchases-1","parcelId":"1","amount":"400","termDays":"30","recognitionBasis":"monthly","recognitionDate":"","originBasis":"recognition","originDate":""},{"kind":"services","month":1,"originId":"services-1","parcelId":"1","amount":"100","termDays":"30","recognitionBasis":"monthly","recognitionDate":"","originBasis":"recognition","originDate":""}]},"inventoryPurchaseLeadMonths":0,"useProductInventorySchedule":false,"useSupplierPaymentTerms":false,"monthlyVariableCostPaymentsByPeriod":null,"openingReceivablesCollectionMonth":null,"openingReceivablesInstallments":[],"openingPayablesInstallments":[],"salesRecoverySchedule":[]}} \ No newline at end of file diff --git a/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/desktop-tables.json b/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/desktop-tables.json new file mode 100644 index 00000000..91c8f899 --- /dev/null +++ b/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/desktop-tables.json @@ -0,0 +1,42 @@ +[ + { + "name": "Start-up / arranque", + "text": "Start-up / arranque\nRubrica\tValor\nConstituição\t100,00\nDespesas de arranque\t100,00\nInvestimento em activos\t600,00\nExistências iniciais\t0,00\nRecebíveis iniciais\t0,00\nObrigações iniciais\t0,00\nUsos líquidos iniciais\t700,00" + }, + { + "name": "Previsão de Vendas", + "text": "Previsão de Vendas\nRubrica\t2027-01\t2027-02\t2027-03\t2027 (parcial)\nServiço sintético F20-A\t1 000,00\t0,00\t0,00\t1 000,00\nVendas totais\t1 000,00\t0,00\t0,00\t1 000,00" + }, + { + "name": "Financiamento", + "text": "Financiamento\nRubrica\tValor\nCapital introduzido\t600,00\nSuprimentos\t0,00\nEmpréstimos\t0,00\nSubvenções declaradas\t0,00\nTotal de fontes\t600,00\nUsos líquidos com arranque\t700,00\nDiferença por financiar\t100,00\nCaixa após financiamento e arranque\t900,00" + }, + { + "name": "Ponto de Equilíbrio", + "text": "Ponto de Equilíbrio\nRubrica\t2027-01\t2027-02\t2027-03\t2027 (parcial)\nVendas de equilíbrio\t110,00\tIndeterminado — margem sem contribuição positiva\tIndeterminado — margem sem contribuição positiva\t130,00" + }, + { + "name": "Lucros e Perdas", + "text": "Lucros e Perdas\nRubrica\t2027-01\t2027-02\t2027-03\t2027 (parcial)\nVendas\t1 000,00\t0,00\t0,00\t1 000,00\nOutras receitas de caixa declaradas\t0,00\t0,00\t0,00\t0,00\nCusto directo\t0,00\t0,00\t0,00\t0,00\nDespesas operacionais\t100,00\t0,00\t0,00\t100,00\nPessoal\t0,00\t0,00\t0,00\t0,00\nDepreciação\t10,00\t10,00\t10,00\t30,00\nJuros\t0,00\t0,00\t0,00\t0,00\nImposto estimado\t30,00\t30,00\t30,00\t90,00\nLucro líquido\t860,00\t-40,00\t-40,00\t780,00" + }, + { + "name": "Fluxo de Caixa", + "text": "Fluxo de Caixa\nRubrica\t2027-01\t2027-02\t2027-03\t2027 (parcial)\nCaixa inicial\t900,00\t880,00\t860,00\t900,00\nRecebimentos\t0,00\t0,00\t1 000,00\t1 000,00\nPagamentos de compras\t0,00\t0,00\t400,00\t400,00\nPagamentos operacionais\t0,00\t0,00\t100,00\t100,00\nPagamentos de pessoal\t0,00\t0,00\t0,00\t0,00\nJuros pagos\t0,00\t0,00\t0,00\t0,00\nCapital reembolsado\t0,00\t0,00\t0,00\t0,00\nPagamento de obrigações iniciais\t0,00\t0,00\t0,00\t0,00\nPagamento fiscal estimado\t20,00\t20,00\t20,00\t60,00\nFluxo líquido\t-20,00\t-20,00\t480,00\t440,00\nCaixa final\t880,00\t860,00\t1 340,00\t1 340,00" + }, + { + "name": "Balanço Projectado", + "text": "Balanço Projectado\nRubrica\t2027-01\t2027-02\t2027-03\t2027 (parcial)\nCaixa líquida\t880,00\t860,00\t1 340,00\t1 340,00\nRecebíveis líquidos\t1 000,00\t1 000,00\t0,00\t0,00\nObrigações operacionais líquidas\t500,00\t500,00\t0,00\t0,00\nSaldo fiscal estimado\t10,00\t20,00\t30,00\t30,00\nActivos fixos líquidos\t590,00\t580,00\t570,00\t570,00\nEmpréstimos e suprimentos por reembolsar\t0,00\t0,00\t0,00\t0,00\nCapital declarado e anterior\t1 600,00\t1 600,00\t1 600,00\t1 600,00\nResultados acumulados, incluindo arranque\t760,00\t720,00\t680,00\t680,00\nTotal do activo\t2 870,00\t2 840,00\t2 310,00\t2 310,00\nTotal do passivo\t510,00\t520,00\t30,00\t30,00\nCapital e resultados\t2 360,00\t2 320,00\t2 280,00\t2 280,00\nExistências\t400,00\t400,00\t400,00\t400,00\nDiferença do balanço\t0,00\t0,00\t0,00\t0,00" + }, + { + "name": "Linhas contabilísticas propostas para classificação fiscal", + "text": "Linhas contabilísticas propostas para classificação fiscal\nOrigem\tEfeito contabilístico\tTotal no período\tTratamento fiscal\nProdutos/serviços facturados\tRendimento; por mês: 1: 1000.00 · 2: 0.00 · 3: 0.00\t1000.00 MZN\tPor classificar\nCusto variável dos produtos\tDespesa; por mês: 1: 0.00 · 2: 0.00 · 3: 0.00\t0.00 MZN\tPor classificar\nDespesas operacionais reconhecidas\tDespesa; por mês: 1: 100.00 · 2: 0.00 · 3: 0.00\t100.00 MZN\tPor classificar\nDespesas com pessoal reconhecidas\tDespesa; por mês: 1: 0.00 · 2: 0.00 · 3: 0.00\t0.00 MZN\tPor classificar\nDepreciação contabilística\tDespesa; por mês: 1: 10.00 · 2: 10.00 · 3: 10.00\t30.00 MZN\tPor classificar\nJuros reconhecidos\tDespesa; por mês: 1: 0.00 · 2: 0.00 · 3: 0.00\t0.00 MZN\tPor classificar" + }, + { + "name": "Encomendas, recepções, mercadoria em trânsito, consumo, falta e saldo de existências por mês", + "text": "Encomendas, recepções, mercadoria em trânsito, consumo, falta e saldo de existências por mês\nMês\tSaldo inicial\tEncomendas\tPrazo (meses)\tRecepções\tEm trânsito\tConsumo\tFalta de stock\tSaldo final\n1\t0.00\t400.00\t0\t400.00\t0.00\t0.00\t0.00\t400.00\n2\t400.00\t0.00\t0\t0.00\t0.00\t0.00\t0.00\t400.00\n3\t400.00\t0.00\t0\t0.00\t0.00\t0.00\t0.00\t400.00" + }, + { + "name": "Resultados financeiros mensais antes de impostos", + "text": "Resultados financeiros mensais antes de impostos\nMês\tFacturação\tCobranças\tCobranças das vendas\tCobranças iniciais\tRecuperações vencidas\tCobrança de valores de abertura\tValores de abertura por receber\tOutras cobranças\tCustos variáveis\tDespesas/pessoal\tDepreciação\tJuros\tResultado antes de impostos\tPagamento de capital\tCaixa final\n1\t1000.00\t0.00\t0.00\t0.00\t0.00\t0.00\t0.00\t0.00\t0.00\t100.00 / 0.00\t10.00\t0.00\t890.00\t0.00\t1000.00\n2\t0.00\t0.00\t0.00\t0.00\t0.00\t0.00\t0.00\t0.00\t0.00\t0.00 / 0.00\t10.00\t0.00\t-10.00\t0.00\t1000.00\n3\t0.00\t1000.00\t1000.00\t1000.00\t0.00\t0.00\t0.00\t0.00\t0.00\t0.00 / 0.00\t10.00\t0.00\t-10.00\t0.00\t1500.00" + } +] \ No newline at end of file diff --git a/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/early-payment-desktop.png b/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/early-payment-desktop.png new file mode 100644 index 00000000..d290d6b9 Binary files /dev/null and b/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/early-payment-desktop.png differ diff --git a/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/export-focused-test.log b/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/export-focused-test.log new file mode 100644 index 00000000..fbfd5d13 --- /dev/null +++ b/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/export-focused-test.log @@ -0,0 +1,9 @@ +✔ F20-A replaces only opted-in cash agendas, preserves recognition and reconciles every monthly balance (48.401209ms) +ℹ tests 1 +ℹ suites 0 +ℹ pass 1 +ℹ fail 0 +ℹ cancelled 0 +ℹ skipped 0 +ℹ todo 0 +ℹ duration_ms 362.476 diff --git a/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/functional-receipt.json b/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/functional-receipt.json new file mode 100644 index 00000000..297d5333 --- /dev/null +++ b/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/functional-receipt.json @@ -0,0 +1,92 @@ +{ + "url": "http://127.0.0.3:18724/simulador-fiscal?draft=9a53831b-c54d-4fa4-a399-848b29000cfa", + "account": "synthetic-f20-a", + "draft": "9a53831b-c54d-4fa4-a399-848b29000cfa", + "viewports": [ + { + "mobile": false, + "url": "http://127.0.0.3:18724/simulador-fiscal?draft=9a53831b-c54d-4fa4-a399-848b29000cfa", + "reads": [ + { + "url": "http://127.0.0.3:18724/api/v1/simulation-drafts/9a53831b-c54d-4fa4-a399-848b29000cfa", + "status": 200 + }, + { + "url": "http://127.0.0.3:18724/api/v1/simulation-drafts/9a53831b-c54d-4fa4-a399-848b29000cfa/business-link", + "status": 200 + } + ], + "bounds": { + "left": 206, + "right": 1234, + "width": 1440 + }, + "recoveredExactly": true + }, + { + "mobile": true, + "url": "http://127.0.0.3:18724/simulador-fiscal?draft=9a53831b-c54d-4fa4-a399-848b29000cfa", + "reads": [ + { + "url": "http://127.0.0.3:18724/api/v1/simulation-drafts/9a53831b-c54d-4fa4-a399-848b29000cfa", + "status": 200 + }, + { + "url": "http://127.0.0.3:18724/api/v1/simulation-drafts/9a53831b-c54d-4fa4-a399-848b29000cfa/business-link", + "status": 200 + } + ], + "bounds": { + "left": 54, + "right": 336, + "width": 390 + }, + "recoveredExactly": true + } + ], + "dialogs": [ + { + "action": "dismiss", + "message": "Activar prazos em dias para Vendas e prestações? A agenda em dias substitui toda a agenda de caixa desta categoria. Os valores anteriores ficam guardados e não serão somados. Confira primeiro as parcelas e as datas." + }, + { + "action": "accept", + "message": "Activar prazos em dias para Vendas e prestações? A agenda em dias substitui toda a agenda de caixa desta categoria. Os valores anteriores ficam guardados e não serão somados. Confira primeiro as parcelas e as datas." + }, + { + "action": "accept", + "message": "Activar prazos em dias para Mercadorias recebidas? A agenda em dias substitui toda a agenda de caixa desta categoria. Os valores anteriores ficam guardados e não serão somados. Confira primeiro as parcelas e as datas." + }, + { + "action": "accept", + "message": "Activar prazos em dias para Serviços adquiridos reconhecidos? A agenda em dias substitui toda a agenda de caixa desta categoria. Os valores anteriores ficam guardados e não serão somados. Confira primeiro as parcelas e as datas." + } + ], + "saves": [ + { + "label": "recovered-desktop", + "status": 200, + "version": 5, + "persistedSnapshotMatchesEditor": true + }, + { + "label": "recovered-mobile", + "status": 200, + "version": 5, + "persistedSnapshotMatchesEditor": true + } + ], + "errors": [], + "blocked": [], + "activationRecoveredFromPriorSuccessfulSave": true, + "events": "Vencimentos previstos\n\nVendas e prestações — sales-1/1: reconhecimento 2027-01-31; origem 2027-01-31; vencimento 2027-03-02; 1000.00 MZN. Aproximação mensal explícita. Caixa no mês 3.\n\nMercadorias recebidas — purchases-1/1: reconhecimento 2027-01-31; origem 2027-01-31; vencimento 2027-03-02; 400.00 MZN. Aproximação mensal explícita. Caixa no mês 3.\n\nServiços adquiridos reconhecidos — services-1/1: reconhecimento 2027-01-31; origem 2027-01-31; vencimento 2027-03-02; 100.00 MZN. Aproximação mensal explícita. Caixa no mês 3.", + "earlyMessage": "Prazos em dias — Mercadorias recebidas, origem purchases-1, parcela 1: vencimento anterior ao reconhecimento: antecipação excluída de F20-A. Use a agenda manual existente; adiantamentos identificados dependem de F20-B.", + "unknownMessage": "Prazos em dias — Mercadorias recebidas, origem purchases-1, parcela 1: data de origem do prazo insuficiente ou inválida; indique o evento contratual ou escolha reconhecimento. Operação excluída do cálculo automático.", + "zeroDays": "Vencimentos previstos\n\nVendas e prestações — sales-1/1: reconhecimento 2027-01-31; origem 2027-01-31; vencimento 2027-01-31; 1000.00 MZN. Aproximação mensal explícita. Caixa no mês 1.\n\nMercadorias recebidas — purchases-1/1: reconhecimento 2027-01-31; origem 2027-01-31; vencimento 2027-03-02; 400.00 MZN. Aproximação mensal explícita. Caixa no mês 3.\n\nServiços adquiridos reconhecidos — services-1/1: reconhecimento 2027-01-31; origem 2027-01-31; vencimento 2027-03-02; 100.00 MZN. Aproximação mensal explícita. Caixa no mês 3.", + "independentIncome": { + "profitRow": "Outras receitas de caixa declaradas\t100,00\t100,00\t100,00\t300,00", + "cashRow": "Recebimentos\t100,00\t100,00\t1 100,00\t1 300,00", + "balanceRow": "Diferença do balanço\t0,00\t0,00\t0,00\t0,00" + }, + "realTablesVerified": true +} \ No newline at end of file diff --git a/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/independent-income-after.log b/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/independent-income-after.log new file mode 100644 index 00000000..9d422e5a --- /dev/null +++ b/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/independent-income-after.log @@ -0,0 +1,10 @@ +✔ F20-A preserves explicitly classified independent other income when replacing sales collections (25.203542ms) +✔ F20-A replaces only opted-in cash agendas, preserves recognition and reconciles every monthly balance (4.100125ms) +ℹ tests 2 +ℹ suites 0 +ℹ pass 2 +ℹ fail 0 +ℹ cancelled 0 +ℹ skipped 0 +ℹ todo 0 +ℹ duration_ms 309.050083 diff --git a/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/independent-income-before.log b/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/independent-income-before.log new file mode 100644 index 00000000..db0d215f --- /dev/null +++ b/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/independent-income-before.log @@ -0,0 +1,38 @@ +✖ F20-A preserves explicitly classified independent other income when replacing sales collections (56.082667ms) +ℹ tests 1 +ℹ suites 0 +ℹ pass 0 +ℹ fail 1 +ℹ cancelled 0 +ℹ skipped 0 +ℹ todo 0 +ℹ duration_ms 460.2845 + +✖ failing tests: + +test at tests\frontend\financial-day-terms.test.mjs:12:1 +✖ F20-A preserves explicitly classified independent other income when replacing sales collections (56.082667ms) + AssertionError [ERR_ASSERTION]: Expected values to be strictly deep-equal: + + actual - expected + + [ + + '0.00', + + '0.00', + + '0.00' + - '100.00', + - '100.00', + - '100.00' + ] + + at TestContext. (file:///C:/laragon/www/portal-investidor-continuity-qa-20261120/tests/frontend/financial-day-terms.test.mjs:17:12) + at Test.runInAsyncScope (node:async_hooks:227:14) + at Test.run (node:internal/test_runner/test:1397:25) + at Test.start (node:internal/test_runner/test:1257:17) + at startSubtestAfterBootstrap (node:internal/test_runner/harness:387:17) { + generatedMessage: true, + code: 'ERR_ASSERTION', + actual: [ '0.00', '0.00', '0.00' ], + expected: [ '100.00', '100.00', '100.00' ], + operator: 'deepStrictEqual', + diff: 'simple' + } diff --git a/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/independent-income-desktop.png b/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/independent-income-desktop.png new file mode 100644 index 00000000..a6aee7c9 Binary files /dev/null and b/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/independent-income-desktop.png differ diff --git a/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/initial-desktop.png b/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/initial-desktop.png new file mode 100644 index 00000000..0429d1ff Binary files /dev/null and b/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/initial-desktop.png differ diff --git a/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/parcelas-mobile.png b/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/parcelas-mobile.png new file mode 100644 index 00000000..7d36794b Binary files /dev/null and b/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/parcelas-mobile.png differ diff --git a/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/recovered-desktop.png b/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/recovered-desktop.png new file mode 100644 index 00000000..a9cbbd98 Binary files /dev/null and b/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/recovered-desktop.png differ diff --git a/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/saved.json b/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/saved.json new file mode 100644 index 00000000..40b0f3e3 --- /dev/null +++ b/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/saved.json @@ -0,0 +1 @@ +{"version":20,"plan":{"currency":"MZN","openingCash":"1000","assetInvestment":"600","equity":"600","products":[{"label":"Serviço sintético F20-A","monthlyUnits":"0","unitPrice":"1000","unitVariableCost":"0","monthlyUnitsByPeriod":["1","0","0"]}],"depreciationLifeMonths":60,"periods":3,"monthlyCollections":"777","monthlyVariableCostPayments":"400","monthlyInventoryPurchases":"400","monthlyOperatingExpenses":"100","monthlyOperatingPayments":"100","monthlyPayrollExpense":"0","monthlyPayrollPayments":"0","inventory":"0","receivables":"0","payables":"0","shareholderLoans":"0","bankLoanProceeds":"0","grants":"0","assetDepreciation":"600","monthlyInterestExpense":"0","monthlyInterestPayment":"0","monthlyPrincipalRepayment":"0","salesCollectionLagMonths":0,"salesCollectionPercent":"100","openingReceivablesCollectionPercent":"0","reportAssumptions":{"startYear":"2027","openingFixedAssets":"0","openingOtherAssets":"0","openingEquity":"1000","startupExpenses":[{"label":"Constituição","amount":"100"}],"taxExpenseByMonth":["30","30","30"],"taxPaymentByMonth":["20","20","20"],"taxSource":"Hipótese sintética de teste; não é taxa legal","grantsTreatment":"","manualCollectionsKind":"sales"},"useInventoryPurchaseSchedule":true,"inventoryPurchaseSchedule":[{"amount":"400","leadMonths":0},{"amount":"0","leadMonths":0},{"amount":"0","leadMonths":0}],"monthlyOperatingExpensesByPeriod":["100","0","0"],"dayTerms":{"sales":true,"purchases":true,"services":true,"operations":[{"kind":"sales","month":1,"originId":"sales-1","parcelId":"1","amount":"1000","termDays":"30","recognitionBasis":"monthly","recognitionDate":"","originBasis":"recognition","originDate":""},{"kind":"purchases","month":1,"originId":"purchases-1","parcelId":"1","amount":"400","termDays":"30","recognitionBasis":"monthly","recognitionDate":"","originBasis":"recognition","originDate":"2027-01-01"},{"kind":"services","month":1,"originId":"services-1","parcelId":"1","amount":"100","termDays":"30","recognitionBasis":"monthly","recognitionDate":"","originBasis":"recognition","originDate":""}]},"inventoryPurchaseLeadMonths":0,"useProductInventorySchedule":false,"useSupplierPaymentTerms":false,"monthlyVariableCostPaymentsByPeriod":null,"openingReceivablesCollectionMonth":null,"openingReceivablesInstallments":[],"openingPayablesInstallments":[],"salesRecoverySchedule":[]}} \ No newline at end of file diff --git a/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/vencimentos-desktop.png b/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/vencimentos-desktop.png new file mode 100644 index 00000000..36715979 Binary files /dev/null and b/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/vencimentos-desktop.png differ diff --git a/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/vencimentos-mobile.png b/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/vencimentos-mobile.png new file mode 100644 index 00000000..2de7b316 Binary files /dev/null and b/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/vencimentos-mobile.png differ diff --git a/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/verification.json b/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/verification.json new file mode 100644 index 00000000..07280de6 --- /dev/null +++ b/docs/investmoz/v2/auditoria-portal/e25-f20-a-20261121/verification.json @@ -0,0 +1,45 @@ +{ + "date": "2026-11-21", + "scope": "F20-A only; F20 global partial; awaiting owner acceptance", + "qa": { + "url": "http://127.0.0.3:18724", + "database": "main_reference_20261104_test", + "port": 55441, + "syntheticDraft": "9a53831b-c54d-4fa4-a399-848b29000cfa" + }, + "checks": { + "priorFocusedTestsReused": 15, + "priorFinancialScenariosPreserved": 6, + "additionalRegression": "independent other income: reproduced failure, corrected, passed", + "affectedReconciliationAndExportTest": "passed after correction", + "types": "prior applicable check passed; no type contract changed in final correction", + "lint": "final affected files passed", + "build": "final isolated QA build passed", + "desktop": "1440x1000, new authenticated storage, exact server recovery", + "mobile": "390x844 emulation, new authenticated storage, exact server recovery", + "matrixRows": 88, + "unchangedOtherRows": 87 + }, + "limits": [ + "not production or physical handset certification", + "manual mode is selected for the entire corresponding agenda; independent other income remains active", + "F20-B advances and F22 not implemented", + "existing 60 KB snapshot limit; at most 240 day-term parcels" + ], + "hashes": { + "before-activation.json": "d781e1ac27512ea925d23788dfd49a47808230e91bdafb7f91272d77ea3fc0dc", + "desktop-tables.json": "94e862a89b32078f4f2a27fb94a9c5be1b708b3a95841a0a3a751202b07b58b3", + "early-payment-desktop.png": "71474f0ba2ea5fdc3db4e20cb70bab6a4a73139d0ba311def7dc93cdba92c2c2", + "export-focused-test.log": "de6250f35cdcfd3f8362539252380828fa811965a431c5dedcfd112c2b8f9027", + "functional-receipt.json": "fdb2e9ea4896ec515382fce4c6686ca79312c7631276c22e2ddf3b16b9d86aae", + "independent-income-after.log": "b396e819d642f83519c28ae2872436b42ae1eb65e7aee2a05199ec7539a645de", + "independent-income-before.log": "4961533883853af13f631984dffe8edc8c0fad8b8b6d6f69f9747f1fd665e1a5", + "independent-income-desktop.png": "aa4e3d17f07ff3b9a0f097462a5366aaea2d212ccc39e28e2af1470a6d4d9c52", + "initial-desktop.png": "8290d563c29a904ffd1b4799a5b520d9dfe6a909bae4fb8998dcd1c944303709", + "parcelas-mobile.png": "f0104f4c54275d8a763235604cdd7400f9ec6558f06570656c59e383330609c5", + "recovered-desktop.png": "0cbcb0cdde746bd3dda01d29db15cc9c463c58279faa9dd548bc21db2a21362f", + "saved.json": "7921afdfabf89c0c54545ad6521c97b97c150ef94e9d0f0772d06131da8c0c83", + "vencimentos-desktop.png": "e309b203af1bce606e3ec2f49178f16ad0ca95047b1db45bc364278a065d1a78", + "vencimentos-mobile.png": "ee85b453b0a137790ce8b07da051d9263bbf53546a645d15b2329b2ca857891a" + } +} \ No newline at end of file diff --git a/resources/js/components/financial-day-terms.tsx b/resources/js/components/financial-day-terms.tsx new file mode 100644 index 00000000..427e449d --- /dev/null +++ b/resources/js/components/financial-day-terms.tsx @@ -0,0 +1,364 @@ +import { + forecastBusinessPlan, + type BusinessFinancialPlanInput, +} from '@/lib/business-financial-plan'; +import { + dayTermLabels, + type DayTermKind, + type DayTermOperation, + type DayTerms, +} from '@/lib/financial-day-terms'; + +const kinds = Object.keys(dayTermLabels) as DayTermKind[]; +const empty = (): DayTerms => ({ + sales: false, + purchases: false, + services: false, + operations: [], +}); + +export function FinancialDayTerms({ + plan, + onChange, +}: { + plan: BusinessFinancialPlanInput; + onChange: (plan: BusinessFinancialPlanInput) => void; +}) { + const config = plan.dayTerms ?? empty(); + const save = (next: DayTerms) => onChange({ ...plan, dayTerms: next }); + const update = (index: number, patch: Partial) => + save({ + ...config, + operations: config.operations.map((o, i) => + i === index ? { ...o, ...patch } : o, + ), + }); + let economic: ReturnType | undefined; + let calculated: ReturnType | undefined; + try { + economic = forecastBusinessPlan({ ...plan, dayTerms: undefined }); + } catch { + /* Existing diagnostics remain in the report. */ + } + try { + calculated = forecastBusinessPlan(plan); + } catch { + /* One existing report diagnostic, no duplicate here. */ + } + const prepare = (kind: DayTermKind) => { + if ( + !economic || + config[kind] || + config.operations.some((o) => o.kind === kind) + ) + return; + const operations: DayTermOperation[] = []; + for (const row of economic.rows) { + const amount = + kind === 'sales' + ? row.revenue + : kind === 'purchases' + ? row.inventoryReceipts + : row.operatingExpenses; + if (amount === null || Number(amount) === 0) continue; + operations.push({ + kind, + month: row.month, + amount, + originId: `${kind}-${row.month}`, + parcelId: '1', + recognitionBasis: 'monthly', + recognitionDate: '', + originBasis: 'recognition', + originDate: '', + termDays: '', + }); + } + save({ ...config, operations: [...config.operations, ...operations] }); + }; + return ( +
+ + Prazos em dias — operações sem adiantamentos + +

+ Adesão opcional por agenda. A agenda em dias substitui + integralmente a agenda de caixa correspondente, incluindo + cobranças mensais e recuperações de vendas do período. Os + valores manuais correspondentes ficam guardados, inactivos; + outras receitas explicitamente classificadas mantêm-se activas. + Os saldos de abertura mantêm as agendas próprias. Para misturar + operações datadas e coortes, distribua o total reconhecido entre + parcelas sem repetir montantes. +

+

+ Mercadorias: só após recepção reconhecida. Serviços adquiridos: + este modo abrange a totalidade das despesas operacionais + declaradas; use-o apenas se todas corresponderem a serviços + elegíveis. Não inclui salários, impostos, juros, empréstimos ou + novos activos. Antecipações e datas insuficientes bloqueiam o + cálculo automático, sem conversão para pagamentos normais. +

+

+ Sem data individual, escolha explicitamente «Último dia do mês + (aproximação)». O vencimento também será aproximado. A origem + dos pagamentos é o evento contratual indicado; não se presume + que factura e recepção coincidam. O prazo em dias deste editor é + independente do campo histórico usado nos avisos de crédito. +

+

+ Ano inicial:{' '} + {plan.reportAssumptions?.startYear || + 'preencha o ano no relatório financeiro integral'} + . Horizonte: {plan.periods} meses. Os vencimentos posteriores + ficam identificados fora do horizonte. +

+ {kinds.map((kind) => ( +
+ + {dayTermLabels[kind]} + + + +

+ Preparar coortes não activa o modo. Revise os valores, + indique o prazo de cada parcela e só depois escolha o + modo em dias. +

+ {config.operations.map((o, index) => + o.kind !== kind ? null : ( +
+ {( + [ + ['Origem', 'originId'], + ['Parcela', 'parcelId'], + ['Montante', 'amount'], + ['Prazo (dias)', 'termDays'], + ] as const + ).map(([label, key]) => ( + + ))} + + + {o.recognitionBasis === 'date' && ( + + )} + + {o.originBasis === 'date' && ( + + )} + +
+ ), + )} + +
+ ))} + {calculated?.dayTermEvents && ( +
+

Vencimentos previstos

+ {calculated.dayTermEvents.map((e) => ( +

+ {dayTermLabels[e.kind]} — {e.originId}/{e.parcelId}: + reconhecimento {e.recognition}; origem {e.origin}; + vencimento {e.due}; {e.amount} {plan.currency}.{' '} + {e.approximate + ? 'Aproximação mensal explícita.' + : 'Datas individuais.'}{' '} + {e.outsideHorizon + ? 'Fora do horizonte; não incluído na caixa do plano.' + : `Caixa no mês ${e.dueMonth}.`} +

+ ))} +
+ )} +
+ ); +} diff --git a/resources/js/components/simulation-business-plan.tsx b/resources/js/components/simulation-business-plan.tsx index a64a8d9d..d240b066 100644 --- a/resources/js/components/simulation-business-plan.tsx +++ b/resources/js/components/simulation-business-plan.tsx @@ -26,6 +26,7 @@ import { MarketAnalysisPlan } from '@/components/market-analysis-plan'; import { FinancialRatiosPlan } from '@/components/financial-ratios-plan'; import { PlanEconomicClassification } from '@/components/plan-economic-classification'; import { FinancialPlanDetails } from '@/components/financial-plan-details'; +import { FinancialDayTerms } from '@/components/financial-day-terms'; import { StartupAssetRequirements } from '@/components/startup-asset-requirements'; import { forecastErrorShownInReport, @@ -948,6 +949,7 @@ export function SimulationBusinessPlan({ )} + - plan[key as keyof BusinessFinancialPlanInput] !== - undefined, - ) - ? 18 - : 17, + version: + plan.dayTerms !== undefined + ? 20 + : plan.startupAssetRequirements + ? 19 + : [ + 'applyAnnualGrowth', + 'creditTermDays', + 'dividendsByPeriod', + 'operatingExpenseLines', + 'fundingBreakdown', + 'reportSource', + ].some( + (key) => + plan[key as keyof BusinessFinancialPlanInput] !== + undefined, + ) + ? 18 + : 17, plan: { ...plan, ...(plan.useSupplierPaymentTerms === true @@ -301,12 +311,18 @@ export function restoreBusinessPlanSnapshot( decoded.version !== 16 && decoded.version !== 17 && decoded.version !== 18 && - decoded.version !== 19) || + decoded.version !== 19 && + decoded.version !== 20) || !decoded.plan || typeof decoded.plan !== 'object' ) return null; const plan = decoded.plan as Record; + if ( + plan.dayTerms !== undefined && + (decoded.version !== 20 || !isDayTerms(plan.dayTerms)) + ) + return null; if ( decoded.version < 18 && [ @@ -439,7 +455,7 @@ export function restoreBusinessPlanSnapshot( ) return null; if ( - [12, 13, 14, 15, 16, 17].includes(Number(decoded.version)) && + [12, 13, 14, 15, 16, 17, 20].includes(Number(decoded.version)) && (!Object.hasOwn(plan, 'inventoryPurchaseSchedule') || !Object.hasOwn(plan, 'useInventoryPurchaseSchedule') || typeof plan.useInventoryPurchaseSchedule !== 'boolean') @@ -450,7 +466,9 @@ export function restoreBusinessPlanSnapshot( plan.inventoryPurchaseSchedule !== null ) { if ( - ![12, 13, 14, 15, 16, 17].includes(Number(decoded.version)) || + ![12, 13, 14, 15, 16, 17, 20].includes( + Number(decoded.version), + ) || !Array.isArray(plan.inventoryPurchaseSchedule) || plan.inventoryPurchaseSchedule.length < Number(plan.periods) || plan.inventoryPurchaseSchedule.length > 60 || @@ -473,14 +491,14 @@ export function restoreBusinessPlanSnapshot( ) return null; if ( - [13, 14, 15, 16, 17].includes(Number(decoded.version)) && + [13, 14, 15, 16, 17, 20].includes(Number(decoded.version)) && !Object.hasOwn(plan, 'monthlyVariableCostPaymentsByPeriod') ) return null; if ( plan.monthlyVariableCostPaymentsByPeriod !== undefined && plan.monthlyVariableCostPaymentsByPeriod !== null && - (![13, 14, 15, 16, 17].includes(Number(decoded.version)) || + (![13, 14, 15, 16, 17, 20].includes(Number(decoded.version)) || !Array.isArray(plan.monthlyVariableCostPaymentsByPeriod) || plan.monthlyVariableCostPaymentsByPeriod.length < Number(plan.periods) || @@ -545,7 +563,7 @@ export function restoreBusinessPlanSnapshot( if (openingCollectionRate < 0n || openingCollectionRate > 100_000_000n) return null; if ( - [7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17].includes( + [7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 20].includes( Number(decoded.version), ) ) { @@ -618,7 +636,7 @@ export function restoreBusinessPlanSnapshot( ) return null; if ( - [8, 9, 10, 11, 12, 13, 14, 15, 16, 17].includes( + [8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 20].includes( Number(decoded.version), ) ) { @@ -657,7 +675,7 @@ export function restoreBusinessPlanSnapshot( const schedule = plan[field]; if ( schedule !== undefined && - (![11, 12, 13, 14, 15, 16, 17].includes( + (![11, 12, 13, 14, 15, 16, 17, 20].includes( Number(decoded.version), ) || !Array.isArray(schedule) || @@ -747,7 +765,7 @@ export function restoreBusinessPlanSnapshot( const costSchedule = productData.unitVariableCostByPeriod; const validMoneySchedule = (values: unknown) => values === undefined || - ([10, 11, 12, 13, 14, 15, 16, 17].includes( + ([10, 11, 12, 13, 14, 15, 16, 17, 20].includes( Number(decoded.version), ) && Array.isArray(values) && @@ -756,7 +774,7 @@ export function restoreBusinessPlanSnapshot( values.every((value) => typeof value === 'string')); return ( (schedule !== undefined && - (![9, 10, 11, 12, 13, 14, 15, 16, 17].includes( + (![9, 10, 11, 12, 13, 14, 15, 16, 17, 20].includes( Number(decoded.version), ) || !Array.isArray(schedule) || @@ -795,7 +813,7 @@ export function restoreBusinessPlanSnapshot( entry.paymentLagMonths < 0 || entry.paymentLagMonths > 12)) || (entry.paymentInstallments !== undefined && - (![16, 17].includes( + (![16, 17, 20].includes( Number(decoded.version), ) || !Array.isArray( @@ -853,7 +871,7 @@ export function restoreBusinessPlanSnapshot( }) ) return null; - return { + const restored = { ...plan, inventoryPurchaseLeadMonths: Number( plan.inventoryPurchaseLeadMonths ?? 0, @@ -915,6 +933,9 @@ export function restoreBusinessPlanSnapshot( ? plan.monthlyVariableCostPaymentsByPeriod.map(String) : null, } as unknown as BusinessFinancialPlanInput; + if (restored.dayTerms && !options.editable) + forecastBusinessPlan(restored); + return restored; } catch { return null; } @@ -1439,7 +1460,47 @@ export function compareBusinessScenarios(input: BusinessFinancialPlanInput) { } /** Forecast separates invoiced sales, collections, accounting expenses and cash payments. */ +type ActiveDayTerms = ReturnType & { + config: DayTerms; +}; + export function forecastBusinessPlan(input: BusinessFinancialPlanInput) { + const config = input.dayTerms; + if (config !== undefined && !isDayTerms(config)) + throw new Error('Prazos em dias: estrutura inválida.'); + if (!config || !(config.sales || config.purchases || config.services)) + return forecastBusinessPlanBase(input); + // First pass obtains economic recognition from the unchanged calculator. The second + // replaces only opted-in cash schedules. Neither pass mutates stored/manual inputs. + const economic = forecastBusinessPlanBase(input); + if (!input.reportAssumptions?.startYear?.trim()) + throw new Error( + 'Prazos em dias — Ano inicial: preencha o ano do relatório.', + ); + const day = buildDayTermSchedule( + config, + Number(input.reportAssumptions.startYear), + economic.rows.length, + { + sales: economic.rows.map((r) => cents(r.revenue, 'Vendas')), + purchases: economic.rows.map((r) => + r.inventoryReceipts === null + ? null + : cents(r.inventoryReceipts, 'Recepções'), + ), + services: economic.rows.map((r) => + cents(r.operatingExpenses, 'Serviços reconhecidos'), + ), + }, + cents, + ); + return forecastBusinessPlanBase(input, { ...day, config }); +} + +function forecastBusinessPlanBase( + input: BusinessFinancialPlanInput, + day?: ActiveDayTerms, +) { if (input.startupAssetRequirements) { const needs = calculateStartupAssetRequirements(input); if ( @@ -2243,10 +2304,13 @@ export function forecastBusinessPlan(input: BusinessFinancialPlanInput) { const rows = []; for (let month = 1; month <= periods; month++) { - const periodVariableCostPayment = - variableCostPaymentsByPeriod[month - 1]; + const periodVariableCostPayment = day?.config.purchases + ? day.schedules.purchases[month - 1] + : variableCostPaymentsByPeriod[month - 1]; const periodOperatingExpense = operatingExpenseByPeriod[month - 1]; - const periodOperatingPayment = operatingPaymentsByPeriod[month - 1]; + const periodOperatingPayment = day?.config.services + ? day.schedules.services[month - 1] + : operatingPaymentsByPeriod[month - 1]; const periodPayrollExpense = payrollExpenseByPeriod[month - 1]; const periodPayrollPayment = payrollPaymentsByPeriod[month - 1]; const revenue = revenueByPeriod[month - 1]; @@ -2368,7 +2432,14 @@ export function forecastBusinessPlan(input: BusinessFinancialPlanInput) { let salesCollections: bigint | null = null; let salesScheduledCollections: bigint | null = null; let salesRecoveryCollections: bigint | null = null; - if (salesCollectionLagMonths !== null) { + if (day?.config.sales) { + salesCollections = day.schedules.sales[month - 1]; + salesScheduledCollections = salesCollections; + salesRecoveryCollections = 0n; + salesReceivables += revenue - salesCollections; + totalSalesCollections += salesCollections; + totalScheduledSalesCollections += salesCollections; + } else if (salesCollectionLagMonths !== null) { const collectionMonth = month + salesCollectionLagMonths; const scheduledCollection = (revenue * salesCollectionRate + 50_000_000n) / 100_000_000n; @@ -2415,7 +2486,13 @@ export function forecastBusinessPlan(input: BusinessFinancialPlanInput) { totalSalesRecoveryCollections += salesRecoveryCollections; totalSalesCollections += salesCollections; } - const totalCollections = monthlyCollections + (salesCollections ?? 0n); + const activeManualCollections = + day?.config.sales && + input.reportAssumptions?.manualCollectionsKind !== 'other_income' + ? 0n + : monthlyCollections; + const totalCollections = + activeManualCollections + (salesCollections ?? 0n); const legacyOpeningReceivablesCollections = month === openingReceivablesCollectionMonth ? openingReceivablesCollectionAmount @@ -2463,7 +2540,9 @@ export function forecastBusinessPlan(input: BusinessFinancialPlanInput) { ? null : format(salesRecoveryCollections), otherCollections: - salesCollections === null ? null : format(monthlyCollections), + salesCollections === null + ? null + : format(activeManualCollections), salesReceivablesClosing: salesCollections === null ? null : format(salesReceivables), variableCost: format(costOfSales), @@ -2572,8 +2651,9 @@ export function forecastBusinessPlan(input: BusinessFinancialPlanInput) { paymentLagMonths: order.paymentLagMonths, }), ), - paymentSchedule: - supplierPaymentSchedules?.[index] ?? null, + paymentSchedule: day?.config.purchases + ? null + : (supplierPaymentSchedules?.[index] ?? null), totalPurchases: format( productStockInputs[index].orders!.reduce( (sum, order) => sum + order.amount, @@ -2651,26 +2731,36 @@ export function forecastBusinessPlan(input: BusinessFinancialPlanInput) { amount: format(installment.amount), })), totalSalesCollections: - salesCollectionLagMonths === null + salesCollectionLagMonths === null && !day?.config.sales ? null : format(totalSalesCollections), totalScheduledSalesCollections: - salesCollectionLagMonths === null + salesCollectionLagMonths === null && !day?.config.sales ? null : format(totalScheduledSalesCollections), totalSalesRecoveryCollections: - salesCollectionLagMonths === null + salesCollectionLagMonths === null && !day?.config.sales ? null : format(totalSalesRecoveryCollections), salesReceivablesAtEnd: - salesCollectionLagMonths === null ? null : format(salesReceivables), + salesCollectionLagMonths === null && !day?.config.sales + ? null + : format(salesReceivables), salesCollectionLagMonths, salesCollectionPercent: - salesCollectionLagMonths === null ? null : salesCollectionPercent, + salesCollectionLagMonths === null && !day?.config.sales + ? null + : salesCollectionPercent, totalPayments: format(totalOperatingPayments), - supplierPaymentsOutstandingAtEnd: useSupplierPaymentTerms - ? format(supplierPaymentsOutstanding) - : null, + supplierPaymentsOutstandingAtEnd: day?.config.purchases + ? format( + day.events + .filter((e) => e.kind === 'purchases' && e.outsideHorizon) + .reduce((sum, e) => sum + BigInt(e.amount), 0n), + ) + : useSupplierPaymentTerms + ? format(supplierPaymentsOutstanding) + : null, totalProfitBeforeTax: format(totalProfitBeforeTax), endingCash: format(cash), inventoryProjection, @@ -2940,7 +3030,19 @@ export function forecastBusinessPlan(input: BusinessFinancialPlanInput) { ), ), }; - return { ...output, presentationCurrency, conversion }; + return { + ...output, + presentationCurrency, + conversion, + ...(day + ? { + dayTermEvents: day.events.map((e) => ({ + ...e, + amount: format(BigInt(e.amount)), + })), + } + : {}), + }; } /** Reproducible local report: original assumptions, declared FX basis, and the same forecast totals. */ @@ -3495,6 +3597,38 @@ export function exportBusinessPlanCsv( 'Estimativa sem aconselhamento fiscal, parâmetros legais, sazonalidade, inflação ou validação contabilística. Moeda original preservada.', ], ]; + if (result.dayTermEvents) { + rows.push( + [], + [ + 'Prazos em dias — agendas anteriores das categorias seleccionadas conservadas inactivas', + ], + [ + 'Categoria', + 'Origem', + 'Parcela', + 'Reconhecimento', + 'Origem do prazo', + 'Vencimento', + 'Montante', + 'Precisão', + 'Horizonte', + ], + ...result.dayTermEvents.map((e) => [ + e.kind, + e.originId, + e.parcelId, + e.recognition, + e.origin, + e.due, + e.amount, + e.approximate ? 'aproximação mensal' : 'datas individuais', + e.outsideHorizon + ? 'fora do horizonte, sem caixa neste plano' + : `mês ${e.dueMonth}`, + ]), + ); + } return `\uFEFF${rows .map((row) => row.map(csvCell).join(',')) .join('\r\n')}`; diff --git a/resources/js/lib/financial-day-terms.ts b/resources/js/lib/financial-day-terms.ts new file mode 100644 index 00000000..51268ea3 --- /dev/null +++ b/resources/js/lib/financial-day-terms.ts @@ -0,0 +1,205 @@ +export type DayTermKind = 'sales' | 'purchases' | 'services'; +export type DayTermOperation = { + originId: string; + parcelId: string; + kind: DayTermKind; + month: number; + amount: string; + recognitionBasis: 'monthly' | 'date' | 'unknown'; + recognitionDate: string; + originBasis: 'recognition' | 'date' | 'unknown'; + originDate: string; + termDays: string; +}; +export type DayTerms = { + sales: boolean; + purchases: boolean; + services: boolean; + operations: DayTermOperation[]; +}; +export const dayTermLabels: Record = { + sales: 'Vendas e prestações', + purchases: 'Mercadorias recebidas', + services: 'Serviços adquiridos reconhecidos', +}; + +export function isDayTerms(value: unknown): value is DayTerms { + if (!value || typeof value !== 'object') return false; + const c = value as DayTerms; + return ( + ['sales', 'purchases', 'services'].every( + (k) => typeof c[k as DayTermKind] === 'boolean', + ) && + Array.isArray(c.operations) && + c.operations.length <= 240 && + c.operations.every( + (o) => + o && + Object.hasOwn(dayTermLabels, o.kind) && + Number.isSafeInteger(o.month) && + o.month >= 1 && + o.month <= 60 && + [ + 'originId', + 'parcelId', + 'amount', + 'recognitionDate', + 'originDate', + 'termDays', + ].every( + (k) => + typeof o[k as keyof DayTermOperation] === 'string' && + String(o[k as keyof DayTermOperation]).length <= 160, + ) && + ['monthly', 'date', 'unknown'].includes(o.recognitionBasis) && + ['recognition', 'date', 'unknown'].includes(o.originBasis), + ) + ); +} + +function civilDate(value: string): Date | null { + if (!/^\d{4}-\d{2}-\d{2}$/.test(value)) return null; + const d = new Date(value + 'T00:00:00.000Z'); + return Number.isFinite(d.getTime()) && + d.toISOString().slice(0, 10) === value + ? d + : null; +} +const iso = (d: Date) => d.toISOString().slice(0, 10); + +/** Only opted-in channels replace their complete cash agenda. No legacy input is mutated. */ +export function buildDayTermSchedule( + config: DayTerms, + year: number, + periods: number, + recognized: Record, + parseAmount: (value: string, label: string) => bigint, +) { + if (!isDayTerms(config)) + throw new Error( + 'Prazos em dias: estrutura inválida. Reveja operações e parcelas.', + ); + if (!Number.isSafeInteger(year) || year < 1900 || year > 9993) + throw new Error( + 'Prazos em dias — Ano inicial: indique o ano do relatório entre 1900 e 9993.', + ); + const schedules: Record = { + sales: Array(periods).fill(0n), + purchases: Array(periods).fill(0n), + services: Array(periods).fill(0n), + }; + const amounts: Record = { + sales: Array(periods).fill(0n), + purchases: Array(periods).fill(0n), + services: Array(periods).fill(0n), + }; + const seen = new Set(); + const origins = new Map(); + const events = config.operations + .filter((o) => config[o.kind]) + .map((o) => { + const label = `Prazos em dias — ${dayTermLabels[o.kind]}, origem ${o.originId || 'por preencher'}, parcela ${o.parcelId || 'por preencher'}`; + const fail = (message: string): never => { + throw new Error(`${label}: ${message}`); + }; + if (!o.originId.trim() || !o.parcelId.trim()) + fail('preencha a origem e a parcela para impedir duplicações.'); + const key = JSON.stringify([ + o.kind, + o.originId.trim(), + o.parcelId.trim(), + ]); + if (seen.has(key)) + fail( + 'parcela duplicada; conserve apenas um movimento da mesma origem/parcela.', + ); + seen.add(key); + if (o.month > periods) + fail( + 'mês de reconhecimento fora do horizonte; reveja o mês ou use a agenda manual.', + ); + const start = new Date(Date.UTC(year, o.month - 1, 1)); + const recognition = + o.recognitionBasis === 'monthly' + ? new Date(Date.UTC(year, o.month, 0)) + : o.recognitionBasis === 'date' + ? civilDate(o.recognitionDate) + : null; + if (!recognition) + fail( + 'data de reconhecimento insuficiente ou inválida; indique uma data ou escolha explicitamente a aproximação mensal. Operação excluída do cálculo automático.', + ); + const r = recognition!; + if ( + r.getUTCFullYear() !== start.getUTCFullYear() || + r.getUTCMonth() !== start.getUTCMonth() + ) + fail( + 'data de reconhecimento não pertence ao mês económico indicado; corrija a data ou o mês.', + ); + const origin = + o.originBasis === 'recognition' + ? r + : o.originBasis === 'date' + ? civilDate(o.originDate) + : null; + if (!origin) + fail( + 'data de origem do prazo insuficiente ou inválida; indique o evento contratual ou escolha reconhecimento. Operação excluída do cálculo automático.', + ); + if (o.kind === 'sales' && iso(origin!) !== iso(r)) + fail( + 'origem do recebimento deve ser a venda/prestação reconhecida; corrija a origem.', + ); + if (!/^\d+$/.test(o.termDays) || Number(o.termDays) > 365) + fail( + 'Prazo (dias): indique um inteiro entre 0 e 365; vazio não significa zero.', + ); + const due = new Date(origin!.getTime()); + due.setUTCDate(due.getUTCDate() + Number(o.termDays)); + if (due < r) + fail( + 'vencimento anterior ao reconhecimento: antecipação excluída de F20-A. Use a agenda manual existente; adiantamentos identificados dependem de F20-B.', + ); + const amount = parseAmount(o.amount, `${label} — Montante`); + const originKey = JSON.stringify([o.kind, o.originId.trim()]); + const identity = JSON.stringify([ + o.month, + iso(r), + o.recognitionBasis, + ]); + if (origins.has(originKey) && origins.get(originKey) !== identity) + fail( + 'parcelas da mesma origem têm reconhecimentos diferentes; confira origem, mês e data.', + ); + origins.set(originKey, identity); + amounts[o.kind][o.month - 1] += amount; + const dueMonth = + (due.getUTCFullYear() - year) * 12 + due.getUTCMonth() + 1; + if (dueMonth <= periods) schedules[o.kind][dueMonth - 1] += amount; + return { + ...o, + amount: amount.toString(), + recognition: iso(r), + origin: iso(origin!), + due: iso(due), + dueMonth, + approximate: o.recognitionBasis === 'monthly', + outsideHorizon: dueMonth > periods, + }; + }); + for (const kind of Object.keys(dayTermLabels) as DayTermKind[]) { + if (!config[kind]) continue; + for (let i = 0; i < periods; i++) { + if (recognized[kind][i] === null) + throw new Error( + `Prazos em dias — ${dayTermLabels[kind]}, mês ${i + 1}: reconhecimento indeterminado; preencha a agenda económica antes de activar este modo.`, + ); + if (amounts[kind][i] !== recognized[kind][i]) + throw new Error( + `Prazos em dias — ${dayTermLabels[kind]}, mês ${i + 1}: a soma dos montantes das origens/parcelas deve coincidir com o valor reconhecido. Corrija a distribuição; não some uma coorte às operações já individualizadas.`, + ); + } + } + return { schedules, events }; +} diff --git a/resources/js/lib/integral-financial-report.ts b/resources/js/lib/integral-financial-report.ts index 374794b9..9ba34484 100644 --- a/resources/js/lib/integral-financial-report.ts +++ b/resources/js/lib/integral-financial-report.ts @@ -224,6 +224,7 @@ export function buildIntegralFinancialTables( 'Escolha o tratamento das subvenções: capital ou passivo diferido.', ); if ( + !plan.dayTerms?.sales && cents(plan.monthlyCollections) > 0n && !['sales', 'other_income'].includes(a.manualCollectionsKind) ) @@ -784,6 +785,15 @@ export function buildIntegralFinancialTables( table('break-even').notes.push( 'Vendas de equilíbrio = custos fixos operacionais, pessoal e depreciação ÷ margem de contribuição ponderada. Juros e impostos excluídos. Arredondamento apenas no resultado final, ao centavo.', ); + if (result.dayTermEvents) { + table('cashflow').notes.push( + 'Prazos em dias: as agendas seleccionadas substituem as agendas anteriores de caixa, conservadas inactivas. Saldos de abertura mantêm as agendas próprias. Não inclui adiantamentos.', + ...result.dayTermEvents.map( + (e) => + `${e.kind === 'sales' ? 'Vendas/prestações' : e.kind === 'purchases' ? 'Mercadorias recebidas' : 'Serviços adquiridos'} — ${e.originId}/${e.parcelId}: ${e.amount} ${plan.currency}; reconhecimento ${e.recognition}; origem ${e.origin}; vencimento ${e.due}${e.approximate ? ' (aproximação mensal)' : ''}; ${e.outsideHorizon ? 'fora do horizonte, sem movimento de caixa neste plano' : `mês de caixa ${e.dueMonth}`}.`, + ), + ); + } } catch (error) { for (const entry of tables) entry.issues.push( diff --git a/tests/frontend/financial-day-terms.test.mjs b/tests/frontend/financial-day-terms.test.mjs new file mode 100644 index 00000000..4dff1038 --- /dev/null +++ b/tests/frontend/financial-day-terms.test.mjs @@ -0,0 +1,211 @@ +import test from 'node:test'; +import assert from 'node:assert/strict'; +import { + forecastBusinessPlan, + serializeBusinessPlanSnapshot, + restoreBusinessPlanSnapshot, + exportBusinessPlanCsv, +} from '../../resources/js/lib/business-financial-plan.ts'; +import { buildIntegralFinancialTables } from '../../resources/js/lib/integral-financial-report.ts'; +import { dayTermsFixture, operation } from './fixtures/financial-day-terms.mjs'; + +test('F20-A preserves explicitly classified independent other income when replacing sales collections', () => { + const p = dayTermsFixture(); + p.monthlyCollections = '100'; + p.reportAssumptions.manualCollectionsKind = 'other_income'; + const r = forecastBusinessPlan(p); + assert.deepEqual( + r.rows.map((row) => row.otherCollections), + ['100.00', '100.00', '100.00'], + ); + assert.equal(r.totalCashCollections, '1300.00'); + const tables = buildIntegralFinancialTables(p); + assert.deepEqual( + tables + .find((t) => t.id === 'profit-loss') + .rows.find((r) => r[0] === 'Outras receitas de caixa declaradas') + .slice(1), + ['100.00', '100.00', '100.00', '300.00'], + ); + assert.deepEqual( + tables + .find((t) => t.id === 'balance') + .rows.find((r) => r[0] === 'Diferença do balanço') + .slice(1), + ['0.00', '0.00', '0.00', '0.00'], + ); +}); + +test('F20-A replaces only opted-in cash agendas, preserves recognition and reconciles every monthly balance', () => { + const p = dayTermsFixture(); + const before = structuredClone(p); + const r = forecastBusinessPlan(p); + assert.deepEqual(p, before); + assert.deepEqual( + r.rows.map((r) => r.salesCollections), + ['0.00', '0.00', '1000.00'], + ); + assert.deepEqual( + r.rows.map((r) => r.variableCostPayments), + ['0.00', '0.00', '400.00'], + ); + assert.deepEqual( + r.rows.map((r) => r.operatingPayments), + ['0.00', '0.00', '100.00'], + ); + assert.equal(r.totalCashCollections, '1000.00'); + assert.equal(r.rows[0].revenue, '1000.00'); + assert.equal(r.rows[0].inventoryReceipts, '400.00'); + assert.equal(r.rows[0].operatingExpenses, '100.00'); + assert.equal(r.salesReceivablesAtEnd, '0.00'); + const tables = buildIntegralFinancialTables(p); + const balance = tables.find((t) => t.id === 'balance'); + assert.deepEqual( + balance.rows.find((r) => r[0] === 'Diferença do balanço').slice(1), + ['0.00', '0.00', '0.00', '0.00'], + ); + assert.deepEqual( + balance.rows + .find((r) => r[0] === 'Obrigações operacionais líquidas') + .slice(1, 4), + ['500.00', '500.00', '0.00'], + ); + assert.ok( + tables.every((t) => t.issues.length === 0), + JSON.stringify(tables.map((t) => t.issues)), + ); + assert.match( + tables.find((t) => t.id === 'cashflow').notes.join(' '), + /2027-03-02.*aproximação/, + ); + assert.match(exportBusinessPlanCsv(p), /2027-03-02/); +}); + +test('F20-A calendar days cover zero, individual dates, leap February and year transition', () => { + const p = dayTermsFixture(); + p.dayTerms.operations.forEach((o) => (o.termDays = '0')); + assert.equal(forecastBusinessPlan(p).rows[0].salesCollections, '1000.00'); + const sale = p.dayTerms.operations[0]; + Object.assign(sale, { + recognitionBasis: 'date', + recognitionDate: '2027-01-20', + termDays: '30', + }); + let r = forecastBusinessPlan(p); + assert.equal(r.dayTermEvents[0].due, '2027-02-19'); + assert.equal(r.dayTermEvents[0].approximate, false); + sale.recognitionBasis = 'monthly'; + p.reportAssumptions.startYear = '2028'; + assert.equal(forecastBusinessPlan(p).dayTermEvents[0].due, '2028-03-01'); + p.reportAssumptions.startYear = '2027'; + sale.termDays = '365'; + assert.equal(forecastBusinessPlan(p).dayTermEvents[0].due, '2028-01-31'); +}); + +test('F20-A excludes early and unknown payments including within the same month, never silently normalizes them', () => { + const p = dayTermsFixture(); + const o = p.dayTerms.operations[1]; + Object.assign(o, { + recognitionBasis: 'date', + recognitionDate: '2027-01-25', + originBasis: 'date', + originDate: '2027-01-01', + termDays: '0', + }); + assert.throws(() => forecastBusinessPlan(p), /antecipação excluída/); + assert.equal( + restoreBusinessPlanSnapshot(serializeBusinessPlanSnapshot(p)), + null, + ); + assert.ok( + restoreBusinessPlanSnapshot(serializeBusinessPlanSnapshot(p), { + editable: true, + }), + ); + o.termDays = '30'; + assert.equal(forecastBusinessPlan(p).dayTermEvents[1].due, '2027-01-31'); + o.originBasis = 'unknown'; + assert.throws(() => forecastBusinessPlan(p), /origem.*insuficiente/); + o.originBasis = 'recognition'; + o.recognitionBasis = 'unknown'; + assert.throws(() => forecastBusinessPlan(p), /reconhecimento insuficiente/); +}); + +test('F20-A parcels reconcile to recognition and reject duplicates without merging distinct equal payments', () => { + const p = dayTermsFixture(); + const original = p.dayTerms.operations[1]; + original.amount = '200'; + const second = { ...original, parcelId: '2' }; + p.dayTerms.operations.push(second); + assert.equal( + forecastBusinessPlan(p).rows[2].variableCostPayments, + '400.00', + ); + second.parcelId = '1'; + assert.throws(() => forecastBusinessPlan(p), /duplicada/); + second.originId = 'another'; + assert.equal( + forecastBusinessPlan(p).rows[2].variableCostPayments, + '400.00', + ); + second.amount = '201'; + assert.throws(() => forecastBusinessPlan(p), /soma dos montantes/); +}); + +test('F20-A retains future receivables and payables at horizons 1 and 60 and restores manual schedules explicitly', () => { + for (const periods of [1, 60]) { + const p = dayTermsFixture(periods); + p.dayTerms.operations.forEach((o) => { + o.month = periods; + o.originId += '-last'; + o.termDays = '365'; + }); + p.products[0].monthlyUnitsByPeriod = Array(periods).fill('0'); + p.products[0].monthlyUnitsByPeriod[periods - 1] = '1'; + p.inventoryPurchaseSchedule.forEach( + (o, i) => (o.amount = i === periods - 1 ? '400' : '0'), + ); + p.monthlyOperatingExpensesByPeriod = Array(periods).fill('0'); + p.monthlyOperatingExpensesByPeriod[periods - 1] = '100'; + const r = forecastBusinessPlan(p); + assert.equal(r.totalCashCollections, '0.00'); + assert.equal(r.supplierPaymentsOutstandingAtEnd, '400.00'); + assert.equal(r.salesReceivablesAtEnd, '1000.00'); + assert.ok(r.dayTermEvents.every((e) => e.outsideHorizon)); + assert.equal(r.rows.at(-1).variableCostPayments, '0.00'); + } + const p = dayTermsFixture(); + const legacy = { ...p, dayTerms: undefined }; + p.dayTerms.sales = p.dayTerms.purchases = p.dayTerms.services = false; + assert.deepEqual(forecastBusinessPlan(p), forecastBusinessPlan(legacy)); +}); + +test('F20-A version 20 recovers dates, inactive manual inputs and outcomes; invalid terms and foreign versions are rejected', () => { + const p = dayTermsFixture(); + const snapshot = serializeBusinessPlanSnapshot(p); + assert.equal(JSON.parse(snapshot).version, 20); + const recovered = restoreBusinessPlanSnapshot(snapshot); + assert.ok(recovered); + assert.deepEqual(recovered.dayTerms, p.dayTerms); + assert.equal(recovered.monthlyCollections, '777'); + assert.deepEqual(forecastBusinessPlan(recovered), forecastBusinessPlan(p)); + assert.equal( + restoreBusinessPlanSnapshot( + snapshot.replace('"version":20', '"version":19'), + ), + null, + ); + for (const termDays of ['', '-1', '366', '1.5', 'abc']) { + p.dayTerms.operations[0].termDays = termDays; + assert.throws(() => forecastBusinessPlan(p), /Prazo \(dias\)/); + } + p.dayTerms.operations[0] = operation('sales', '1000'); + Object.assign(p.dayTerms.operations[0], { + recognitionBasis: 'date', + recognitionDate: '2027-02-30', + }); + assert.throws( + () => forecastBusinessPlan(p), + /reconhecimento insuficiente ou inválida/, + ); +}); diff --git a/tests/frontend/fixtures/financial-day-terms.mjs b/tests/frontend/fixtures/financial-day-terms.mjs new file mode 100644 index 00000000..0d85e6c8 --- /dev/null +++ b/tests/frontend/fixtures/financial-day-terms.mjs @@ -0,0 +1,23 @@ +import { financialReportFixture } from './integral-financial-plan.mjs'; + +export function dayTermsFixture(periods = 3) { + const p = financialReportFixture(periods); + const schedule = amount => Array.from({ length: periods }, (_, i) => i === 0 ? amount : '0'); + p.products = [{ label: 'Serviço sintético F20-A', monthlyUnits: '0', unitPrice: '1000', unitVariableCost: '0', monthlyUnitsByPeriod: schedule('1') }]; + p.useInventoryPurchaseSchedule = true; + p.inventoryPurchaseSchedule = schedule('400').map(amount => ({ amount, leadMonths: 0 })); + p.monthlyOperatingExpensesByPeriod = schedule('100'); + p.monthlyPayrollExpense = '0'; + p.monthlyPayrollPayments = '0'; + p.monthlyCollections = '777'; // Kept, never added to the opted-in sales agenda. + p.reportAssumptions.manualCollectionsKind = 'sales'; + p.dayTerms = { sales: true, purchases: true, services: true, operations: [ + operation('sales', '1000'), operation('purchases', '400'), operation('services', '100'), + ] }; + return p; +} + +export function operation(kind, amount) { + return { kind, month: 1, originId: kind + '-1', parcelId: '1', amount, termDays: '30', + recognitionBasis: 'monthly', recognitionDate: '', originBasis: 'recognition', originDate: '' }; +}