feat(qa): integrate financial ratios with accounting consistency guards

This commit is contained in:
2026-11-20 12:59:39 +02:00
parent a90c8ef2dd
commit 35c9e4fc15
10 changed files with 476 additions and 2 deletions
@@ -10435,3 +10435,9 @@ Sete testes novos, integração HTTP201/200/422/404, tipos/lint/Pint e buildQA a
### Encerramento formal do Pacote 2 — aceitação do proprietário
Pacote 2 da Etapa 2 APROVADO E ENCERRADO EM QA, com referência `4fb9296f`. Análise de Mercado, Marcos, Pessoal, persistência, reconciliação mensal/anual e exportações aprovados. Aceitação baseada nas evidências comunicadas, sem inspecção directa dos ficheiros locais pelo proprietário; nenhuma pendência ou regressão reportada no pacote. Relatório integral de onze tabelas NÃO APTO; Pacote 3 NÃO INICIADO; instalação e publicação NÃO AUTORIZADAS. Preservados os encerramentos da Etapa 1 e do Pacote 1. Actualizadas somente documentação e matriz existentes; sem alterações funcionais, testes ou início de outro pacote.
### Pacote3 — Rácios financeiros implementados em QA
Base `a90c8ef2`: cinco rácios mensais/anuais integrados como11.ªtabela, usando os mesmos saldos/resultados aprovados. Fórmulas anteriores preservadas; apresentação arredonda apenas no fim. Classificação corrente opcional por mês no snapshot existente, sem presumir vencimentos. Balanços inconsistentes bloqueiam liquidez/endividamento/retorno; dados em falta e denominadores zero permanecem por determinar. Anos parciais não são anualizados; crescimento150% não bloqueia. Sem alterações financeiras dos pacotes aceites.
Seis testes novos e um teste de integração afectado aprovados; tipos/lint/buildQA aprovados. UI1440×1000/390×844, edição/gravação/recuperação1180,25 e bloqueio da liquidez por falta de classificação demonstrados. Word e impressão com2páginas cada conferidos integralmente. Provas e hashes em `outputs/controlled-5f7db7cd-20261120/package3/acceptance.json`; matriz individual no aditamento existente. Resultado técnico APTO em QA, por aceitar pelo proprietário. Relatório integral NÃO APTO até consolidação/CAE; Pacotes4e5 não iniciados nesta execução. Sem instalação/publicação/migrações; encerramentos anteriores preservados.
@@ -862,3 +862,40 @@ Pendências concretas do Pacote2: nenhuma identificada nos critérios acima; ace
| Instalação e publicação | NÃO AUTORIZADAS |
Este registo substitui o estado técnico «por aceitar» pela aceitação expressa, preservando o histórico e as provas. Etapa 1 e Pacote 1 continuam aprovados e encerrados. A consolidação final e a classificação CAE permanecem pendentes; histórico QA perdido e tradução HTTP 503 mantêm-se independentes. Execução exclusivamente documental, sem código funcional, repetição de testes ou início de outros pacotes. A prioridade recomendada para Rácios não autoriza o seu início nesta execução.
### Pacote 3 — Rácios financeiros em QA
Base: encerramento do Pacote2 `a90c8ef2`. Pedido posterior do proprietário para completar a tabela de rácios. **Resultado técnico: APTO em QA, por aceitar pelo proprietário.** As onze tabelas estão agora integradas no modelo de relatório; o relatório integral continua NÃO APTO até à conferência consolidada e ao trabalho CAE. Esta execução não iniciou os Pacotes4ou5.
As cinco fórmulas previamente existentes em `business-plan-guidance.ts` foram respeitadas e permanecem inalteradas. A nova apresentação reutiliza os valores exactos das sete tabelas financeiras aprovadas, com divisão em inteiros/centavos e arredondamento apenas na apresentação final. Não altera receitas, impostos, resultados, balanços ou classificações anteriores.
| Indicador | Fórmula / unidade | Dependência e estado indeterminado | Prova sintética |
| --- | --- | --- | --- |
| Crescimento das vendas | Vendas/vendas anteriores−1; percentagem | Vendas válidas e períodos com igual duração; primeiro período e base anterior zero ficam por determinar | Meses constantes0,00%; cenário de dois anos completos com crescimento150,00% permitido; ano parcial não comparado ao ano completo |
| Liquidez corrente | Activo corrente/passivo corrente; múltiplo | Balanço reconciliado, classificação declarada válida dentro dos totais e passivo corrente não nulo | Janeiro118,00×; ano2027:35,50×; classificação em falta num mês bloqueia apenas essa liquidez |
| Endividamento | Total do passivo/total do activo; percentagem | Balanço reconciliado e activo positivo | Janeiro0,56%; ano2027:2,53% |
| Margem líquida | Lucro líquido/vendas; percentagem | Resultados e vendas determinados; vendas não nulas | Mensal e anual26,00%; não é soma das percentagens mensais |
| Retorno do capital | Lucro líquido/capital e resultados de fecho; percentagem | Balanço reconciliado, resultado determinado e capital não nulo; capital negativo explicitamente sinalizado | Janeiro14,77%; ano2027:67,53%; ano parcial5,33%, sem anualização |
A classificação corrente não estava documentada nos saldos existentes. Foi acrescentada recolha opcional dos dois totais por mês, exclusivamente para liquidez, em `ratioCurrentBalances` do `business_plan_snapshot` cifrado já existente. Não se inventam vencimentos nem se classificam automaticamente empréstimos, subvenções ou outros activos. A classificação não cria movimentos nem altera o balanço; pode ser completada mês a mês, conservando valores guardados fora do horizonte actualmente visível. Estruturas desconhecidas permanecem preservadas. Não há tabela de base de dados, armazenamento paralelo, migração, permissão ou serviço novo.
Bloqueios demonstrados: diferença de balanço0,01, rubricas/saldos indeterminados ou inconsistências sinalizadas no balanço suspendem liquidez, endividamento e retorno do capital. Um resultado indeterminado suspende margem e retorno. Indicadores independentes de uma falha conservam-se quando os seus próprios dados são válidos. Denominador zero nunca se converte em rácio zero. Os avisos são agrupados por causa/períodos, sem repetir a mesma instrução em cada linha. Financiamento insuficiente e crescimento superior a100% continuam não bloqueantes; não foram alteradas as regras aprovadas.
**Verificação:** seis testes novos em `financial-ratios-report.test.mjs`, todos aprovados: equivalência das fórmulas, agregação anual, crescimento150%, períodos parciais, balanço incoerente, dados em falta, denominadores zero, classificação inválida/malformada, classificação parcial, preservação dos inputs e persistência/exportações. Executado somente o teste de integração afectado do Pacote2, actualizado de10para11tabelas, aprovado. Tipos, lint/formatação e buildQA finais aprovados. Não repetidas as baterias da Etapa1 ou do Pacote1, nem os restantes testes do Pacote2. Avisos preexistentes de fonte opcional e chunks mantidos; build com código0.
Conferência funcional via Playwright/Chromium já instalados no QA `http://127.0.0.3:18720/simulador-fiscal`: em1440×1000 e390×844, criação201, edição/gravação200 e recuperação real da classificação1180,25, tanto no pedido/API como no campo após recarregamento. A divisão desta classificação por10,00 é apresentada como118,03×; nenhuma rubrica do balanço foi alterada. Apagar a classificação apresenta «Por determinar» na liquidez. Sem erros JavaScript ou transbordo da página; colunas anuais acessíveis por deslocamento interno. O painel de ajuda reaberto após recarregar foi fechado pelo controlo normal antes de continuar; sem cliques forçados, contorno de segurança ou alteração da interface.
| Prova visual | Estado | Artefacto em `outputs/controlled-5f7db7cd-20261120/package3/` |
| --- | --- | --- |
| Computador1440×1000, primeiros meses e anos | APROVADO | `1440-left.png`, `1440-right.png` |
| Telemóvel390×844, tabela, cabeçalhos e notas ao deslocar | APROVADO | `390-left.png`, `390-right.png`, `mobile-viewport-{left,right,notes}.png` |
| Word página1 | APROVADO: identificação sintética, fórmulas e primeiros meses | `word-1.png` |
| Word página2 | APROVADO: continuação Maio–Dezembro, ano completo e parcial | `word-2.png` |
| Impressão página1 | APROVADO: pressupostos e início da tabela | `print-1.png` |
| Impressão página2 | APROVADO: continuações e rácios anuais | `print-2.png` |
Word aberto na aplicação nativa e convertido localmente para PDF; impressão pelo mecanismo HTML existente. As duas páginas de cada exportação foram rasterizadas com Poppler e examinadas, sem cortes de conteúdo ou sobreposições. Os artefactos são um recorte explícito da tabela de rácios para QA, não a validação consolidada do Pacote4. Todas as células do DOCX estão presentes no PDF Word. [Recibo e hashes](../../../../outputs/controlled-5f7db7cd-20261120/package3/acceptance.json), [Word](../../../../outputs/controlled-5f7db7cd-20261120/package3/report.docx), [PDF Word](../../../../outputs/controlled-5f7db7cd-20261120/package3/report.pdf), [PDF de impressão](../../../../outputs/controlled-5f7db7cd-20261120/package3/report-print.pdf).
Ficheiros: novos `financial-ratios-report.ts`, `financial-ratios-plan.tsx` e teste específico; extensão apenas de tipo no plano, ligação no componente financeiro e na secção financeira do dossier; uma expectativa do teste de integração passou a11tabelas. Documentação/manual/matriz existentes actualizados. Nenhuma alteração às cinco fórmulas anteriores, ao motor financeiro ou às sete demonstrações aprovadas.
Pendências do Pacote3: nenhuma identificada nos critérios acima; aceitação formal pelo proprietário pendente. Conferência consolidada e CAE continuam por executar. Etapa1/Pacotes1e2 encerrados preservados; histórico QA perdido e tradução503 independentes. Sem instalação, publicação ou migrações operacionais. Próxima tarefa recomendada: aceitar o Pacote3 e decidir a conferência consolidada, sem a iniciar nesta execução.
File diff suppressed because one or more lines are too long