Motor Gráfico — Parte 2: Modelos, Templates, Configurações e Banco de Dados¶

ARQUIVO HISTÓRICO / LEGADO. Preservado para memória, auditoria e contexto de decisões. Não usar como documentação operacional atual.

Como o visual é renderizado, os 29 modelos de carrossel, os templates HTML/CSS, as configurações do tenant e o schema do banco de dados.

Etapa 7 — Rendering (Motor de Renderização)¶

Arquivo: cadencia-workers/src/workers/slide_renderer/__init__.py (401 linhas)

Transforma slides (texto + variáveis visuais) em imagens PNG de 1080x1440 pixels via Playwright (Chromium headless).

Fluxo¶

1. Recebe: tenant_id, document_id, slides, visual_identity, carousel_model, brand_handle, cover_image_path
2. Carrega template HTML do modelo ({slug}.html). Fallback para storytelling.html se não encontrar
3. Se há cover image: download da URL Supabase Storage → converte para base64 data URI
4. Para cada slide:
5. Monta variáveis: cores, fontes, texto, subtexto, tipo, número, highlights
6. Slide tipo "cover" com foto → HTML standalone com foto full-bleed + gradient overlay
7. Outros → substitui variáveis {{var}} no template HTML
8. Aplica highlights: envolve palavras em <span> com fundo accent
9. Injeta CSS de safe zones e tipografia mínima
10. Playwright carrega HTML no viewport 1080x1440 → screenshot PNG
11. Upload para Supabase Storage com 3 retries
12. Se upload falha após 3 tentativas → HEAD request para verificar se arquivo existe
13. Retorna lista de URLs
14. Orchestrator faz merge: adiciona "url" a cada slide → grava com status "ready"

Dimensões e Safe Zones¶

Tipografia mínima: headlines 50px, body text 14px.

Mecanismo de Highlights¶

Para cada palavra em highlighted_words: 1. Busca case-insensitive no texto 2. Substitui primeira ocorrência por: <span style="background-color: {accent_color}; padding: 2px 8px; border-radius: 4px; color: #FFFFFF;">{palavra}</span>

Upload para Supabase Storage¶

Os 29 Modelos de Carrossel¶

Definidos em arquivos YAML em cadencia-workers/src/models/.

Categorias¶

Templates HTML/CSS¶

58 arquivos HTML (29 modelos × 2 variantes A/B) + 1 CSS base compartilhado.

Fluxo: 1. Renderer carrega {slug}_a.html ou {slug}_b.html 2. Substitui variáveis {{var}} pelos valores reais 3. Injeta CSS de safe zones e tipografia mínima 4. Playwright renderiza → screenshot 1080×1440 PNG

CSS Base — Classes disponíveis¶

Variáveis disponíveis nos templates¶

Editorias (por tenant)¶

Armazenadas em tenant_editorials. Cada ideia pertence a uma editoria. Cada tenant tem tipicamente 3.

Campos de cada editoria¶

Funções editoriais disponíveis¶

Visual Identity (por tenant)¶

Gerada automaticamente a partir do logo no onboarding. Armazenada em tenant_visual_identity.

Config do Tenant (tenant_config)¶

Pipeline Global e Cron¶

Pipeline Settings¶

Cron Diário¶

Endpoint: POST /api/v1/cron/daily com header x-cron-secret (chamado por scheduler externo às 8h BRT — disparador exato não confirmado, ver Foundation - Tech Architecture §Cron jobs)

Fluxo: 1. Verifica secret 2. Busca tenants com schedule.active = true e dia atual em schedule.days 3. Para cada tenant: verifica idempotência → gera 5-10 ideias distribuídas entre as 3 editorias → insere como "approved" → cria jobs no pipeline

Geração de Ideias¶

Arquivo: cadencia-workers/src/workers/ideas.py

Prompt:

Você é um estrategista de conteúdo para Instagram.
Gere entre 5 e 10 ideias de carrosséis para este profissional,
distribuídas entre as 3 editorias abaixo.

REGRAS:
- Distribua: ~40% editorial 0, ~35% editorial 1, ~25% editorial 2.
- Títulos: máximo 12 palavras.
- Score: 0.0 a 1.0 indicando relevância/potencial.
- Keywords: 3-5 palavras-chave.
- Tudo em pt-BR. NÃO repita temas.

EDITORIAS: [bloco com as 3 editorias do tenant]
CONTEXTO: nicho, posicionamento (300 chars), público (300 chars), tom (200 chars)

Publicação no Instagram¶

Arquivo: cadencia-workers/src/workers/instagram_publisher.py (208 linhas)

Fluxo: 1. Busca social_connections → descriptografa access_token (XOR com TOKEN_ENCRYPTION_KEY) 2. Cria containers filhos: POST para cada slide PNG com is_carousel_item=true 3. Cria container do carrossel: POST com media_type=CAROUSEL + todos os IDs + caption 4. Publica: POST em media_publish 5. Busca permalink: GET no media publicado 6. Atualiza banco: publish_status="published", instagram_media_id, instagram_permalink

Config: Graph API v21.0, mínimo 2 slides (exigência do Instagram)

Token Refresh¶

Arquivo: cadencia-workers/src/workers/token_refresh.py (106 linhas)

• Roda diariamente via cron
• Busca conexões com token_expires_at < agora + 10 dias
• Chama GET refresh_access_token na Graph API
• Sucesso: atualiza token criptografado + token_expires_at + last_refresh_at
• Falha: marca como "expired" e loga

Schema do Banco de Dados¶

Variáveis de Ambiente¶

Custos por modelo LLM (estimativa, USD/token)¶

Notas Relacionadas¶

• Projetos/Cadencia/Docs/Motor-Grafico-Carrosseis-Doc-Tecnica
• Projetos/Cadencia/Docs/Motor-Parte1-Pipeline-Agentes-Prompts
• Projetos/Cadencia/Docs/PRD-Arquitetura-Tecnica