feat(documents): renderização real de PDF via Chromium headless

Substitui a geração de PDF simulada (pdf_s3_key/pdf_sha256/pdf_size_bytes
sempre nulos) por Chromium real (Playwright), portado do
chromiumPdfRenderer.js do legado: SSRF impossível por construção
(setContent + bloqueio de toda requisição de rede da página), browser
único reaproveitado com relançamento automático, semáforo de
concorrência + timeout duro.

Infra: MinIO (compose.yaml, primeiro consumidor real do adapter S3) e
instalação condicional do Chromium só na imagem da API
(Dockerfile.node). DocumentsService.createGeneration agora renderiza,
faz upload e persiste hash/tamanho de verdade; novo endpoint de
download GET /v1/documents/generations/:id/pdf.

Verificado ao vivo através do container real: PDF gerado, baixado, e
SHA-256 conferido byte a byte contra o valor persistido no Postgres.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BcWWuKfykGtUweXmHD6cKx
This commit is contained in:
2026-09-04 09:26:31 -03:00
parent 4d23af3b23
commit 29430d0d96
13 changed files with 486 additions and 15 deletions

View File

@@ -68,6 +68,11 @@ SMTP_PASS=
SMTP_FROM=
# --- S3 / storage de objetos (compatível MinIO ou AWS S3) ---
# Usando o serviço eden-minio do compose.yaml (bundled, sobe junto com o
# resto): endpoint é http://eden-minio:9000, e as credenciais abaixo viram
# MINIO_ROOT_USER/MINIO_ROOT_PASSWORD desse container — gerar com
# openssl rand -hex 12 / openssl rand -hex 24. Usando AWS S3 real: apagar
# S3_ENDPOINT (deixar em branco) e usar as credenciais IAM normais.
S3_ENDPOINT=
S3_REGION=us-east-1
S3_FORCE_PATH_STYLE=true
@@ -78,6 +83,13 @@ S3_BUCKET=
# --- URL pública base (usada para montar links absolutos em e-mails) ---
PUBLIC_BASE_URL=http://localhost:3001
# --- Renderização de PDF (Chromium headless via Playwright) ---
# Usado por documentos, PDF de oferta/orçamento (ANATEL) e certificado de
# assinatura — packages/integrations/src/pdf/renderer.ts. Concorrência
# limitada (cada aba do Chromium consome memória real) e timeout obrigatório.
PDF_MAX_CONCURRENCY=3
PDF_RENDER_TIMEOUT_SECONDS=15
# --- Integrações externas (preenchidas quando cada adapter for implementado) ---
FOCUS_NFE_API_TOKEN=
FOCUS_NFE_BASE_URL=