# 📋 Manual de Gerenciamento de Parceiros - Culturando

## 📖 Visão Geral

A seção Parceiros é destinada a exibir negócios, instituições e colaboradores do projeto. Cada parceiro possui uma página própria (`/parceiros/nome-do-parceiro/`), integração nativa com mapa interativo, caixa de contatos padronizada e filtros por categoria (`Áreas`).

## 🧩 Estrutura da Tela de Edição

Ao criar ou editar um parceiro, você encontrará os seguintes blocos:

Bloco | Local na Tela | Função
--- | --- | ---
Título | Topo | Nome oficial do parceiro
Editor de Conteúdo | Centro | Descrição completa, história, serviços, galerias, vídeos
Imagem Destacada | Coluna direita | Logo oficial do parceiro
Áreas | Coluna direita | Categoria do negócio (Gastronomia, Cultura, Passeios, etc.)
Mapa: clique para definir | Abaixo do editor | Seleção de coordenadas no mapa interativo
Dados do Marcador | Coluna direita | Título e texto do popup do mapa + zoom
Dados de Contato | Coluna direita | Endereço, telefone, e-mail, WhatsApp, redes sociais

## 🛠️ Passo a Passo: Como Adicionar um Parceiro

### 1. Acessar e Criar

1. No menu lateral, clique em Parceiros → Adicionar novo
2. Preencha o Título com o nome exato do estabelecimento/instituição

### 2. Conteúdo Principal

- Use o editor padrão para escrever a apresentação do parceiro
- Você pode inserir imagens, galerias, vídeos do YouTube, listas e formatação rica
- 💡 Dica: Evite repetir aqui os dados de contato (telefone, e-mail, WhatsApp). O sistema exibe automaticamente um box padronizado no final da página.

### 3. Logo (Imagem Destacada)

1. Na coluna direita, clique em Definir imagem destacada
2. Envie a logo do parceiro
3. ✅ Recomendações:
   - Formato: `PNG` com fundo transparente ou `JPG` de alta qualidade
   - Tamanho ideal: `400 × 400 px` (quadrada ou circular)
   - Peso: até `150KB`
   - Evite logos com margens brancas ou textos muito pequenos

### 4. Definir Localização no Mapa

1. Role até o box Mapa: clique para definir
2. Navegue até o endereço ou clique diretamente no local no mapa
3. O marcador será posicionado. Para ajustar:
   - Arraste o marcador para o ponto exato
   - Use a roda do mouse ou os controles `+`/`-` para definir o zoom
   - O zoom será salvo automaticamente
4. Na caixa Dados do Marcador (sidebar), preencha:
   - Coordenadas: (preenchidas automaticamente, não edite)
   - Zoom: (ajustado pelo mapa, pode editar manualmente se preferir)
   - Título: Nome que aparecerá no topo do popup do mapa
   - Conteúdo da popup: Breve descrição ou horário (ex: `Seg a Sex, 9h às 18h`)
5. ✅ O link “Como chegar” é gerado automaticamente no popup

### 5. Preencher Dados de Contato

No box Dados de Contato (sidebar), preencha:

Campo | Formato Recomendado
--- | ---
Endereço | Texto livre (ex: `Rua das Flores, 123 - Centro`)
Telefone | Apenas números e formatação visual (ex: `(21) 3333-4444`)
E-mail | E-mail válido (ex: `contato@parceiro.com.br`)
WhatsApp | Apenas números, com DDI+DDD (ex: `5521999998888`)
Facebook / Instagram | URL completa (ex: `https://instagram.com/parceiro`)

⚠️ Importante: O box de contatos no frontend é gerado exclusivamente a partir desses campos. Se você digitar o telefone apenas no conteúdo principal, ele não aparecerá na caixa padronizada.

### 6. Categorizar (Áreas)

1. No box Áreas, selecione ou crie categorias (ex: `Gastronomia`, `Cultura`, `Hospedagem`)
2. Um parceiro pode ter múltiplas áreas
3. Isso permite filtrar a listagem no site (`/area/gastronomia/`, etc.)

### 7. Publicar

- Clique em Publicar (ou Agendar se quiser controle de data)
- Acesse `/parceiros/nome-do-parceiro/` para verificar a renderização

## 🌐 Como o Parceiro Aparece no Site

Elemento | Comportamento
--- | ---
URL | `/parceiros/{slug-do-parceiro}/`
Logo | Exibida no topo, antes do conteúdo
Conteúdo | Texto rico inserido no editor
Mapa | Renderizado automaticamente se coordenadas forem definidas
Box de Contatos | Gerado automaticamente ao final, com links clicáveis (`tel:`, `mailto:`, WhatsApp, redes)
Filtros | Aparece nas listagens filtradas por `Áreas`

## ✅ Boas Práticas

Área | Recomendação
--- | ---
Nomenclatura | Use o nome comercial oficial. Evite siglas sem contexto
Conteúdo | Mantenha entre 2 e 5 parágrafos. Use subtítulos, listas e mídia
Logo | Fundo transparente sempre que possível. Teste em fundo claro e escuro
Mapa | Posicione o marcador na entrada principal do estabelecimento
Contato | Preencha WhatsApp apenas com números. O site adiciona automaticamente o link `wa.me/`
Áreas | Selecione no máximo 3 áreas por parceiro para manter a listagem relevante

## 🔧 Solução de Problemas

### “O mapa não aparece na página do parceiro”

✅ Verifique:

- Se clicou no mapa e salvou o post (coordenadas `lat`/`lng` devem estar preenchidas)
- Se o status do post é Publicado
- Se há conflito de cache (limpe o cache do navegador/plugin)

### “O box de contatos está vazio”

✅ Verifique:

- Se os campos foram preenchidos no box lateral Dados de Contato
- Se não há espaços em branco acidentais antes/depois dos valores
- Se o post foi atualizado após preencher

### “A logo aparece distorcida ou cortada”

✅ Verifique:

- Se a imagem enviada é próxima de quadrada (`1:1`)
- Se o peso está abaixo de `150KB`
- Reenvie com as dimensões recomendadas (`400×400 px`)

### “Quero alterar a posição do marcador no mapa”

✅ Abra o parceiro novamente, clique no mapa para mover o pino, ajuste o zoom se necessário e clique em Atualizar.

## 📞 Suporte e Solicitações

Para:

- Criar novas `Áreas` personalizadas
- Ajustar ordem de exibição no mapa ou listagens
- Integrar dados adicionais (horário de funcionamento, link para cardápio, etc.)

Entre em contato com a equipe de desenvolvimento ou registre uma solicitação no canal de suporte.

Última atualização: Abril 2026
Versão do módulo: 1.0