feat(qa): consolidate eleven financial report tables pending private visual acceptance

This commit is contained in:
2026-11-20 13:31:47 +02:00
parent 2e5b7f973c
commit 93fc837a47
12 changed files with 674 additions and 68 deletions
+4 -2
View File
@@ -329,12 +329,14 @@ final class InvestorPath
'snapshot_sha256' => $draft->snapshot_sha256, 'financial_snapshot' => $snapshot,
'context_opportunity' => $opportunity,
'currency' => $economic['currency'] ?? null, 'engine' => 'financial-calculators:v1',
'preparation_snapshot' => Arr::only($economic, ['total_investment', 'secured_amount', 'planned_funding', 'requested_funding', 'approved_funding', 'planning_loan', 'annual_revenue', 'annual_operating_costs', 'investment_budget_min', 'investment_budget_max', 'initial_budget_snapshot', 'planning_assumptions_snapshot']),
'preparation_snapshot' => Arr::only($economic, ['total_investment', 'secured_amount', 'planned_funding', 'requested_funding', 'approved_funding', 'planning_loan', 'annual_revenue', 'annual_operating_costs', 'investment_budget_min', 'investment_budget_max', 'initial_budget_snapshot', 'planning_assumptions_snapshot', 'business_plan_snapshot', 'project_team_snapshot', 'project_execution_snapshot']),
'kind' => 'local_calculation_inputs', 'context_state' => 'current', 'context_revision' => $context['revision'], 'context_dependency_hash' => $context['dependency_hash'] ?? app(InvestorContext::class)->dependencyHash([]), 'recorded_at' => now()->toIso8601String()];
$payload['investor_path']['results'][] = $result;
abort_unless(count($payload['investor_path']['results']) <= 100, 422, 'Limite de evidências financeiras deste dossier atingido.');
$this->savePayload($case, $payload);
$this->desk->event($this->desk->case($actor, $id), $actor, 'tool_evidence_returned', array_diff_key($result, ['financial_snapshot' => true]));
$eventResult = $result;
$eventResult['preparation_snapshot'] = Arr::except($eventResult['preparation_snapshot'], ['business_plan_snapshot', 'project_team_snapshot', 'project_execution_snapshot']);
$this->desk->event($this->desk->case($actor, $id), $actor, 'tool_evidence_returned', array_diff_key($eventResult, ['financial_snapshot' => true]));
return $result;
});
@@ -10445,3 +10445,13 @@ Seis testes novos e um teste de integração afectado aprovados; tipos/lint/buil
### Encerramento formal do Pacote 3 — aceitação do proprietário
Pacote 3 da Etapa 2 APROVADO E ENCERRADO EM QA, por aceitação funcional expressa baseada no commit `35c9e4fc`. Cinco rácios, tratamento de inconsistências contabilísticas, dados ausentes e denominadores zero aprovados; persistência, interface e exportações aprovadas. Onze tabelas INTEGRADAS. Relatório integral NÃO APTO, pendente de consolidação e CAE. Pacote 4 NÃO INICIADO; instalação e publicação NÃO AUTORIZADAS. Preservados os encerramentos anteriores. Actualizadas somente documentação e matriz existentes, sem código, testes ou início de outro pacote.
### Etapa 2 — Pacote 4 — relatório único, 20/11/2026
Implementada em QA a opção «Relatório financeiro integral — onze tabelas» na revisão do simulador. Abra «Conferir o relatório antes de exportar»; o Word e a impressão/PDF utilizam o mesmo modelo e os construtores já aprovados. O modo anterior de dossier e contexto conserva as secções seleccionadas. Os novos selectores cabem no espaço móvel e as tabelas largas conservam deslocação horizontal própria.
Ao devolver um resultado ao dossier, a persistência privada existente conserva agora plano, pessoal e marcos na versão exacta. Nos relatórios do dossier, seleccione a versão financeira quando houver alternativas; uma versão única é utilizada automaticamente. Outros contextos são excluídos e versões históricas permanecem identificadas. Originais antigos sem snapshots completos não são reconstruídos. Os novos snapshots não são copiados para os eventos gerais.
Quatro testes novos de consolidação, oito testes afectados do dossier, um teste HTTP transaccional com 18 asserções, tipos/lint/build QA aprovados. Onze tabelas e recuperação conferidas no simulador em 1440 × 1000 e 390 × 844; componente real do dossier conferido isoladamente nas mesmas resoluções. Word 14 páginas e impressão PDF 13 páginas examinados integralmente, com identidade das células. Cenário sintético aprovado reutilizado, sem alterações às fórmulas ou classificações dos pacotes encerrados.
Pacote 4 APTO COM CONDIÇÕES, por aceitar: a página privada autenticada completa permanece NÃO VERIFICADA visualmente por ausência de serviço `project-preparation` publicado neste QA. Contrato privado demonstrado por HTTP com reversão; componente demonstrado separadamente. Não se activou serviço nem criou conta permanente para substituir essa prova. Matriz individual, páginas, resoluções, limites e hashes no aditamento existente e `outputs/controlled-5f7db7cd-20261120/package4/acceptance.json`. Relatório integral NÃO APTO até aceitação da consolidação e CAE; Pacote 5 não iniciado. Sem instalação, publicação, migrações operacionais ou reconstrução do histórico QA perdido.
@@ -916,3 +916,47 @@ Pendências do Pacote3: nenhuma identificada nos critérios acima; aceitação f
| Instalação e publicação | NÃO AUTORIZADAS |
Este registo substitui o estado técnico «por aceitar» pela aceitação expressa, preservando as provas, o histórico e os encerramentos da Etapa 1 e dos Pacotes 1 e 2. Execução exclusivamente documental: sem alterações de código, repetição de testes ou início de outros pacotes. O encerramento do Pacote 3 não equivale à aceitação do relatório integral nem autoriza instalação ou publicação.
### Etapa 2 — Pacote 4 — relatório consolidado em QA, 20/11/2026
Base: `2e5b7f97`; Etapa 1 e Pacotes 1–3 aprovados e encerrados preservados. Implementação limitada à consolidação, apresentação, transporte dos snapshots e exportações existentes. Nenhuma alteração de fórmulas, classificações CAE, permissões ou schema.
O simulador passa a permitir escolher «Relatório financeiro integral — onze tabelas» e conferir a mesma versão antes de exportar Word/impressão/PDF. A ordem das onze tabelas é única; os valores provêm dos construtores já aprovados. O resumo utiliza os mesmos pagamentos, resultados e caixa das tabelas, sem conversões monetárias nem ajustamentos contabilísticos.
Foi corrigida uma lacuna concreta na passagem ao dossier: o resultado guardava o snapshot das ferramentas antigas mas não os snapshots do plano, pessoal e marcos. O retorno autorizado conserva agora os três snapshots na versão exacta do resultado, na persistência privada existente. Não copia esses novos conteúdos para os eventos gerais. Uma única versão disponível é utilizada; várias versões exigem escolha expressa. Outro contexto/oportunidade é excluído. Versões históricas são identificadas; originais sem os snapshots não são reconstruídos nem substituídos.
**Resultado: Pacote 4 APTO COM CONDIÇÕES, por aceitar.** As onze tabelas, a interface do simulador, os documentos e os contratos de persistência/isolamento foram verificados. A página privada autenticada completa não foi conferida visualmente: este QA não dispõe de um exemplar publicado de `project-preparation`. Não foi activado serviço nem criada conta permanente para contornar essa ausência. Em alternativa, o componente real do dossier foi conferido isoladamente com dados sintéticos nas duas resoluções; o percurso privado foi verificado por HTTP dentro de uma transacção revertida. Estas provas independentes não são apresentadas como captura da página privada autenticada.
| Tabela | Estado da consolidação | Word: páginas | Impressão PDF: páginas |
| --- | --- | --- | --- |
| Start-up / arranque | APROVADO | 2 | 2 |
| Análise de Mercado | APROVADO | 2–3 | 3 |
| Previsão de Vendas | APROVADO | 3 | 3 |
| Marcos | APROVADO | 3–4 | 3–4 |
| Pessoal | APROVADO | 4–5 | 4–5 |
| Financiamento | APROVADO | 5 | 5–6 |
| Ponto de Equilíbrio | APROVADO | 6 | 6 |
| Lucros e Perdas | APROVADO | 6–8 | 6–8 |
| Fluxo de Caixa | APROVADO | 8–10 | 8–9 |
| Balanço Projectado | APROVADO | 10–13 | 10–12 |
| Rácios financeiros | APROVADO | 13–14 | 12–13 |
Resumo nas páginas 1–2 de ambos os documentos. Conferidas visualmente todas as 14 páginas da conversão nativa Word e todas as 13 páginas da impressão HTML/PDF, rasterizadas com Poppler: títulos, valores, cabeçalhos nas continuações, colunas e rodapés legíveis, sem cortes de conteúdo. Todas as células do DOCX foram encontradas nos dois PDF. As diferenças de paginação decorrem dos dois mecanismos existentes e não de omissão de tabelas.
Cenário sintético reutilizado dos Pacotes 2/3, não dados reais nem recuperação do histórico perdido: 13 meses, vendas/cobranças 13.000,00 MZN, pagamentos 9.360,00 MZN, resultado antes de impostos 3.770,00 MZN, resultado líquido mensal somado 3.380,00 MZN e caixa final 4.540,00 MZN. O arranque de 100,00 MZN continua reconhecido na abertura, pelo que os resultados acumulados finais são 3.280,00 MZN. Não foi confundido esse saldo com a soma dos lucros mensais. Financiamento insuficiente de 100,00 MZN mantém aviso não bloqueante; valores sintéticos e hipóteses de mercado/fiscalidade continuam explícitos.
| Verificação | Resultado e prova |
| --- | --- |
| Novo contrato de consolidação | 4 testes frontend aprovados: identidade das onze tabelas, versão/contexto, históricos/ausência e moedas diferentes |
| Regressão afectada do dossier | 8 testes existentes aprovados; sem repetir as baterias financeiras encerradas |
| Persistência privada | 1 teste HTTP, 18 asserções: versão exacta, idempotência, recuperação do proprietário, 403 para outra conta e exclusão dos novos snapshots dos eventos; transacção revertida |
| Simulador 1440 × 1000 e 390 × 844 | Onze tabelas na mesma ordem, todas as células comparadas ao modelo exportado, snapshots recuperados após recarregar, sem erros JavaScript e largura do documento igual à resolução |
| Componente real do dossier, isolado | Escolha obrigatória entre duas versões, onze tabelas após escolha e exclusão de outra oportunidade; 1440 × 1000 e 390 × 844, sem erros JavaScript |
| Tipos, lint e compilação QA | Aprovados. Build com avisos de tamanho/tempos dos plugins, sem erro de compilação. Sintaxe PHP e formatação do novo teste verificadas |
| Página privada autenticada completa | NÃO VERIFICADA visualmente; serviço QA publicado indisponível, conforme limitação acima |
Provas locais em `outputs/controlled-5f7db7cd-20261120/package4/`: `visual.json`, `component.json`, `acceptance.json` com hashes, `model.json`, `interface.docx` descarregado na interface, `report.docx`, `report-native.pdf`, `report-print.pdf`, `word-01.png` a `word-14.png`, `print-01.png` a `print-13.png`, capturas `{1440,390}-overview.png` e `{1440,390}-{1..11}{,-end}.png`. As tabelas largas usam deslocação horizontal própria; as capturas das extremidades são complementares. O botão flutuante de ajuda preexistente pode aparecer sobre uma captura de elemento; não foi ocultado para produzir provas.
A automação inicial usava o nome exacto de um label que incluía o texto das opções; corrigido o selector da prova, sem alteração funcional da aplicação. A recaptura aguarda a leitura da resposta de recuperação antes de observar a interface, evitando observar o formulário ainda a inicializar. Conversão COM sem resposta interrompida; conversão nativa Word concluída sem alteração de segurança ou instalação de dependências. Um ajuste concreto limita a largura dos novos selectores ao espaço móvel.
Pendência do Pacote 4: conferência visual integrada da página privada autenticada quando existir o serviço QA adequado; não é uma falha funcional demonstrada. Relatório integral continua NÃO APTO até à aceitação da consolidação e ao Pacote 5 — CAE. Pacote 5 NÃO INICIADO. Histórico QA perdido e tradução HTTP 503 mantidos como pendências independentes. Instalação, publicação e migrações operacionais não efectuadas nem autorizadas.
File diff suppressed because one or more lines are too long
@@ -0,0 +1,47 @@
import type { DossierReportModel } from '@/lib/project-dossier-report';
import { InvestmentReportTables } from './investment-report-tables';
export function DossierReportPreview({
report,
}: {
report: DossierReportModel;
}) {
return (
<article
aria-label="Pré-visualização do relatório"
className="min-w-0 space-y-3 rounded border p-3"
>
<h3 className="font-semibold">{report.title}</h3>
<p className="text-sm">{report.version}</p>
{report.sections.map((section, i) => (
<section
key={`${section.id}-${i}`}
className="min-w-0 space-y-2"
>
<h4 className="font-medium">{section.title}</h4>
{section.paragraphs.map((p, j) => (
<p key={j}>{p}</p>
))}
<dl className="space-y-2">
{section.rows.map((r, j) => (
<div className="break-words" key={j}>
<dt className="font-medium">{r.field}</dt>
<dd>{r.value}</dd>
<dd className="text-sm">
{r.classification} · {r.origin}
</dd>
</div>
))}
</dl>
{section.tables && (
<InvestmentReportTables tables={section.tables} />
)}
</section>
))}
{report.limitations.map((p, i) => (
<p className="text-sm" key={i}>
{p}
</p>
))}
</article>
);
}
@@ -1,9 +1,10 @@
import { useEffect, useState } from 'react';
import { InvestmentReportTables } from './investment-report-tables';
import { useEffect, useMemo, useState } from 'react';
import { DossierReportPreview } from './dossier-report-preview';
import {
createInvestorDossierReport,
createInvestorStageReport,
investorDossierReportIndex,
investorFinancialReportChoices,
type InvestorDossierReportInput,
} from '@/lib/investor-dossier-report';
import {
@@ -32,6 +33,7 @@ function InvestorDossierReportsContent({
const [busy, setBusy] = useState(false);
const [error, setError] = useState('');
const [stage, setStage] = useState('');
const [financialResultId, setFinancialResultId] = useState('');
const [download, setDownload] = useState<{
url: string;
name: string;
@@ -45,13 +47,44 @@ function InvestorDossierReportsContent({
const requiresChoice =
dossier.opportunity_options.length > 1 && !dossier.context_opportunity;
const entries = requiresChoice ? [] : investorDossierReportIndex(dossier);
const financialChoices = requiresChoice
? []
: investorFinancialReportChoices(dossier);
const financialChoiceRequired =
(!stage || stage === 'S03') &&
financialChoices.length > 1 &&
!financialResultId;
const report = useMemo(
() =>
requiresChoice || financialChoiceRequired
? null
: stage
? createInvestorStageReport(
dossier,
stage,
undefined,
financialResultId || undefined,
)
: createInvestorDossierReport(dossier, undefined, {
financialResultId: financialResultId || undefined,
}),
[
dossier,
stage,
financialResultId,
requiresChoice,
financialChoiceRequired,
],
);
async function exportReport(format: 'word' | 'html') {
setBusy(true);
setError('');
try {
const model = stage
? createInvestorStageReport(dossier, stage)
: createInvestorDossierReport(dossier);
if (!report)
throw Error(
'Escolha o contexto e a versão financeira antes de exportar.',
);
const model = report;
const blob =
format === 'word'
? await generateProjectDossierDocx(model, [], true)
@@ -116,13 +149,69 @@ function InvestorDossierReportsContent({
))}
</select>
</label>
{stage && (
<StageReportPreview dossier={dossier} stage={stage} />
{(!stage || stage === 'S03') &&
financialChoices.length > 0 && (
<label className="grid min-w-0 gap-1">
Plano financeiro a incluir
<select
className="w-full min-w-0 rounded border p-2"
value={financialResultId}
disabled={busy}
onChange={(e) => {
setFinancialResultId(e.target.value);
setDownload(null);
}}
>
<option value="">
{financialChoices.length === 1
? 'Única versão preservada neste contexto'
: 'Escolha uma versão — os valores não serão misturados'}
</option>
{financialChoices.map((r) => (
<option key={r.id} value={r.id}>
Rascunho v{r.draft_version} ·{' '}
{r.recorded_at} · contexto v
{r.context_revision ??
'por identificar'}
</option>
))}
</select>
</label>
)}
{financialChoiceRequired && (
<p role="status">
Escolha a versão financeira a incluir. As restantes
versões permanecem no histórico.
</p>
)}
{!financialChoices.length &&
dossier.results.some(
(r) =>
(r.context_opportunity ?? null) ===
dossier.context_opportunity,
) && (
<p className="text-sm">
As versões antigas não contêm todos os dados do
relatório integral. Os originais permanecem
disponíveis; use uma versão completa guardada
para reunir as onze tabelas.
</p>
)}
{report && (
<details
className="rounded border p-3"
open={Boolean(stage)}
>
<summary>
Conferir o relatório antes de exportar
</summary>
<DossierReportPreview report={report} />
</details>
)}
<div className="flex flex-wrap gap-3">
<button
className="rounded border px-3 py-2"
disabled={busy}
disabled={busy || financialChoiceRequired}
onClick={() => exportReport('word')}
>
Preparar{' '}
@@ -133,7 +222,7 @@ function InvestorDossierReportsContent({
</button>
<button
className="rounded border px-3 py-2"
disabled={busy}
disabled={busy || financialChoiceRequired}
onClick={() => exportReport('html')}
>
Preparar versão para impressão/PDF
@@ -227,49 +316,3 @@ function InvestorDossierReportsContent({
</section>
);
}
function StageReportPreview({
dossier,
stage,
}: {
dossier: InvestorDossierReportInput;
stage: string;
}) {
const report = createInvestorStageReport(dossier, stage);
return (
<article
className="space-y-3 rounded border p-3"
aria-label={`Relatório da etapa ${stage}`}
>
<h3 className="font-semibold">{report.title}</h3>
<p className="text-sm">{report.version}</p>
{report.sections.map((section) => (
<section key={section.id} className="space-y-2">
<h4 className="font-medium">{section.title}</h4>
{section.paragraphs.map((text) => (
<p key={text}>{text}</p>
))}
<dl className="space-y-2">
{section.rows.map((row, index) => (
<div key={index} className="break-words">
<dt className="font-medium">{row.field}</dt>
<dd>{row.value}</dd>
<dd className="text-sm">
{row.classification} · {row.origin}
</dd>
</div>
))}
</dl>
{section.tables && (
<InvestmentReportTables tables={section.tables} />
)}
</section>
))}
{report.limitations.map((text) => (
<p className="text-sm" key={text}>
{text}
</p>
))}
</article>
);
}
@@ -1,4 +1,5 @@
import { useMemo, useRef, useState } from 'react';
import { DossierReportPreview } from './dossier-report-preview';
import {
DossierExportGate,
dossierExportFailure,
@@ -7,6 +8,7 @@ import {
import {
createProjectDossierPrintHtml,
createProjectDossierReport,
createIntegralFinancialReport,
dossierReportSections,
generateProjectDossierDocx,
generateProjectDossierPackage,
@@ -58,6 +60,7 @@ export function ProjectDossierExport({
currentCalculation = null,
}: Props) {
const [selectedSections, setSelectedSections] = useState(defaultSections);
const [reportMode, setReportMode] = useState('dossier');
const [attachments, setAttachments] = useState<DossierAttachment[]>([]);
const [error, setError] = useState('');
const [busy, setBusy] = useState('');
@@ -127,13 +130,31 @@ export function ProjectDossierExport({
);
}
function model() {
return createProjectDossierReport(draft, {
selectedSections: selectedSectionSet,
const report = useMemo(
() =>
reportMode === 'financial'
? createIntegralFinancialReport(draft, {
version,
references,
currentCalculation,
})
: createProjectDossierReport(draft, {
selectedSections: selectedSectionSet,
version,
references,
currentCalculation,
}),
[
draft,
reportMode,
version,
references,
currentCalculation,
});
selectedSectionSet,
],
);
function model() {
return report;
}
async function exportWord(): Promise<void> {
@@ -272,7 +293,10 @@ export function ProjectDossierExport({
</p>
</div>
<fieldset className="space-y-2">
<fieldset
className="space-y-2"
disabled={reportMode === 'financial'}
>
<legend className="font-medium">
Escolha as secções a incluir
</legend>
@@ -400,6 +424,26 @@ export function ProjectDossierExport({
em zero. O relatório identifica pressupostos, estimativas e
referências sem as apresentar como resultados confirmados.
</p>
<label className="grid min-w-0 gap-1">
Conteúdo do relatório
<select
className="w-full min-w-0 rounded border p-2"
value={reportMode}
onChange={(e) => setReportMode(e.target.value)}
disabled={Boolean(busy)}
>
<option value="dossier">
Dossier e contexto — secções seleccionadas
</option>
<option value="financial">
Relatório financeiro integral — onze tabelas
</option>
</select>
</label>
<details className="rounded border p-3">
<summary>Conferir o relatório antes de exportar</summary>
<DossierReportPreview report={report} />
</details>
{notice && (
<p role="status" className="text-sm">
{notice}
@@ -414,7 +458,11 @@ export function ProjectDossierExport({
<button
type="button"
className="rounded bg-emerald-800 px-4 py-2 font-semibold text-white disabled:opacity-50"
disabled={Boolean(busy) || selectedSections.size === 0}
disabled={
Boolean(busy) ||
(reportMode === 'dossier' &&
selectedSections.size === 0)
}
onClick={() => void exportWord()}
>
{busy === 'word'
@@ -424,7 +472,11 @@ export function ProjectDossierExport({
<button
type="button"
className="rounded border px-4 py-2 disabled:opacity-50"
disabled={Boolean(busy) || selectedSections.size === 0}
disabled={
Boolean(busy) ||
(reportMode === 'dossier' &&
selectedSections.size === 0)
}
onClick={() => void exportPdf()}
>
{busy === 'pdf'
+68 -2
View File
@@ -8,6 +8,7 @@ import type {
DossierReportModel,
DossierReportRow,
} from './project-dossier-report.ts';
import { createIntegralFinancialReport } from './project-dossier-report.ts';
export type PreparationReport = {
case_id: string;
@@ -337,11 +338,71 @@ export function investorDossierReportIndex(
return entries.sort((a, b) => a.stage.localeCompare(b.stage));
}
export function investorFinancialReportChoices(
input: InvestorDossierReportInput,
) {
return input.results.filter(
(r) =>
(r.context_opportunity ?? null) === input.context_opportunity &&
typeof r.preparation_snapshot?.business_plan_snapshot ===
'string' &&
r.preparation_snapshot.business_plan_snapshot.trim() !== '',
);
}
export function createInvestorDossierReport(
input: InvestorDossierReportInput,
generatedAt = new Date().toISOString(),
options: {
financialResultId?: string;
omitIntegralFinancial?: boolean;
} = {},
): DossierReportModel {
const index = investorDossierReportIndex(input);
const choices = options.omitIntegralFinancial
? []
: investorFinancialReportChoices(input);
if (
options.financialResultId &&
!choices.some((r) => r.id === options.financialResultId)
)
throw Error(
'O plano financeiro escolhido não pertence a este contexto ou não foi preservado nesta versão.',
);
if (choices.length > 1 && !options.financialResultId)
throw Error(
'Escolha a versão financeira a incluir; os valores de versões diferentes não são misturados.',
);
const chosen = options.financialResultId
? choices.find((r) => r.id === options.financialResultId)
: choices.length === 1
? choices[0]
: undefined;
const integral = chosen
? createIntegralFinancialReport(
{
...chosen.preparation_snapshot,
currency: chosen.currency ?? '',
project_title: input.case.title,
},
{
generatedAt,
version: `Plano guardado v${chosen.draft_version} · contexto v${chosen.context_revision ?? 'por identificar'}`,
},
)
: null;
if (integral && chosen) {
integral.sections[0].paragraphs.unshift(
`Plano preservado em ${chosen.recorded_at}, rascunho v${chosen.draft_version}. As onze tabelas desta secção correspondem apenas à versão escolhida; os outros registos financeiros do dossier mantêm a sua origem e não são somados a este plano.`,
);
if (
chosen.context_revision !== input.investment_context?.revision ||
chosen.context_state === 'review_required'
)
integral.sections[0].paragraphs.unshift(
'Versão histórica: o contexto mudou. Os valores foram preservados e exigem conferência antes de utilização.',
);
}
const supply = input.supply_aggregates?.at(-1);
const row = (
field: string,
@@ -552,6 +613,7 @@ export function createInvestorDossierReport(
'O índice referencia os originais; não incorpora automaticamente os seus anexos nem envia dados a entidades externas.',
],
sections: [
...(integral?.sections ?? []),
{
id: 'supply',
title: 'Actividades existentes — análise agregada',
@@ -764,17 +826,21 @@ export function createInvestorStageReport(
input: InvestorDossierReportInput,
stageCode: string,
generatedAt = new Date().toISOString(),
financialResultId?: string,
): DossierReportModel {
const step = input.steps.find((item) => item.code === stageCode);
if (!step) throw new Error('Etapa não encontrada neste dossier.');
const report = createInvestorDossierReport(input, generatedAt);
const report = createInvestorDossierReport(input, generatedAt, {
financialResultId: stageCode === 'S03' ? financialResultId : undefined,
omitIntegralFinancial: stageCode !== 'S03',
});
const entries = investorDossierReportIndex(input).filter((entry) =>
entry.stage.split(', ').includes(stageCode),
);
const origins = new Set(entries.map((entry) => entry.href));
const specificSections = new Set([
...(stageCode === 'S02' ? ['market'] : []),
...(stageCode === 'S03' ? ['finance'] : []),
...(stageCode === 'S03' ? ['finance', 'financial-report'] : []),
...(['S06', 'S07'].includes(stageCode) ? ['sources'] : []),
]);
return {
+12 -1
View File
@@ -629,6 +629,17 @@ export async function createProjectDossierPrintHtml(
content.push(`<section><h2>${escapeHtml(section.title)}</h2>`);
for (const paragraph of section.paragraphs)
content.push(`<p>${escapeHtml(paragraph)}</p>`);
if (section.id === 'financial-report' && section.rows.length)
content.push(
htmlTable(
['Campo', 'Conteúdo', 'Classificação / origem'],
section.rows.map((row) => [
row.field,
row.value,
`${row.classification}. ${row.origin}`,
]),
),
);
for (const entry of section.tables ?? []) {
content.push(`<h3>${escapeHtml(entry.title)}</h3>`);
for (const note of [...entry.issues, ...entry.notes])
@@ -636,7 +647,7 @@ export async function createProjectDossierPrintHtml(
for (const slice of investmentReportTableSlices(entry))
content.push(htmlTable(slice.headers, slice.rows));
}
if (section.rows.length)
if (section.rows.length && section.id !== 'financial-report')
content.push(
htmlTable(
['Campo', 'Conteúdo', 'Classificação / origem'],
@@ -43,6 +43,7 @@ export const dossierReportSections = [
export type DossierReportSectionId =
| (typeof dossierReportSections)[number]['id']
| 'financial-report'
| 'supply';
export type DossierReference = {
version: number;
@@ -860,6 +861,80 @@ export function createProjectDossierReport(
};
}
export const integralFinancialTableIds = [
'startup',
'market-analysis',
'sales',
'milestones',
'personnel',
'funding',
'break-even',
'profit-loss',
'cashflow',
'balance',
'ratios',
] as const;
/** One saved scenario, one report; existing statement builders remain the source. */
export function createIntegralFinancialReport(
draft: Record<string, string | string[]>,
options: Omit<
Parameters<typeof createProjectDossierReport>[1],
'selectedSections'
> = {},
): DossierReportModel {
const report = createProjectDossierReport(draft, {
...options,
selectedSections: new Set(['market', 'finance', 'team', 'execution']),
});
const tables = report.sections.flatMap((s) => s.tables ?? []);
const finance = report.sections.find((s) => s.id === 'finance');
const planCurrency = restoreBusinessPlanSnapshot(
text(draft, 'business_plan_snapshot'),
)?.currency;
const declaredCurrency = text(draft, 'currency');
const summary = new Set([
'Moeda do plano',
'Horizonte',
'Facturação no horizonte',
'Cobranças no horizonte',
'Pagamentos no horizonte',
'Resultado antes de impostos',
'Caixa final projectada',
'Reconciliação do financiamento',
'Diferença entre usos e fontes',
'Resultado líquido no horizonte',
]);
const ordered = integralFinancialTableIds.flatMap((id) => {
const t = tables.find((t) => t.id === id);
return t ? [t] : [];
});
return {
...report,
sections: [
{
id: 'financial-report',
title: 'Relatório financeiro integral',
private: true,
paragraphs: [
...(planCurrency &&
declaredCurrency &&
planCurrency !== declaredCurrency
? [
`Moedas diferentes: o plano financeiro mantém ${planCurrency}; o projecto declara ${declaredCurrency}. Confira os dados complementares antes de comparar montantes. Não foi feita conversão.`,
]
: []),
`Tabelas incluídas: ${ordered.length} de 11. Os valores provêm do mesmo plano e dos dados complementares guardados.`,
'Projecções para avaliar o investimento; não são contas realizadas nem confirmação de financiamento. Campos em falta e indicadores indeterminados mantêm-se identificados.',
],
rows:
finance?.rows.filter((row) => summary.has(row.field)) ?? [],
tables: ordered,
},
],
};
}
export function classifyDossierAttachment(
file: Pick<File, 'name' | 'type' | 'size'>,
): DossierAttachmentKind {
@@ -0,0 +1,55 @@
<?php
namespace Tests\Feature;
use App\Models\User;
use App\Services\VirtualDesk;
use Illuminate\Foundation\Testing\DatabaseTransactions;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Facades\Http;
use Illuminate\Support\Str;
use Tests\TestCase;
class InvestorIntegralReportTest extends TestCase
{
use DatabaseTransactions;
public function test_private_report_snapshots_are_preserved_in_the_exact_result_version_without_exposing_them_in_events(): void
{
$identity = DB::selectOne('select current_database() as name, inet_server_port() as port');
$this->assertStringEndsWith('_test', $identity->name);
$this->assertSame(55441, (int) $identity->port);
$this->withoutVite();
Http::fake();
$owner = User::factory()->create();
config(['investor-path.enabled' => true, 'portal.managers' => [$owner->email], 'suitecrm.enabled' => false, 'investmoz_ai.enabled' => false]);
$this->actingAs($owner);
if (! DB::table('desk_service_versions')->where('code', 'project-preparation')->exists()) {
$this->postJson('/management/balcao/servicos', ['code' => 'project-preparation', 'confirm' => true])->assertCreated();
}
$case = $this->postJson('/investimentos', ['title' => 'QA synthetic report transport', 'client_key' => (string) Str::uuid(), 'reuse_consent' => true])->assertCreated()->json('id');
// Transport contract only: no invented financial amounts or calculated results.
$economic = [
'purpose' => 'simulate_only',
'financial_tools_snapshot' => json_encode(['version' => 1, 'data' => []], JSON_THROW_ON_ERROR),
'business_plan_snapshot' => json_encode(['version' => 17, 'plan' => ['fixture' => 'synthetic transport only']], JSON_THROW_ON_ERROR),
'project_team_snapshot' => json_encode([['competency' => 'QA role', 'state' => 'unknown', 'action' => '', 'estimated_cost' => '', 'due_date' => '']], JSON_THROW_ON_ERROR),
'project_execution_snapshot' => json_encode([['title' => 'QA milestone', 'due_date' => '', 'status' => 'planned', 'planned_amount' => '', 'actual_amount' => '']], JSON_THROW_ON_ERROR),
];
$draft = $this->postJson('/api/v1/simulation-drafts', ['context' => $case, 'personal_snapshot' => [], 'economic_snapshot' => $economic], ['Idempotency-Key' => (string) Str::uuid()])->assertCreated()->json('data.id');
$view = $this->getJson('/investimentos/'.$case)->assertOk()->json();
$request = ['version' => $view['case']['version'], 'draft_id' => $draft, 'draft_version' => 1];
$result = $this->postJson('/investimentos/'.$case.'/resultados', $request)->assertOk()->json('result');
foreach (['business_plan_snapshot', 'project_team_snapshot', 'project_execution_snapshot'] as $field) {
$this->assertSame($economic[$field], $result['preparation_snapshot'][$field]);
}
$this->postJson('/investimentos/'.$case.'/resultados', $request)->assertOk()->assertJsonPath('result.id', $result['id']);
$this->flushSession();
$this->actingAs($owner)->getJson('/investimentos/'.$case)->assertOk()->assertJsonPath('results.0.preparation_snapshot', $result['preparation_snapshot']);
$event = app(VirtualDesk::class)->decode(DB::table('desk_events')->where('case_id', $case)->where('action', 'tool_evidence_returned')->value('payload'));
foreach (['business_plan_snapshot', 'project_team_snapshot', 'project_execution_snapshot'] as $field) {
$this->assertArrayNotHasKey($field, $event['preparation_snapshot']);
}
$this->actingAs(User::factory()->create())->getJson('/investimentos/'.$case)->assertForbidden();
}
}
@@ -0,0 +1,201 @@
import test from 'node:test';
import assert from 'node:assert/strict';
import JSZip from 'jszip';
import { complementaryFixture } from './fixtures/complementary-plan.mjs';
import { buildIntegralFinancialTables } from '../../resources/js/lib/integral-financial-report.ts';
import { serializeBusinessPlanSnapshot } from '../../resources/js/lib/business-financial-plan.ts';
import {
createIntegralFinancialReport,
createProjectDossierReport,
integralFinancialTableIds,
generateProjectDossierDocx,
createProjectDossierPrintHtml,
} from '../../resources/js/lib/project-dossier-report.ts';
import {
createInvestorDossierReport,
createInvestorStageReport,
investorFinancialReportChoices,
} from '../../resources/js/lib/investor-dossier-report.ts';
export function consolidatedFixture() {
const { plan, draft } = complementaryFixture(),
balance = buildIntegralFinancialTables(plan).find(
(t) => t.id === 'balance',
);
plan.ratioCurrentBalances = {
assetsByMonth: balance.rows
.find((r) => r[0] === 'Caixa líquida')
.slice(1, 14),
liabilitiesByMonth: balance.rows
.find((r) => r[0] === 'Total do passivo')
.slice(1, 14),
};
draft.business_plan_snapshot = serializeBusinessPlanSnapshot(plan);
return { plan, draft };
}
const dossier = () => {
const { draft } = consolidatedFixture();
return {
case: { id: 'synthetic-case', title: 'Hotel QA sintético', version: 3 },
context_opportunity: null,
opportunity_options: [],
investment_context: { revision: 1, fields: {} },
phases: {},
steps: [
{
code: 'S03',
title: 'Viabilidade',
state: 'preparing',
reason: '',
phase: 1,
detail: {},
},
],
documents: [],
results: [
{
id: 'saved-one',
draft_id: 'synthetic-draft',
draft_version: 1,
recorded_at: '2026-11-20T12:00:00Z',
currency: 'MZN',
engine: 'financial-calculators:v1',
financial_snapshot: '',
preparation_snapshot: draft,
context_revision: 1,
context_state: 'current',
},
],
};
};
void test('eleven tables and summary come from one immutable saved scenario and appear in both export formats', async () => {
const { draft } = consolidatedFixture(),
before = JSON.stringify(draft),
report = createIntegralFinancialReport(draft, {
version: 'QA v1',
generatedAt: '2026-11-20T12:00:00Z',
});
assert.equal(report.sections.length, 1);
assert.deepEqual(
report.sections[0].tables.map((t) => t.id),
[...integralFinancialTableIds],
);
assert.equal(new Set(report.sections[0].tables.map((t) => t.id)).size, 11);
const original = createProjectDossierReport(draft, {
selectedSections: new Set(['finance', 'market', 'team', 'execution']),
});
for (const t of report.sections[0].tables)
assert.deepEqual(
t,
original.sections
.flatMap((s) => s.tables ?? [])
.find((r) => r.id === t.id),
);
const cash = report.sections[0].rows.find(
(r) => r.field === 'Caixa final projectada',
);
assert.match(cash.value, /4 540,00/);
assert.equal(JSON.stringify(draft), before);
const html = await createProjectDossierPrintHtml(report, []),
doc = await generateProjectDossierDocx(report, []),
zip = await JSZip.loadAsync(
doc instanceof Blob ? await doc.arrayBuffer() : doc,
),
xml = await zip.file('word/document.xml').async('string');
for (const t of report.sections[0].tables) {
assert.ok(html.includes(t.title));
assert.ok(xml.includes(t.title));
}
});
void test('dossier uses only the chosen preserved scenario, requires choice between versions and never leaks another opportunity', () => {
const input = dossier();
let report = createInvestorDossierReport(input);
assert.equal(
report.sections.find((s) => s.id === 'financial-report').tables.length,
11,
);
const other = structuredClone(input.results[0]);
other.id = 'other-opportunity';
other.context_opportunity = 'foreign';
other.preparation_snapshot.project_team_snapshot = 'FOREIGN PRIVATE DATA';
input.results.push(other);
assert.equal(investorFinancialReportChoices(input).length, 1);
assert.ok(
!JSON.stringify(createInvestorDossierReport(input)).includes(
'FOREIGN PRIVATE DATA',
),
);
const second = structuredClone(input.results[0]);
second.id = 'saved-two';
second.draft_version = 2;
const snapshot = JSON.parse(
second.preparation_snapshot.business_plan_snapshot,
);
snapshot.plan.reportAssumptions.startupExpenses[0].amount = '100.25';
second.preparation_snapshot.business_plan_snapshot =
JSON.stringify(snapshot);
input.results.push(second);
assert.throws(() => createInvestorDossierReport(input), /Escolha/);
const chosen = createInvestorDossierReport(input, undefined, {
financialResultId: 'saved-two',
}).sections.find((s) => s.id === 'financial-report');
assert.match(
chosen.rows.find((r) => r.field === 'Caixa final projectada').value,
/4 539,75/,
);
assert.equal(
chosen.tables
.find((t) => t.id === 'funding')
.rows.find((r) => r[0] === 'Diferença por financiar')[1],
'100.25',
);
assert.throws(
() =>
createInvestorDossierReport(input, undefined, {
financialResultId: other.id,
}),
/contexto/,
);
report = createInvestorDossierReport(input, undefined, {
financialResultId: second.id,
});
assert.match(
report.sections
.find((s) => s.id === 'financial-report')
.rows.find((r) => r.field === 'Caixa final projectada').value,
/4 539,75/,
);
assert.equal(
createInvestorStageReport(
input,
'S03',
undefined,
second.id,
).sections.find((s) => s.id === 'financial-report').tables.length,
11,
);
});
void test('historical or absent snapshots are not silently reconstructed from another version', () => {
const input = dossier();
input.results[0].context_revision = 0;
let report = createInvestorDossierReport(input);
assert.match(
report.sections
.find((s) => s.id === 'financial-report')
.paragraphs.join(' '),
/histórica/,
);
delete input.results[0].preparation_snapshot.business_plan_snapshot;
report = createInvestorDossierReport(input);
assert.ok(!report.sections.some((s) => s.id === 'financial-report'));
});
void test('currency differences remain explicit without relabelling or converting the saved plan', () => {
const { draft } = consolidatedFixture();
const report = createIntegralFinancialReport({ ...draft, currency: 'USD' });
assert.match(report.sections[0].paragraphs.join(' '), /MZN.*USD/);
assert.equal(
report.sections[0].rows.find((r) => r.field === 'Moeda do plano').value,
'MZN',
);
});