docs: delimit V12 financial message coverage and remaining gaps

This commit is contained in:
2026-11-20 22:01:47 +02:00
parent 4ef5f58e97
commit a5f3714cac
@@ -1197,7 +1197,7 @@ Nomes de ficheiros na coluna de implementação referem-se a `resources/js/lib/`
| V09 | PN P0073–0087 | Validação financeira | Aplicar todas as mensagens literais definidas em todos os formulários e consumidores | IMPLEMENTADO MAS NÃO VALIDADO | business-financial-plan.ts:25–34; complementary-report.ts; integral-financial-plan.tsx | 04d8db6c;4fb9296f | Mensagens locais existem; não há prova de cobertura literal integral de percentagens, datas, caixa e divergências. Validação funcional não comprova todos os textos exigidos. |
| V10 | PN P0081 | Validação financeira | Campo de prazo em dias e mensagem de intervalo 0–365 | INTEGRADO E VALIDADO | financial-plan-details.tsx; business-financial-plan.ts; financial-plan-warnings.ts | 9c34af04;19f06ddf | Campo opcional de prazo contratual em dias, persistido no snapshot 18; inteiro entre 0 e 365, com mensagem pedida para -1, 366, 30.5 e abc. Mantém-se a agenda mensal independente. Dependência indispensável do aviso exacto de crédito V08, não uma alteração da fórmula de caixa. E8: limites 0/30/90/91/365, recuperação e comparação exacta dos fluxos antes/depois. |
| V11 | PN P0083 | Validação financeira | Aviso de caixa negativa identifica o mês e valor | APROVADO E ENCERRADO EM QA | financial-plan-warnings.ts; monthly-negative-cash-warnings.test.mjs; componentes e relatório existentes | fe615e55; E16; prova-v11-caixa-mensal-20261120.json | Aceitação expressa do proprietário com base no relatório E16 do commit fe615e55, sem inspecção independente dos ficheiros locais. Cinco avisos Janeiro–Maio 2027 (-1720.00/-1340.00/-960.00/-580.00/-200.00 MZN), apesar do fecho anual +2460.00; cenário sem défices sem avisos indevidos; gravação e recuperação demonstradas em computador e móvel 390×844; seis testes específicos aprovados. Fórmulas financeiras preservadas. Encerramento exclusivamente documental, sem repetir testes ou modificar código; instalação, publicação e migrações não autorizadas. |
| V12 | PN P0085 | Validação financeira | Detectar toda a inconsistência entre tabelas, indicando tabela e campo | PARCIALMENTE DEMONSTRADO | financial-issue-presentation.ts; investment-report-tables.tsx; simulation-business-plan.tsx; project-dossier-document.ts | E15/E17; prova-v12-mensagens-20261120.json | E17: mensagens de capital, existências, activos, abertura e pessoal identificam tabelas/campos sem alterar detectores ou cálculos. Capital repetido nas sete tabelas e no resumo passa a aviso único; resumo genérico de abertura omitido quando há detalhe específico. Editor real QA em computador/móvel: capital 600 versus discriminação 700 e abertura 999 versus 1000, correcção e recuperação sem avisos antigos. Sete testes específicos aprovados; impressão/Word sem repetição. Mantém-se parcial: cobertura integral de inconsistências/campos não demonstrada, sem encerramento. |
| V12 | PN P0085 | Validação financeira | Detectar toda a inconsistência entre tabelas, indicando tabela e campo | PARCIALMENTE DEMONSTRADO | financial-issue-presentation.ts; investment-report-tables.tsx; simulation-business-plan.tsx; project-dossier-document.ts | 4ef5f58e; E15/E17/E18; prova-v12-mensagens-20261120.json | Melhoria E17 aprovada pelo proprietário no âmbito verificado: mensagens, deduplicação, correcção e recuperação; cobertura integral não demonstrada, manter aberto. E18 inventaria as regras e separa provas de cálculo, tradução e interface; três lacunas concretas de apresentação identificadas por leitura do código, sem novos testes: avisos de arranque fora do agrupamento, mensagem conjunta de depreciação/reembolso e parcelas de fornecedor acima de 100% com mensagem de encomendas/prazos. Nenhum cálculo, código ou requisito restante alterado nesta delimitação. |
| V13 | PN P0086 | Validação financeira | Lista Falta preencher com ligação directa a cada campo por corrigir | NÃO IMPLEMENTADO | integral-financial-plan.tsx; simulation-business-plan.tsx | — | Existem erros e notas; não foi encontrada implementação completa do sumário com ligações por campo pedido. |
| V14 | PN P0098 | Validação financeira | Aviso específico sobre textos opcionais em falta (concorrência/SWOT) | NÃO IMPLEMENTADO | business-plan-guidance.ts; business-plan-warnings.tsx | — | Catálogo de avisos não inclui estes textos opcionais. |
| C01 | PN P0015; ME P0115 | Portal — actividades existentes | Análise agregada privada sem divulgar empresas/contactos individuais | INTEGRADO E VALIDADO | app/Services/InvestorContext.php; componentes de consulta agregada | base bae996e1 (histórico de incorporação no documento) | E7: provas agregadas e protecções documentadas; não é publicação de listas individuais. |
@@ -1857,3 +1857,68 @@ Capturas e texto de acessibilidade foram inspeccionados na sessão de computer-u
- Apenas a linha V12 alterada nas 88; restantes 87 exactamente preservadas, incluindo V11 aprovado/encerrado, F20 parcial, F22 pendente, P01 suspenso/parcial e aprovações financeiras anteriores.
**V12 permanece PARCIALMENTE DEMONSTRADO.** A melhoria da qualidade e deduplicação está validada no recorte descrito; não equivale à prova de detecção de todas as inconsistências nem à identificação de campo em todos os diagnósticos possíveis. Não se inventa uma causa para divergências agregadas. Sem encerramento automático ou início de nova frente. Próxima acção recomendada: apreciação deste recorte de mensagens antes de autorizar quaisquer casos adicionais. Instalação, publicação, migrações operacionais e alterações financeiras continuam não autorizadas.
### E18 — 20/11/2026 — Quadro final de cobertura documental de V12
Referência `4ef5f58e` e E17. Aceitação do proprietário: melhoria específica aprovada no âmbito verificado; V12 parcialmente validado e aberto. Conferência exclusivamente de documentos, código e provas existentes, sem executar testes, funções financeiras, browser, consultas à base ou alterar código. A contagem de linhas da matriz é verificação documental, não teste de software.
| Convenção / limite | Significado neste quadro |
| --- | --- |
| Critério original | PN Revisão 1, XML 89: inconsistência entre tabelas deve indicar tabela/campo; XML 91: mensagens compreensíveis, correcção remove a mensagem e actualiza dependências. XML 35/37 e 57/59/61–64 identificam pessoal, financiamento, despesas, fluxo, balanço e rácios. Índices XML contam `w:p` a partir de zero, incluindo tabelas; a referência PN P0085 da matriz mantém-se |
| Âmbito | Inventário das comparações entre grandezas, tabelas, agendas e pressupostos implementadas no plano, e das mensagens auxiliares necessárias à sua interpretação. Não é inventário de todos os erros de formato ou de todas as regras fiscais do portal; não cria equivalências financeiras novas |
| Validada no recorte | Há prova aceite do aspecto indicado. Prova do cálculo/rejeição, tradução de texto, renderização e percurso real são distinguidas; uma não substitui as outras |
| Não demonstrada | Implementação ou teste existente foi lido, mas não há prova suficiente da mensagem/campo, ausência de repetição ou recuperação no caso específico. Não significa regra inexistente, falha de cálculo nem autorização para repetir testes |
| Defeito por leitura estática | O ramo e a mensagem/renderização podem ser identificados precisamente no código. Não se afirma nova reprodução em navegador ou novo teste aprovado nesta execução |
| Fontes abreviadas | BFP = `resources/js/lib/business-financial-plan.ts`; IFR = `resources/js/lib/integral-financial-report.ts`; CR = `resources/js/lib/complementary-report.ts`; RR = `resources/js/lib/financial-ratios-report.ts`; AP = `resources/js/lib/financial-issue-presentation.ts`. Os números após `:` são linhas da versão `4ef5f58e` |
| Provas aceites reutilizadas | E2: sete tabelas, reconciliação e ausência de compensações (`722322f9`, `20998b89`, encerramento `f3148d16`); E3: tabelas complementares (`4fb9296f`, encerramento `a90c8ef2`); E4: rácios (`35c9e4fc`, encerramento `2e5b7f97`); E17: sete testes específicos e percurso real de capital/abertura aceites nesta decisão. Nenhuma suite foi repetida |
| Limite de E17 | Agrupamento por chamada a `InvestmentReportTables` e por secção exportada, com preservação dos `issues` originais. Não é um mecanismo de deduplicação de todos os alertas locais de todos os componentes |
| Regra implementada e vínculo documental | Fonte da regra | Mensagem apresentada, tabela e campo | Testes e provas existentes | Cobertura / lacuna concreta |
| --- | --- | --- | --- | --- |
| Capital discriminado = capital próprio — PN XML 59/89 | BFP:1460–1468; AP | “Financiamento — Capital próprio: este valor não coincide com a soma de Capital do proprietário, Capital do investidor e Capital adicional angariado…”; indica a secção da discriminação e permite corrigir um dos lados | E15/E17; `financial-issue-presentation.test.mjs`, caso `capital mismatch…`, componente real e impressão/Word; prova real 600/700, correcção, guarda e recuperação | **Validada no recorte, aprovada.** Não repetir este percurso |
| Aquisição de activos = aquisições adicionais calculadas — PN XML 37/59/63/89 | BFP:1443–1452; AP | “Arranque / Aquisição de activos…”; compara com “Caixa e activos necessários ao arranque”, requeridos/disponíveis | E17, caso `inventory and startup messages…`: tradução do diagnóstico. F16 e `startup-example-correspondence.test.mjs:86/158/193` preservam cálculo e adopção explícita | **Tradução validada.** Prova individual da mensagem de divergência no navegador não demonstrada. Não repetir nem reabrir o cálculo F16. Alertas locais de dados incompletos são tratados separadamente na linha de arranque abaixo |
| Existências iniciais por produto = total do plano — PN XML 37/63/89 | BFP:2059–2069; AP | “Balanço / Existências iniciais…”; nomeia “Planear stock por produto” e total versus linhas | `business-financial-plan.test.mjs:1467/1527` contém rejeição do total 1499 face ao somatório por produto; E17 valida a tradução em `inventory and startup messages…` | **Tradução validada; detector com teste existente.** Percurso real específico e remoção do aviso após correcção não demonstrados nesta regra |
| Activo de abertura − obrigações/dívida − capital = zero — PN XML 59/63/89 | IFR:475–495; AP | “Balanço projectado / Saldos de abertura: diferença …”; nomeia Capital e resultados anteriores e saldos patrimoniais, sem atribuir falsamente um único campo errado | E2, `integral-financial-report.test.mjs:175`; E17, `opening imbalance…`; prova real 999/1000, correcção e recuperação. Resumo genérico omitido quando já há detalhe de abertura | **Validada no recorte, aprovada.** A diferença agregada não permite saber automaticamente qual saldo de origem está errado; isso não é uma regra financeira em falta |
| Balanço dos períodos reconciliado — PN XML 63/89 | IFR:545–710; RR:104–113 | “Existem períodos não reconciliados; reveja as rubricas indicadas.” Tabela Balanço, linha Diferença do balanço; sem campo causal único na mensagem | E2, `seven integrated statements reconcile…` e `missing inputs…`; E4, `inconsistent balance blocks only dependent indicators…`; E17 cobre a sobreposição com abertura | **Cálculo/bloqueio com prova histórica. Mensagem específica fora da abertura não demonstrada.** Manter distinção entre saldo inconsistente e indeterminado; não inventar o campo errado |
| Stock suficiente para vendas declaradas — PN XML 37/63/89 | IFR:534–539; BFP, projecção de existências | “Mês N: existências insuficientes para as vendas declaradas.” Balanço; campos de existências/compras, consumo e vendas do plano | E2, `integral-financial-report.test.mjs:175`; `business-financial-plan.test.mjs:1283/1305/1467`, incluindo falta por produto e proibição de transferir stock entre produtos | **Detector/cálculo com prova histórica.** Mensagem por produto/campo e percurso real de resolução não demonstrados em E17. Avisos de meses distintos não são duplicados apenas por terem o mesmo texto-base |
| Depreciação acumulada não excede activos — PN XML 61/63/89 | IFR:540–543 | “Mês N: depreciação superior aos activos **ou** reembolso superior à dívida; confira os dados.” Balanço; base/vida útil da depreciação e activos anteriores/adquiridos | `business-financial-plan.test.mjs:589` prova alocação da depreciação, não esta mensagem de excesso. E17 não mapeia o aviso | **Defeito de especificidade por código (D2).** Dois ramos diferentes produzem a mesma alternativa; não indica qual comparação falhou. Prova funcional individual do aviso não localizada |
| Reembolso acumulado não excede empréstimos/suprimentos — PN XML 59/62/63/89 | IFR:540–543, mesmo `OR` | A mesma mensagem conjunta da linha anterior. Balanço; “Reembolso de capital” versus empréstimos e suprimentos declarados | `business-financial-plan.test.mjs:572` prova efeito do reembolso na caixa e exclusão do lucro, não a precisão do aviso de excesso | **Mesmo defeito D2, não um segundo defeito de cálculo.** Há informação no ramo para distinguir a comparação, mas o texto não a distingue; não se propõe alterar o limite ou o cálculo |
| Folha salarial por função = despesa de pessoal no plano — PN XML 57/61/89 | CR:400–424; AP | “Mapa de pessoal / Folha salarial prevista…” versus “Pessoal” em Lucros e perdas e “Custo mensal de pessoal”; quantidade, remuneração e meses activos, com linha de diferenças | E3; recibo `outputs/controlled-5f7db7cd-20261120/package2/acceptance.json`: `mismatchWarningBothResolutions=true`, 1440/390 px. `complementary-report.test.mjs:110`; E17, `personnel mismatch…`, confirma texto novo e remoção após correcção | **Validada nos aspectos documentados.** Há prova visual histórica da divergência e prova de funções da apresentação actual; E17 não fez uma nova sessão individual no navegador para o texto reformulado. Não tratar essa ausência de repetição como perda da aprovação anterior |
| Moeda do mapa de pessoal compatível com a do plano — PN XML 57/89; preservação V10 | CR:114–122/400–431 | “A moeda do projecto difere da moeda do plano financeiro. A reconciliação fica por determinar, sem conversão automática.” Pessoal; moeda do projecto/plano | E3; `complementary-report.test.mjs:21` e preservação V10 | **Comparação e recusa de conversão com teste/prova histórica.** Não é regra nova de câmbio. Mensagem de resolução completa em interface actual não demonstrada; não reabrir V10 |
| Rácios dependem de balanço reconciliado — PN XML 64/89 | RR:104–120/149–150 | “Balanço inconsistente ou indeterminado: liquidez, endividamento e retorno do capital não calculados em [períodos].” Rácios; remete ao balanço, sem indicar um campo causal único | E4, `financial-ratios-report.test.mjs:92`; E4 testa também bloqueios parciais e preservação dos indicadores independentes | **Bloqueio validado historicamente.** A mensagem é uma consequência da inconsistência/indeterminação, não uma nova regra de financiamento. Precisão causal e sequência de correcção em interface actual não demonstradas |
| Activo/passivo correntes declarados dentro dos totais do balanço — PN XML 63/64/89 | RR:121–154 | “Para determinar a liquidez, classifique activo e passivo correntes dentro dos totais do balanço. Períodos por completar ou corrigir: …”; campos Activo corrente/Passivo corrente do mês | E4, `financial-ratios-report.test.mjs:115` usa activo corrente 999999; recibo `package3/acceptance.json` prova classificação em falta e recuperação em 1440/390 px | **Regra com teste e prova de ausência.** O mesmo aviso cobre ausência e valor superior ao total; não demonstrada identificação individual de qual campo excedeu o total. Não se declara defeito adicional de fórmula nem se inventam maturidades |
| Agendas mensais cobrem o horizonte — PN XML 61/62/89 | BFP:1516/1697–1730/1841/1939; IFR:185–190 | Exemplos: “[rubrica]: a agenda deve cobrir os N meses…”; “Preencha imposto estimado e pagamento fiscal para cada mês…”. Campos de quantidades/preços/custos/pagamentos por mês e agendas fiscais | `business-financial-plan.test.mjs:289/388/489`; E2, falta de imposto em `integral-financial-report.test.mjs:175` | **Testes de estrutura/consistência temporal existentes; mensagem por célula não demonstrada.** Mensagens agregadas não localizam necessariamente o mês em falta. F20 permanece separado: isto não demonstra conversão de dias em meses |
| Modos de compras coerentes — PN XML 37/62/89 | BFP:1520–1534 | “Seleccione compras agregadas ou stock por produto, nao os dois modos.” / “Os prazos de pagamento a fornecedores exigem compras planeadas por produto.” Campos dos modos e respectivos controlos | `business-financial-plan.test.mjs:1531` contém rejeição de modos incompatíveis; outros casos de fornecedores em 1545/1627 | **Rejeição com teste existente; qualidade do percurso real não demonstrada.** Não criar nova obrigação de inventário nem reinterpretar F20 |
| Parcelas de abertura coerentes com o saldo e horizonte — PN XML 62/63/89 | BFP:1559–1663 | “A soma das cobranças declaradas de recebíveis de abertura não pode exceder 100%.” / “A soma das liquidações declaradas de valores a pagar não pode exceder 100%.” / “Cada recuperação deve ter um mês único dentro do horizonte.” Campos das agendas respectivas | `business-financial-plan.test.mjs:93/1193/1245/1256/1266`; arredondamento limitado ao saldo e preservação das parcelas também têm casos existentes | **Testes de rejeição e saldos existentes.** Mensagem que localiza a parcela concreta e remoção no navegador não demonstradas; não confundir com prova de F20 ou F22 |
| Parcelas de fornecedor somam no máximo 100% da encomenda — PN XML 62/89/91 | BFP:1786–1843 | Para soma 110%, cai em “[produto]: declare encomendas e prazos de entrega para todos os N meses.” Não nomeia soma/percentagem das parcelas nem encomenda/mês responsável | `business-financial-plan.test.mjs:1679–1687` contém explicitamente parcelas 60% + 50% e espera `/declare encomendas/`; AP não traduz este diagnóstico | **Defeito concreto de mensagem (D3), sustentado por condição e teste já existente lido.** Rejeição implementada; texto aponta encomendas/prazos em vez da percentagem. Sem nova execução ou prova de interface nesta conferência |
| Erros com relatório de estrutura desconhecida ou fonte anual — PN XML 35/89/91 | AP, `forecastErrorShownInReport`; `IntegralFinancialPlan`, retornos antecipados | O resumo conserva o erro se as tabelas não o puderem mostrar. Não atribui um campo financeiro a uma estrutura não reconhecida | E17, `deduplication never hides a forecast error…` e `unknown diagnostics…` | **Salvaguarda validada por teste E17.** Não equivale a validar todos os diagnósticos desconhecidos nem a dar por corrigidos os seus campos |
| Mensagens auxiliares de arranque incompleto — PN XML 37/59/89/91, sem reabrir F16 | `startup-asset-requirements.ts:3–6/24–55`; componente homónimo:22–31/169; `simulation-business-plan.tsx:950–951`; `integral-financial-plan.tsx:85` | Exemplo: “Indique a caixa requerida, com até duas casas decimais; use zero apenas quando conhecido.” Campo Caixa requerida. O mesmo componente com o mesmo plano é montado duas vezes e cada instância imprime `error`; o relatório ainda pode apresentar o mesmo erro agrupado | E17 só demonstra o agrupamento das tabelas e a tradução da divergência de aquisições. Testes F16 em `startup-example-correspondence.test.mjs` não comprovam unicidade destes alertas locais | **Defeito de repetição por código (D1).** Com necessidades activadas e `cashRequired` vazio/inválido, percurso do plano do investidor pode apresentar duas mensagens locais iguais, mais uma no painel. Sem reprodução nova no navegador; cálculos F16 permanecem aprovados |
| Delimitação de duplicações | Resultado da conferência |
| --- | --- |
| Capital nas sete tabelas e no resumo inferior | Resolvido e aceite em E17; não reabrir |
| Resumo genérico do balanço quando já há detalhe de abertura | Resolvido e aceite em E17; `issues` originais preservados |
| Arranque incompleto em componentes locais | D1 fora do agrupamento de E17. Dois locais de renderização com o mesmo plano e o mesmo `error`; eventual terceiro é o painel. Correcção futura, se autorizada, deve limitar-se à propriedade/apresentação do aviso, sem mudar F16 ou as entradas |
| Avisos de meses diferentes, ou mensagem de causa mais aviso de indicador não calculado | Não são automaticamente duplicados. Não foi demonstrado que todos os avisos de stock/rácios devam ser eliminados ou fundidos. Preservar os períodos e os indicadores efectivamente afectados |
| Mesmo texto em secções diferentes ou mensagens locais de outros campos | Agrupamento é local à chamada/secção; cobertura global não demonstrada. Não afirmar novo defeito apenas por falta de prova; não usar isto como autorização para varrimento geral ou deduplicação indiscriminada |
| Lacuna concreta que poderia justificar intervenção final separada | Âmbito mínimo proposto, sem execução nesta conferência |
| --- | --- |
| D1 — repetição de alerta de arranque | Tornar única a apresentação do mesmo diagnóstico entre as instâncias locais e o relatório, preservando estados de erro, campos, fórmulas e a aprovação F16 |
| D2 — aviso conjunto de depreciação/reembolso | Nomear a comparação que efectivamente falhou e os campos respectivos; se ambas falharem, comunicar ambas. Manter exactamente os limites e os cálculos existentes. A precisão dos ramos ainda carece de prova funcional individual |
| D3 — soma de parcelas de fornecedor acima de 100% com texto de encomendas/prazos | Separar a mensagem desse ramo, indicando percentagem/soma e encomenda/mês/produto disponíveis no contexto. Não alterar os prazos, os pagamentos ou F20 |
| Restantes linhas não demonstradas | São limites de prova, não defeitos já confirmados. Reutilizar testes/provas aceites e delimitar apenas os casos necessários; não criar novos cálculos, comparações económicas ou regras de aprovação para encerrar V12 |
| Exclusões preservadas | Razão |
| --- | --- |
| Caixa negativa, prejuízo, financiamento insuficiente e rácios economicamente desfavoráveis | Riscos/avisos não equivalem a inconsistência entre tabelas. V11 permanece aprovado e encerrado; não criar dívida ou bloquear planos a partir destes avisos |
| Números negativos/formato, percentagens isoladas, datas ordenadas e pessoas inteiras | Validações já tratadas nos requisitos próprios. PN XML 79/85, V04 e restantes aprovações não são reabertos. O quadro inclui apenas relações entre parcelas/saldos/calendários relevantes a V12 |
| Totais derivados automaticamente, departamentos do exemplo e pressupostos ausentes | Não exigir uma segunda entrada independente só para poder compará-la; não impor estrutura TEMPO/CAE nem preencher desconhecidos com zero. PN Revisão 1 XML 58 preservado |
| Movimentos novos por período e equivalência de prazos em dias | F22 e F20 permanecem separados e inalterados; a presente leitura dos ramos existentes não autoriza decisões sobre esses modelos |
| Resultado final documental | Estado |
| --- | --- |
| V12 | **Parcialmente validado — aberto.** Melhoria específica de `4ef5f58e` aprovada; cobertura integral não demonstrada. Não há obrigação de repetir os casos já aceites |
| Provas desta execução | Leitura de fontes e recibos existentes. Nenhum teste, motor, browser ou operação de dados executado; defeitos D1/D2/D3 identificados por leitura, com o nível de evidência indicado |
| Alterações documentais | Apenas a linha V12 e o presente quadro E18 na matriz existente. Restantes 87 linhas, V11/F20/F22 e fontes/cálculos preservados. Nenhum novo requisito ou backlog criado |
| Limites operacionais | Sem alteração de código, fontes originais ou dados; sem instalação, publicação ou migrações. Qualquer intervenção D1–D3 exige autorização separada e delimitada |