Preserve installed dossier and support presentation while delivering authorised quick search

2026-11-13 15:17:26 +02:00
parent 0f79d0d54c 8854b2928c
commit 1d52c3d8f4
6 changed files with 304 additions and 10 deletions
@@ -9772,3 +9772,25 @@ Provas: `outputs/dossier-reports-20261113/`. Vinte e um testes frontend aprovado


 Relatórios do dossier — conferência final de 13/11/2026: regressão focada do servidor 4 testes/168 asserções; caso final de recuperação, descargas privadas, âmbito, repetição e bloqueio com módulo desactivado 45 asserções. Os 21 testes frontend passaram; tipos, análise PHP, lint e compilação QA aprovados. Delta próprio de relatórios preparado, sem instalação remota e sem interferir na incorporação demográfica em curso.
+
+
+## 13/11/2026 — relatórios do dossier instalados na homologação em 07182c7c
+
+Entrega autorizada pelo proprietário e instalada pelo executor Git em `https://teste-investidor.tempo.co.mz`. A revisão servida é `07182c7c735efa88d850551da71b671c3dadfa9d`. Entrada: `/investimentos`, abrir o dossier autorizado e a secção `#relatorios`. Índice por etapa e exportação consolidada Word/HTML disponíveis; cópias fiscais preservadas são recuperadas pelo titular a partir do próprio dossier. Continua sem envio ou publicação automática.
+
+Backup/restauro fresco:193 tabelas e381ficheiros. Conferência pós-entrega:12ficheiros de fonte por SHA256,HTTPS e controlos de entrada privada,12tabelas de negócio/geometria sem alteração,mais os três lotes demográficos presentes no backup conservados por contagens/checksum de metadados,observações e eventos. Durante a entrega foram concluídas,por operações autenticadas independentes,as restantes incorporações demográficas:a verificação final encontrou12lotes aprovados/920456observações. Esta entrega de relatórios não fez importações ou migrações;actualizou o vínculo da readiness à nova revisão,preservando as preparações CLI aceites.
+
+Prova final `outputs/dossier-reports-20261113/homologation-installed.json`;estado agregado `verification.json`. QA funcional,privacidade,recuperação,exportações,tipos,lint,análise PHP e compilação aprovados. A conferência visual no uso normal permanece pendente,sem reabrir a instalação nem as provas aceites. Este estado substitui a indicação histórica de QA sem instalação acima e não declara concluídos outros módulos ou relatórios ainda por implementar.
+
+
+## 13/11/2026 — consulta e descarga de resumos das 19 etapas, correcção em QA
+
+Conferência com conta sintética e MFA normal em `http://127.0.0.1:18814/investimentos/5245f06c-bdbd-4caf-bc37-900f10bf582c`, base isolada `investmoz_demography_test:55441`. Novo dossier, versão 21: os serviços existentes guardaram fundamentos sintéticos em S01–S19. Não foram alterados dossiers anteriores nem simuladas decisões/licenças externas. Na homologação foi criado apenas o dossier separado de ensaio `db85f087-0737-4164-892a-4fa4fe1313df`, com fundamento sintético S01; os três dossiers anteriores foram preservados.
+
+Lacuna corrigida: o componente existente passa a permitir seleccionar a etapa, consultar o resumo dos registos recuperados e preparar Word ou HTML. A ligação de descarga permanece visível com indicação de ficheiro pronto; o conteúdo e as pendências não são confundidos com documentos oficiais em falta. As limitações do modelo passam a integrar ambos os formatos. Mudar de dossier, versão ou oportunidade reinicializa a selecção/ligação local para não reutilizar uma exportação de outro contexto.
+
+Prova integrada: consulta das 19 etapas e 38 descargas reais pelo Edge (19 Word/19 HTML), conferidas em disco por identidade, etapa, versão, fundamento, limitações e ausência de registos de outra etapa. Actualizar a página recuperou os 19 registos e a versão 21. Evidência em `outputs/dossier-reports-20261113/stage-authenticated-browser-checks.json`, `stage-authenticated-download-verification.json`, `stage-recovery.json` e `visual/04-dossier-qa-S19-descarga.jpg`. Os ensaios isolados do componente estão identificados separadamente, sem os apresentar como prova de persistência.
+
+Validação nova, limitada ao delta: dois testes frontend (incluem exportação das 19 etapas e escape das limitações), tipos, lint dos três ficheiros de produto afectados e compilação QA. Não foram repetidas as provas aceites de APIEX/SWOT, cálculo fiscal, permissões ou instalação. O perfil antigo de QA referia contas que já não existem no cluster actualmente ligado; foi localizado e usado o perfil documentado da demografia, sem criar permissões ou reiniciar o cluster. A serialização da chave MFA da conta recém-criada foi corrigida apenas nessa conta sintética.
+
+Estado: correcção implementada e conferida em QA, ainda sem instalação. A homologação mantém `07182c7c` para o recorte de relatórios anteriormente instalado. A prova demonstra resumos de preparação por etapa; não declara produzidos estudos financeiros, licenças, decisões, pacotes APIEX ou documentos que não existam nos respectivos percursos. A instalação deste novo delta é a pendência de entrega; os saldos próprios dos outros módulos mantêm-se.
@@ -11126,5 +11126,5 @@ AUD-SIM-L1-P131,"Facto gerador/exigibilidade: entrega, serviço, importação, i
 AUD-SIM-L1-P132,"Exigibilidade em uso próprio,comissão,consignação e adiantamentos",Refinamento Tempo24/10 do saldoL1; origemAUD-SIM-INT02; CIVA2016 PDF8–9 e alterações aplicáveis,Simulador/IVA — cobertura por operacao,/simulador,"G11B/P132 instalado e8b5ae43:own_goods,own_services,commission_delivery,consignment_deadline,advance_payment. Eventos7(4)/(5)/(6) e8c:afectações/transmissões assimiladas3(3)e/f,serviços4(2),disponibilização pelo comissário,termo180dias de mercadorias à consignação3(3)d e pagamentos anteriores à factura. Corrigida remissão a consignação,não embalagensP102.8a/b/c separam parcela recebida e restante,sem dupla contagem.",Disponível na homologação e8b5ae43;delta instalado conferido,19frontend/API1/65rollback/tipos/build/EdgeCUA;provas anteriores reutilizadas.,"Demonstrado em QA e entregue na homologação e8b5ae43,no âmbito do ramo","Sem pendência neste recorte de eventos7/exigibilidade8 parametrizada;2026contexto;facto gerador7 e exigibilidade8 por data/âmbito;uma parcela de recebimento e restante por linha,ou parcelas de âmbitos distintos,sem agregação de totais entre linhas. Prazo de emissão é parâmetro legal identificado,não calendário presumido;importação segue7c. P104parcial não aplica câmbio fiscal.Sem nova base/IVA,taxa,dedução,campo11,regularização ou totaisModeloA;P133regimes suspensivos/viagens mantém âmbito separado.","Eventos7(4)/(5)/(6) e8c:afectações/transmissões assimiladas3(3)e/f,serviços4(2),disponibilização pelo comissário,termo180dias de mercadorias à consignação3(3)d e pagamentos anteriores à factura. Corrigida remissão a consignação,não embalagensP102.8a/b/c separam parcela recebida e restante,sem dupla contagem.",Condicoes/fonte/periodo desta operacao -> calculo ou nao aplicacao explicada -> gravacao -> recuperacao -> relatorio coerentes; desconhecido nao e zero. Preservar oportunidade e historico.,Saldo L1; sequencia do incremento indicada,,AUD-SIM-INT02,1,,,,,,,,,,"P131/P132 entregue conjuntamente e8b5ae43 sobre92eaa935;backup/restauro174tabelas/369ficheiros e delta conferidos. | Histórico: QAconcluído7e6e462e. | Histórico: PreparaçãoQA P104/P131/P132;118fechos inventariados antes dos testes,sem perdas confirmadas. | Histórico: 25/10/2026 impedimento: Falta exigibilidade dos eventos específicos de uso próprio/comissão/embalagens/adiantamentos. | Operacao discriminada do saldo anterior; e desenvolvimento nao demonstrado, nao regressao ou perda de fonte aceite.",Manter encerrado no âmbito entregue;reutilizar provas e conferir apenas deltas afectados.,currencyEvents nosnapshot/API/dossier;convertCents existente exportado semmudarlógica,Backup/restauro/destino autenticado;sem schema/permissões alterados ou ensaios sintéticos no activo.,"CIVA Lei13/2016:7(1)–(7),PDF8/p1426(266);8,PDF9/p1426(267);15(8),PDF14/p1426(272),páginas visualmente conferidas.Lei22/2022 eLei10/2025 não alteram7/8;15(8)mantido.RIVADecreto7/2008,21,PDF4:regra histórica5dias úteis e excepções;prazo actual não automatizado,exige disposição/calendário/âmbito identificados.","Desenvolvimento,QA e entrega conjunta concluídos no recorte;L1aberto",Sem esforço funcional pendente neste recorte;não estimativa de todoL1.,"Cotejo documental e revisao do codigo; candidato544068e8 preservado. Sem ensaio funcional deste ramo. | C:\laragon\www\portal-investidor\outputs\iva-l1-currency-events-20261025\preservation-before-tests.json | docs\investmoz\simulations\iva-l1-currency-events-qa-20261025.json | iva_l1_currency_events_P131_P132_partial_P104_homologation_20261025:manifesto/24marcadores/5hashes/simuladorHTTP200,preservação174tabelas/369ficheiros/29fichas/28relações/408geometrias;QA individual reutilizada",G11B,25/10/2026 — entrega conjuntaP131/P132 e8b5ae43,"{""article"": ""7(4–7)"", ""source"": ""CIVA2016 PDF8–9 e alterações aplicáveis"", ""scope"": ""2026 somente quando condicoes e periodo aplicavel forem determinados"", ""next_increment"": ""L1-R1P: período fiscal efectivo, distinto de mês orçamental""}",,,,,,,,,Nao confundir prova dos dez tratamentos anteriores com cobertura deste ramo.,,,,Entregue na homologação e8b5ae43;L1aberto
 AUD-SIM-L1-P133,Saída de regimes suspensivos e operações de viagens,Refinamento Tempo24/10 do saldoL1; origemAUD-SIM-INT02; CIVA2016 PDF8–9 e alterações aplicáveis,Simulador/IVA — cobertura por operacao,/simulador,"P133 instalado a48e9749: Cessação efectiva de regime7(8), distinta de mudança de armazém/transferência; viagens7(9)/RIVA40 pelo primeiro entre integral e início/primeiro serviço, sem subtrair dia nem inferir ordem intradiária. Exigibilidade8 por factura/recebimento separada, incluindo sinal e saldo integral sem dupla soma. Sem montante de imposto, desembaraço, direito ou ICE apurados.",Disponível na homologação a48e9749; delta instalado conferido no âmbito demonstrado.,29testes frontend; API privada1teste/68asserções; tipos/build; Edge gravação/recuperação/relatório;10operações/5períodos/12eventos.,"Demonstrado em QA e entregue na homologação a48e9749, no âmbito do ramo","Sem pendência de entrega neste recorte de margem/eventos. Sem cálculo de IVA devido ou dedução. Continuidade do apuramento/liquidação em AUD-SIM-INT02; deduções/regularizações nos lotes próprios, incluindoL2/L3, não encerradas. Factura/modelo oficial/regularização não executados.","Fontes do regime fiscal e evento específico cotejadas; moedaMZN para base, âmbito completo por operador/período, dados/datas/referências concretos. P104 não bloqueia classificação/eventos independentes.",Condicoes/fonte/periodo desta operacao -> calculo ou nao aplicacao explicada -> gravacao -> recuperacao -> relatorio coerentes; desconhecido nao e zero. Preservar oportunidade e historico.,Saldo L1; sequencia do incremento indicada,,AUD-SIM-INT02,1,,,,,,,,,,"P129/P133 entregues conjuntamente a48e9749 sobre df43aeb1;123fechos preservados; backup/restauro e delta conferidos; limitação ligada a AUD-SIM-INT02. | Histórico: P133 QA concluído no âmbito demonstrado,123fechos preservados,sem repetição de provas aceites. | Histórico: Preparação QA viagens/eventos:123fechos inventariados antes dos testes; nenhuma perda confirmada. | Histórico: 25/10/2026 impedimento: Falta motor de saída de regimes suspensivos e evento das viagens,no regime específico. | Operacao discriminada do saldo anterior; e desenvolvimento nao demonstrado, nao regressao ou perda de fonte aceite.","Manter encerrado no âmbito de margem/eventos demonstrado, reutilizando provas. Conservar ligação ao trabalho fiscal restante em AUD-SIM-INT02: apuramento/liquidação, deduções e regularizações próprias não concluídos por esta entrega.","Snapshot/API/dossier, moeda, datas UTC, histórico e motor de exigibilidade8 existentes; viagem classificada associada à mesma oportunidade, sem copiar edições deliberadas.","Destino autenticado e backup/restauro; sem migração, alteração de permissões, importação/publicação documental ou ensaio sintético no activo.","RIVA Decreto7/2008,38–46,acervoBR16-I16/04/2008PDF6–8/p104–106 (6/7 conferidas visualmente,46(2) texto extraídoPDF8). CIVA Lei13/2016,4(5)/5(2),PDF7/p1426(265);7(8)/(9)/8,PDF9/p1426(267);14(1),PDF13/p1426(271),páginas visualmente conferidas. CIVA17(1),Lei22/2022PDF3,16% usado no divisor da base;Lei10/2025não altera4/7/8/17. Não confundir regime fiscal com licenciamento turístico.","Desenvolvimento, QA e entrega conjunta concluídos no âmbito de margem/eventos; IVA devido/dedução não calculados e trabalho restante rastreável.",Sem esforço de entrega pendente neste recorte; não representa fecho ou estimativa do restante trabalho fiscal.,Cotejo documental e revisao do codigo; candidato544068e8 preservado. Sem ensaio funcional deste ramo. | C:\laragon\www\portal-investidor\outputs\iva-l1-travel-events-20261025\preservation-before-tests.json | docs\investmoz\simulations\iva-l1-travel-events-qa-20261025.json | iva_l1_travel_events_P129_P133_homologation_20261025:24marcadores/6hashes/simuladorHTTP200;174tabelas/369ficheiros/29fichas/28relações/408geometrias;provasQA reutilizadas;fiscal_continuity:AUD-SIM-INT02,Viagens e eventos P129/P133,25/10/2026 — entrega conjunta a48e9749,"{""article"": ""7(8–9)"", ""source"": ""CIVA2016 PDF8–9 e alterações aplicáveis"", ""scope"": ""2026 somente quando condicoes e periodo aplicavel forem determinados"", ""next_increment"": ""L1-R1P: período fiscal efectivo, distinto de mês orçamental""}",,,,,,,,,Nao confundir prova dos dez tratamentos anteriores com cobertura deste ramo.,,,,Entregue na homologação a48e9749 no âmbito demonstrado;L1 aberto
 INE-DEMO-01,"Integração nacional de dados demográficos INE na viabilidade existente, importador em duas etapas, séries/versionamento, comparação territorial e adenda nacional.",Pedido colado pelo proprietário nesta sessão; execução expressamente confirmada; Macate/Vanduzi autorizados apenas em QA em 13/11/2026.,Território; viabilidade; percurso; SWOT; simulador,/localizacoes/demografia; /api/v1/investment/demography; /management/demography,DemographicImport; DemographicEvidence; leitor XLSX; cadastro/mapa/comparação/simulador e fontes SWOT existentes reutilizados.,"Homologação:4988ca89 instalado,erro500 de processos corrigido;preparaçõesCLI12/920456 privadas,por confirmaçãoMFA. Local:12lotes/920456 instalados e verificados.","154706 observações reais INE; três originais com scan real/hash; repetição sem duplicação; 72 reconciliações entre exemplares; comparação GONDOLA/GURO. Homologação: backup/restauro190 tabelas/369 ficheiros;11 tabelas de negócio preservadas;168 correspondências+15 distritos autorizados,sem pendências;HTTPS200 e revisão b20068d0 confirmada. Correcção df543a44:3testes/17asserções;HTTPS confirma revisão;ambos os titulares designados passam a autorização de leitura;nenhuma permissão alterada;hashes de código/configuração conferidos. Correcção500:2testes/20asserções sem proc_open;14testes/52asserções consumidores;8preparador;PHPStan aprovado. PHP-FPM real confirmou processos bloqueados,cacheCLI e antimalware disponíveis,hashes correctos,sem actor/sessão ou escrita de negócio;HTTPS confirma4988ca89.",Código instalado e verificado no PHP-FPM real;incorporação remota dos dados pendente da confirmação autenticada.,"Confirmar coortes initial/remaining/zambezia na sessão com MFA e conferir recibos,12 lotes/920456 observações e consulta territorial. Conferência visual administrativa pendente.",PostgreSQL/PostGIS QA; ClamAV; Python stdlib; autenticação e MFA existentes; nenhum novo aprovador.,"Três ficheiros associados aos territórios, valores exactos, séries 2017–2050, consulta sectorial/temporal, duas localizações, fontes/versões, inconsistências e acessos demonstrados em QA. Homologação manual restante registada no relatório.",Alta,,,,,"Consulta pública desktop/mobile conferida; visual administrativa pendente, testes HTTP aprovados.",11 testes de integração aprovados.,Três lotes QA; 154706 observações; idempotência e unicidade verificadas.,Consulta por território/ano/exemplar; desactivação/reaprovação preservam histórico.,"População/idade/residência, vitais, fontes e limitações; sem extrapolação, procura automática ou probabilidade de sucesso.",,,,,"Sem pendência de importação dos ficheiros provinciais fornecidos. Conferência visual administrativa,ressalvas/unidades ausentes e indicadores sem valores mantidos;outros ambientes não instalados por esta operação.","PortalProfileInstallation/MFA existentes; DemographicInstallation; DemographicImport; InvestmentGeography; simulador, mapa/comparação e fontes SWOT existentes.",,Proprietário executou a disponibilização autorizada de Zambezia.xlsx e cinco distritos;recibo autenticado e resultado confirmados sem repetição.,,,"outputs/demography-20261113/zambezia/installation-status.json e verification.json:recibo autenticado09:33:38UTC,hash/lote/count126684,total12lotes/920456,preservação11lotes e oito tabelas de negócio,série provincial e cinco distritos públicos. operational-status.json actualizado;ensaios e backup/restauro anteriores preservados.",demografia-ine,13/11/2026 — instalação autenticada concluída; conferência técnica de leitura sem repetição da operação,,,,,,,,,,,,,,
