📤 ENCAMINHAR CONVERSA - IMPLEMENTAÇÃO

=====================================================
ARQUIVOS CRIADOS
=====================================================

1. popup-encaminhar.php
   - HTML + CSS + JS do popup
   - Inclua em sua página principal antes de </body>

2. listar_usuarios.php
   - API que retorna lista de usuários ativos
   - Retorna JSON com id, nome, tipo_usuario, iniciais

3. encaminhar_conversa.php
   - API que faz o UPDATE nas tabelas
   - Atualiza: contatos.usuario_id, conversas.usuario_id
   - Reseta: mensagem_lida2 = 0 (para notificar novo dono)

4. topo-atualizado.php
   - Versão do topo.php com botão funcionando
   - Substitua seu topo.php por este


=====================================================
COMO IMPLEMENTAR
=====================================================

PASSO 1: Incluir o popup no seu HTML principal
───────────────────────────────────────────────

No seu dashboard.php ou wherever você carrega chat, adicione:

```php
<?php include 'popup-encaminhar.php'; ?>
```

Antes de </body>


PASSO 2: Substituir topo.php
───────────────────────────────

Se estiver usando topo.php como arquivo separado:

1. Renomeie seu topo.php para topo-backup.php
2. Renomeie topo-atualizado.php para topo.php

OU copie a linha do botão Encaminhar manualmente


PASSO 3: Verificar se está funcionando
─────────────────────────────────────────

1. Abra um contato
2. Clique no menu (⋮) no topo
3. Clique em "Encaminhar"
4. Deve aparecer popup com lista de usuários


=====================================================
O QUE ACONTECE QUANDO ENCAMINHA
=====================================================

✅ Tabela CONTATOS:
   - usuario_id → muda para o novo usuário
   - mensagem_lida2 → muda para 0 (marca como não lido para novo dono)
   - atualizado_em → atualiza timestamp

✅ Tabela CONVERSAS:
   - usuario_id → muda para o novo usuário em TODAS as linhas
   - atualizado_em → atualiza timestamp

✅ LOG:
   - Adiciona mensagem de sistema indicando encaminhamento

✅ PERMISSÕES:
   - Só usuário dono do contato pode encaminhar
   - Usuário atual é excluído da lista


=====================================================
FLUXO NO NAVEGADOR
=====================================================

1. Clica "Encaminhar" → abre popup
2. Lista carrega com fetch de listar_usuarios.php
3. Clica em um usuário → seleciona (botão ativa)
4. Clica "Encaminhar" → POST para encaminhar_conversa.php
5. Se sucesso → reload da página
6. Novo usuário vê contato com brilho (msg-nao-lida)


=====================================================
CUSTOMIZAR ESTILO
=====================================================

Se quiser mudar cores/tamanho do popup, edite em popup-encaminhar.php:

- .popup-encaminhar-container → tamanho/posição
- .popup-encaminhar-header → header color
- .btn-encaminhar → cor do botão principal
- .usuario-item.ativo → cor quando selecionado


=====================================================
TESTANDO
=====================================================

F12 > Console enquanto encaminha, deve ver:

📤 Abrindo popup para encaminhar contato: 118
✅ Usuário selecionado: 5
📤 Encaminhando contato 118 para usuário 5
(depois) ✅ Conversa encaminhada com sucesso!
