docs(qa): validate F16 and document exact F31 source gaps

This commit is contained in:
2026-11-20 17:53:38 +02:00
parent 9f7dd7df6d
commit 2f4ba962a2
2 changed files with 51 additions and 5 deletions
@@ -1152,7 +1152,7 @@ Nomes de ficheiros na coluna de implementação referem-se a `resources/js/lib/`
### Matriz única
| ID | Documento/localizador | Âmbito | Requisito | Estado na QA c34670ef | Ficheiro ou módulo | Commit/revisão | Evidência e limite concreto |
| ID | Documento/localizador | Âmbito | Requisito | Estado na QA (último commit indicado) | Ficheiro ou módulo | Commit/revisão | Evidência e limite concreto |
| --- | --- | --- | --- | --- | --- | --- | --- |
| F01 | PN P0044/P0050; T001 | Relatório financeiro | Start-up: tabela, despesas discriminadas e somatórios | INTEGRADO E VALIDADO | integral-financial-report.ts; integral-financial-plan.tsx | 722322f9 | E2 |
| F02 | PN P0039/P0051/P0176–0188; T002 | Relatório financeiro | Mercado: segmentos, clientes iniciais, crescimento, projecções, CAGR e totais | INTEGRADO E VALIDADO | complementary-report.ts; market-analysis-plan.tsx | 4fb9296f | E3 |
@@ -1169,7 +1169,7 @@ Nomes de ficheiros na coluna de implementação referem-se a `resources/js/lib/`
| F13 | PN P0046/P0048; ME P0152 | Relatório financeiro | Persistência, recuperação, isolamento e Word/impressão/PDF do relatório | INTEGRADO E VALIDADO | project-dossier-document.ts; investor-dossier-reports.tsx | 28ff2408;4c221e0f | E5/E6 |
| F14 | PN P0035; ME P0144/P0162 | Relatório financeiro | Planeamento opcional de stock/inventário por produto | INTEGRADO E VALIDADO | business-financial-plan.ts; simulation-business-plan.tsx | 04d8db6c (correcção de edição); base anterior | E0: business-financial-plan.test.mjs; não equivale a execução completa do percurso Hotel |
| F15 | PN P0038; ME P0147/P0161 | Relatório financeiro | Produtos/serviços com unidades, preço e custo variável; margem calculada | INTEGRADO E VALIDADO | simulation-business-plan.tsx; business-financial-plan.ts | 04d8db6c;722322f9 | E0/E2 |
| F16 | PN P0050/P0037; ME P0146 | Relatório financeiro | Activos iniciais: separação explícita caixa necessária / outros correntes / longo prazo no modelo geral | IMPLEMENTADO MAS NÃO VALIDADO | integral-financial-plan.tsx; integral-financial-report.ts; simulation-annual-example.tsx | 722322f9;65a52aa3 | Existem saldos iniciais e activos; separação exacta do pedido está no exemplo anual. E2 não demonstra todos estes campos como tal no mesmo modelo geral. |
| F16 | PN P0050/P0037; ME P0146 | Relatório financeiro | Activos iniciais: separação explícita caixa necessária / outros correntes / longo prazo no modelo geral | INTEGRADO E VALIDADO | startup-asset-requirements.ts; startup-asset-requirements.tsx; business-financial-plan.ts; integral-financial-report.ts; integral-financial-plan.tsx | 9f7dd7df | E9: necessidades e disponibilidade separadas; aquisições adoptadas só por acção explícita, com classificação corrente/longo prazo e sem dupla contagem de existências/recebíveis. Caixa disponível não incorpora fontes planeadas. Snapshot 19, CAE, HTTP de recuperação/isolamento, Word/impressão e componentes reais em 1440/390 px demonstrados; fórmulas anteriores preservadas. |
| 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. |
@@ -1184,7 +1184,7 @@ Nomes de ficheiros na coluna de implementação referem-se a `resources/js/lib/`
| F28 | PN P0063–0070/P0103–0107; T008/T009/T010/T014/T015/T016 | Exemplo financeiro | Reconciliação dos três balanços e 36 meses ilustrativos; precisão monetária sem ajustes artificiais | INTEGRADO E VALIDADO | business-plan-guidance.ts; financial-reference-reconciliation.test.mjs | 65a52aa3 | E1: capital 499.834,00 + obrigações 1.641,00 = activos 501.475,00; fonte conserva divergência original 1.642,00 |
| F29 | PN P0009/P0100; ME P0136 | Exemplo financeiro | Identificar dados sintéticos, projecções ilustrativas e separá-los do investimento real | INTEGRADO E VALIDADO | simulation-annual-example.tsx; business-plan-guidance.ts | 65a52aa3;51d31d37 | E1 |
| F30 | PN P0031/P0100 | Exemplo financeiro | Gravar e recuperar as edições do exemplo após recarga | INTEGRADO E VALIDADO | simulation-annual-example.tsx; simulation-business-plan.tsx | 51d31d37;eb6dfa32 | E1: 14.537,25 e 14.537,50 recuperados; 1440 px e 390 × 844 |
| F31 | PN P0041/P0100/P0109–0347; T001–T016 | Exemplo financeiro | Carregar o exemplo completo dos documentos nas onze tabelas do relatório único | IMPLEMENTADO MAS NÃO VALIDADO | annual-example-report.ts; financial-plan-details.tsx; integral-financial-plan.tsx; project-dossier-report.ts | 9c34af04 | Ligação funcional demonstrada: escolha explícita do exemplo, onze tabelas, edição 14.537,25 reflectida na mesma versão e exportações; regresso preserva dados do investidor. E8. Critério literal de exemplo completo mantém-se parcial: relatório do exemplo usa totais anuais e explicita divergências das linhas por serviço/departamento; não reproduz os cinco quadros mensais originais nem inventa a repartição em falta. |
| F31 | PN P0041/P0100/P0109–0347; T001–T016 | Exemplo financeiro | Carregar o exemplo completo dos documentos nas onze tabelas do relatório único | IMPLEMENTADO MAS NÃO VALIDADO | annual-example-original-detail.ts; annual-example-reconciliation.ts; annual-example-report.ts; business-plan-guidance.ts | 9f7dd7df | E9: quatro serviços, cinco linhas de custo e sete departamentos recuperados do original; 36 meses calculados e três anos, com totais e balanços preservados e exportações conferidas. Pessoal de 2025 integralmente explicado pelas sete linhas mensais. Não encerrado: as linhas originais de vendas/custos não somam os totais anuais e faltam quatro remunerações em 2026/2027 e repartições mensais. Diferenças exactas e dados necessários em E9, sem rubricas de ajuste. |
| F32 | PN P0109–0347; T002–T006/T011–T016 | Exemplo financeiro | Reproduzir todas as linhas e textos do modelo, incluindo perfil da indústria e rácios adicionais | NÃO DETERMINADO | business-plan-guidance.ts; financial-ratios-report.ts | 65a52aa3;35c9e4fc | Modelo tem 16 tabelas físicas (11 famílias e 5 desdobramentos mensais). Foram aprovados cinco rácios; restantes linhas do exemplo não são automaticamente requisitos de novos indicadores nem valores a importar. Não existe prova de reprodução literal completa. |
| V01 | PN P0006/P0033/P0072–0075; ME P0134/P0160–0168 | Validação financeira | Unidades, preços, custos e despesas editáveis; vazio/valor inválido/negativo com erro local | INTEGRADO E VALIDADO | business-financial-plan.ts; business-plan-guidance.ts; complementary-report.ts; financial-ratios-report.ts | 04d8db6c;5f7db7cd;65a52aa3;722322f9;4fb9296f;35c9e4fc | E0: business-plan-editing.test.mjs; E1 recuperação |
| V02 | PN P0076/P0094 | Validação financeira | Crescimento acima de 100% permitido com aviso, conforme decisão posterior do proprietário | INTEGRADO E VALIDADO | business-financial-plan.ts; business-plan-guidance.ts; complementary-report.ts; financial-ratios-report.ts | 04d8db6c;5f7db7cd;65a52aa3;722322f9;4fb9296f;35c9e4fc | E0/E1: decisions-regression.log; business-plan-guidance.test.mjs |
@@ -1245,9 +1245,9 @@ Nomes de ficheiros na coluna de implementação referem-se a `resources/js/lib/`
### Resultado e pendências delimitadas
Matriz com **88 linhas de correspondência**, incluindo uma linha de cobertura editorial (P18); não são percentagens de implementação nem contagem de requisitos atómicos. INTEGRADO E VALIDADO: **37**; IMPLEMENTADO MAS NÃO VALIDADO: **30**; NÃO DETERMINADO: **11**; NÃO IMPLEMENTADO: **10**. IMPLEMENTADO NOUTRO RAMO OU REVISÃO: **0 casos demonstrados**.
Matriz com **88 linhas de correspondência**, incluindo uma linha de cobertura editorial (P18); não são percentagens de implementação nem contagem de requisitos atómicos. INTEGRADO E VALIDADO: **38**; IMPLEMENTADO MAS NÃO VALIDADO: **29**; NÃO DETERMINADO: **11**; NÃO IMPLEMENTADO: **10**. IMPLEMENTADO NOUTRO RAMO OU REVISÃO: **0 casos demonstrados**.
O relatório aprovado mantém as onze tabelas e CAE integrados no âmbito aceite. A comparação com o pedido original revela detalhes adicionais ausentes ou não demonstrados: recolha de activos/caixa requerida (F16), reprodução integral do exemplo (F31/F32), conteúdo executivo/opcional e cobertura integral das mensagens/avisos. Crescimento, capital, despesas correntes e dividendos foram entretanto concluídos em 9c34af04, conforme E8. Fora do relatório, permanecem lacunas concretas no selector Turismo, nos valores demográficos por dimensão, na ocultação de informação técnica, no mínimo da pesquisa financeira e na apresentação incorporada de oportunidades; vários percursos transversais têm apenas validação parcial. Não se atribui uma regressão a estes pontos sem comparação que demonstre uma perda.
O relatório aprovado mantém as onze tabelas e CAE integrados no âmbito aceite. A comparação com o pedido original mantém pendentes a reprodução integral do exemplo (F31/F32), conteúdo executivo/opcional e cobertura integral das mensagens/avisos. Crescimento, capital, despesas correntes e dividendos foram concluídos em E8; a distinção de caixa e activos (F16) foi entretanto concluída em E9. Fora do relatório, permanecem lacunas concretas no selector Turismo, nos valores demográficos por dimensão, na ocultação de informação técnica, no mínimo da pesquisa financeira e na apresentação incorporada de oportunidades; vários percursos transversais têm apenas validação parcial. Não se atribui uma regressão a estes pontos sem comparação que demonstre uma perda.
Não foi demonstrado que uma correcção pendente esteja pronta e isolada noutro ramo. A existência de alterações não confirmadas na pasta principal não autoriza considerá-las integradas, validadas ou associá-las a um commit. Não se realizou cherry-pick nem alteração de ramos.
@@ -1277,3 +1277,44 @@ Provas em `outputs/financial-pending-20261120/`: `tests.log`, `check.log`, `chec
**Pendências exactas dentro das linhas abordadas:** F31 — repartição do exemplo por serviços/departamentos e reprodução dos quadros mensais completos não certificados. V08 e V10 ficaram concluídos após a recolha explícita em dias. F16, a distinção entre caixa requerida para arranque e caixa inicial disponível e a discriminação correspondente dos activos no modelo geral, conserva o estado anterior: não se reinterpretou um saldo disponível como reserva requerida, nem se alterou a fórmula de financiamento aprovada. V07/configuração dos limites, os restantes campos/mensagens e todas as áreas fora deste recorte conservam os estados anteriores.
Entrega funcional limitada a QA, **parcial quanto ao conjunto solicitado**, sem encerramento integral dos requisitos dos dois documentos. Sem instalação, publicação ou migrações operacionais; sem novo grupo de trabalho. Etapa 1 e pacotes aprovados preservados. Histórico perdido e HTTP503 de tradução continuam independentes. Próxima tarefa recomendada, não iniciada: fechar o significado e a recolha da caixa/activos do arranque e o critério remanescente F31, com provas delimitadas; não avançar para outras áreas da matriz sem autorização.
### E9 — 20/11/2026: retoma exclusiva de F16 e F31
Referências: auditoria `b2cfa939`, estado documental `41968bc5`; implementação `9f7dd7df`, exclusivamente no ramo QA. **F16 concluído e demonstrado; F31 parcialmente implementado, sem encerramento do critério original.** A actualização funcional da matriz limita-se a estas duas linhas; a referência histórica c34670ef não é apresentada como contendo retroactivamente este código. Nenhuma outra área da matriz foi iniciada.
**Fontes consultadas antes das alterações:** os dois DOCX originais na pasta indicada pelo proprietário, novamente lidos por OOXML e confrontados com os hashes registados nesta auditoria: PN `4f1e1dbc90c8a4888291201898f306c06e2e687843a754a04a9a8a56f459ab99`; ME `12d5efbea9fe2634208decd2261ca7bf8f332c4a5de41b89c549cc64150a909c`. F16 corresponde a PN P0037/P0050 e ME P0146. F31 usa PN T003/T005/T012/T013 para o detalhe, mantendo o cálculo anual e a distribuição ilustrativa aprovados. O exemplar de referência já existente em `tests/frontend/fixtures/financial-reference-2025.txt` tem as mesmas linhas de vendas/custos e não acrescenta os montantes em falta; não se reiniciou investigação de histórico perdido.
**F16 — caixa e activos.** A caixa requerida é uma reserva pretendida após despesas e aquisições; a disponibilidade é o saldo declarado antes de novo financiamento. Activos correntes e de longo prazo têm necessidades e saldos disponíveis separados. As existências e recebíveis já planeados contam uma única vez. A adopção das aquisições exige a acção explícita «Adoptar as aquisições calculadas no cenário», não cria financiamento e não sobrescreve caixa disponível, capital, empréstimos ou subvenções. A retirada do modo permite repor o investimento anterior, identificado no botão. Dados desconhecidos permanecem por preencher, sem conversão automática para zero.
Reutilizou-se o saldo `openingCash`, os activos anteriores e a equação de caixa aprovada. A repartição das novas aquisições entre correntes e longo prazo apenas as classifica correctamente no balanço, preservando o investimento total e a reconciliação. Os requisitos brutos continuam a ser despesas de arranque + caixa requerida + activos requeridos. A diferença original entre usos e fontes mantém a fórmula; a falta para a reserva requerida é apresentada separadamente. Capital, empréstimos, suprimentos e subvenções são rotulados como **planeados**, sem os apresentar como recebidos. Disponibilidade declarada não é certificação bancária nem pagamento realizado.
Ensaio sintético, não dados de um investidor real: caixa disponível 20.000,00; outros activos disponíveis 10.000,00; activos de longo prazo disponíveis 55.000,00. Objectivos: caixa 90.000,00; correntes 150.000,00; longo prazo 260.250,00; despesas de arranque 1.325.000,00. Existências/recebíveis a constituir 15.000,00 já entram no motor existente. Aquisições adicionais: correntes 125.000,00 e longo prazo 205.250,00, total 330.250,00. Requisitos brutos 1.825.250,00. Sem fontes planeadas, a falta para a reserva é 1.740.250,00 e não surge capital fictício. Ao declarar essa contribuição como planeada, a caixa **projectada** após arranque fica em 90.000,00; a caixa **disponível** permanece 20.000,00. Activos projectados 500.250,00 e diferenças do balanço zero nos meses e no ano. Na interface, editar o objectivo para 90.000,25 conserva 20.000,00 disponíveis e mostra 0,25 de falta prevista para a reserva, sem fabricar financiamento.
O formato 19 do mesmo snapshot protege esta nova classificação contra leitores antigos; planos sem necessidades de arranque conservam os formatos 17/18. Não há armazenamento paralelo, tabela ou migração. CAE e demais entradas permanecem no plano. Os documentos Word/impressão incluem requerido/disponível/planeado com os mesmos valores.
**F31 — detalhe recuperado e causa concreta da pendência.** O quadro mensal original tem sete departamentos, embora o anual mostre só três. Recuperaram-se Marketing, Revista Tempo, Gestão de Projectos e Gabinete Jurídico: sete linhas de 25,00 somam 175,00 por mês e 2.100,00 em 2025. Os quatro valores anuais omitidos em 2025 derivam exactamente da soma dos doze meses documentados, sem um pressuposto novo. O original declara uma pessoa; não se presumiram sete trabalhadores. Foram também transcritos os quatro serviços e cinco linhas anuais de custo, conservando Marketing como não documentado nos meses onde o original não o apresenta.
O relatório mantém onze famílias, agora com os **36 meses e os três totais anuais** nas tabelas de vendas, resultados, tesouraria, balanço e pessoal. O ponto de equilíbrio e os rácios conservam os períodos do modelo aprovado. O cálculo aprovado não foi substituído: apenas se expuseram resultados mensais já calculados para o adaptador do relatório. As linhas documentais aparecem identificadas separadamente dos totais calculados; diferenças são diagnóstico, nunca receita, custo ou capital para equilibrar contas. Células não documentadas não se tornam zero. Um aviso explícito acompanha o relatório do exemplo indicando que a reprodução integral do original não está validada.
As duas fontes de detalhe (DOCX e exemplar de referência existente) não permitem fechar as seguintes diferenças. Valores abaixo são total anual aceite menos soma das linhas anuais documentadas; não são lançamentos:
| Ano | Vendas aceites | Vendas documentadas | Diferença de vendas | Custos aceites | Custos documentados | Diferença de custos |
| --- | --- | --- | --- | --- | --- | --- |
| 2025 | 14.537,00 | 10.885,00 | 3.652,00 | 12.538,00 | 10.295,00 | 2.243,00 |
| 2026 | 21.500,00 | 13.250,00 | 8.250,00 | 16.200,00 | 13.300,00 | 2.900,00 |
| 2027 | 23.875,00 | 14.525,00 | 9.350,00 | 18.325,00 | 14.675,00 | 3.650,00 |
Janeiro original: linhas de vendas 510,00 para total 680,00; custos conhecidos 431,00 para subtotal 586,00. A linha anual de custo Marketing tem 1.077,00 em 2025, mas não existe a respectiva distribuição mensal no original. Em 2026/2027, os três departamentos com remuneração anual documentada somam 1.200,00, enquanto a folha aceite é 2.800,00: faltam os quatro valores de Marketing, Revista Tempo, Gestão de Projectos e Gabinete Jurídico, somando 1.600,00 em cada ano. Não é possível determinar essa repartição de forma única sem dados ou um pressuposto adicional autorizado.
**Dados necessários para encerrar F31:** linhas de vendas e de custos corrigidas ou omitidas que expliquem as diferenças anuais acima, com correspondência mensal; distribuição mensal do custo Marketing de 2025; remuneração dos quatro departamentos em 2026 e 2027 e a sua distribuição por meses, ou um critério expressamente aprovado de projecção. Nenhum serviço, salário ou ajustamento foi inventado. Não se escalonaram os valores originais para os forçar a coincidir com os totais. A fórmula e os totais anuais aprovados permanecem intactos, incluindo o balanço de 2025: 501.475,00 = 1.641,00 + 499.834,00.
**Verificação executada:** seis regressões novas em `tests/frontend/startup-example-correspondence.test.mjs`; 23 testes novos/afectados aprovados no conjunto dirigido, incluindo adaptação dos ensaios antigos do exemplo ao novo índice anual depois dos 36 meses e do mock do novo editor. Testados adopção explícita, retorno ao investimento anterior, requerido/disponível, inexistência de financiamento automático, não duplicação de activos, formatos 17/18/19, CAE, saldos mensais/anuais, nomes/valores do original, células ausentes, recuperação e conteúdo Word/impressão. Tipos, lint/formatação dirigidos e compilação QA aprovados. Não se repetiram os 92 testes da Etapa 1 nem uma auditoria geral.
**Persistência e isolamento:** processo QA existente em `127.0.0.3:18720`, com router que recusa base diferente de `continuity_20261120_test:55441`. Um rascunho sintético novo, pelo mecanismo funcional existente, `6fcd9471-50e5-4a99-aadc-c03d8d20a695`, versão 2: criação 201, alteração 200, recarga/leitura 200, snapshot 19 exactamente recuperado e onze tabelas do exemplo exactamente iguais; outra sessão recebe 404. Sem SQL de inserção, credenciais registadas ou reconstrução do histórico perdido. Não é apresentado como nova conferência autenticada privada.
**Conferência visual:** componentes reais, em prévia sintética isolada de 1440×1000 e 390×844, com edição do objectivo de caixa, adopção, diferença entre disponível e projectado, serviço/departamento/mês, deslocação até às colunas anuais e regresso ao plano do investidor sem perda. Capturas inspeccionadas; sem erros JavaScript ou extravasamento da página. O primeiro ensaio da prévia não incluía as classes CSS dos componentes; delimitada a causa no compilador de ensaio e incluídas as fontes CSS existentes, sem alteração de segurança ou do CSS operacional. Word e HTML de impressão gerados pelo mecanismo existente, com testes do conteúdo e valores; não se afirma nova aprovação visual integral da paginação Word/PDF nativo.
Provas: `outputs/f16-f31-20261120/{tests.log,check.log,check-final.log,types-final.log,build-final.log,persistence-http.json,visual.json,source-reconciliation.json,evidence-manifest.json}`; capturas `1440-*`/`390-*`; `f16-report.{json,html,docx}` e `f31-report.{json,html,docx}`. O manifesto identifica hashes e commit dos ficheiros de código e das provas. A transcrição do original pode ser reproduzida pelo script de extracção conservado na pasta de provas anterior; os DOCX originais não foram modificados.
**Estado final deste recorte:** F16 INTEGRADO E VALIDADO em QA; F31 IMPLEMENTADO MAS NÃO VALIDADO integralmente, dependente apenas dos dados/regras de repartição identificados acima. Nenhum outro requisito foi encerrado, e não se iniciou outro grupo. Sem instalação, publicação ou migrações operacionais. Etapa 1 e aprovações anteriores preservadas; histórico perdido e HTTP503 de tradução continuam pendências independentes.