-REL-DOSSIER-20261113,"Agrupar no dossier correspondente os relatórios produzidos pelas etapas, com versão, oportunidade e recuperação.",Pedido expresso do proprietário em 13/11/2026: «tem de ser resolvido».,Percurso do investidor; dossier; relatórios,/investimentos/{id}#relatorios; /investimentos/{id}/relatorios/fiscais/{reportId},"Índice e relatório consolidado no percurso existente; reutiliza os geradores Word/HTML, cálculos e cópias preservadas.",QA implementado; esta alteração ainda não instalada na homologação.,21 testes frontend; recuperação e isolamento com 45 asserções em QA; originais e histórico preservados.,Implementado em QA; instalação pendente,Instalar o delta autorizado e conferir visualmente o uso normal. Não encerra funcionalidades ainda inexistentes noutros módulos.,,"Mesmo dossier/oportunidade → índice por etapa → relatório Word/HTML → acesso a versões APIEX, fiscais e documentos → recuperação sem misturar oportunidades ou expor finanças a gestores.",Alta,,,,,Índice responsivo e exportação consolidada,"Descarga privada da cópia fiscal preservada, autorizada por titular e dossier","Reutiliza os registos existentes; associação fiscal nova conserva âmbito, sem reescrever fontes anteriores.",Aprovada em prova sintética; sem depender de acesso à simulação anónima original.,Versão/data/estado/origem; pendências e âmbito por confirmar explícitos.,,,,,,,,"Acrescentar índice e consolidar saídas existentes; sem módulo paralelo, publicação ou envio automático.",Instalação e conferência; implementação QA concluída,,outputs/dossier-reports-20261113/,,,,,,,,,,,,,,,,
+REL-DOSSIER-20261113,"Agrupar no dossier correspondente os relatórios produzidos pelas etapas, com versão, oportunidade e recuperação.",Pedido expresso do proprietário em 13/11/2026: «tem de ser resolvido».,Percurso do investidor; dossier; relatórios,/investimentos/{id}#relatorios; /investimentos/{id}/relatorios/fiscais/{reportId},"Índice e relatório consolidado no percurso existente; reutiliza os geradores Word/HTML, cálculos e cópias preservadas.",Homologação teste-investidor.tempo.co.mz instalada em 07182c7c; /investimentos/{id}#relatorios.,"21 testes frontend; regressão servidor 4/168 asserções e caso final 45 asserções; tipos,lint,PHPStan e build aprovados. HTTPS e preservação conferidos na revisão instalada.",Consolidado instalado em 07182c7c; resumos por etapa conferidos em QA; delta sem instalação,Novo dossier sintético: 19 consultas e 38 descargas reais Word/HTML conferidas; recuperação após actualização. Falta instalar o delta por etapa; saídas específicas ainda não produzidas mantêm o saldo próprio.,,"Mesmo dossier/oportunidade → índice por etapa → relatório Word/HTML → acesso a versões APIEX, fiscais e documentos → recuperação sem misturar oportunidades ou expor finanças a gestores.",Alta,,,,,Índice responsivo e exportação consolidada,"Descarga privada da cópia fiscal preservada, autorizada por titular e dossier","Reutiliza os registos existentes; associação fiscal nova conserva âmbito, sem reescrever fontes anteriores.",Aprovada em prova sintética; sem depender de acesso à simulação anónima original.,Versão/data/estado/origem; pendências e âmbito por confirmar explícitos.,,,,,,,,"Acrescentar índice e consolidar saídas existentes; sem módulo paralelo, publicação ou envio automático.",Consulta e descargas por etapa concluídas em QA; instalação do novo delta pendente,,outputs/dossier-reports-20261113/verification.json; outputs/dossier-reports-20261113/homologation-installed.json; outputs/dossier-reports-20261113/stage-authenticated-download-verification.json,,,,,,,,,,,,,,,,
 ACT-20261113-PESQUISA,Pesquisa rápida: contar corredores sem misturar referências; produtos físicos e financeiros separados por categoria e localização; como licenciar empresa.,Pedidos Tempo na conversa de 13/11/2026,Pesquisa rápida,/pesquisa; /,"SearchTerms::requestIntent, GlobalSearchController, FederatedSearch, portal/search, portal-hero; reutiliza catálogos publicados existentes.",Implementado em QA; nova candidata ainda não instalada.,"outputs/quick-search-20261113/: integration.log, regression.log, unit.log, frontend.log, types.log, analysis.log, build.log",QA implementado e testes focados aprovados; instalação e visual pendentes,Instalar após autorização concreta; conferir apresentação no navegador.,,Contagem tipada e zero distinto de falha; produtos separados com localização/cobertura e contexto nos links; licenciamento no roteiro/dossier existentes; só publicados; erros de fontes explícitos; paginação preservada.,Alta,,,,,,,,,,,,,,"Conferência visual e instalação desta candidata; pesquisa territorial é textual, sem inferir elegibilidade.",,,,Implementação QA concluída neste recorte; entrega preparada.,,,,,,,,,,,,,,,,,,
