# Zazz Vendas — Guia de instalação no cPanel

Sistema de gestão de vendas com login por perfil (vendedor / gestor),
banco MySQL e assistente de IA. PHP 8.1 puro, sem framework.

---

## 1. Estrutura de arquivos

```
comercial/
  config/
    database.php       ← credenciais do banco (já preenchidas)
    app.php             ← chave da API Anthropic (você precisa colar a sua)
    .htaccess            ← bloqueia acesso direto a esta pasta
  includes/
    auth.php
    functions.php
    .htaccess
  vendedor/              ← telas do vendedor
  gestor/                ← telas do gestor
  api/                   ← endpoints que gravam no banco e chamam a IA
  assets/
    style.css
  login.php
  logout.php
  setup.php              ← criar o 1º gestor (EXCLUIR depois de usar!)
  database.sql           ← script para criar as tabelas
```

---

## 2. Subir os arquivos — via FTP (mais simples)

1. No cPanel, vá em **Contas FTP** e crie um usuário FTP (ou use o usuário principal).
2. Anote: **host** (geralmente `ftp.wifixsolucoes.com.br`), **usuário**, **senha**, **porta 21**.
3. Baixe um cliente FTP gratuito: **FileZilla** (https://filezilla-project.org).
4. Em FileZilla, conecte com esses dados.
5. No painel direito (servidor), navegue até `public_html/`.
6. Crie uma pasta chamada `comercial`.
7. Arraste a pasta inteira do projeto (todos os arquivos que te entreguei) para dentro de `public_html/comercial/`.

Pronto — o site fica acessível em `http://wifixsolucoes.com.br/comercial/`.

---

## 3. Subir os arquivos — via SSH (mais rápido, se preferir terminal)

1. No cPanel, vá em **SSH Access** (ou peça à hospedagem para habilitar, se não aparecer).
2. Gere ou copie sua chave SSH, ou anote usuário/senha de acesso SSH.
3. No seu computador, abra o terminal e conecte:
   ```bash
   ssh seu_usuario@wifixsolucoes.com.br -p 22
   ```
4. Navegue até a pasta pública:
   ```bash
   cd public_html
   mkdir comercial
   cd comercial
   ```
5. Para subir os arquivos do seu PC para o servidor, use `scp` a partir do seu computador (não de dentro do SSH):
   ```bash
   scp -r C:\claude\comercial\* seu_usuario@wifixsolucoes.com.br:public_html/comercial/
   ```
   (ajuste o caminho `C:\claude\comercial` para onde você salvou os arquivos)

---

## 4. Criar as tabelas do banco de dados

1. No cPanel, abra **phpMyAdmin**.
2. No menu lateral esquerdo, clique no banco `wifixsolucoescom_zazzvendas`.
3. Clique na aba **Importar** (Import).
4. Selecione o arquivo `database.sql` que está na raiz do projeto.
5. Clique em **Executar/Go**.

Isso cria todas as tabelas: usuários, referidos, leads PAP, ligações, vendas, pontuação e rotina diária.

---

## 5. Criar o primeiro gestor

1. Acesse no navegador: `http://wifixsolucoes.com.br/comercial/setup.php`
2. Preencha seu nome, e-mail e uma senha forte.
3. Clique em **Criar conta de gestor**.
4. **IMPORTANTE**: depois disso, **exclua o arquivo `setup.php`** do servidor (via FTP ou SSH) — ele não deve continuar acessível, por segurança.
   ```bash
   rm public_html/comercial/setup.php
   ```

---

## 6. Configurar a chave da IA (opcional, mas recomendado)

1. Crie uma conta em https://console.anthropic.com
2. Gere uma chave de API em **Settings → API Keys**
3. Edite o arquivo `config/app.php` no servidor (pode editar direto pelo **Editor de arquivos** do cPanel, ou via FTP) e troque:
   ```php
   define('ANTHROPIC_API_KEY', 'COLE_SUA_CHAVE_AQUI');
   ```
   pela sua chave real.

Sem isso, o sistema funciona normalmente — só o chat de IA fica desativado e mostra uma mensagem avisando.

---

## 7. Testar o sistema

1. Acesse `http://wifixsolucoes.com.br/comercial/login.php`
2. Entre com o e-mail/senha que você criou no `setup.php` — você vai cair direto no **painel do gestor**.
3. No painel do gestor, vá em **Vendedores → + Novo vendedor** e crie o primeiro vendedor de teste.
4. Faça logout e entre com a conta do vendedor — você vai cair na tela **"Hoje"**, com a rotina diária, referidos e PAP.

---

## 8. Segurança — checklist final

- [ ] Excluir `setup.php` do servidor depois do primeiro uso
- [ ] Trocar a senha do banco de dados (a que foi usada nesta conversa) pelo **Assistente de banco de dados MySQL** no cPanel, e atualizar `config/database.php` com a nova senha
- [ ] Confirmar que `config/.htaccess` e `includes/.htaccess` estão no servidor (bloqueiam acesso direto a essas pastas)
- [ ] Ativar HTTPS no domínio (cPanel → SSL/TLS Status → AutoSSL), se ainda não estiver ativo
- [ ] Fazer backup periódico do banco via phpMyAdmin → Exportar

---

## 9. Estrutura do banco (resumo)

| Tabela            | O que guarda                                  |
|--------------------|------------------------------------------------|
| `usuarios`         | Login, nome, papel (vendedor/gestor), meta     |
| `referidos`        | Indicados pelo fluxo de referidos              |
| `leads_pap`        | Contatos capturados no porta a porta           |
| `ligacoes`         | Histórico de toda ligação registrada           |
| `vendas`           | Vendas fechadas                                |
| `pontos_log`       | Histórico de pontos ganhos (auditoria)         |
| `pontuacao_config` | Valores de pontos por atividade (editável)     |
| `rotina_diaria`    | Checklist diário marcado por vendedor          |

---

Qualquer erro de conexão com banco, confira `config/database.php` —
host, nome do banco, usuário e senha precisam ser exatamente os do cPanel.