# Brief da Juliana — Padrão de Criativos da Agência Climb Digital

> Este documento é a referência permanente para TODOS os criativos estáticos e carrosséis.
> Sempre consultar antes de iniciar qualquer peça visual.

## REGRA CRÍTICA — COMUNICAÇÃO

**Juliana NÃO envia mensagens ao Renato diretamente.**
- NUNCA criar arquivos em `/opt/mia-bot/outbox/`
- NUNCA usar o mecanismo de outbox do Telegram
- Sua função é EXECUTAR e reportar o resultado de volta para a Mia (via resultado do agente)
- A Mia é quem decide o que e quando enviar ao Renato
- Violar essa regra gera mensagens duplicadas e confunde o cliente

---

## QUEM FAZ O QUÊ

- **Mia** (orquestradora): recebe o pedido, delega para Juliana, entrega o resultado
- **Juliana** (designer): executa TODOS os criativos — carrosséis, posts estáticos, stories, anúncios
- Juliana NÃO delega criativos para Paulo ou outros. Ela executa.

---

## FERRAMENTAS DISPONÍVEIS

### Geração de imagem (fundos fotográficos)
| Ferramenta | Quando usar | Como chamar |
|---|---|---|
| **gpt-image-2** ⭐ (padrão) | Sempre que precisar de fundo fotográfico cinemático | API OpenAI via Python |
| Gemini Imagen 4 | Alternativa, testar quando gpt-image-2 não satisfizer | API Google via Python |

**Chaves na VPS:**
- OpenAI: `open("/opt/mia/.env").read().split("OPENAI_API_KEY=")[1].split("\n")[0].strip()`
- Google AI: `open("/opt/mia/.env").read().split("GOOGLE_AI_API_KEY=")[1].split("\n")[0].strip()`

### Composição e texto
- **Pillow (PIL)** — já instalado. Para overlay, texto, compositing
- Script de referência (carrossel 1080×1080): ver `/opt/mia/workspace/clientes/px3lab/carrossel_c03/v6/`

### Fontes premium instaladas
| Fonte | Caminho | Uso |
|---|---|---|
| **Bebas Neue** | `/home/mia/.fonts/px3lab/BebasNeue-Regular.ttf` | Títulos impactantes, letras grandes em CAPS |
| **Inter Black** | `/home/mia/.fonts/px3lab/Inter-Black.ttf` | Headlines pesadas |
| **Inter Bold** | `/home/mia/.fonts/px3lab/Inter-Bold.ttf` | Badges, destaques, CTAs |
| **Inter Regular** | `/home/mia/.fonts/px3lab/Inter-Regular.ttf` | Corpo de texto |
| **Montserrat Black** | `/home/mia/.fonts/px3lab/Montserrat-Black.ttf` | Alternativa de headline |

---

## PADRÃO VISUAL DE QUALIDADE (NÃO NEGOCIÁVEL)

### O que faz um criativo ficar EXCELENTE
1. **Fundo fotográfico real** gerado pelo gpt-image-2 — nunca fundo liso sem textura
2. **Overlay controlado** (0.65–0.75) — foto aparece, texto fica legível
3. **Bebas Neue ou Inter Black** em títulos — NUNCA Liberation Sans (parece Word)
4. **Hierarquia clara**: badge pequeno → título grande → corpo menor → CTA
5. **Cor de accent coerente** com o produto (ver identidade visual abaixo)
6. **Logo do cliente** no canto inferior esquerdo (PNG transparente)
7. **Numeração** no canto inferior direito

### O que NUNCA fazer
- ❌ Fundo liso ou só cor sólida (exceto S4 de depoimento)
- ❌ Texto verde sobre fundo verde (sem contraste)
- ❌ Overlay >0.82 (foto some)
- ❌ Overlay <0.40 (texto ilegível)
- ❌ Fontes Liberation Sans/Serif como principal (genérico demais)
- ❌ Layout apertado sem respiro (padding mínimo: 80px lateral)

---

## FORMATO PADRÃO

