# ⚡ GUIA RÁPIDO - PESQUISAS COM CONTATOS

## 🚀 COMECE EM 3 MINUTOS

### 1️⃣ Prepare o Banco (1 minuto)

Execute o arquivo SQL:
```
criar_tabelas_pesquisas.sql
```

Ou se as tabelas já existem e precisam da coluna descricao:
```sql
ALTER TABLE pesquisas ADD COLUMN descricao TEXT AFTER status;
```

### 2️⃣ Acesse a Aplicação (30 segundos)

```
http://localhost/aplicacao%20itltech/montagem_questionario.php
```

Clique no botão: **[📊 Pesquisas]**

### 3️⃣ Crie Sua Primeira Pesquisa (1.5 minutos)

Na página que abrir, clique: **[➕ Nova Pesquisa]**

Preencha o formulário:
- **Nome:** "Minha Primeira Pesquisa"
- **Data:** (hoje)
- **Status:** Ativa
- **Questionário:** Selecione um template
- **Descrição:** Deixe em branco ou escreva algo

Clique: **[Salvar Pesquisa]**

✅ **PRONTO!** Você verá a pesquisa com lista de empresas.

---

## 🎯 INTERAJA COM A PESQUISA

### Para Expandir Empresa:
```
Clique no nome da empresa (ex: "Empresa A")
```

### Ver Contatos:
```
Empresa A abre automaticamente mostrando:
- 📧 Nome do contato
- Email
- Telefone
- Área
```

### Para Retrair:
```
Clique novamente na empresa
```

---

## 📊 VERIFICAR SE FUNCIONOU

### No Banco de Dados:

Conecte-se ao MySQL e execute:

```sql
-- Ver pesquisas criadas
SELECT nome, status, data_criacao FROM pesquisas ORDER BY id DESC LIMIT 1;

-- Contar empresas que receberam a pesquisa
SELECT COUNT(*) FROM pesquisa_empresa WHERE id_pesquisa_fk = 1;

-- Contar contatos populados
SELECT COUNT(*) FROM pesquisa_contatos 
WHERE id_pesquisa_empresa_fk IN (
    SELECT id FROM pesquisa_empresa WHERE id_pesquisa_fk = 1
);
```

### Na Interface:
- ✅ Vê lista de empresas?
- ✅ Consegue expandir uma empresa?
- ✅ Aparecem contatos quando expande?
- ✅ Seta (▼) rotaciona?

Se tudo OK → **Sistema funcionando! 🎉**

---

## 🔗 NAVEGAÇÃO RÁPIDA

| Página | URL | O que faz |
|--------|-----|----------|
| Listar | `pesquisas.php` | Ver todas pesquisas |
| Criar | `nova_pesquisa.php` | Formulário nova pesquisa |
| Ver | `visualizar_pesquisa.php?id=1` | Detalhes com accordion |

---

## ⚠️ PROBLEMAS COMUNS

### Nenhuma empresa aparece
```
→ Verifique se existem empresas ativas
→ Verifique coluna ATIVA = 'S' na tabela empresas
```

### Nenhum contato aparece
```
→ Verifique se empresas têm contatos
→ Verifique coluna ativo = 'S' em contatos_empresa
```

### Accordion não abre
```
→ Verifique console (F12 → Console)
→ Tente refresh da página
→ Verifique se JavaScript está habilitado
```

### SQL Error ao criar tabelas
```
→ Verifique permissões do usuário MySQL
→ Verifique se já existem as tabelas
→ Se existem, use ALTER TABLE para adicionar colunas
```

---

## 📝 DICAS ÚTEIS

### Para Testar Rápido:
```
1. Vá para nova_pesquisa.php
2. Dê um nome simples (ex: "Teste 1")
3. Deixe data como hoje
4. Selecione qualquer questionário
5. Salve
6. Clique em uma empresa para expandir
```

### Para Ver Dados:
```
1. Abra o formulário de pesquisa
2. Pressione F12
3. Vá em "Network"
4. Crie uma pesquisa
5. Veja os requests e responses
```

### Para Debugar:
```
1. No PHP, adicione:
   var_dump($resultado);
   
2. No JavaScript, adicione:
   console.log('variavel:', variavel);
```

---

## 📚 DOCUMENTAÇÃO COMPLETA

Para mais detalhes, leia:
- **DOCUMENTACAO_PESQUISAS.md** - Guia técnico completo
- **IMPLEMENTACAO_COMPLETA.md** - Visão geral do sistema
- **TEST_PESQUISA_CONTATOS.md** - Testes detalhados

---

## 🎓 O SISTEMA FAZ:

✅ Cria uma pesquisa
✅ Distribui para todas empresas ativas
✅ Busca contatos de cada empresa
✅ Mostra tudo em accordion interativo
✅ Armazena tudo no banco de dados
✅ Interface amigável e responsiva

---

## 🎉 PRÓXIMO PASSO

Depois que testar e se sentir confortável, você pode:

1. **Responder pesquisa** - Implementar `responder_pesquisa.php`
2. **Ver resultados** - Criar relatórios
3. **Exportar dados** - Gerar CSV/PDF
4. **Enviar emails** - Notificar empresas

---

## ❓ PERGUNTAS FREQUENTES

### P: Posso alterar o layout do accordion?
**R:** Sim! Modifique o CSS em `visualizar_pesquisa.php` (linhas 95-164)

### P: Posso usar em outros navegadores?
**R:** Sim! Testado em Chrome, Firefox, Edge, Safari

### P: Os contatos aparecem automaticamente?
**R:** Sim! São populados quando você cria a pesquisa

### P: Posso deletar uma pesquisa?
**R:** Em desenvolvimento - use DELETE direto no banco por agora

### P: Quantas pesquisas posso criar?
**R:** Ilimitadas! O banco suporta quantidade grande

---

## 🏁 VOCÊ ESTÁ PRONTO!

Agora é só:

1. Executar o SQL
2. Abrir a aplicação
3. Criar uma pesquisa
4. Expandir uma empresa
5. Ver os contatos

**Divirta-se! 🚀**

---

*Guia rápido - Sistema de Pesquisas v1.0*
