Pipeline CRM — Board e Deals
O Pipeline CRM fica em Menu lateral → Pipeline (rota /pipeline). É um quadro kanban de oportunidades de venda onde cada card representa um deal (negócio/oportunidade).
O que você vê na tela
Barra de filtros (topo)
| Elemento | O que faz |
|---|---|
| Seletor de Pipeline | Aparece apenas se a empresa tiver mais de um pipeline cadastrado. Troca o board exibido. |
| Filtro por Responsável | Lista todos os usuários. Selecione um para ver só os deals dele. "Todos" mostra tudo. |
| Campo de busca | Filtra pelo título do deal ou pelo nome do contato (em tempo real, sem precisar clicar em buscar). |
Botão "Novo Deal"
Fica no canto superior direito. Abre o modal de criação de deal. Fica desabilitado se não existir nenhum estágio configurado no pipeline.
Colunas (estágios)
Cada coluna representa um estágio do pipeline. O cabeçalho de cada coluna mostra:
- Bolinha colorida — cor configurada pelo admin no estágio
- Nome do estágio
- Contador de deals (número à direita do nome)
- Total em R$ dos deals da coluna (soma dos valores)
Colunas marcadas como estágio final ficam recolhidas por padrão (mostram apenas um número na lateral). Clique na seta para expandir. Você não pode arrastar um deal para um estágio final diretamente — use o botão "Ganho" ou "Perdido" dentro do deal.
Card de deal
Cada card exibe:
| Campo | Onde aparece |
|---|---|
| Título do deal | Linha superior em negrito |
| Nome do contato | Linha abaixo do título em cinza |
| Valor (R$) | Lado esquerdo do rodapé do card |
| Responsável | Avatar com iniciais no canto direito |
| Data prevista de fechamento | Rodapé esquerdo |
| Indicador de inatividade | Badge laranja (> 7 dias sem atualização) ou vermelho (> 14 dias) com o número de dias |
Tooltip do responsável
Passe o mouse sobre o avatar para ver o nome completo do responsável.
Criar um novo deal
- Clique em Novo Deal (canto superior direito).
- Preencha os campos no modal:
| Campo | Obrigatório | Descrição |
|---|---|---|
| Contato | Sim | Digite ao menos 3 letras para buscar. O sistema sugere contatos cadastrados. |
| Título | Sim | Nome da oportunidade (ex.: "Pacote Premium — João Silva"). |
| Valor (R$) | Não | Valor estimado da venda. Pode deixar em branco e preencher depois. |
| Data de fechamento prevista | Não | Data esperada para concluir o negócio. |
| Estágio | Sim | Em qual coluna o deal começa. Estágios finais não aparecem aqui. |
| Responsável | Não | Quem cuida deste deal. O padrão é o usuário logado. |
- Clique em Criar.
O deal aparece imediatamente na coluna do estágio escolhido sem precisar recarregar a página.
Contato obrigatório
Não é possível criar um deal sem vincular a um contato existente. Cadastre o contato primeiro em Contatos se ele ainda não existir.
Mover um deal entre estágios
Arraste o card da coluna atual para a coluna de destino. A movimentação é instantânea na tela (atualização otimista) e sincronizada com o servidor em segundo plano. Se houver falha de rede, o card volta automaticamente para a posição original e aparece uma mensagem de erro.
Colaboração em tempo real
Se outro usuário mover um deal ao mesmo tempo, o quadro atualiza automaticamente via WebSocket sem precisar recarregar.
Abrir o detalhe de um deal
Clique em qualquer card para abrir o painel lateral (drawer) com todos os campos e o histórico do deal. Consulte Detalhes do Deal para a documentação completa do painel.
Estado vazio
| Situação | O que a tela mostra |
|---|---|
| Nenhum pipeline configurado | Mensagem pedindo para criar um pipeline (admin precisa agir primeiro) |
| Pipeline sem deals | Mensagem com botão "Novo Deal" no centro do board |
| Filtro não retornou resultados | Mensagem discreta abaixo do board informando que nenhum deal corresponde ao filtro |