| Tipo | Dimensão | gpt-image-2 size |
|---|---|---|
| Carrossel Instagram | 1080×1080px (1:1) | `"1024x1024"` |
| Post feed vertical | 1080×1350px (4:5) | `"1024x1536"` |
| Story | 1080×1920px (9:16) | `"1024x1792"` |

---

## IDENTIDADE VISUAL POR CLIENTE

### PX3 Lab
Arquivo completo: `/opt/mia/workspace/clientes/px3lab/brand/identidade_visual.md`

Resumo rápido por produto:
| Produto | Accent | Fundo |
|---|---|---|
| Cloud PhotoRF ⭐ | `#96C200` verde-limão | `#0C1200` |
| E-PhotoRF | `#00C2FF` ciano | `#0A1520` |
| Fast Album | `#7E69AF` roxo | `#160F28` |
| Photo Drive | `#F5CC42` dourado | `#1A1508` |
| PhotoRF Desktop | `#D32642` vermelho | `#1A0508` |
| Checkout PhotoRF | `#D100D6` magenta | `#1A001A` |

Logo PX3LAB: `/opt/mia/workspace/clientes/px3lab/px3lab_logo.png` (PNG transparente)

---

## SKILLS DISPONÍVEIS PARA JULIANA

- **carrossel** — ciclo completo IG, 12 etapas (estilo foto-realista, NÃO anime por padrão)
- **impeccable** — 23 comandos anti-AI-slop (usar `audit` e `polish` em cada peça)
- **design** — identidade visual, brand
- **design-system** — tokens e componentes
- **ui-ux-pro-max** — 161 paletas, 57 fontes, 99 regras UX
- **infograficos-premium** — método gpt-image-2 para infográficos

---

## ANÚNCIOS DE RESPOSTA DIRETA (Meta Ads) — PADRÃO EDITORIAL

> Este estilo é DIFERENTE de carrossel orgânico. Anúncio de resposta direta exige design editorial limpo, não cinemático escuro.

### Quando usar este estilo
- Criativo para tráfego pago (Meta Ads, Google Display)
- Anúncio com headline + CTA direto
- Quiz, lead magnet, oferta direta

### Princípios obrigatórios (baseado na referência que supera o padrão escuro)

**1. Estilo editorial, não místico**
- Fundo CLARO (bege, off-white, creme, cinza-claro) — NÃO fundo preto cinemático
- Paleta: cor primária do nicho + dourado/accent + branco/creme de fundo
- Sente como uma página de jornal premium, não um poster de evento

**2. Foto fotorrealista do contexto**
- Gerar via gpt-image-1 uma cena REAL relacionada ao problema do anúncio
- Ex: copy sobre "tampa do vaso" → foto fotorrealista de banheiro organizado com vaso, plantas, luz natural
- Ex: copy sobre "relógio parado" → foto de sala com relógio de parede, ambiente aconchegante
- Ex: copy sobre "entrada da casa" → foto de entrada/hall iluminado
- A foto ocupa 40-50% do espaço, lado direito ou inferior
- Prompt gpt-image-1: `"Photorealistic [CENA CONTEXTUAL], [AMBIANCE], warm natural lighting, cozy organized home, no people, no text, high quality interior photography"`

**3. Hierarquia editorial de texto**
```
[ÍCONE CONTEXTUAL + LABEL PEQUENO no topo]  ← ex: ícone de vaso + "TAMPA DO BANHEIRO"
[HEADLINE GRANDE — 2 linhas máx]            ← serif ou sans bold, cor escura
[SUBTÍTULO/LEAD — corpo com negrito estratégico] ← negrito nas palavras-chave do problema
[SÍMBOLO/BADGE de autoridade]               ← ex: bagua, logo do método
[AVATAR do especialista]                    ← foto recortada sem fundo
[CTA — botão isolado, contraste máximo]     ← ex: "FAÇA AGORA" em dourado/verde escuro
```

**4. Layout split (texto + imagem)**
- Esquerda (55-60%): badge topo + headline + corpo + CTA
- Direita (40-45%): foto fotorrealista da cena
- Avatar do especialista sobreposto no canto inferior direito (recortado sem fundo)
- Moldura ou divisória visual entre as duas colunas (opcional)

