Files
Investidor-V2/docs/investmoz/simulations/project-dossier-report-2026-10-04.md
T
nala e65cb26901
tests / ci (push) Canceled after 0s
varias alteracoes
2026-10-06 14:50:12 +02:00

4.9 KiB

Relatório consolidado do projecto — implementação

Data: 04/10/2026
Estado: implementação local concluída; paginação final em Microsoft Word/PDF aguarda verificação visual numa aplicação Office.

Entrega

  • O percurso de revisão do simulador oferece relatório Word .docx, preparação para PDF pelo diálogo de impressão do browser e CSV complementar. O relatório é gerado no dispositivo; não publica nem envia conteúdo.
  • O utilizador escolhe as secções e os anexos. A interface assinala que cada secção e anexo pode conter informação privada e permite excluir ficheiros individualmente.
  • O documento combina campos do dossier, snapshots financeiros e resultados do simulador já existentes. Identifica revisão, data e, quando presente, versão, referência, fórmula, explicação e hash do cálculo guardado. Não volta a calcular o snapshot fiscal.
  • Valores desconhecidos ficam como “Não informado” ou “Indeterminado”. Informação de mercado declarada, estimativas matemáticas e referências/catálogos são identificados separadamente. Financiamento sem catálogo e critérios documentados permanece indeterminado.
  • PNG/JPEG são incorporados com legenda; dimensões inválidas ou acima de 40 megapixels/12.000 px por lado são rejeitadas antes da incorporação. CSV/TSV e TXT são incorporados com limites de tamanho; PDF, DOCX, XLSX, ODT e restantes formatos permanecem originais no ZIP, com índice que informa explicitamente que não foram incorporados.
  • O pacote ZIP inclui o Word, anexos seleccionados e índice. Limites: 10 ficheiros, 15 MB por ficheiro e 50 MB no total. Texto incorporado limita-se a 2 MiB; tabelas no Word limitam-se a 250 linhas e 16 colunas, preservando o original integral no ZIP.

Ficheiros alterados/criados nesta funcionalidade

  • resources/js/lib/project-dossier.ts: partilha a construção das linhas entre relatório e CSV e expõe pressupostos/resultados financeiros existentes.
  • resources/js/lib/project-dossier-report.ts: modelo, classificação de proveniência, geração DOCX, HTML para impressão/PDF, incorporação de anexos e ZIP indexado.
  • resources/js/components/project-dossier-export.tsx: selecção de secções/anexos, sinalização de privacidade e acções de exportação.
  • resources/js/components/simulation-form.tsx: integração na revisão do dossier com a versão actual e os snapshots existentes.
  • tests/frontend/project-dossier-report.test.mjs: testes de relatório incompleto, reconciliação financeira, versão/hash, OpenXML, acentos, tabelas, imagem e legenda, ZIP, escape HTML e limites.
  • package.json, package-lock.json: dependências docx e jszip.

Validação executada

  • npm.cmd run types:check — passou.
  • node --test tests/frontend/*.test.mjs — 138/138 passaram.
  • npm.cmd run build — passou; compilou 2.403 módulos. O build assinala dependência opcional fontaine ausente e chunks grandes superiores a 500 kB.
  • O teste abriu o .docx como ZIP OpenXML, confirmou texto português acentuado, tabelas e campo de página. Um PNG de teste foi encontrado em word/media, referenciado em document.xml.rels, e a legenda apareceu no XML do documento.
  • Chromium headless gerou uma pré-visualização A4 de 8 páginas com 90 linhas financeiras sintéticas; título e acentos estavam presentes, sem overflow horizontal. O PDF foi mantido em memória e descartado. Evidência: docs/investmoz/simulations/project-dossier-print-qa-2026-10-04.json.
  • winword, soffice e libreoffice não estão instalados/disponíveis neste Windows. A paginação do HTML de impressão foi ensaiada em Chromium, mas não se declara abertura/renderização final do DOCX em Microsoft Word/LibreOffice, impressão física ou abertura do CSV numa folha de cálculo nesta entrega.

Limitações e revisão pendente

  • PDF usa a janela de impressão do browser; o utilizador escolhe “Guardar como PDF”. Não é criado automaticamente um ficheiro PDF a partir do Word.
  • Fotografias e tabelas compatíveis ficam dentro do DOCX. Para formatos não incorporáveis, é necessário transferir o pacote ZIP para obter o original e o índice; a ligação nominal no relatório não é apresentada como anexo incorporado.
  • A paginação pode variar entre versões de Word e browsers. Rever o ficheiro DOCX em Microsoft Word ou LibreOffice, especialmente relatórios longos, tabelas largas e imagens antes de considerar a apresentação tipográfica aprovada.
  • A lista de anexos fornecida é local à sessão do formulário; só é incluída se o utilizador a seleccionar no momento da exportação. O CSV continua disponível separadamente e não inclui automaticamente imagens/anexos.

Rollback

Reverter apenas os ficheiros desta funcionalidade e as dependências docx/jszip dos manifestos. Não há migration, escrita de dados, alteração de configuração de infraestrutura ou upload de ficheiros associado a esta entrega.