# 📡 ProspectoApp — Sistema de Prospecção Comercial
## Guia de Instalação Completo

---

## 📋 O que está incluso

```
prospecto/
├── banco.sql                  ← Crie as tabelas no MySQL
├── config.php                 ← ⚠️ EDITE AS CREDENCIAIS AQUI
├── login.php                  ← Tela de login (vendedor + admin)
├── logout.php                 ← Logout
├── admin/
│   ├── index.php              ← Dashboard admin (gráficos e stats)
│   ├── categorias.php         ← Criar categorias + importar planilhas CSV
│   ├── vendedores.php         ← Criar/gerenciar vendedores
│   └── relatorio.php          ← Relatório detalhado de atividades
└── vendedor/
    ├── index.php              ← Tela de prospecção (app mobile-friendly)
    ├── api.php                ← API JSON de todas as ações
    └── api_stats.php          ← API de estatísticas do vendedor
```

---

## 🚀 Passo a Passo de Instalação

### 1. Copie os arquivos para o servidor
```
Coloque a pasta "prospecto" dentro de:
  - XAMPP/WAMP: C:\xampp\htdocs\prospecto
  - cPanel/Servidor: public_html/prospecto
```

### 2. Crie o banco de dados
```sql
-- No phpMyAdmin ou MySQL CLI:
-- 1. Crie um banco chamado "prospecto"
-- 2. Importe o arquivo banco.sql
--    (phpMyAdmin: selecione o banco → aba "Importar" → escolha banco.sql)
```

### 3. Configure as credenciais
Edite o arquivo `config.php`:
```php
define('DB_HOST', 'localhost');     // geralmente localhost
define('DB_NAME', 'prospecto');     // nome do banco
define('DB_USER', 'root');          // seu usuário MySQL
define('DB_PASS', '');              // sua senha MySQL
define('SITE_URL', 'http://localhost/prospecto'); // URL do sistema
```

### 4. Acesse o sistema
```
Login Admin:  http://seusite.com/prospecto/login.php
  Celular: admin
  Senha:   password

⚠️ IMPORTANTE: Mude a senha do admin imediatamente após o 1º acesso!
```

---

## 🔑 Como mudar a senha do Admin

No phpMyAdmin, execute:
```sql
USE prospecto;
UPDATE usuarios 
SET senha = '$2y$10$SEU_HASH_AQUI' 
WHERE celular = 'admin';
```

Gere o hash pelo PHP:
```php
<?php echo password_hash('SUA_NOVA_SENHA', PASSWORD_BCRYPT); ?>
```

Ou crie um arquivo `gerar_hash.php` temporário na raiz:
```php
<?php
$senha = 'SuaNovaSenha123';
echo password_hash($senha, PASSWORD_BCRYPT);
```

---

## 📊 Como importar a planilha Excel

1. Abra sua planilha no **Excel** ou **Google Sheets**
2. Certifique-se que tem exatamente **2 colunas**:
   - Coluna A: **Nome da Loja**
   - Coluna B: **Telefone**
   - Linha 1 é o cabeçalho (será ignorada automaticamente)
3. Salve como: `Arquivo → Salvar Como → CSV (separado por ponto-e-vírgula)`
4. No painel Admin → Categorias → escolha a categoria → importe o CSV

**Exemplo de planilha:**
```
Nome da Loja       ; Telefone
Padaria São João   ; (11) 99999-0001
Mercado do Zé      ; (11) 99999-0002
```

---

## 📱 Fluxo do Vendedor

1. **Login** com celular e senha
2. **Tela de Prospecção** — scroll horizontal mostra as categorias
3. Clica na categoria → vê os cards das lojas disponíveis
4. Clica **🎯 Atender Loja** → loja fica vinculada a ele
5. Na aba **Em Atendimento** ele pode:
   - **📞 Ligar WhatsApp** → abre WhatsApp e registra a ligação
   - **✏️ Anotar** → adiciona nota de andamento
   - **📅 Agendar Visita** → informa data e hora, loja sai da lista
   - **❌ Sem Interesse** → informa motivo, loja sai da lista
   - **🕐 Histórico** → vê todo o histórico da loja

---

## 📊 O que o Admin vê

- **Dashboard**: total de lojas, ligações, agendamentos por vendedor
- **Ranking de vendedores**: quem mais ligou, agendou, perdeu clientes
- **Motivos de recusa**: análise dos "nãos" mais comuns
- **Relatório completo**: toda atividade filtrada por vendedor/categoria

---

## ⚙️ Requisitos do Servidor

- PHP 7.4+ (recomendado PHP 8.x)
- MySQL 5.7+ ou MariaDB 10.3+
- Extensões PHP: PDO, PDO_MySQL
- Apache ou Nginx (funciona com .htaccess padrão)

---

## 🆘 Problemas Comuns

**"Erro de conexão"** → Verifique config.php (usuário/senha/nome do banco)

**"Classe PDO não encontrada"** → Habilite a extensão pdo_mysql no php.ini

**Admin não consegue logar** → Confira se o banco.sql foi importado corretamente

**CSV não importa** → Use o separador ponto-e-vírgula (;) não vírgula

---

Desenvolvido para sua equipe de prospecção comercial. 🚀