43 lines
4.9 KiB
Markdown
43 lines
4.9 KiB
Markdown
# 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.
|