# Gestão de Leads - README

## Visão Geral

Este sistema de Gestão de Leads é uma solução completa para captura, qualificação, distribuição e acompanhamento de leads em processos comerciais. Ele permite o gerenciamento eficiente do ciclo de vida do lead, desde a captação até a conversão em cliente.

## Funcionalidades Principais

- **Captura de Leads:** Importação via CSV, integração com formulários e APIs.
- **Qualificação:** Filtros avançados, avaliação e status customizados.
- **Distribuição:** Atribuição automática e manual de leads para equipes e vendedores.
- **Atendimento:** Registro de interações, cronômetro de atendimento e histórico.
- **Relatórios:** Dashboards e gráficos para análise de performance e origem dos leads.
- **Controle de Acesso:** Permissões baseadas em contratos e hierarquia de equipes.

## Estrutura do Sistema

- **Arquivos principais:**
  - `adm-leads.php`: Dashboard principal de leads.
  - `adm-leads-novos.php`: Gerenciamento de leads recém-chegados.
  - `adm-meus-leads.php`: Leads atribuídos ao usuário.
  - `adm-lead-atendimento.php`: Tela de atendimento individual.
  - `rel-leads.php` e `rel-equipe-leads.php`: Relatórios e análises.
- **Classes e Helpers:**
  - `includes/classes/LeadClass.php`: Lógica principal de negócios.
  - `includes/helpers/LeadHelper.php`: Funções auxiliares para formatação.
- **Modais e Widgets:**
  - Modais para filtros, importação, conversão, avaliação e histórico.
  - Widgets para resumo, origem e cronômetro de leads.
- **Gráficos:**
  - Diversos gráficos para status, origem, equipe, horário e ranking.

## Status dos Leads

- `novo`, `em_espera`, `em_andamento`, `agendado`, `aguardando`, `ganho`, `perdido`, `sem_interesse`, `invalido`.

## Como Usar

1. **Importar Leads:** Utilize o modal de importação para carregar arquivos CSV.
2. **Filtrar e Visualizar:** Use os filtros para segmentar leads por status, origem, equipe, etc.
3. **Atribuir Leads:** Distribua leads para vendedores ou equipes manualmente ou automaticamente.
4. **Atender Leads:** Registre interações e atualize status durante o atendimento.
5. **Gerar Relatórios:** Acesse relatórios para análise de performance e tomada de decisão.

## Requisitos Técnicos

- PHP 7.4+
- Banco de dados MySQL com tabelas prefixadas (`wp_`).
- Integração com WordPress para usuários e permissões.
- Bibliotecas JS para gráficos e datatables.

## Contato e Suporte

Para dúvidas ou suporte, entre em contato com a equipe de desenvolvimento ou consulte a documentação técnica detalhada.

---

*Este README foi gerado automaticamente com base nos arquivos do sistema de Leads.*