@@ -1,6 +1,7 @@
-import { useState } from 'react';
+import { useEffect, useState } from 'react';
 import {
    createInvestorDossierReport,
+    createInvestorStageReport,
    investorDossierReportIndex,
    type InvestorDossierReportInput,
 } from '@/lib/investor-dossier-report';
@@ -13,9 +14,33 @@ export function InvestorDossierReports({
    dossier,
 }: {
    dossier: InvestorDossierReportInput;
+}) {
+    return (
+        <InvestorDossierReportsContent
+            key={`${dossier.case.id}:${dossier.case.version}:${dossier.context_opportunity ?? ''}`}
+            dossier={dossier}
+        />
+    );
+}
+
+function InvestorDossierReportsContent({
+    dossier,
+}: {
+    dossier: InvestorDossierReportInput;
 }) {
    const [busy, setBusy] = useState(false);
    const [error, setError] = useState('');
+    const [stage, setStage] = useState('');
+    const [download, setDownload] = useState<{
+        url: string;
+        name: string;
+    } | null>(null);
+    useEffect(
+        () => () => {
+            if (download) URL.revokeObjectURL(download.url);
+        },
+        [download],
+    );
    const requiresChoice =
        dossier.opportunity_options.length > 1 && !dossier.context_opportunity;
    const entries = requiresChoice ? [] : investorDossierReportIndex(dossier);
@@ -23,7 +48,9 @@ export function InvestorDossierReports({
        setBusy(true);
        setError('');
        try {
-            const model = createInvestorDossierReport(dossier);
+            const model = stage
+                ? createInvestorStageReport(dossier, stage)
+                : createInvestorDossierReport(dossier);
            const blob =
                format === 'word'
                    ? await generateProjectDossierDocx(model, [], true)
@@ -38,11 +65,8 @@ export function InvestorDossierReports({
                          { type: 'text/html;charset=utf-8' },
                      );
            const url = URL.createObjectURL(blob);
-            const link = document.createElement('a');
-            link.href = url;
-            link.download = `dossier-${dossier.case.id}-v${dossier.case.version}-${dossier.context_opportunity ? encodeURIComponent(dossier.context_opportunity) : 'comum'}.${format === 'word' ? 'docx' : 'html'}`;
-            link.click();
-            window.setTimeout(() => URL.revokeObjectURL(url), 1000);
+            const name = `dossier-${dossier.case.id}-v${dossier.case.version}-${dossier.context_opportunity ? encodeURIComponent(dossier.context_opportunity) : 'comum'}${stage ? `-${stage}` : ''}.${format === 'word' ? 'docx' : 'html'}`;
+            setDownload({ url, name });
        } catch (cause) {
            setError(
                cause instanceof Error
@@ -72,22 +96,61 @@ export function InvestorDossierReports({
                </p>
            ) : (
                <>
+                    <label className="block">
+                        Relatório a consultar e descarregar
+                        <select
+                            className="mt-1 block w-full rounded border p-2"
+                            value={stage}
+                            disabled={busy}
+                            onChange={(event) => {
+                                setStage(event.target.value);
+                                setDownload(null);
+                            }}
+                        >
+                            <option value="">Dossier completo</option>
+                            {dossier.steps.map((step) => (
+                                <option key={step.code} value={step.code}>
+                                    {step.code} — {step.title}
+                                </option>
+                            ))}
+                        </select>
+                    </label>
+                    {stage && (
+                        <StageReportPreview dossier={dossier} stage={stage} />
+                    )}
                    <div className="flex flex-wrap gap-3">
                        <button
                            className="rounded border px-3 py-2"
                            disabled={busy}
                            onClick={() => exportReport('word')}
                        >
-                            Descarregar relatório consolidado (Word)
+                            Preparar{' '}
+                            {stage
+                                ? `relatório ${stage}`
+                                : 'relatório consolidado'}{' '}
+                            (Word)
                        </button>
                        <button
                            className="rounded border px-3 py-2"
                            disabled={busy}
                            onClick={() => exportReport('html')}
                        >
-                            Descarregar versão para impressão/PDF
+                            Preparar versão para impressão/PDF
                        </button>
                    </div>
+                    {busy && <p role="status">A preparar o ficheiro…</p>}
+                    {download && (
+                        <p role="status">
+                            Ficheiro pronto.{' '}
+                            <a
+                                className="font-medium underline"
+                                href={download.url}
+                                download={download.name}
+                            >
+                                Descarregar {download.name}
+                            </a>
+                        </p>
+                    )}
                    <p className="text-sm">
                        A versão HTML pode ser aberta e impressa ou guardada
                        como PDF. As descargas são privadas; não enviam
@@ -163,3 +226,46 @@ export function InvestorDossierReports({
        </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>
+            ))}
+            {report.limitations.map((text) => (
+                <p className="text-sm" key={text}>
+                    {text}
+                </p>
+            ))}
+        </article>
+    );
+}
@@ -552,3 +552,63 @@ export function createInvestorDossierReport(
        ],
    };
 }
+
+/** A preparation summary, never a substitute for an external act or its original. */
+export function createInvestorStageReport(
+    input: InvestorDossierReportInput,
+    stageCode: string,
+    generatedAt = new Date().toISOString(),
+): 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 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'] : []),
+        ...(['S06', 'S07'].includes(stageCode) ? ['sources'] : []),
+    ]);
+    return {
+        ...report,
+        title: `${input.case.title} — ${stageCode}: ${step.title}`,
+        version: `${report.version} · etapa v${step.version ?? 'não registada'}`,
+        limitations: [
+            ...report.limitations,
+            'Resumo dos registos disponíveis nesta etapa; não cria documentos, decisões ou resultados em falta.',
+        ],
+        sections: report.sections
+            .filter(
+                (section) =>
+                    ['project', 'summary', 'execution', 'resources'].includes(
+                        section.id,
+                    ) || specificSections.has(section.id),
+            )
+            .map((section) => {
+                if (section.id === 'summary')
+                    return {
+                        ...section,
+                        rows: section.rows.filter((item) =>
+                            origins.has(item.origin),
+                        ),
+                    };
+                if (section.id === 'execution')
+                    return {
+                        ...section,
+                        rows: section.rows.filter((item) =>
+                            item.field.startsWith(`${stageCode} —`),
+                        ),
+                    };
+                if (section.id === 'resources')
+                    return {
+                        ...section,
+                        rows: section.rows.filter((item) =>
+                            origins.has(item.origin),
+                        ),
+                    };
+                return section;
+            }),
+    };
+}
@@ -396,6 +396,11 @@ export async function generateProjectDossierDocx(
            ],
        }),
    ];