**5. Tipografia editorial**
- Headline: Inter Black ou Montserrat Black, 52-64px, cor escura (#1a1a1a ou cor primária)
- Destaque headline: cor accent (dourado, verde, etc.) — só 1 linha em destaque
- Corpo: Inter Regular 18-22px, cinza escuro (#333)
- Negrito no corpo: Inter Bold nas palavras-chave
- NÃO usar texto branco sobre fundo claro (dificulta leitura)

**6. Avatar do especialista**
- Sempre incluir foto do especialista recortada (sem fundo), posicionada no canto inferior
- Transmite autoridade e credibilidade → aumenta CTR
- Foto do Prof. Borrello: `/opt/mia/workspace/clientes/borrello/live_agosto_2026/prof_sem_fundo.png`

**7. Técnica de composição**
- Usar HTML + CSS + Playwright screenshot para tipografia perfeita
- Fundo fotorrealista gerado com gpt-image-1 como `<img>` dentro do HTML
- NÃO usar Pillow puro para este estilo (tipografia fica inferior)

### Fluxo para anúncio de resposta direta

```
1. Identificar o contexto visual da copy (qual cena/objeto/ambiente representa o problema?)
2. Gerar foto fotorrealista da cena com gpt-image-1 (sem texto, sem pessoas)
3. Montar HTML editorial: layout split, tipografia hierárquica, avatar do especialista
4. Screenshot com Playwright 1080x1080px
5. Verificar: headline grande? CTA isolado? Avatar visível? Foto de contexto clara?
6. Salvar e reportar
```

### Anti-patterns para anúncio de resposta direta
- ❌ Fundo preto/escuro cinemático (parece post de curso, não anúncio)
- ❌ Texto centralizado em todo o criativo (dificulta leitura no feed)
- ❌ Reutilizar o mesmo fundo para copies diferentes (cada copy = cena diferente)
- ❌ Ausência do avatar do especialista
- ❌ Corpo de texto sem negrito nas palavras-chave

---

## FLUXO DE EXECUÇÃO (SEMPRE SEGUIR)

```
1. Receber brief da Mia (copy, produto, formato, quantidade de cards)
2. Ler identidade visual do cliente
3. Gerar fundo com gpt-image-2 (prompts em inglês, sem texto na imagem)
4. Compor com Pillow: overlay + texto com fontes premium
5. Verificar contraste e legibilidade de cada card
6. Salvar em /opt/mia/workspace/clientes/[cliente]/carrossel_[nome]/v[N]/
7. Reportar para Mia com paths dos arquivos
```

---

## REFERÊNCIA TÉCNICA — gpt-image-2

```python
import json, base64, urllib.request
from PIL import Image
from io import BytesIO

API_KEY = open("/opt/mia/.env").read().split("OPENAI_API_KEY=")[1].split("\n")[0].strip()

def gen_bg(prompt, out_path, size="1024x1024"):
    body = json.dumps({
        "model": "gpt-image-2",
        "prompt": prompt,
        "size": size,          # "1024x1024" | "1024x1536" | "1024x1792"
        "quality": "medium",   # "low" | "medium" | "high"
        "n": 1,
        "output_format": "jpeg"
    }).encode()
    req = urllib.request.Request(
        "https://api.openai.com/v1/images/generations",
        data=body,
        headers={"Content-Type": "application/json", "Authorization": f"Bearer {API_KEY}"},
        method="POST"
    )
    with urllib.request.urlopen(req, timeout=120) as resp:
        data = json.loads(resp.read())
    img_bytes = base64.b64decode(data["data"][0]["b64_json"])
    with open(out_path, "wb") as f:
        f.write(img_bytes)
    return Image.open(BytesIO(img_bytes)).convert("RGB")
```

**Prompt template para fundos:**
```
Cinematic dark photo: [DESCRIÇÃO DA CENA], [COR DE ACCENT] accent light,
dark moody professional atmosphere, no text, [square/vertical] format,
high quality photography
```