Bianca Sanity CMS - Sistema Integrado de Gestão de Conteúdo e Apresentações

Sistema integrado que combina Sanity CMS para gestão de conteúdo, Slidev para apresentações interativas, BiancaTools MCP para automação, e ferramentas auxiliares para cronogramas e gestão de clientes.

Funcionalidades Principais

Estrutura do Projeto

```

/BIANCA-SANITY/

├── /schemas/ # Schemas do Sanity (documents & objects)

├── /clientes/ # Dados de clientes (Follow the Money, Nurnberg)

├── /planilha/ # Sistema de cronograma (SQLite + Python)

├── /bianca-slidev/ # Módulo Slidev com integração Sanity

│ ├── /components/ # Componentes Vue

│ ├── /composables/ # Hooks para Sanity

│ └── /sanity/client.ts # Cliente Sanity

├── /mcp-run-ts-tools/ # BiancaTools MCP

└── /icones/ # Ícones SVG compartilhados

```

Instruções para o Agente

1. Sempre Responda em Português Brasileiro

Todas as respostas, documentação e código devem ser em PT-BR.

2. Configurar BiancaTools MCP Globalmente

Antes de iniciar qualquer tarefa, verifique se o BiancaTools MCP está instalado:

```bash

claude mcp add BiancaTools /Users/phiz/Desktop/BIANCA-SANITY/mcp-run-ts-tools/run-bianca-tools.sh --env GITHUB_TOKEN=SEU_TOKEN_AQUI -s user

```

**Ferramentas disponíveis:**

3. Diferenciar Cliente Sanity vs Sanity Studio

**IMPORTANTE:**

Sempre verifique se o usuário precisa do Studio (edição) ou apenas do cliente (leitura).

4. Instalar Sanity Studio (Quando Necessário)

Se o usuário precisar criar/editar conteúdo:

```bash

1. Instalar CLI globalmente

npm install -g @sanity/cli

2. Criar Studio na raiz do projeto

cd /Users/phiz/Desktop/BIANCA-SANITY

npm create sanity@latest -- --template clean --create-project "Bianca CMS" --dataset production

3. Mover schemas existentes

cp -r schemas/* studio/schemas/

4. Iniciar Studio

cd studio

npm run dev

```

5. Configurar Integração Sanity + Slidev

**Passo 1:** Criar arquivo `.env` em `/bianca-slidev/`:

```env

VITE_SANITY_PROJECT_ID=seu_project_id

VITE_SANITY_DATASET=production

```

**Passo 2:** Testar conexão:

```bash

cd bianca-slidev

npm install

npm run dev

```

**Passo 3:** Usar dados em componentes Vue:

```vue

<script setup>

import { useSanity } from '../composables/sanity'

const { data, loading } = await useSanity().getPresentation('id')

</script>

```

6. Validar Visualmente com Puppeteer

Sempre que modificar componentes visuais:

1. **Navegar para a página:**

- Use ferramenta `mcp__puppeteer-server__puppeteer_navigate`

- URL: `http://localhost:3030` (Slidev padrão)

2. **Capturar screenshot:**

- Use ferramenta `mcp__puppeteer-server__puppeteer_screenshot`

- Salve em `/bianca-slidev/screenshots/`

3. **Iterar até perfeição:**

- Analisar screenshot

- Corrigir código

- Repetir processo

7. Trabalhar com Schemas do Sanity

**Schemas disponíveis:**

**Ao modificar schemas:**

```bash

cd studio

npm run dev # Testar localmente

Verificar no Studio se mudanças aplicaram

```

8. Executar Sistema de Cronograma

```bash

cd planilha

python servidor_cronograma.py

Acessar: http://localhost:8080

```

9. Workflow de Desenvolvimento Completo

**Para criar nova apresentação:**

1. **Criar conteúdo no Sanity Studio:**

- Acessar Studio (port 3333)

- Criar documento tipo `presentation`

- Adicionar slides, cliente, evidências

- Publicar

2. **Consumir no Slidev:**

- Criar componente Vue em `/bianca-slidev/components/`

- Usar composable `useSanity()` para buscar dados

- Renderizar conteúdo dinamicamente

3. **Validar visualmente:**

- Iniciar Slidev (`npm run dev`)

- Usar Puppeteer para screenshots

- Iterar até aprovação

4. **Deploy:**

- Build Slidev: `npm run build`

- Deploy Studio: `cd studio && npm run deploy`

10. Dados de Clientes

**Clientes existentes:**

- `nurnberg-site.json`

- `playbook-replanejamento.json`

- `workflow-playbook.md`

Sempre verificar dados existentes antes de criar novos.

11. Comandos Essenciais

**Slidev:**

```bash

cd bianca-slidev

npm run dev # Desenvolvimento

npm run build # Produção

npm run export # PDF

```

**Sanity Studio:**

```bash

cd studio

npm run dev # Local (port 3333)

npm run deploy # Publicar online

```

**Cronograma:**

```bash

cd planilha

python servidor_cronograma.py

```

12. Checklist de Integração

Antes de qualquer tarefa complexa, verificar:

13. Queries GROQ Úteis

**Buscar todas apresentações:**

```groq

*[_type == "presentation"]{

_id,

titulo,

cliente->{nome},

slides

}

```

**Buscar cliente específico:**

```groq

*[_type == "cliente" && slug.current == $slug][0]{

nome,

descricao,

logo

}

```

**Testar queries no Vision plugin do Studio.**

14. Solução de Problemas Comuns

**Erro de conexão Sanity:**

**Slidev não encontra dados:**

**Puppeteer não carrega página:**

15. Recursos de Referência

Exemplos de Uso

**Criar nova apresentação para cliente Nurnberg:**

```

1. Verificar dados existentes em /clientes/nurnberg/

2. Abrir Sanity Studio

3. Criar documento "presentation"

4. Adicionar referência ao cliente Nurnberg

5. Criar slides com conteúdo

6. Publicar

7. Criar componente Vue em /bianca-slidev/components/NurnbergPresentation.vue

8. Buscar dados via useSanity()

9. Testar com Puppeteer

10. Iterar e refinar

```

**Automatizar screenshot de todas apresentações:**

```

1. Usar Puppeteer para navegar Slidev

2. Iterar por rotas de apresentações

3. Capturar screenshot de cada slide

4. Salvar em /screenshots/{cliente}/{data}/

5. Usar Mem0 para registrar processo

```

Notas Importantes