Tutorial do Sistema

Guia completo de uso do Clube Bem Viver Benefícios

Atualizado em 06/10/2025 - Versão 2.0

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
Dica: Mantenha este tutorial aberto em outra aba para consulta rápida durante o uso do sistema.

Tutorial do Corretor

1 Acesso ao Sistema

Para acessar o sistema como corretor:

  1. Acesse login.html
  2. Insira seu email e senha cadastrados
  3. Selecione o sistema "odonto"
  4. Clique em "Entrar"
Dica: Não tem cadastro ainda? Clique aqui para se cadastrar

2 Criação de Propostas (Nova Funcionalidade!)

Para criar uma nova proposta com as novas ferramentas:

  1. Clique em "Nova Proposta" no menu principal
  2. 🆕 USE O DEBUG: Clique em "Mostrar Debug" para ativar o console
  3. 🆕 PREENCHA RÁPIDO: Clique em "Preencher Dados de Teste" para agilizar
  4. 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
  5. Adicione dependentes (se houver):
    • Clique em "Adicionar Dependente"
    • Preencha os dados de cada dependente
    • Remova dependentes clicando no "X"
  6. Selecione o plano desejado
  7. IMPORTANTE: Anexe os 3 documentos obrigatórios:
    • 📄 RG do Titular (frente e verso)
    • 📄 CPF do Titular
    • 📄 Comprovante de Residência
  8. Marque todas as 4 declarações obrigatórias
  9. Clique em "Enviar Proposta e Notificar Cliente"
Dica: O console de debug mostra em tempo real se há campos faltando ou erros na validação!
Novo! Após enviar a proposta, o cliente receberá automaticamente um email com link para assinar digitalmente a proposta.

3 Acompanhamento de Propostas

Para acompanhar suas propostas:

  1. Acesse "Minhas Propostas" no menu
  2. Use os filtros para encontrar propostas específicas:
    • Por status (pendente, aprovada, rejeitada)
    • Por período
    • Por nome do cliente
  3. 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
  4. 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:

  1. 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
  2. Logs do Sistema: Acesse Verificar Logs
    • Veja todas as tentativas de envio
    • Identifique erros específicos
    • Verifique estatísticas de sucesso
  3. 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:

  1. Acesse "Gerenciar Corretores" no menu
  2. Visualize todos os corretores da sua equipe
  3. Monitore a performance individual
  4. Aprove/rejeite propostas pendentes

2 Aprovação de Propostas

Para aprovar propostas:

  1. Acesse "Propostas Pendentes"
  2. Analise a documentação enviada
  3. Verifique os dados preenchidos
  4. Aprove ou solicite correções
Dica: Configure alertas para novas propostas pendentes.

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:

  1. Acesse "Gerenciar Supervisores"
  2. Visualize a estrutura da equipe
  3. Monitore performance por supervisor
  4. 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:

  1. Defina metas por supervisor
  2. Acompanhe o progresso
  3. Ajuste estratégias
  4. Gere relatórios de performance

Tutorial da Filial

1 Gestão de Gerentes

Administração de gerentes:

  1. Acesse "Admin Gerentes"
  2. Cadastre novos gerentes
  3. Defina territórios e regiões
  4. 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:

  1. Configure metas globais
  2. Defina políticas de aprovação
  3. Ajuste parâmetros do sistema
  4. Gerencie permissões

Tutorial do Administrador

1 Gestão do Sistema

Administração completa:

  1. Acesse "Admin Sistema"
  2. Gerencie todas as filiais
  3. Configure parâmetros globais
  4. Monitore logs do sistema

2 Gestão de Usuários

Administração de acessos:

  1. Gerencie todos os níveis de usuário
  2. Configure permissões
  3. Resete senhas
  4. 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
Dica: Mantenha um registro de todas as alterações de configuração.

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"
Dica: O console abre automaticamente quando há erro ou sucesso!

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
Dica: Se o email não chegou, verifique aqui se foi enviado com sucesso!

4 Ferramenta de Teste Rápido

Na página de Nova Proposta:

  1. Clique em "Preencher Dados de Teste"
  2. 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
  3. IMPORTANTE: Você ainda precisa:
    • Fazer upload dos 3 documentos
    • Marcar as 4 declarações
    • Selecionar o plano (se não estiver selecionado)
Dica: Use esta função para testar o sistema rapidamente sem digitar todos os dados!

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