Communitygithub.com

sistema-premium-pdf-design

Sistema de design institucional para apresentações PDF (16:9 dark executive decks) e relatórios (Carta light Swiss ivory). Garante pipelines de dados abertos verificáveis, balanço de cores 60-30-10, ledger Tufte hairline, títulos de ação da Pirâmide Minto, visualização de dados vetoriais a 300 DPI, registro seguro da fonte Inter, pintura em tela full-bleed e auditoria visual automatizada com PyMuPDF.

O que é sistema-premium-pdf-design?

Este skill estabelece um sistema de design rigoroso e verificável para criar apresentações e relatórios institucionais em PDF, inspirado nos padrões visuais da McKinsey, Stripe Press, WEF e The Economist. Ele se concentra em dois modos principais: decks de slides escuros 16:9 (modo executivo) e relatórios claros em formato Carta (modo editorial suíço). O skill impõe 10 regras anti-fraude para garantir a integridade dos dados, incluindo pipelines de dados abertos, compilação verificável e um ledger de proveniência atômica. As regras de design abrangem hierarquia de cores 60-30-10 (com paletas escuras e claras), uso de hairlines e espaço em branco em vez de caixas pesadas, títulos de ação da Pirâmide Minto (afirmações completas em vez de rótulos passivos) e receitas de visualização de dados vetoriais a 300 DPI, como sparklines Tufte, gráficos de bala Stephen Few e matrizes de calor. A implementação usa ReportLab e WeasyPrint, com padrões para pintura de fundo full-bleed, descoberta segura da fonte Inter e cabeçalhos dinâmicos 'Página X de Y'. Para decks flagship, o skill detalha um modo de consultoria 2023 com SVG vetorial puro, uma rampa cromática azul McKinsey de 4 camadas e arquétipos de gráfico como waterfall mass-balance e matrizes de waffle 10x10. Um modo adicional de revista editorial fotográfica em estilo Kinfolk/Condé Nast também é suportado, com requisitos específicos de tipografia, sangria e layout. O skill é compatível com Claude Code, Cursor e Codex, e depende dos skills complementares 'verifiable-pdf-pipeline' e 'editorial-page-layout-guidelines'.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/gke0op/verifiable-editorial-skills/tree/HEAD/skills/premium-pdf-design

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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:

  1. Zero Interrupção de Dados Manuscritos — analisar todos os números de arquivos brutos imutáveis em data/raw/.
  2. Compilador de Realidade & Invariantes — impor limites de domínio Pydantic e identidades contábeis.
  3. Verificação Anti-Circular — re-computação independente de arquivo bruto + verificação AST Python proibindo asserções literais codificadas.
  4. Ledger de Proveniência Atômica — cada escalar publicado mapeado 1:1 em data/provenance_ledger.json.
  5. Capacidade Negativa & O Sagrado "N/A" — nulos genuínos upstream são renderizados explicitamente como [N/A], nunca como proxies fabricados.
  6. Trava de Compilação — compiladores PDF invocam verify_integrity.py e abortam em saída não zero.
  7. Guarda de Categoria & Unidade — nunca misturar escopos ou métodos de teste incomensuráveis.
  8. Prova Estatutária — IDs de diário oficial necessários para qualquer alegação regulatória/tarifária.
  9. Taxonomia Científica & Verificação de Registro — reconciliar binômios, autoridades, filogenia e status IUCN textualmente contra registros vivos do GBIF/OpenTree/iNaturalist.
  10. Fundamentação de Prosa Pós-Renderização (vedit prose) — cada numeral renderizado no PDF final rastreia de volta para provenance_ledger.json, summary_metrics.json ou uma entrada com DOI em background_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 via onPage.
    • 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 em onFirstPage/onLaterPages ANTES 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 (>= #e2e8f0 a >= 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 BOX retangular ou INNERGRID de painéis web.
  • Agrupar KPIs e chamadas via faixas tonais sem bordas (#111827 escuro / #f1f5f9 claro) coroadas com uma hairline de destaque superior de 1.2 pt, generosas margens de coluna de 12–16 pt e 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 de 85%–92% (mín >= 82%).
  • Decks 16:9 (960×540 pt): Preenchimento vertical alvo de 72%–88% (mín >= 72%).
  • Nunca tratar uma passagem automatizada como palavra final: exportar prévias PNG de 180 DPI via audit_pdf.py e 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):

  1. 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.
  2. Á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.
  3. 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.
  4. 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(...)).
  5. Sparklines Tufte Headless in-memory: Micro-linhas 46–66 pt × 13–16 pt renderizadas em buffers io.BytesIO() e incorporadas diretamente em células de tabela ReportLab com pontos terminais semânticos esmeralda/carmim.
  6. 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>:

  1. 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ítido 28 pt sobre uma régua horizontal branca de 1.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 branco 120 pt em negrito (1, 2), fundo 52% branco puro com título de capítulo serifado recuado 220 pt à esquerda e cópia de enquadramento em 2 colunas.
    • Slides de Exposição de Dados: Tela #FFFFFF pura, título de ação serifado em negrito 19.5–22 pt acima de uma régua #051C2C de 1.1 pt, separador de nota de rodapé sutil no fundo e uma pílula de progresso de seção ciano-gelo #9AE6FF no canto inferior direito.
  2. Emparelhamento de Serifa Editorial de Alto Contraste + Sem Serifa Geométrica:
    • Serifa de Exibição (Charter / Georgia / Baskerville Bold): Títulos de capa, numerais de seção, títulos de ação de slides, chamadas KPI gigantes 54 pt #2251FF e 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.
  3. A Rampa Cromática Azul McKinsey de 4 Camadas (Zero Desordem de Arco-Íris):
    • #051C2C Azul Marinho Meia-Noite (totais de âncora, linhas de base, contrações profundas) → #06319C Azul Real Profundo → #2251FF Azul Elétrico (deltas focais, grandes KPIs, surtos de expansão) → #00A9F4 Ciano Vívido → #9AE6FF Ciano Gelo (participações secundárias e pílulas de seção).
  4. 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 agrupados 5 + 3 emparelhados com uma barra lateral #EFEFEF à direita unida por um crachá de chevron » #051C2C circular (anel branco 3 pt).
    • Matriz de Waffle de Quadrado Arredondado 10×10: Grades 10×10 preenchidas 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 colunas 2000 vs 2024 ligadas por fitas de fluxo translúcidas.
    • Barreiras de Proteção SVG WeasyPrint: Dentro de flex containers, sempre dar ao <svg> inline width/height explícitos em pt (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 de 300 px. Nunca usar SVG 2 paint-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.
  5. Modo de Revista Editorial Fotográfica Full-Bleed (612 × 792 pt Carta Retrato, WeasyPrint): Ao produzir revistas editoriais com foco em fotografia (estilo Kinfolk × Cereal × Condé Nast Traveler × National Geographic, conforme demonstrado em demos/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 / Baskerville a 9 pt, 1.5× entrelinha) e metadados sem serifa em maiúsculas com tracking amplo (Inter, 6.5–7 pt, +0.18em tracking). Inverter folios correntes e créditos perfeitamente para #FFFFFF puro 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 (veja references/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 brancas 4 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 cap float: left dentro 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 bloco position: 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-gradient de 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 para 100% de seu container de foto e desvanecer para rgba(..., 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: ...

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 dados
  • editorial-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

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas