Sistema Verificável de Apresentação PDF Institucional e Visualização de Dados
Este skill trabalha em conjunto com verifiable-pdf-pipeline (integridade de dados) e editorial-page-layout-guidelines (geometria de grade) para produzir decks de slides escuros 16:9 e relatórios institucionais claros em formato Carta (Swiss ivory) de qualidade de publicação, inspirados por McKinsey, Stripe Press, WEF e The Economist.
1. Invariante Central: Substância Antecede Estética
Toda apresentação ou relatório construído com este skill deve obedecer às 10 Regras Rígidas Anti-Fraude definidas em verifiable-pdf-pipeline/SKILL.md:
- Zero Interrupção de Dados Manuscritos — analisar todos os números de arquivos brutos imutáveis em
data/raw/. - Compilador de Realidade & Invariantes — impor limites de domínio Pydantic e identidades contábeis.
- Verificação Anti-Circular — re-computação independente de arquivo bruto + verificação AST Python proibindo asserções literais codificadas.
- Ledger de Proveniência Atômica — cada escalar publicado mapeado 1:1 em
data/provenance_ledger.json. - Capacidade Negativa & O Sagrado "N/A" — nulos genuínos upstream são renderizados explicitamente como
[N/A], nunca como proxies fabricados. - Trava de Compilação — compiladores PDF invocam
verify_integrity.pye abortam em saída não zero. - Guarda de Categoria & Unidade — nunca misturar escopos ou métodos de teste incomensuráveis.
- Prova Estatutária — IDs de diário oficial necessários para qualquer alegação regulatória/tarifária.
- Taxonomia Científica & Verificação de Registro — reconciliar binômios, autoridades, filogenia e status IUCN textualmente contra registros vivos do GBIF/OpenTree/iNaturalist.
- Fundamentação de Prosa Pós-Renderização (
vedit prose) — cada numeral renderizado no PDF final rastreia de volta paraprovenance_ledger.json,summary_metrics.jsonou uma entrada com DOI embackground_citations.json.
2. As 4 Leis Douradas de Design
Lei 1: A Hierarquia de Cores 60-30-10 (Modos Claro & Escuro)
- Modo Editorial Suíço Claro (Relatórios Carta):
60%Tela: Marfim Suíço Quente (#fcfbf9) — pintado explicitamente viaonPage.30%Estrutura: Azul Marinho Profundo (#0f2b48), Ardósia (#334155), Aço (#64748b), Hairlines (#cbd5e1), Matiz Sutil (#f1f5f9).10%Destaque de Sinal: Cobalto (#0284c7), Âmbar (#d97706), Esmeralda (#059669), Carmim de Sinal (#dc2626— apenas risco/surto).
- Modo Executivo Escuro (Decks de Slides 16:9):
60%Tela: Obsidiana Profunda (#0b0f19) ou Azul Marinho Meia-Noite (#051c2c) — DEVE ser pintado full-bleed emonFirstPage/onLaterPagesANTES de os flowables renderizarem, nunca confiando no papel PDF branco padrão!30%Estrutura & Texto de Alto Contraste: Faixa Tonal Sutil (#111827/#0a253a), Hairlines (#243247), Títulos Branco Puro (#ffffff), Corpo Leve Nítido (>= #e2e8f0a>= 9.5–10 pt), Legendas Secundárias (>= #cbd5e1, nunca prosa escura#64748b–#94a3b8). Sempre colocar um fundo escuro horizontal sutil atrás da tipografia da capa quando ondas paramétricas de wireframe ou arte brilhante estiverem próximas ao texto.10%Destaque de Sinal: Cobalto Elétrico (#38bdf8), Âmbar Brilhante (#fbbf24), Esmeralda (#34d399), Carmim de Sinal (#f87171).
Lei 2: Hairline & Gravidade do Espaço em Branco (Zero Cartões com Caixas)
- Nunca prender métricas ou prosa dentro de traços pesados de
BOXretangular ouINNERGRIDde painéis web. - Agrupar KPIs e chamadas via faixas tonais sem bordas (
#111827escuro /#f1f5f9claro) coroadas com uma hairline de destaque superior de1.2 pt, generosas margens de coluna de12–16 pte ledgers Tufte estilo booktabs (zero linhas verticais).
Lei 3: Títulos de Ação da Pirâmide Minto
Cada slide ou seção de relatório abre com uma afirmação completa e assertiva, não um rótulo de tópico passivo:
- Proibido:
"Tendências Globais de Emissões" - Obrigatório:
"Países da OCDE-5 Reduziram Emissões em -25.0%, Mas Mercados Emergentes-3 Aumentaram +235.8% Elevando o Total do Painel para 23.52 Gt CO2e."
Lei 4: Orçamentos de Preenchimento Vertical Calibrados + Inspeção Visual
- Relatórios Carta (
612×792 pt): Preenchimento vertical alvo de85%–92%(mín >= 82%). - Decks 16:9 (
960×540 pt): Preenchimento vertical alvo de72%–88%(mín >= 72%). - Nunca tratar uma passagem automatizada como palavra final: exportar prévias PNG de 180 DPI via
audit_pdf.pye inspecionar visualmente cada página renderizada para sobreposição de rótulos, quebras de linha em títulos e equilíbrio óptico.
3. Receitas de Visualização de Dados Institucionais (300 DPI, Transparentes)
Renderizar todos os gráficos com dpi=300, transparent=True, spines superior e direito removidos e paletas alinhadas ao tema (escuro vs claro):
- Série Temporal de Painel Duplo + Taxa de Aceleração: Trajetória histórica mensal/diária com sombreamento de eventos e anotações diretas de início/pico, emparelhada com barras de taxa decenal/período.
- Área de Equilíbrio de Massa Empilhada + Trajetória Indexada: Volumes de fluxo empilhados com rótulos terminais de borda direita (zero caixas de legenda flutuantes separadas!) emparelhados com linhas de divergência estrutural
Base = 100. - Dispersão de Quadrante de Desacoplamento + Dumbbell de Compressão: Dispersão 2D de crescimento-vs-resultado com quadrante alvo sombreado + setas de líder para clusters apertados, emparelhada com dumbbells horizontais de linha de base para atual.
- Gráficos de Bala Horizontais Stephen Few: 3 bandas de fundo qualitativas + barra de desempenho primária + marca de alvo/baseline vertical âmbar + texto delta alinhado à direita (spine do eixo x aparado usando
ax.spines["bottom"].set_bounds(...)). - Sparklines Tufte Headless in-memory: Micro-linhas
46–66 pt × 13–16 ptrenderizadas em buffersio.BytesIO()e incorporadas diretamente em células de tabela ReportLab com pontos terminais semânticos esmeralda/carmim. - Heatmap de Matriz Origem-Destino & KDEs Ridgeline: Paleta sequencial com tipografia dupla de contraste alternado ou cristas de distribuição sobrepostas marcando $P_{50}$ e $P_{90}$.
4. Padrões de Implementação ReportLab de Produção
4.1 Pintura de Tela Full-Bleed (Crítico para Temas Escuros & Marfim)
Sempre registrar um callback onPage para que o fundo da tela pinte sob cada flowable em cada página:
from reportlab.lib import colors
def paint_background(canv, _doc, bg_hex="#0b0f19", accent_hex="#38bdf8", page_w=960.0, page_h=540.0):
canv.saveState()
canv.setFillColor(colors.HexColor(bg_hex))
canv.rect(0, 0, page_w, page_h, fill=1, stroke=0)
if canv.getPageNumber() == 1:
canv.setFillColor(colors.HexColor(accent_hex))
canv.rect(0, page_h - 4, page_w, 4, fill=1, stroke=0)
canv.restoreState()
4.2 Descoberta Segura da Fonte Inter com Fallback Limpo
Nunca codificar "Inter-SemiBold" sem registrar o TTF primeiro — usar um helper que verifica INTER_FONT_DIR e caminhos de fonte padrão do SO e faz fallback limpo para Helvetica:
import os
from pathlib import Path
from reportlab.pdfbase import pdfmetrics
from reportlab.pdfbase.ttfonts import TTFont
def register_editorial_fonts() -> dict[str, str]:
search = [Path(os.environ["INTER_FONT_DIR"])] if os.environ.get("INTER_FONT_DIR") else []
search += [Path.home() / "Library/Fonts", Path("/Library/Fonts"), Path("/usr/share/fonts/truetype/inter")]
files = {"regular": "Inter-Regular.ttf", "semibold": "Inter-SemiBold.ttf",
"bold": "Inter-Bold.ttf", "italic": "Inter-Italic.ttf", "bold_italic": "Inter-BoldItalic.ttf"}
found = {r: d / f for d in search if d.is_dir() for r, f in files.items() if (d / f).is_file()}
if {"regular", "bold", "italic", "bold_italic"}.issubset(found):
for role, name in [("regular", "Inter-Regular"), ("bold", "Inter-Bold"),
("italic", "Inter-Italic"), ("bold_italic", "Inter-BoldItalic")]:
pdfmetrics.registerFont(TTFont(name, str(found[role])))
semi = "Inter-Bold"
if "semibold" in found:
pdfmetrics.registerFont(TTFont("Inter-SemiBold", str(found["semibold"])))
semi = "Inter-SemiBold"
pdfmetrics.registerFontFamily("Inter-Regular", normal="Inter-Regular", bold="Inter-Bold",
italic="Inter-Italic", boldItalic="Inter-BoldItalic")
return {"regular": "Inter-Regular", "semibold": semi, "bold": "Inter-Bold",
"italic": "Inter-Italic", "bold_italic": "Inter-BoldItalic", "mono": "Courier"}
return {"regular": "Helvetica", "semibold": "Helvetica-Bold", "bold": "Helvetica-Bold",
"italic": "Helvetica-Oblique", "bold_italic": "Helvetica-BoldOblique", "mono": "Courier"}
4.3 Cabeçalhos Correntes de Duas Passagens & Folhação Dinâmica
Usar uma subclasse de reportlab.pdfgen.canvas.Canvas salvando dicts de estado de página em showPage() e carimbando "Página X de Y" ou "Slide X / Y" em save() (veja examples/reportlab_premium_template.py).
5. Modo Flagship 2023 para Consultoria (WeasyPrint + SVG Vetorial Puro Inline)
Para decks de nível keynote modelados em publicações institucionais flagship de 2023 (Quantum Technology Monitor, The Economic Potential of Generative AI, Global Economics Intelligence, The State of Organizations), emparelhar WeasyPrint (@page { size: 960pt 540pt; margin: 0; }) com exposições 100% vetoriais puras inline <svg>:
- Cadência de Polaridade Herói-Escuro / Dados-Branco-Puro (Nunca Monótona):
- Herói de Capa: Azul Marinho Meia-Noite Profundo (
#051C2C) transicionando para Cobalto (#0A2E8A), sobreposto com uma onda de wireframe Bezier hiperbólica paramétrica de 42 fios (#2251FF/#00A9F4) e arte editorial limpa de herói à direita. - Sumário Executivo: Full-bleed
#051C2C, título serifado branco nítido28 ptsobre uma régua horizontal branca de1.2 pt, 3 colunas arejadas sem serifa e 3 KPIs serifados gigantes ciano/azul. - Divisores de Capítulo Divididos: Topo
48%arte luminosa full-bleed ancorada por um numeral serifado branco120 ptem negrito (1,2), fundo52%branco puro com título de capítulo serifado recuado220 ptà esquerda e cópia de enquadramento em 2 colunas. - Slides de Exposição de Dados: Tela
#FFFFFFpura, título de ação serifado em negrito19.5–22 ptacima de uma régua#051C2Cde1.1 pt, separador de nota de rodapé sutil no fundo e uma pílula de progresso de seção ciano-gelo#9AE6FFno canto inferior direito.
- Herói de Capa: Azul Marinho Meia-Noite Profundo (
- Emparelhamento de Serifa Editorial de Alto Contraste + Sem Serifa Geométrica:
- Serifa de Exibição (
Charter/Georgia/BaskervilleBold): Títulos de capa, numerais de seção, títulos de ação de slides, chamadas KPI gigantes54 pt#2251FFe totais de centro de donut. - Sem Serifa de Dados (
Inter/Helvetica Neue): Anotações de gráfico, subtítulos, células de ledger, notas de rodapé e cópia de implicações.
- Serifa de Exibição (
- A Rampa Cromática Azul McKinsey de 4 Camadas (Zero Desordem de Arco-Íris):
#051C2CAzul Marinho Meia-Noite (totais de âncora, linhas de base, contrações profundas) →#06319CAzul Real Profundo →#2251FFAzul Elétrico (deltas focais, grandes KPIs, surtos de expansão) →#00A9F4Ciano Vívido →#9AE6FFCiano Gelo (participações secundárias e pílulas de seção).
- Arquétipos de Exposição SVG Vetorial de Marca Registrada:
- Gráfico de Waterfall / Ponte de Equilíbrio de Massa: Barras de âncora (
#051C2C), adições flutuantes (#2251FF) e reduções (#00A9F4), conectores de degrau tracejados, chamadas de extensão de suporte quadrado no topo e delta líquido serifado flutuante. - Parede de Múltiplos Pequenos + Barra Lateral de Implicações Cinza
»: Cartões de trajetória indexada agrupados5 + 3emparelhados com uma barra lateral#EFEFEFà direita unida por um crachá de chevron»#051C2Ccircular (anel branco3 pt). - Matriz de Waffle de Quadrado Arredondado 10×10: Grades
10×10preenchidas de baixo para cima (trilho#E5E7EB, preenchimento azul de 4 camadas) com numerais em negrito centralizados dentro do espaço negativo cinza. - Anel de Donut + Mudança de Participação Empilhada 100%: Donut azul de 5 etapas (divisores de fatia branca
2 px, total central serifado) emparelhado com colunas2000vs2024ligadas por fitas de fluxo translúcidas. - Barreiras de Proteção SVG WeasyPrint: Dentro de flex containers, sempre dar ao
<svg>inlinewidth/heightexplícitos empt(e definir.slide { height: 539.5pt; break-after: page; break-inside: avoid; }) para evitar páginas de derramamento em branco de sub-pixel ou colapso SVG de300 px. Nunca usar SVG 2paint-order="stroke"em<text>no WeasyPrint (ele traça sobre o preenchimento do texto); usar deslocamentos de rótulo limpos ou um<rect>de fundo explícito.
- Gráfico de Waterfall / Ponte de Equilíbrio de Massa: Barras de âncora (
- Modo de Revista Editorial Fotográfica Full-Bleed (
612 × 792 ptCarta Retrato, WeasyPrint): Ao produzir revistas editoriais com foco em fotografia (estilo Kinfolk × Cereal × Condé Nast Traveler × National Geographic, conforme demonstrado emdemos/felis-mundi-magazine/):- Tipografia & Suporte de Papel: Combinar papel de arquivo quente não revestido (
#FAF8F5) e tinta de carvão carbono profundo (#161616) com serifas de exibição Didone de alto contraste (Didot/Bodoni 72), corpo de texto serifado de livro quente (Charter/Baskervillea9 pt,1.5×entrelinha) e metadados sem serifa em maiúsculas com tracking amplo (Inter,6.5–7 pt,+0.18emtracking). Inverter folios correntes e créditos perfeitamente para#FFFFFFpuro sobre fotografia full-bleed. - Fotografia Coesa (
>= 50%Sangria de Borda a Borda): Gerar cada chapa sob um Núcleo de Identidade de Filme Fotográfico Mestre bloqueado (vejareferences/image_generation_recipes.md§5), variar a arquitetura de espalhamento entre páginas adjacentes (capa 100% → sangria superior 61% → coluna vertical direita 65% → ensaio fotográfico 100% → díptico 76% com margens de impressão brancas4 pt→ sangria inferior 68% → tríptico de folha de contato 77% → colofão de crepúsculo de fechamento 100%) e creditar fotografia IA de forma transparente junto com um manifesto de chapa SHA-256. - Barreiras de Proteção WeasyPrint para Revista (Verificadas Empiricamente):
- Drop Caps (
float: left): Nunca colocar um drop capfloat: leftdentro de um item CSS Grid ou Flexbox no WeasyPrint 67.0 (ele encolhe a coluna de texto ou desloca/colide o drop cap). Usar colunas de blocoposition: absolute(display: block) para páginas de revista divididas para que os drop caps fiquem 100% flush-left com quebra de linha limpa em várias linhas. - Scrims de Gradiente Contínuo: Nunca colocar uma caixa de sobreposição
linear-gradientde altura parcial sobre céu brilhante ou neve no WeasyPrint (Cairo pinta uma costura de hairline de 1 px fraca ao longo da borda da caixa). Sempre dimensionar cada sobreposição de scrim para100%de seu container de foto e desvanecer parargba(..., 0)dentro dos stops transparentes. - Créditos Marginais Rotacionados: Ancorar créditos de borda direita verticais com
top: 18pt; right: 16pt; transform-origin: 100% 0%; transform: ...
- Drop Caps (
- Tipografia & Suporte de Papel: Combinar papel de arquivo quente não revestido (
6. Garantia de Qualidade & Auditoria Visual
Sempre concluir executando audit_pdf.py contra o PDF compilado:
python tools/audit_pdf.py output/deck.pdf \
--dpi 180 \
--check-fill 72 88 \
--check-fonts Inter-Regular Inter-Bold Helvetica \
--export-png preview_page_ \
--verbose
A ferramenta gera imagens PNG de cada página, verifica o preenchimento vertical, relata fontes não registradas e marca problemas potenciais de layout. Corrigir visualmente qualquer sobreposição de rótulo, viúva de título ou desequilíbrio óptico antes da publicação.
7. Dependências
verifiable-pdf-pipeline— integridade anti-fraude de dadoseditorial-page-layout-guidelines— geometria de grade & especificações de layout editorial- Python 3.10+ com ReportLab 4.0+ (
reportlab) e/ou WeasyPrint 60+ (weasyprint) PyMuPDF(fitz) para pós-processamento e auditoria- Fonte Inter (otimizada) ou fallback para Helvetica/Courier