fix(qa): reconcile report summary and separate Word period tables

This commit is contained in:
2026-11-20 12:14:08 +02:00
parent d367e18eec
commit 722322f9f6
6 changed files with 157 additions and 4 deletions
@@ -10413,3 +10413,7 @@ Relatório integral de onze tabelas NÃO APTO. Histórico perdido do QA anterior
Autorização posterior permite implementar a Etapa2 em QA. A execução actual ficou limitada pelo proprietário à preservação e revisão do Pacote1. Guardado em `64f282c3`, expressamente sem aceitação funcional. Sete tabelas integradas ao plano e ao dossier, com dados complementares no snapshot existente e exportação Word/impressão. Sem alteração das fórmulas da Etapa1, permissões, schema ou migrações.
Revisão corrigiu no delta a reclassificação indevida de caixa negativa como dívida e o excesso de colunas na impressão. Dois testes novos e um teste de exportação afectado aprovados; tipos/lint/build QA finais aprovados. Reutilizadas as provas anteriores19/4, sem repetir92testes da Etapa1. Matriz individual, valores, causas e recibos no aditamento `apresentacao-contexto-qa-20261115.md`. Pacote1 NÃO APTO para aceitação enquanto faltarem conferência funcional/visual em computador/móvel e apresentação das exportações finais. Pacote2 não iniciado. Etapa1 continua APROVADA E ENCERRADA; histórico perdido e tradução503 independentes. Sem instalação ou publicação; não se contorna a interrupção de segurança do navegador.
### 20/11/2026 — conferência adicional do Pacote1
HTTP confirmou edição e recuperação exacta do snapshot e das sete tabelas, com isolamento404 noutra sessão. Corrigidos resumo financeiro divergente e fusão de tabelas Word que repetia meses incorrectos. Dois testes afectados aprovados; tipos/lint/buildQA aprovados. Word/PDF sintéticos gerados; PDF11páginas conserva todas as células, mas conferência visual integral final ainda não verificada. Cabeçalho corrigido confirmado no Word nativo. Sem nova tentativa de navegador nas mesmas condições indisponíveis. Matriz individual e recibos no aditamento de `apresentacao-contexto-qa-20261115.md`. Pacote1 NÃO APTO para aceitação final até conferir documentos finais e interface em computador/móvel. Etapa1 encerrada preservada; Pacote2 não iniciado; sem instalação/publicação.
@@ -720,3 +720,30 @@ Evidência anterior reutilizada:19testes afectados aprovados na primeira impleme
Provas existentes/finais em `outputs/controlled-5f7db7cd-20261120/`: `package1-tests.log`, `package1-build.log`, `package1-review-tests.log`, `package1-review-export.log`, `package1-review-types.log` e `package1-review-build.log`. Os artefactos sintéticos Word/HTML anteriores demonstram geração, não aceitação de paginação final; precisam de ser regenerados antes da conferência visual do fraccionamento corrigido. Nenhum documento ou dado real foi sobrescrito.
**Classificação provisória do Pacote1: NÃO APTO para aceitação funcional.** Pendências concretas: conferência das sete tabelas, edição/recuperação do novo conjunto em computador e móvel, e apresentação das exportações finais. A ocorrência anterior de segurança do navegador (`could not determine the current browser URL on Windows with enough confidence to enforce policy`) foi respeitada, sem contorno. A eventual tentativa seguinte exige sessão funcional e URL verificável. Sem Pacote2, instalação, publicação ou migrações operacionais.
### 20/11/2026 — aceitação final do Pacote 1: evidências adicionais
Referências preservadas: `64f282c3`, `febb5b0b`, `d367e18e`. Esta entrega não encerra o Pacote1: **NÃO APTO para aceitação final**. Etapa1 preservada e encerrada; Pacote2 não iniciado.
| Critério | Estado e evidência |
| --- | --- |
| Start-up | APROVADO na integração: despesas e investimento preservados |
| Previsão de Vendas | APROVADO na integração: meses e anos recuperados exactamente |
| Financiamento | APROVADO na integração: necessidade100,00 não bloqueante |
| Ponto de Equilíbrio | APROVADO na integração; fórmula aprovada preservada |
| Lucros e Perdas | APROVADO na integração: resultados mensais/anuais preservados |
| Fluxo de Caixa | APROVADO na integração: saldos e pagamentos preservados |
| Balanço Projectado | APROVADO na integração: recuperação exacta sem novos ajustamentos |
| Persistência após recarregamento | APROVADA por HTTP: criação201, edição200, página200, recuperação200, versão2; snapshot e sete tabelas iguais; outra sessão404 |
| Word | Gerado e conferido parcialmente na aplicação nativa; correcção de cabeçalhos confirmada; conferência integral da revisão final NÃO VERIFICADA |
| PDF | Gerado pelo Word,11páginas; todas as células do DOCX presentes no texto; conferência visual integral NÃO VERIFICADA |
| Interface em computador | Conferência final NÃO VERIFICADA |
| Interface móvel | Conferência final NÃO VERIFICADA |
Cenário exclusivamente sintético de teste,13meses, fixture existente. Prova HTTP altera arranque100,00 para100,25 e confirma recuperação integral. Artefactos documentais usam a fixture100,00; não representam dados reais nem recuperação do histórico. Recibos em `outputs/controlled-5f7db7cd-20261120/package1-acceptance-http.json` e `package1-export-receipt.json`; exportações `package1-report.docx`, `package1-report.pdf` e HTML no mesmo directório.
Dois erros concretos corrigidos sem alterar o motor financeiro: (1) resumo antigo ignorava arranque e impostos declarados nas sete tabelas. Antes/depois: caixa4.900,00→4.540,00; pagamentos9.100,00→9.360,00; necessidade0,00→100,00; resultado antes de impostos3.770,00 conservado e líquido3.380,00 explicitado. Agora deriva das mesmas células mensais, com precisão em centavos e desconhecidos explícitos. (2) Word fundia tabelas consecutivas e repetia cabeçalhos dos primeiros meses em páginas seguintes. Parágrafos separadores conservam a identidade de cada bloco; cabeçalhoMaio–Agosto confirmado directamente após regeneração. Títulos/notas mantêm ligação ao conteúdo seguinte. Documentos anteriores guardados separadamente para comparação.
Verificações novas/afectadas: dois testes focados aprovados (resumo e Word), lint/formatação dos três ficheiros aprovados, TypeScript aprovado, buildQA aprovado com avisos preexistentes de fonte opcional e chunks. Não repetidos92testes da Etapa1. Tentativa com ESLint genérico não correspondia ao projecto; utilizada depois a ferramenta existente Vite+. Nenhuma dependência do repositório alterada.
Limitação instrumental: inventário de navegador sem sessão disponível, erro `The browser access host is unavailable`; condições anteriores não mudaram, portanto não foi repetido controlo do Edge. Word nativo disponível e utilizado independentemente. Renderização PDF local impedida por ausência de Poppler e política que impede executar o script Windows.Data.Pdf; política preservada, sem contorno nem instalação. A presença de texto no PDF não comprova ausência visual de cortes. Pendências exactas: inspecção visual integral dos documentos finais e interface final em computador/móvel. Não foi identificada falha funcional da aplicação pela indisponibilidade instrumental. Sem instalação, publicação, migrações ou avanço para Pacote2.
File diff suppressed because one or more lines are too long
+9 -2
View File
@@ -456,12 +456,19 @@ export async function generateProjectDossierDocx(
new Paragraph({
text: entry.title,
heading: HeadingLevel.HEADING_2,
keepNext: true,
}),
);
for (const note of [...entry.issues, ...entry.notes])
children.push(new Paragraph(note));
for (const slice of investmentReportTableSlices(entry))
children.push(new Paragraph({ text: note, keepNext: true }));
for (const slice of investmentReportTableSlices(entry)) {
// Word merges adjacent tables and then repeats the first
// table's period header on subsequent pages.
children.push(
new Paragraph({ spacing: { before: 0, after: 0 } }),
);
children.push(tableForDocx(slice.headers, slice.rows));
}
}
if (!section.rows.length && !section.paragraphs.length)
children.push(
+85 -1
View File
@@ -1,6 +1,8 @@
import { displayValue } from './display-value.ts';
import {
buildIntegralFinancialTables,
displayReportMoney,
reportMoney,
type InvestmentReportTable,
} from './integral-financial-report.ts';
import { restoreBusinessPlanSnapshot } from './business-financial-plan.ts';
@@ -521,8 +523,90 @@ function makeSections(
const financialPlan = restoreBusinessPlanSnapshot(
text(draft, 'business_plan_snapshot'),
);
if (finance && financialPlan?.reportAssumptions)
if (finance && financialPlan?.reportAssumptions) {
finance.tables = buildIntegralFinancialTables(financialPlan);
const periods = financialPlan.periods ?? 12;
const cell = (id: string, label: string) =>
finance.tables
?.find((table) => table.id === id)
?.rows.find((row) => row[0] === label);
const sumRows = (id: string, labels: string[]) => {
let total = 0n;
for (const label of labels) {
const values = cell(id, label)?.slice(1, periods + 1);
if (
!values ||
values.length !== periods ||
values.some((value) => !/^-?\d+\.\d{2}$/.test(value))
)
return null;
total += values.reduce(
(sum, value) => sum + BigInt(value.replace('.', '')),
0n,
);
}
return reportMoney(total);
};
const gap = cell('funding', 'Diferença por financiar')?.[1];
const values: Record<string, string | undefined | null> = {
'Caixa final projectada': cell('cashflow', 'Caixa final')?.[
periods
],
'Pagamentos no horizonte': sumRows('cashflow', [
'Pagamentos de compras',
'Pagamentos operacionais',
'Pagamentos de pessoal',
'Juros pagos',
'Capital reembolsado',
'Pagamento de obrigações iniciais',
'Pagamento fiscal estimado',
]),
'Resultado antes de impostos': sumRows('profit-loss', [
'Lucro líquido',
'Imposto estimado',
]),
'Diferença entre usos e fontes': gap,
};
for (const row of finance.rows) {
if (row.field in values) {
const value = values[row.field];
row.value = value
? `${displayReportMoney(value)} ${financialPlan.currency}`
: 'Por determinar — complete os dados complementares do relatório';
row.origin =
'Mesmas tabelas financeiras do relatório, incluindo complementos declarados';
row.classification =
'Projecção calculada; não é valor realizado';
} else if (row.field === 'Reconciliação do financiamento') {
row.value =
!gap || !/^-?\d+\.\d{2}$/.test(gap)
? 'Informação insuficiente'
: formatDossierReportValue(
row.field,
Number(gap) > 0
? 'shortfall'
: Number(gap) < 0
? 'surplus'
: 'balanced',
);
} else if (
row.field === 'Fórmula e valores substituídos' &&
row.origin.includes('Métodos do plano financeiro')
) {
row.value =
'Facturação: quantidade × preço por produto. Caixa final: caixa de abertura após fontes, usos e arranque + recebimentos − pagamentos, incluindo pagamentos fiscais estimados. Os totais usam os mesmos meses e pressupostos das tabelas abaixo.';
}
}
const net = sumRows('profit-loss', ['Lucro líquido']);
finance.rows.push({
field: 'Resultado líquido no horizonte',
value: net
? `${displayReportMoney(net)} ${financialPlan.currency}`
: 'Por determinar',
origin: 'Soma dos mesmos resultados mensais da tabela Lucros e Perdas; arranque reconhecido na abertura',
classification: 'Projecção calculada; não é valor realizado',
});
}
if (
finance &&
['fiscal_rule_qa_preview', 'fiscal_rule_published'].includes(
@@ -21,6 +21,36 @@ import {
restoreSimulationDraft,
} from '../../resources/js/lib/simulation-form.ts';
void test('acceptance regression: summary uses the same cash, tax payments and startup funding gap as its seven tables', () => {
const input = plan(13);
const make = () =>
createProjectDossierReport(
{
project_title: 'QA',
business_plan_snapshot: serializeBusinessPlanSnapshot(input),
},
{ selectedSections: new Set(['finance']) },
).sections[0];
const finance = make();
const value = (field) =>
finance.rows.find((row) => row.field === field)?.value;
assert.equal(value('Caixa final projectada'), '4 540,00 MZN');
assert.equal(value('Pagamentos no horizonte'), '9 360,00 MZN');
assert.equal(value('Resultado antes de impostos'), '3 770,00 MZN');
assert.equal(value('Resultado líquido no horizonte'), '3 380,00 MZN');
assert.equal(value('Diferença entre usos e fontes'), '100,00 MZN');
assert.match(
value('Reconciliação do financiamento'),
/insuficiente.*não bloqueante/,
);
assert.equal(get(finance.tables, 'cashflow', 'Caixa final')[13], '4540.00');
input.reportAssumptions.taxExpenseByMonth[0] = '';
assert.match(
make().rows.find((row) => row.field === 'Caixa final projectada').value,
/Por determinar/,
);
});
void test('review regression: cash deficit does not create an undeclared loan or inflate projected liabilities', () => {
const input = plan(12);
input.reportAssumptions.startupExpenses[0].amount = '10000';
@@ -221,5 +251,6 @@ void test('dossier print and Word exports include the same seven statements, esc
const xml = await zip.file('word/document.xml').async('string');
assert.match(xml, /Balanço Projectado/);
assert.match(xml, /Lucros e Perdas/);
assert.doesNotMatch(xml, /<\/w:tbl>\s*<w:tbl>/);
assert.match(xml, /7 620,00|7620,00|4 540,00|4540,00/);
});