fix(qa): review package one deficits and print layout pending acceptance

This commit is contained in:
2026-11-20 11:53:16 +02:00
parent 64f282c341
commit febb5b0b94
6 changed files with 116 additions and 31 deletions
@@ -10407,3 +10407,9 @@ Sobre código51d31d37, duas abordagens: host de navegador indisponível; alterna
Aceitação expressa baseada nas evidências do commit documental `eb6dfa32`. Cálculos, reconciliação, balanços, precisão monetária, identificação sintética, persistência/recuperação e conferência visual em computador e emulação390×844 APROVADOS. Substitui o estado anterior de proposta de encerramento, sem repetir verificações. Aceitação expressa baseada nas evidências do commit documental `eb6dfa32`. Cálculos, reconciliação, balanços, precisão monetária, identificação sintética, persistência/recuperação e conferência visual em computador e emulação390×844 APROVADOS. Substitui o estado anterior de proposta de encerramento, sem repetir verificações.
Relatório integral de onze tabelas NÃO APTO. Histórico perdido do QA anterior: pendência independente, não recuperado. HTTP503 de tradução: incidente independente, sem reabrir a Etapa1 enquanto não afectar os critérios financeiros aprovados. Etapa2 NÃO AUTORIZADA. Instalação e publicação NÃO AUTORIZADAS. Actualizados apenas documentação e matriz existentes; sem código funcional, testes, preparação da Etapa2 ou novo desenvolvimento. Relatório integral de onze tabelas NÃO APTO. Histórico perdido do QA anterior: pendência independente, não recuperado. HTTP503 de tradução: incidente independente, sem reabrir a Etapa1 enquanto não afectar os critérios financeiros aprovados. Etapa2 NÃO AUTORIZADA. Instalação e publicação NÃO AUTORIZADAS. Actualizados apenas documentação e matriz existentes; sem código funcional, testes, preparação da Etapa2 ou novo desenvolvimento.
### 20/11/2026 — nova autorização QA da Etapa2 e preservação do Pacote1
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.
@@ -691,3 +691,32 @@ O proprietário aceitou expressamente as evidências do commit documental `eb6df
| Instalação e publicação | **NÃO AUTORIZADAS** | | Instalação e publicação | **NÃO AUTORIZADAS** |
Recuperação de vendas14.537,25 no computador e14.537,50 na emulação móvel aceite como prova funcional. O encerramento limita-se ao cenário financeiro da Etapa1, sem aceitação das onze tabelas nem recuperação presumida do histórico. Execução exclusivamente documental: sem alteração funcional, repetição de testes, preparação da Etapa2 ou novos desenvolvimentos. Recuperação de vendas14.537,25 no computador e14.537,50 na emulação móvel aceite como prova funcional. O encerramento limita-se ao cenário financeiro da Etapa1, sem aceitação das onze tabelas nem recuperação presumida do histórico. Execução exclusivamente documental: sem alteração funcional, repetição de testes, preparação da Etapa2 ou novos desenvolvimentos.
### Etapa 2, Pacote 1 — preservação e revisão, ainda por aceitar
Autorização posterior do proprietário: implementação da Etapa2 exclusivamente em QA, por pacotes sequenciais. A instrução mais recente limita esta execução à preservação, revisão e verificações do Pacote1; não autoriza avançar automaticamente ao Pacote2. A Etapa1 permanece APROVADA E ENCERRADA; histórico perdido e tradução503 mantêm-se independentes.
**Commit de preservação: `64f282c3`**, ramo `qa/continuidade-investimento-20261120`, mensagem expressa `wip(qa): preserve package one pending functional acceptance`. Foram conferidos o diff e o âmbito: onze ficheiros de implementação/teste ligados às sete tabelas, sem rotas, permissões, tabelas de base de dados, migrações, configuração operacional ou fórmulas da Etapa1 alteradas. O motor financeiro existente recebeu apenas o tipo opcional dos dados complementares.
| Tabela | Implementação e integridade verificadas | Estado de aceitação |
| --- | --- | --- |
| Start-up / arranque | Despesas declaradas, activos, fundo de maneio e usos iniciais; sem preenchimento económico automático | Implementada, por aceitar visualmente |
| Previsão de Vendas | Agendas/produtos existentes, valores por mês, soma por ano; anos parciais identificados | Implementada, por aceitar visualmente |
| Financiamento | Fontes existentes, usos com arranque, diferença e caixa de abertura; fontes continuam pressupostos | Implementada, por aceitar visualmente |
| Ponto de Equilíbrio | Contribuição ponderada sem arredondamento intermédio; despesas fixas, pessoal e depreciação explícitos | Implementada, por aceitar visualmente |
| Lucros e Perdas | Vendas, outras receitas classificadas, custos, pessoal, depreciação, juros e imposto estimado declarado | Implementada, por aceitar visualmente |
| Fluxo de Caixa | Recebimentos/pagamentos existentes, imposto previsto separado, saldos e fluxos mensais/anuais | Implementada, por aceitar visualmente |
| Balanço Projectado | Saldos derivados das mesmas agendas; abertura, stock insuficiente e períodos não reconciliados ficam explícitos | Implementada, por aceitar visualmente |
Persistência: `reportAssumptions` integra o `business_plan_snapshot` existente; sem armazenamento paralelo. Prova automatizada existente faz serialização, partição económica, recuperação e igualdade integral das sete tabelas; verifica também ausência de alteração da previsão anterior. A demonstração sintética da Etapa1 não alimenta as tabelas do investimento. O limite existente de60KB e os controlos do rascunho não foram alterados. Não foi repetido o HTTP de persistência já aceite nem alegado novo ensaio de base nesta revisão.
Revisão final encontrou e corrigiu somente dois erros concretos do delta, depois de preservar o original:
1. Caixa negativa era reclassificada como aumento do passivo, sem empréstimo declarado. Passa a conservar o défice projectado na posição de caixa, sem criar dívida ou fonte. Prova nova: caixa−8.720,00, passivo10,00 de imposto reconhecido e não pago, empréstimos0,00 e diferença0,00. A necessidade de tesouraria continua visível; não é tratada como financiamento confirmado.
2. O HTML de impressão incluía até60meses numa única tabela. Impressão e Word passam a usar o mesmo fraccionamento de colunas: rubrica repetida e no máximo quatro períodos por tabela, sem eliminar meses nem totais anuais. A prova de60meses/cincoanos confirma a conservação dos cabeçalhos e o limite de cinco colunas.
Evidência anterior reutilizada:19testes afectados aprovados na primeira implementação; quatro testes específicos aprovados após os ajustes anteriores. Nesta revisão foram executados apenas **dois testes novos de regressão** e **um teste de exportação afectado** pela correcção do fraccionamento, todos aprovados. Tipos TypeScript, lint dos três ficheiros corrigidos e compilação QA finais aprovados. Não se repetiram os92testes financeiros aprovados da Etapa1. O aviso opcional `fontaine` e os avisos de dimensão dos chunks permanecem; a compilação termina com êxito. O `NativeCommandError` do PowerShell no log antigo acompanha o aviso escrito em stderr e não é uma falha de compilação.
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.
File diff suppressed because one or more lines are too long
+25 -3
View File
@@ -12,6 +12,29 @@ export type InvestmentReportTable = {
notes: string[]; notes: string[];
issues: string[]; issues: string[];
}; };
/** Shared print/Word layout: repeat the rubric beside at most four periods. */
export function investmentReportTableSlices(table: InvestmentReportTable) {
return Array.from(
{ length: Math.ceil((table.headers.length - 1) / 4) },
(_, chunk) => {
const start = 1 + chunk * 4;
const indices = [
0,
...Array.from(
{ length: Math.min(4, table.headers.length - start) },
(_, i) => start + i,
),
];
return {
headers: indices.map((i) => table.headers[i]),
rows: table.rows.map((row) =>
indices.map((i) => displayReportMoney(row[i] ?? '')),
),
};
},
);
}
const cents = (value: string): bigint => { const cents = (value: string): bigint => {
if (!/^-?\d+(?:\.\d{1,2})?$/.test(value)) if (!/^-?\d+(?:\.\d{1,2})?$/.test(value))
throw new Error( throw new Error(
@@ -383,7 +406,7 @@ export function buildIntegralFinancialTables(
`Mês ${i + 1}: depreciação superior aos activos ou reembolso superior à dívida; confira os dados.`, `Mês ${i + 1}: depreciação superior aos activos ou reembolso superior à dívida; confira os dados.`,
); );
const assets = const assets =
positive(cash) + cash +
positive(receivables) + positive(receivables) +
(inventory ?? 0n) + (inventory ?? 0n) +
fixed - fixed -
@@ -392,7 +415,6 @@ export function buildIntegralFinancialTables(
positive(-obligations) + positive(-obligations) +
positive(-taxDue); positive(-taxDue);
const liabilities = const liabilities =
positive(-cash) +
positive(-receivables) + positive(-receivables) +
positive(obligations) + positive(obligations) +
positive(taxDue) + positive(taxDue) +
@@ -535,7 +557,7 @@ export function buildIntegralFinancialTables(
'Existem períodos não reconciliados; reveja as rubricas indicadas.', 'Existem períodos não reconciliados; reveja as rubricas indicadas.',
); );
table('balance').notes.push( table('balance').notes.push(
'Caixa negativa é necessidade de tesouraria no passivo; recebíveis negativos são adiantamentos de clientes; obrigações negativas são adiantamentos a fornecedores. Não são fontes mobilizadas.', 'Caixa negativa conserva-se como défice projectado de tesouraria; não cria dívida, crédito aprovado ou financiamento mobilizado. Recebíveis negativos são adiantamentos de clientes; obrigações negativas são adiantamentos a fornecedores.',
'Capital inicial e activos anteriores são declarados. Depreciação e reembolsos provêm do motor existente. Subvenções: ' + 'Capital inicial e activos anteriores são declarados. Depreciação e reembolsos provêm do motor existente. Subvenções: ' +
(a.grantsTreatment || 'sem montante declarado') + (a.grantsTreatment || 'sem montante declarado') +
'.', '.',
+5 -27
View File
@@ -17,7 +17,7 @@ import {
WidthType, WidthType,
} from 'docx'; } from 'docx';
import JSZip from 'jszip'; import JSZip from 'jszip';
import { displayReportMoney } from './integral-financial-report.ts'; import { investmentReportTableSlices } from './integral-financial-report.ts';
import { import {
classifyDossierAttachment, classifyDossierAttachment,
MAX_EMBEDDED_TEXT_BYTES, MAX_EMBEDDED_TEXT_BYTES,
@@ -460,26 +460,8 @@ export async function generateProjectDossierDocx(
); );
for (const note of [...entry.issues, ...entry.notes]) for (const note of [...entry.issues, ...entry.notes])
children.push(new Paragraph(note)); children.push(new Paragraph(note));
// Repeat the rubric with at most four periods per page-width table. for (const slice of investmentReportTableSlices(entry))
for (let start = 1; start < entry.headers.length; start += 4) { children.push(tableForDocx(slice.headers, slice.rows));
const indices = [
0,
...Array.from(
{ length: Math.min(4, entry.headers.length - start) },
(_, i) => start + i,
),
];
children.push(
tableForDocx(
indices.map((i) => entry.headers[i]),
entry.rows.map((row) =>
indices.map((i) =>
displayReportMoney(row[i] ?? ''),
),
),
),
);
}
} }
if (!section.rows.length && !section.paragraphs.length) if (!section.rows.length && !section.paragraphs.length)
children.push( children.push(
@@ -644,12 +626,8 @@ export async function createProjectDossierPrintHtml(
content.push(`<h3>${escapeHtml(entry.title)}</h3>`); content.push(`<h3>${escapeHtml(entry.title)}</h3>`);
for (const note of [...entry.issues, ...entry.notes]) for (const note of [...entry.issues, ...entry.notes])
content.push(`<p>${escapeHtml(note)}</p>`); content.push(`<p>${escapeHtml(note)}</p>`);
content.push( for (const slice of investmentReportTableSlices(entry))
`<div style="overflow-x:auto">${htmlTable( content.push(htmlTable(slice.headers, slice.rows));
entry.headers,
entry.rows.map((row) => row.map(displayReportMoney)),
)}</div>`,
);
} }
if (section.rows.length) if (section.rows.length)
content.push( content.push(
@@ -21,6 +21,56 @@ import {
restoreSimulationDraft, restoreSimulationDraft,
} from '../../resources/js/lib/simulation-form.ts'; } from '../../resources/js/lib/simulation-form.ts';
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';
const tables = buildIntegralFinancialTables(input);
assert.equal(get(tables, 'cashflow', 'Caixa inicial')[1], '-9000.00');
assert.equal(get(tables, 'balance', 'Caixa líquida')[1], '-8720.00');
assert.equal(
get(tables, 'balance', 'Total do passivo')[1],
'10.00',
'only the declared accrued tax, without a fabricated overdraft',
);
assert.equal(
get(tables, 'balance', 'Empréstimos e suprimentos por reembolsar')[1],
'0.00',
);
assert.equal(get(tables, 'balance', 'Total do activo')[1], '-8130.00');
assert.equal(get(tables, 'balance', 'Diferença do balanço')[1], '0.00');
assert.match(
tables.find((table) => table.id === 'balance').notes.join(' '),
/não cria dívida/,
);
});
void test('review regression: print export repeats rubrics in readable slices without losing any of sixty months or five annual periods', async () => {
const input = plan(60);
const report = createProjectDossierReport(
{
project_title: 'QA 60 meses',
business_plan_snapshot: serializeBusinessPlanSnapshot(input),
},
{
selectedSections: new Set(['finance']),
generatedAt: '2026-11-20T12:00:00Z',
},
);
const html = await createProjectDossierPrintHtml(report, []);
const heads = [...html.matchAll(/<thead>([\s\S]*?)<\/thead>/g)];
assert.ok(heads.length > 7);
for (const [, head] of heads)
assert.ok(
(head.match(/<th>/g) ?? []).length <= 5,
'four periods plus rubric maximum',
);
for (const table of report.sections[0].tables)
for (const header of table.headers)
assert.ok(html.includes(header), header);
assert.match(html, /2031-12/);
assert.doesNotMatch(html, /overflow-x:auto/);
});
const get = (tables, id, label) => const get = (tables, id, label) =>
tables tables
.find((table) => table.id === id) .find((table) => table.id === id)