Gerador de Relatório GEO PDF (pipeline pandoc)

Pré-requisitos

• pandoc — brew install pandoc
• Google Chrome — deve estar instalado em /Applications/Google Chrome.app/

Sem dependências Python. Sem ReportLab. Sem manipulação de dados JSON.

Como Funciona

1. Leia GEO-AUDIT-REPORT.md no diretório atual (criado por /geo audit)
2. Extraia metadados da capa do relatório (nome da marca, domínio, pontuação GEO, data, locais)
3. Execute pandoc com o CSS + template HTML agrupados para produzir um GEO-REPORT.html autônomo
4. Execute o Chrome em modo headless para imprimir o HTML em GEO-REPORT.pdf

O template pandoc (references/ templates nesta skill ou HTML fornecido pelo usuário) injeta:

• Uma seção de capa em azul marinho escuro com preenchimento total e o selo da pontuação GEO
• Metadados da capa por seção (data, tipo de negócio, locais, plataforma)
• JavaScript que roda dentro do Chrome antes de imprimir para colorir as células de pontuação e os blocos de chamada de severidade das seções de achados

Fluxo de Trabalho

Etapa 1: Verificar relatório de auditoria

Procure por GEO-AUDIT-REPORT.md no diretório atual. Se ausente, diga ao usuário para executar /geo audit <url> primeiro.

Etapa 2: Extrair metadados da capa do relatório

Leia o topo de GEO-AUDIT-REPORT.md e extraia:

Etapa 3: Executar pandoc

pandoc GEO-AUDIT-REPORT.md \
  --to html5 \
  --standalone \
  --embed-resources \
  --template ~/.claude/skills/geo/templates/geo-report-template.html \
  --css ~/.claude/skills/geo/templates/geo-report-style.css \
  --metadata title="GEO Audit Report — <brand_name>" \
  --metadata brand_name="<brand_name>" \
  --metadata domain="<domain>" \
  --metadata geo_score="<geo_score>" \
  --metadata score_label="<score_label>" \
  --metadata date="<date>" \
  --metadata business_type="<business_type>" \
  --metadata locations="<locations>" \
  --metadata platform="<platform>" \
  -o GEO-REPORT.html

Substitua os placeholders <field> pelos valores extraídos na Etapa 2. Se um campo não for encontrado no relatório, omita essa flag --metadata — o template tem padrões razoáveis.

Etapa 4: Executar Chrome em modo headless

"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" \
  --headless=new \
  --disable-gpu \
  --no-sandbox \
  --print-to-pdf="$(pwd)/GEO-REPORT.pdf" \
  --print-to-pdf-no-header \
  --no-pdf-header-footer \
  --virtual-time-budget=5000 \
  "file://$(pwd)/GEO-REPORT.html"

Etapa 5: Conclusão do relatório

Informe ao usuário:

• GEO-REPORT.pdf foi gerado no diretório atual
• Tamanho do arquivo
• Opcionalmente: open GEO-REPORT.pdf para pré-visualizá-lo

O Que o PDF Contém

• Página de capa — Gradiente azul marinho escuro, nome da marca, domínio, selo da pontuação GEO (colorido por pontuação), data da auditoria, tipo de negócio, locais, plataforma CMS
• Tabelas de pontuação — Células contendo XX/100 são coloridas: ≥80 verde, ≥65 azul, ≥50 âmbar, ≥35 laranja, <35 vermelho
• Seções de achados — Títulos h3 contendo "Critical / High / Medium / Low" recebem blocos de chamada com borda esquerda colorida por severidade (vermelho / laranja / amarelo / verde)
• Quebras de página de seção — Seções principais (High Priority, 90-Day Roadmap, Component Score Summary, Generated Schema) quebram para novas páginas automaticamente
• Blocos de código — Templates de esquema JSON renderizam com estilo monospace de tema escuro
• Rodapé da página — Nome da marca · GEO Audit · data + números de página (via CSS @page)

Personalizando o Relatório

• Cores / tipografia — Edite os templates references/ nesta skill ou HTML fornecido pelo usuário
• Layout da capa — Edite os templates references/ nesta skill ou HTML fornecido pelo usuário
• Limiares de pontuação para colorir — Edite a função scoreColor() no bloco <script> do template
• Quais seções recebem quebras de página — Edite o array breakBefore no bloco <script> do template

Solução de Problemas

…