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 049d224e..b0edf17c 100644 --- a/docs/investmoz/v2/auditoria-portal/apresentacao-contexto-qa-20261115.md +++ b/docs/investmoz/v2/auditoria-portal/apresentacao-contexto-qa-20261115.md @@ -2106,7 +2106,7 @@ F20 e F22 são lacunas funcionais distintas e permanecem abertos. A próxima aut 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 +## E24 — F20: compatibilidade e proposta consolidada — versão 2 — 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. @@ -2139,24 +2139,43 @@ Conferidos novamente os trechos de requisitos nas duas Revisões 1: prazos de re | 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 +### 3. Proposta técnica consolidada — versão 2, para decisã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. +Consolidação solicitada pelo proprietário a partir de `48780fde`. **As nove convenções abaixo são propostas funcionais do produto; não se registam como funcionalidades existentes, aceitação de F20 ou autorização de implementação.** A recomendação de aprovar não é convertida neste documento em aprovação definitiva, especialmente quanto ao último dia do mês. -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. +| Ponto | Proposta consolidada | Natureza/estado | +| --- | --- | --- | +| 1. Granularidade | Coortes mensais por defeito; admitir datas individuais quando disponíveis, com prevalência dessas datas sobre a aproximação mensal | Decisão funcional proposta | +| 2. Origem económica e caixa | Origem na venda/prestação para recebimentos; obrigação contratual aplicável para pagamentos. Conservar separadamente as datas de aquisição, factura e recepção, sem presumir coincidência ou deslocar o reconhecimento económico para a caixa | Decisão funcional proposta; aplicação contabilística delimitada abaixo | +| 3. Contagem | Dias de calendário, incluindo fins-de-semana e feriados, sem ajustamento automático de vencimento | Decisão funcional proposta | +| 4. Prazo zero | Recebimento/pagamento previsto no próprio dia de origem; vazio não equivale a zero | Decisão funcional proposta | +| 5. Afectação mensal | Agregar o movimento de caixa no ano/mês da data de vencimento, preservando o período económico da receita/despesa | Decisão funcional proposta | +| 6. Modos e duplicações | Agenda manual como alternativa explícita à automática para a mesma operação/parcela; não contar duas vezes a mesma obrigação. Movimentos distintos com igual data/valor não são duplicados por essa mera igualdade | Decisão funcional proposta | +| 7. Horizonte | Preservar a configuração e os planos existentes de 1 a 60 meses; não impor 36 como limite universal | Preservação vigente, reiterada na proposta; sem alteração de limites/defaults | +| 8. Vencimentos posteriores | Identificar data, montante e saldo fora do horizonte activo separadamente, sem os truncar ou transferir para o último mês | Decisão funcional proposta | +| 9. Data representativa | Na ausência de data individual, usar o último dia do mês de origem da coorte, com indicação explícita de aproximação | **Hipótese de modelação proposta, ainda por confirmar** | -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. +**Decisões aprovadas/vigentes que esta proposta preserva:** cálculos e resultados anteriores aceites, V11/V12 encerrados, F22 separado, planos antigos e edições deliberadas conservados. A execução actual é apenas documental; implementação, instalação, migrações e publicação não estão autorizadas. O limite documental de prazo 0–365 e o aviso anteriormente aprovado permanecem referências existentes. Isto não activa automaticamente a geração de caixa a partir de `creditTermDays` histórico. -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. +Para cada operação/coorte ou parcela, a futura implementação deverá conseguir rastrear origem, natureza, montante, data económica, prazo, vencimento, mês de caixa e modo activo. A origem da data deve distinguir **individual indicada** de **último dia do mês aproximado**. Um vencimento calculado a partir de uma origem aproximada conserva essa qualidade: não pode ser apresentado como data contratual exacta. Prazo zero numa coorte mensal significaria o próprio último dia assumido, não conhecimento do dia real de cada operação. -### 4. Pontos que ainda exigem decisão +A coexistência de operações datadas e uma coorte mensal exige reconciliação: os montantes individualizados não podem continuar incluídos, pela segunda vez, no remanescente da coorte. Não deduplicar por valor/data nem preencher diferenças com montantes fictícios. Agendas de origens distintas podem coexistir; a exclusão manual/automática aplica-se à mesma origem/parcela. Alterações da convenção ou do prazo não devem sobrescrever edições deliberadas sem pré-visualização e escolha explícita. -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. +O último dia é uma aproximação de previsão, **não uma garantia de prudência financeira**: pode adiar tanto recebimentos como pagamentos, com efeitos diferentes na liquidez. Exemplo sintético, sem execução: venda individual em 20/01/2027 + 30 dias vence em 19/02/2027; coorte de Janeiro de 2027 representada por 31/01 + 30 dias vence em 02/03/2027. Em 2028, 31/01 + 30 dias vence em 01/03. Os exemplos ilustram a convenção; não são resultados já demonstrados no editor. -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. +Se a proposta for confirmada, o cálculo temporal será `vencimento = origem explícita ou representativa + prazo inteiro em dias de calendário`, usando datas civis, sem conversão aproximada de dias em meses ou mudanças de dia por fuso. O prazo deve continuar declarado; ausência de prazo/data individual não significa prazo zero. A eventual substituição da data individual ausente pela data representativa só poderá ocorrer no modo de coortes expressamente autorizado e visivelmente identificado. + +Preservar a separação económica/caixa, os montantes e arredondamentos aceites. Datas/modo exigirão um contrato versionado apenas quando houver autorização para implementar; snapshots antigos não serão convertidos ou activados automaticamente. Parcelas de abertura, recuperação de vencidos, salários, impostos e juros não passam a usar esta convenção por extensão implícita. + +### 4. Confirmações pendentes antes de autorizar código + +| Ponto | O que ainda deve ser confirmado | Limite da proposta | +| --- | --- | --- | +| Último dia do mês | Aprovação expressa da data representativa, da sua indicação como aproximação e da prevalência da data individual; confirmar aplicação às coortes de recebimentos e de pagamentos abrangidas | Esta hipótese pode mudar o mês e os avisos de liquidez. Continua por aprovar; não se presume decisão pela passagem do tempo ou pela compatibilidade técnica | +| Obrigação contratual e reconhecimento das compras | Definir qual o evento contratual que inicia o prazo quando aquisição, factura e recepção diferem; tratar ou excluir expressamente adiantamentos antes da recepção | O balanço actual reconhece compras/obrigações a partir das recepções. F20 não autoriza alterar esse reconhecimento ou fingir mercadoria recebida/despesa para acomodar um pagamento | +| Operações e parcelas abrangidas | Fechar vendas/serviços e compras/serviços a crédito do primeiro recorte; definir como datas individuais, coortes residuais, percentagens e parcelas existentes se conciliam | Não reinterpretar percentagem de cobrança como percentagem de venda a crédito, alterar saldos de abertura ou alargar a salários/impostos/juros/F22 sem decisão específica | + +A validação contabilística aqui referida é **específica destes tratamentos de datas, reconhecimento e parcelas**. Não constitui nova certificação genérica, novo aprovador ou revalidação das fórmulas já aceites. As demais convenções podem ser confirmadas como um conjunto de decisões de produto; continuam sem autorização de implementação nesta consolidação. Não há pendência para impor um horizonte novo: preserva-se 1–60. ### 5. Impacto financeiro a verificar quando houver implementação autorizada @@ -2176,6 +2195,7 @@ Dias corridos, prazo zero e caixa no mês do vencimento não apresentam incompat | 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 | +| Coorte mensal sem data individual; coorte com parcelas individualizadas | Último dia identificado como aproximação; prevalência da data individual e remanescente reconciliado sem dupla contagem. Comparar Janeiro de 2027/2028 e o impacto nos meses de caixa | | 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 | @@ -2184,4 +2204,4 @@ Dias corridos, prazo zero e caixa no mês do vencimento não apresentam incompat | 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. +**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.