docs(f20): consolidate proposed temporal conventions
This commit is contained in:
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user