+    for (const limitation of model.limitations) {
+        children.push(
+            new Paragraph({ children: [new TextRun({ text: limitation })] }),
+        );
+    }
    for (const section of model.sections) {
        if (section.id === 'annexes') {
            if (!attachments.some((item) => item.include)) {
@@ -591,6 +596,8 @@ export async function createProjectDossierPrintHtml(
    annexesIncluded: boolean,
 ): Promise<string> {
    const content: string[] = [];
+    for (const limitation of model.limitations)
+        content.push(`<p>${escapeHtml(limitation)}</p>`);
    for (const section of model.sections) {
        if (
            section.id === 'annexes' &&
@@ -0,0 +1,99 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import JSZip from 'jszip';
+import { createInvestorStageReport } from '../../resources/js/lib/investor-dossier-report.ts';
+import {
+    createProjectDossierPrintHtml,
+    generateProjectDossierDocx,
+} from '../../resources/js/lib/project-dossier-report.ts';
+
+const input = {
+    case: {
+        id: 'synthetic-stage-dossier',
+        title: 'Ensaio sintético',
+        version: 3,
+    },
+    context_opportunity: null,
+    opportunity_options: [],
+    investment_context: {
+        revision: 1,
+        fields: { project_title: 'Fábrica sintética', province: 'Sofala' },
+    },
+    phases: { 1: 'Preparação sintética' },
+    results: [],
+    documents: [],
+    steps: Array.from({ length: 19 }, (_, i) => ({
+        code: `S${String(i + 1).padStart(2, '0')}`,
+        title: `Etapa sintética ${i + 1}`,
+        phase: 1,
+        version: i + 2,
+        state: 'preparing',
+        reason: `Fundamento sintético exclusivo ${i + 1}.`,
+        detail: { recorded_at: '2026-11-13' },
+    })),
+};
+
+void test('all 19 stage reports can be consulted and exported without inventing outcomes or changing source data', async () => {
+    const before = JSON.stringify(input);
+    for (const step of input.steps) {
+        const model = createInvestorStageReport(
+            input,
+            step.code,
+            '2026-11-13T15:00:00Z',
+        );
+        assert.match(model.title, new RegExp(step.code));
+        const execution = model.sections.find((s) => s.id === 'execution');
+        assert.equal(execution.rows.length, 1);
+        assert.ok(execution.rows[0].value.includes(step.reason));
+        assert.ok(
+            model.sections
+                .find((s) => s.id === 'summary')
+                .rows.every((r) => r.field.startsWith(step.code)),
+        );
+        assert.ok(
+            !model.sections.some((s) => s.id === 'finance') ||
+                step.code === 'S03',
+        );
+        const html = await createProjectDossierPrintHtml(model, [], true);
+        assert.ok(html.includes(step.reason));
+        assert.ok(html.includes('synthetic-stage-dossier'));
+        const blob = await generateProjectDossierDocx(model, [], true);
+        const zip = await JSZip.loadAsync(await blob.arrayBuffer());
+        const xml = await zip.file('word/document.xml').async('string');
+        assert.ok(xml.includes(step.reason));
+        assert.ok(xml.includes('não cria documentos'));
+    }
+    assert.equal(JSON.stringify(input), before);
+    assert.throws(
+        () => createInvestorStageReport(input, 'S99'),
+        /não encontrada/,
+    );
+    assert.throws(
+        () =>
+            createInvestorStageReport(
+                { ...input, opportunity_options: ['a', 'b'] },
+                'S01',
+            ),
+        /Seleccione/,
+    );
+});
+
+void test('exported limitations retain literal text and cannot inject active HTML', async () => {
+    const model = createInvestorStageReport(input, 'S08');
+    model.limitations.push('Limite <script>alert(1)</script> & origem');
+    const html = await createProjectDossierPrintHtml(model, [], true);
+    assert.ok(
+        html.includes(
+            'Limite &lt;script&gt;alert(1)&lt;/script&gt; &amp; origem',
+        ),
+    );
+    assert.ok(!html.includes('<script>alert(1)</script>'));
+    const zip = await JSZip.loadAsync(
+        await (await generateProjectDossierDocx(model, [], true)).arrayBuffer(),
+    );
+    assert.ok(
+        (await zip.file('word/document.xml').async('string')).includes(
+            'Limite &lt;script&gt;alert(1)&lt;/script&gt; &amp; origem',
+        ),
+    );
+});