Bem-vindo ao Sistema Clube Bem Viver
Este tutorial contém todas as informações necessárias para utilizar o sistema de gestão de propostas odontológicas.
1 Navegação Rápida
Use as abas no topo da página para navegar entre os tutoriais:
- Corretor: Criação e acompanhamento de propostas
- Supervisor: Gestão de equipe e aprovação de propostas
- Gerente: Gestão de supervisores e análise de performance
- Filial: Administração de gerentes e relatórios consolidados
- Administrador: Gestão completa do sistema
- Debug: Ferramentas de depuração e logs
2 Novidades da Versão 2.0
- ✅ Sistema de Debug Visual: Console de debug em tempo real
- ✅ Preenchimento Automático: Botão para preencher dados de teste
- ✅ Logs Detalhados: Visualizadores de log para proposta e email
- ✅ Validação Aprimorada: Feedback em tempo real nos formulários
- ✅ Email Automático: Envio de proposta para cliente assinar
- ✅ Dashboard Expandido: Novos filtros e métricas
3 Links Importantes
Tutorial do Corretor
1 Acesso ao Sistema
Para acessar o sistema como corretor:
- Acesse login.html
- Insira seu email e senha cadastrados
- Selecione o sistema "odonto"
- Clique em "Entrar"
2 Criação de Propostas (Nova Funcionalidade!)
Para criar uma nova proposta com as novas ferramentas:
- Clique em "Nova Proposta" no menu principal
- 🆕 USE O DEBUG: Clique em "Mostrar Debug" para ativar o console
- 🆕 PREENCHA RÁPIDO: Clique em "Preencher Dados de Teste" para agilizar
- Preencha os dados do titular:
- Nome completo
- CPF (apenas números)
- RG e órgão expedidor
- Data de nascimento e expedição do RG
- Email e telefone
- Endereço completo
- Adicione dependentes (se houver):
- Clique em "Adicionar Dependente"
- Preencha os dados de cada dependente
- Remova dependentes clicando no "X"
- Selecione o plano desejado
- IMPORTANTE: Anexe os 3 documentos obrigatórios:
- 📄 RG do Titular (frente e verso)
- 📄 CPF do Titular
- 📄 Comprovante de Residência
- Marque todas as 4 declarações obrigatórias
- Clique em "Enviar Proposta e Notificar Cliente"
3 Acompanhamento de Propostas
Para acompanhar suas propostas:
- Acesse "Minhas Propostas" no menu
- Use os filtros para encontrar propostas específicas:
- Por status (pendente, aprovada, rejeitada)
- Por período
- Por nome do cliente
- Verifique o status de cada proposta:
- 🟡 Pendente: Aguardando aprovação
- 🔵 Em análise: Sendo avaliada
- 🟢 Aprovada: Proposta aceita
- 🔴 Rejeitada: Precisa correções
- 📧 Enviada: Email enviado ao cliente
- Clique em "Ver Detalhes" para informações completas
4 Dashboard e Relatórios
No seu dashboard você encontra:
- 📊 Total de propostas enviadas
- ⏳ Propostas em análise
- ✅ Propostas aprovadas
- 💰 Comissões previstas
- 📈 Gráfico de desempenho mensal
- 🎯 Metas e objetivos
5 Ferramentas de Debug (Novo!)
Se encontrar problemas ao enviar propostas:
- Console de Debug: Ative o debug na página de nova proposta
- Mostra validação de cada campo
- Indica campos faltando
- Mostra mensagens de erro detalhadas
- Logs do Sistema: Acesse Verificar Logs
- Veja todas as tentativas de envio
- Identifique erros específicos
- Verifique estatísticas de sucesso
- Logs de Email: Acesse Logs de Email
- Confirme se o email foi enviado
- Veja detalhes do envio
- Taxa de sucesso de envio
Tutorial do Supervisor
1 Gestão de Corretores
Como gerenciar sua equipe de corretores:
- Acesse "Gerenciar Corretores" no menu
- Visualize todos os corretores da sua equipe
- Monitore a performance individual
- Aprove/rejeite propostas pendentes
2 Aprovação de Propostas
Para aprovar propostas:
- Acesse "Propostas Pendentes"
- Analise a documentação enviada
- Verifique os dados preenchidos
- Aprove ou solicite correções
3 Relatórios e Métricas
Acompanhamento de performance:
- Dashboard com métricas da equipe
- Relatórios de produtividade
- Acompanhamento de metas
- Histórico de aprovações
Tutorial do Gerente
1 Gestão de Supervisores
Como gerenciar supervisores:
- Acesse "Gerenciar Supervisores"
- Visualize a estrutura da equipe
- Monitore performance por supervisor
- Defina metas e objetivos
2 Análise de Performance
Acompanhamento de resultados:
- Dashboard gerencial completo
- Relatórios consolidados
- Comparativos entre equipes
- Projeções e tendências
3 Gestão de Metas
Configuração e acompanhamento:
- Defina metas por supervisor
- Acompanhe o progresso
- Ajuste estratégias
- Gere relatórios de performance
Tutorial da Filial
1 Gestão de Gerentes
Administração de gerentes:
- Acesse "Admin Gerentes"
- Cadastre novos gerentes
- Defina territórios e regiões
- Monitore resultados globais
2 Relatórios Consolidados
Análise de dados da filial:
- Visão geral da operação
- Resultados por gerente
- Análise de conversão
- Relatórios financeiros
3 Configurações da Filial
Gestão de parâmetros:
- Configure metas globais
- Defina políticas de aprovação
- Ajuste parâmetros do sistema
- Gerencie permissões
Tutorial do Administrador
1 Gestão do Sistema
Administração completa:
- Acesse "Admin Sistema"
- Gerencie todas as filiais
- Configure parâmetros globais
- Monitore logs do sistema
2 Gestão de Usuários
Administração de acessos:
- Gerencie todos os níveis de usuário
- Configure permissões
- Resete senhas
- Monitore atividades
3 Configurações Avançadas
Parametrização do sistema:
- Configure regras de negócio
- Defina workflows de aprovação
- Gerencie integrações
- Configure backup e segurança
Ferramentas de Debug e Logs
Novidade: Sistema completo de debug para identificar e resolver problemas rapidamente!
1 Console de Debug (Frontend)
Ferramenta visual na página de nova proposta:
- Ativação: Clique em "Mostrar Debug" na página
- Cores dos logs:
- 🔵 Azul = Informação
- 🟢 Verde = Sucesso
- 🟡 Amarelo = Aviso
- 🔴 Vermelho = Erro
- ⚪ Cinza = Dados
- Informações mostradas:
- Validação de cada campo individual
- Documentos anexados
- Declarações marcadas
- Estatísticas (X/Y campos OK)
- URL de redirecionamento
- Mensagens de erro detalhadas
- Limpar logs: Clique em "Limpar Debug"
2 Visualizador de Logs de Propostas
Acesse: php/verificar_logs_proposta.php
Esta página mostra:
- 📊 Estatísticas:
- Total de tentativas de envio
- Sucessos e erros
- Taxa de sucesso
- Tamanho do arquivo de log
- 📝 Logs detalhados:
- Últimas 500 linhas do log
- Timestamp de cada evento
- Mensagens coloridas por tipo
- Auto-refresh a cada 10 segundos
- 🔍 O que procurar:
- ✅ "VALIDAÇÃO PASSOU" = Campos OK
- ✅ "PROPOSTA CRIADA" = Salvou no banco
- ❌ "ERRO INSERT" = Erro no banco de dados
- ❌ "VALIDAÇÃO FALHOU" = Campos faltando
- 🗑️ Limpar logs: Botão para apagar arquivo de log
3 Visualizador de Logs de Email
Acesse: php/verificar_logs_email.php
Esta página mostra:
- 📧 Estatísticas de envio:
- Total de tentativas
- Emails enviados com sucesso
- Falhas no envio
- Taxa de sucesso (%)
- 📋 Detalhes do log:
- Últimas 300 linhas
- Horário de cada tentativa
- Destinatário do email
- Status (sucesso/falha)
- Mensagem de erro (se houver)
- 🔄 Auto-refresh: Atualiza a cada 15 segundos
4 Ferramenta de Teste Rápido
Na página de Nova Proposta:
- Clique em "Preencher Dados de Teste"
- O sistema preenche automaticamente:
- Nome com timestamp único (ex: "Cliente Teste 1234567890")
- CPF válido gerado
- RG e dados pessoais
- Email único (teste_1234567890@exemplo.com)
- Telefone e endereço completo
- Datas de nascimento e expedição
- IMPORTANTE: Você ainda precisa:
- Fazer upload dos 3 documentos
- Marcar as 4 declarações
- Selecionar o plano (se não estiver selecionado)
5 Solucionando Problemas Comuns
❌ Erro: "Erro interno do sistema"
- 1. Acesse php/verificar_logs_proposta.php
- 2. Procure por "❌ ERRO INSERT"
- 3. Veja a mensagem de erro específica
- 4. Comum: campo obrigatório faltando ou formato incorreto
❌ Erro: "Email não chegou"
- 1. Acesse php/verificar_logs_email.php
- 2. Verifique se o email foi enviado
- 3. Confira o destinatário está correto
- 4. Peça ao cliente verificar spam/lixo eletrônico
❌ Erro: "Campos faltando"
- 1. Ative o console de debug
- 2. Veja a lista de campos faltantes
- 3. Preencha os campos indicados
- 4. Tente enviar novamente
❌ Erro: "Documentos não anexados"
- 1. Verifique se anexou os 3 documentos obrigatórios
- 2. Formatos aceitos: JPG, PNG, PDF
- 3. Tamanho máximo: 5MB por arquivo
- 4. O console de debug mostra quais documentos faltam
6 Interpretando os Logs
Sequência normal de sucesso:
[2025-10-06 10:30:15] ✅ VALIDAÇÃO PASSOU - Todos os campos OK [2025-10-06 10:30:15] 🔄 Iniciando INSERT na tabela propostas... [2025-10-06 10:30:15] ✅ PROPOSTA CRIADA - ID: 123 | Hash: abc123def456 [2025-10-06 10:30:15] === DEBUG EMAIL === [2025-10-06 10:30:15] enviar_email flag: SIM [2025-10-06 10:30:15] 📧 Destinatário: cliente@email.com [2025-10-06 10:30:16] ✅ EMAIL ENVIADO COM SUCESSO! [2025-10-06 10:30:16] 🔚 Redirecionando para: ../minhas_propostas.php?success=1&email_enviado=1
Exemplo de erro:
[2025-10-06 10:30:15] ❌ VALIDAÇÃO FALHOU - Campos faltando: email_titular, telefone_titular [2025-10-06 10:30:15] 🔚 Redirecionando para: ../nova_proposta.php?error=validation&msg=Campos+obrigatórios+faltando