From 48780fdea63e2151b71231386ce81a5b498f0bad Mon Sep 17 00:00:00 2001 From: nala Date: Sat, 21 Nov 2026 09:43:57 +0200 Subject: [PATCH] docs(f20): assess proposed calendar conventions before implementation --- .../apresentacao-contexto-qa-20261115.md | 83 ++++++++++++++++++- 1 file changed, 82 insertions(+), 1 deletion(-) 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 1d47dc74..049d224e 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; verificacao-f20-f22-v11-v12-20261120.json; referência 50b95936 | E23 delimita a ligação ainda não demonstrada entre prazos de recebimento/pagamento em dias e movimentos nas agendas mensais. Campo creditTermDays e agendas por meses preservados. Antes de implementar, decidir data-âncora, dias corridos/úteis, origem do prazo do fornecedor e escolha entre agenda manual/calculada, sem presumir 30 dias = um mês. Documentos Revisão 1 conferidos; sem alteração funcional ou novos testes. Estado parcial mantido. | +| 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. | | 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. | @@ -2104,3 +2104,84 @@ Aceitação futura focada, **não executada**: empréstimo posterior só afecta F20 e F22 são lacunas funcionais distintas e permanecem abertos. A próxima autorização deve fechar primeiro as convenções temporais de F20 e o tratamento de aquisição/depreciação/dívida de F22; podem ser autorizados separadamente. Recomenda-se começar por F20, para estabilizar a distribuição temporal antes de admitir compras de activos a crédito em F22. Isso não impede autorizar um recorte F22 expressamente limitado a movimentos pagos no próprio período, se essa for a decisão do proprietário. Não há defeito novo de fórmula demonstrado nesta leitura. Não se propõe substituir cálculos aceites, importar o exemplo TEMPO como modelo obrigatório ou preencher pressupostos em falta com valores fictícios. Nenhuma implementação está autorizada por este quadro. Actualizadas somente as notas/rastreabilidade de F20/F22 e esta secção na matriz existente; os estados mantêm-se, as restantes 86 linhas e todas as aprovações, incluindo o encerramento V12, permanecem iguais. + + +## E24 — F20: compatibilidade das convenções temporais — 21/11/2026 + +Base `8a35dd0e`/E23, documentos Revisão 1 e linha F20 da matriz. Validação técnica por leitura, não demonstração funcional de uma implementação nova. Sem alteração de código, dados, fórmulas, documentos originais, configuração ou serviços; sem testes, compilação, instalação, publicação ou migração. F22, V11/V12 e restantes requisitos preservados. + +### 1. O que o modelo utiliza actualmente + +| Elemento | Constatação no código actual | Consequência para F20 | +| --- | --- | --- | +| Vendas e serviços facturados | `ProductLine` contém unidades/preços/custos base e agendas por mês. `monthlyProjectedSales`/`forecastBusinessPlan` atribuem facturação a um índice mensal, sem data diária de venda ou prestação | Não existe um dia de origem que possa ser convertido com segurança em vencimento por dias. Não reutilizar datas do dossier, câmbio ou operação fiscal sem vínculo demonstrado | +| Compras | Agendas de encomenda, prazo de recepção em meses e parcelas do fornecedor. O pagamento calculado usa mês da encomenda + `lagMonths`, não a data diária da aquisição nem a recepção por inferência | Data comercial de origem, recepção e vencimento são dimensões distintas; a convenção proposta não pode ser aplicada silenciosamente ao prazo de entrega | +| Serviços/custos operacionais | Despesa reconhecida e pagamento têm montantes/agendas mensais separados. Salários, impostos e juros também têm tratamento próprio | Um prazo comercial novo não deve deslocar automaticamente o reconhecimento económico nem ser aplicado a todas estas rubricas sem delimitação | +| Prazo em dias | `creditTermDays?: string` é persistido no snapshot; campo inteiro 0–365, validação no motor e aviso acima de 90 dias. Vazio é opcional, não prazo zero | O prazo actual informa validação/aviso, mas não gera movimentos. Não activar o novo cálculo pela mera existência deste campo histórico | +| Agendas de cobrança | `salesCollectionLagMonths` 0–12, percentagem de cobrança, coortes por mês de vencimento e recuperação de saldos. `monthlyCollections` pode somar outras cobranças ao modo por prazo | Uma exclusão global de todos os movimentos manuais apagaria cobranças independentes legítimas. A prevenção de duplicação deve identificar a mesma operação/origem | +| Agendas de pagamento | Modo fornecedor calcula parcelas e suspende a agenda manual de compras/variáveis; agendas inactivas são conservadas. Modos de compras agregadas e stock por produto são alternativos | Há um padrão de selecção explícita a reutilizar, sem perder pressupostos manuais nem somar dois modos sobre a mesma operação | +| Calendário/horizonte | O relatório identifica Janeiro–Dezembro a partir de `reportAssumptions.startYear`. O motor/editor aceitam 1–60 meses, com 12 por omissão; as agendas podem conservar meses inactivos | 36 meses não é um limite global actual. Aplicar a regra de saída ao horizonte efectivo; validar o recorte solicitado de 36 meses sem truncar planos existentes | +| Fora do horizonte | Coortes de vendas conservam saldo em `salesReceivablesAtEnd`. Fornecedores distinguem parcelas posteriores ao horizonte e montantes sem prazo em `supplierPaymentsOutstandingAtEnd`/eventos | Reutilizar a conservação de saldos, acrescentando rastreabilidade diária quando autorizada; não deslocar o vencimento para o último mês, nem chamar «atraso» a uma data ainda futura | + +Fontes delimitadas: `resources/js/lib/business-financial-plan.ts` — contrato, snapshots, validação de dias, coortes e parcelas; `simulation-business-plan.tsx` — selecção de modos e horizonte; `financial-plan-details.tsx` — declaração de dias; `integral-financial-report.ts` — calendário, caixa, recebíveis e obrigações; `financial-plan-warnings.ts` — avisos derivados. Leitura confirma a separação já existente entre facturação/despesas e recebimentos/pagamentos; não foi identificado um motor diário escondido nestas agendas. + +### 2. Compatibilidade das convenções propostas + +Conferidos novamente os trechos de requisitos nas duas Revisões 1: prazos de recebimento/pagamento a crédito, exemplo de 30 dias, cálculo de caixa e limite 0–365. Esses trechos não fixam dia representativo, dias úteis/corridos ou ajuste por feriados. Assim, as convenções abaixo são compatíveis como **decisões de desenho propostas pelo proprietário**, não regras já comprovadas no documento. + +| Convenção proposta | Avaliação técnica | Salvaguarda necessária | +| --- | --- | --- | +| Origem na data prevista da venda, prestação ou aquisição | Compatível, mas a data diária ainda não existe no contrato financeiro | Guardar a data do evento económico e vinculá-la ao montante/coorte. Uma única data para vendas mensais agregadas é um pressuposto visível, não a data real de todas as vendas | +| Dias de calendário, incluindo fins-de-semana/feriados | Compatível; não requer calendário de feriados ou serviços externos | Somar dias civis a uma data, sem horas ou ajustes de fuso que mudem o dia; não arredondar para 30 dias/mês | +| Prazo zero = próprio dia | Compatível com a contagem proposta | Distinguir zero explícito de data/prazo em falta; a ausência não gera movimento fictício | +| Caixa no mês do vencimento | Compatível com agregação mensal existente | Preservar o mês económico original da receita/despesa. A transformação é da distribuição de caixa, não da facturação ou da margem | +| Agenda manual preservada | Compatível com os modos actuais | Nova opção em dias apenas por escolha explícita, com pré-visualização; conservar agenda anterior sem a activar simultaneamente para a mesma origem | +| Não somar automático e manual da mesma operação | Compatível, mas exige correspondência de origem | Identificador/vínculo de operação/coorte e modo activo. Não deduplicar apenas por igualdade de valor/data: operações distintas podem ser iguais | +| Vencimento fora de 36 meses | Compatível no recorte de 36 meses | Guardar a data e o saldo posterior, excluindo-o da caixa dentro do horizonte; nada transferido para o mês 36. Recomenda-se generalizar ao `periods` activo sem mudar limites/defaults históricos | + +### 3. Proposta técnica mínima, sem implementação + +Separar uma camada de **operações económicas previstas** da camada de **movimentos de caixa previstos**. Cada parcela a crédito deve conseguir recuperar: origem, natureza (recebimento/pagamento), data económica, montante ou parcela, prazo em dias, data de vencimento calculada, mês de caixa e modo manual/calculado. Esta é uma descrição de contrato a aprovar, não um novo esquema já instalado nem obrigação de cadastrar cada factura. + +Para uma operação datada, calcular `vencimento = data de origem + prazo inteiro em dias de calendário`; agregar pelo ano/mês do vencimento. Data/prazo inválido ou ausente mantém a operação por completar, sem usar zero. Adoptar representação de data civil, por exemplo AAAA-MM-DD, sem depender do fuso/horário do navegador. Montantes continuam com a precisão/arredondamento aprovados. No modo manual, o investidor continua a declarar a previsão de caixa; não se deve apresentar uma data de vencimento calculada como pagamento realizado ou cumprimento certificado. + +O gerador em dias deve fornecer uma única agenda activa à previsão, reutilizando a separação económica/caixa existente. A agenda gerada e a sua origem devem ser rastreáveis; edição manual deliberada exige escolha explícita, não uma regeneração que sobrescreva a edição. Recebimentos manuais independentes mantêm natureza própria. Parcelas de abertura, recuperação de vencidos e pagamentos já modelados conservam o contrato actual até se decidir expressamente abrangê-los. Não reinterpretar a percentagem de cobrança actual como nova percentagem de venda a crédito: são conceitos a delimitar. + +Preservar leitores e resultados dos snapshots antigos. Uma futura versão de contrato deverá guardar datas/modo sem activar automaticamente F20 sobre `creditTermDays` já existente. O ano/mês de início deve ser coerente com o calendário do relatório; não deslocar um plano existente de Janeiro para outro mês por inferência. A escolha do formato/versão e dos campos definitivos só será implementada após autorização. + +### 4. Pontos que ainda exigem decisão + +1. **Granularidade da data:** movimentos individuais ou parcelas/coortes de um total mensal. Recomenda-se permitir parcelas com datas explícitas; um dia representativo para todo o mês só mediante hipótese assumida pelo investidor. Não presumir dia 1 ou último dia. +2. **Aquisição versus recepção:** confirmar o evento que inicia o prazo do fornecedor quando encomenda, factura e recepção não coincidem. O balanço actual reconhece compras/obrigações a partir das recepções. A nova data de pagamento não autoriza mudar esse reconhecimento. Se houver adiantamento antes da recepção, decidir o tratamento ou delimitar o recorte, sem o converter artificialmente em mercadoria recebida/despesa. Não confundir esta decisão com novos activos de F22. +3. **Abrangência comercial:** confirmar vendas/prestações de serviços e compras de mercadorias/serviços a crédito incluídas no primeiro recorte. Não aplicar prazos comerciais a salários, impostos, empréstimos ou juros por extensão implícita. Confirmar a relação com percentagens e parcelas já declaradas. +4. **36 meses:** recomenda-se demonstrar F20 num plano de 36 meses, mantendo a regra «fora do horizonte activo» e a compatibilidade 1–60. Uma intenção de tornar 36 o limite/default universal exigiria decisão adicional e não decorre desta validação. + +Dias corridos, prazo zero e caixa no mês do vencimento não apresentam incompatibilidade técnica identificada. Continuam propostas à espera de confirmação/autorização; a compatibilidade não equivale a implementação ou aceitação funcional de F20. + +### 5. Impacto financeiro a verificar quando houver implementação autorizada + +| Consumidor | Efeito esperado da distribuição temporal | O que preservar | +| --- | --- | --- | +| Previsão de Vendas; Lucros e Perdas; ponto de equilíbrio | Datas económicas mantêm facturação, custos reconhecidos e resultados nos meses de origem | Não mover receita/despesa para o mês do dinheiro; compras de stock não são automaticamente custo das vendas | +| Fluxo de Caixa | Mudam meses dos recebimentos/pagamentos, saldos iniciais/finais e agregados anuais quando há passagem de ano | Uma só contabilização de cada movimento; reconciliação mês a mês e cêntimos conservados | +| Balanço | Mudam caixa, valores por receber/pagar conforme movimentos e reconhecimento económico | Identidade activo = passivo + capital; saldos futuros visíveis, sem compensações arbitrárias | +| Arranque/financiamento e rácios dependentes | Liquidez e eventual insuficiência de caixa podem mudar legitimamente | Nenhum empréstimo/activo fictício para eliminar défice; nenhuma implementação de F22 | +| V11 e V12 | V11 continua a ler «Caixa final» mensal; V12 continua a diagnosticar inconsistências dos dados/tabelas | Sem reabrir aprovações. Verificar apenas o delta: novos meses negativos ou desaparecimento legítimo após alteração de prazo, sem mudar a regra de aviso | +| Gravação, recuperação e exportações | Devem conservar datas, modo, origem, vencimentos e saldos fora do horizonte | Mesmo plano e mesma versão de dados em editor/relatório; rastreabilidade técnica administrativa, sem expor identificadores internos na apresentação pública | + +### 6. Aceitação futura proposta — não executada nesta análise + +| Caso sintético a reutilizar/adaptar | Resultado esperado | +| --- | --- | +| Venda/serviço em 20/01/2027, 30 dias | Receita em Janeiro, vencimento em 19/02/2027, caixa em Fevereiro; recebível entretanto conservado | +| Origem 31/01/2027, 30 dias | Vencimento em 02/03/2027; não deslocar apenas um mês | +| Origem 28/02/2028, 1 dia; 31/12/2027, 1 dia | 29/02/2028 e 01/01/2028, incluindo transição anual | +| Prazo 0 numa data de fim-de-semana/feriado | Próprio dia, sem ajuste; mesmo mês de caixa | +| Limites e dados em falta | 0 e 365 válidos; negativos, 366, fraccionários e datas impossíveis recusados; vazio não equivale a zero | +| Recebimento e pagamento com a mesma regra temporal | Meses correctos em ambos os sentidos; custos/facturação no período económico próprio | +| Parcela com vencimento posterior ao mês 36 | Data e saldo posterior conservados, sem entrada/saída no mês 36 nem empréstimo automático. Também conferir o horizonte activo diferente de 36 sem o alterar | +| Uma operação em dois modos; duas operações distintas com igual valor/data | A primeira exige escolha e não duplica caixa; as duas distintas mantêm-se ambas | +| Troca de modo, edição manual e reabertura | Pré-visualização/decisão explícita; edições deliberadas e agenda inactiva preservadas; gravação e recuperação equivalentes | +| 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 | + +**Resultado da validação técnica:** propostas temporalmente compatíveis, condicionadas às quatro decisões delimitadas. F20 permanece **PARCIALMENTE DEMONSTRADO**, sem implementação autorizada. Próxima acção recomendada: confirmar essas decisões e o recorte de aceitação, antes de autorizar a alteração funcional. Nenhum avanço para F22 ou nova ronda de testes foi iniciado. Apenas a nota/rastreabilidade de F20 e esta secção documental foram actualizadas; restantes 87 linhas inalteradas.