4.9 KiB
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ênciasdocxejszip.
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 opcionalfontaineausente e chunks grandes superiores a 500 kB.- O teste abriu o
.docxcomo ZIP OpenXML, confirmou texto português acentuado, tabelas e campo de página. Um PNG de teste foi encontrado emword/media, referenciado emdocument.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,sofficeelibreofficenã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.