Vibe Coding 22 visualizacoes

Prompt CRM - Sales

E-commerce CRM ERP Vendas Redes Sociais
ESCOPO

CRM padrão de mercado com foco em vendas, usando o anexo como referência. O CRM deve atender empresas B2B com vendas consultivas, contratos recorrentes, projetos de longo prazo e gestão comercial completa.


Inclua módulos de leads, clientes, contatos, oportunidades, funil de vendas, atividades, agenda, propostas, produtos e serviços, contratos, metas, forecast, comissões, dashboards, permissões, integrações, automações e IA comercial.

Considere como fluxo principal:
Lead → Qualificação → Oportunidade → Diagnóstico → Proposta → Negociação → Fechamento → Contrato → Renovação → Upsell/Cross-sell

13 modulos 6 agentes Pronto para usar
Projeto
Prompt principal + estrutura complementar
Prompt para criação de CRM padrão de mercado com foco em vendas

Crie a especificação completa de um CRM padrão de mercado com foco em vendas, voltado para empresas B2B que precisam controlar leads, clientes, oportunidades comerciais, propostas, contratos, metas, forecast, atividades comerciais, carteira de clientes e relatórios gerenciais.

Use como base o conteúdo do anexo enviado, que descreve as principais funcionalidades esperadas para um CRM comercial moderno.

O objetivo é construir um CRM robusto, escalável, simples de usar e com visão clara do processo comercial, desde a entrada do lead até o fechamento da venda, contrato, renovação, upsell e cross-sell.

1. Objetivo do sistema

Descrever o CRM como uma plataforma para:

Capturar e organizar leads;
Gerenciar clientes e contatos;
Controlar oportunidades comerciais;
Acompanhar o funil de vendas;
Automatizar follow-ups;
Criar e acompanhar propostas comerciais;
Controlar contratos e recorrência;
Gerenciar metas comerciais;
Fazer previsão de vendas;
Acompanhar indicadores e dashboards;
Apoiar gestores, vendedores, SDRs, pré-vendas, marketing, financeiro e diretoria.

O CRM deve ajudar a empresa a vender mais, reduzir perda de oportunidades, melhorar previsibilidade de receita e centralizar todo o histórico comercial do cliente.
MVP de CRM padrão de mercado com foco em vendas, pensado para começar enxuto, mas já com base forte para evoluir depois.

MVP — CRM com foco em vendas
1. Objetivo do MVP

Criar a primeira versão de um CRM comercial para controlar:

Leads → Clientes → Oportunidades → Propostas → Follow-ups → Fechamento → Relatórios

O MVP deve resolver o problema principal: dar visibilidade ao time comercial sobre quem está sendo atendido, em qual etapa está cada venda, quanto existe no pipeline e quais ações precisam ser feitas.

A base vem das funcionalidades principais do anexo: cadastro de leads/clientes, funil, oportunidades, atividades, propostas, metas, forecast e relatórios comerciais.
CRUD — MVP CRM com foco em vendas
Visão geral do fluxo

O CRM deve seguir este fluxo principal:

Lead → Cliente → Oportunidade → Proposta → Atividades/Follow-ups → Fechamento → Relatórios

A ideia é começar enxuto, mas com estrutura pronta para evoluir depois com automações, WhatsApp, e-mail, ERP, comissão, contratos e IA.

1. CRUD de Usuários

Usado para controlar vendedores, gestores e administradores.

| Campo         |     Tipo | Obrigatório | Observação                 |
| ------------- | -------: | ----------: | -------------------------- |
| id            | UUID/INT |         Sim | Identificador              |
| nome          |    Texto |         Sim | Nome do usuário            |
| email         |    Texto |         Sim | Login                      |
| telefone      |    Texto |         Não | WhatsApp ou celular        |
| cargo         |    Texto |         Não | Ex: Vendedor, SDR, Gerente |
| perfil        |     Enum |         Sim | admin, gestor, vendedor    |
| status        |     Enum |         Sim | ativo, inativo             |
| data_criacao  |     Data |         Sim | Automático                 |
| ultimo_acesso |     Data |         Não | Controle de uso            |


Ações CRUD
Ação	Descrição
Criar	Cadastrar novo usuário
Listar	Ver usuários cadastrados
Visualizar	Ver detalhes do usuário
Editar	Alterar dados e perfil
Inativar	Remover acesso sem apagar histórico

Endpoints sugeridos
POST   /usuarios
GET    /usuarios
GET    /usuarios/{id}
PUT    /usuarios/{id}
PATCH  /usuarios/{id}/inativar
Modulos
Módulos do Projeto
13 módulos incluídos
1
Módulos do MVP Master Tela inicial com visão rápida da operação.
MVP CRUD Incluso
v
criar 

Indicadores principais
Total de leads;
Leads novos;
Leads em atendimento;
Oportunidades abertas;
Valor total do pipeline;
Propostas enviadas;
Vendas ganhas;
Vendas perdidas;
Forecast do mês;
Atividades atrasadas;
Ranking de vendedores.
Filtros
Período;
Vendedor;
Etapa do funil;
Origem do lead;
Produto ou serviço;
Status da oportunidade.
2
Leads Controle dos potenciais clientes antes de virarem oportunidade — qualificação, atendimento...
MVP CRUD Incluso
v
OBJETIVO
Controlar potenciais clientes desde a entrada até a qualificação e conversão.

CAMPOS PRINCIPAIS
- Nome do lead / Empresa / CNPJ ou CPF
- Segmento / Porte da empresa
- Cidade / Estado
- Nome do contato / Cargo
- E-mail / Telefone / WhatsApp
- Origem do lead (site, indicação, evento, anúncio, prospecção...)
- Produto ou serviço de interesse
- Status do lead
- Responsável comercial
- Data de entrada / Primeiro contato / Última interação
- Próxima ação / Data da próxima ação
- Observações

STATUS DO LEAD
1. Novo
2. Em contato
3. Qualificado
4. Não qualificado
5. Convertido em oportunidade
6. Perdido

REGRAS DE NEGÓCIO
- Todo lead precisa ter um responsável atribuído
- Lead qualificado pode ser convertido: cria Cliente + Oportunidade automaticamente
- Lead perdido exige motivo de perda obrigatório
- Lead sem contato por X dias gera alerta no dashboard
- Ao converter, o lead fica como "Convertido" e não pode ser editado

TELA DE LISTA
- Tabela com colunas configuráveis
- Filtros: status, responsável, origem, período, segmento
- Busca por nome, empresa, CNPJ, e-mail
- Ações rápidas: editar, converter, perder
- Botão "Novo Lead"
3
Clientes Base central de empresas e clientes — dados cadastrais, responsável, status e histórico co...
MVP CRUD Incluso
v
OBJETIVO
Base central de todas as empresas atendidas ou em atendimento.

CAMPOS PRINCIPAIS
- Razão social / Nome fantasia
- CNPJ (único na base)
- Segmento / Porte
- Site
- Cidade / Estado / Endereço completo
- Status do cliente
- Responsável pela conta
- Origem (como entrou na base)
- Observações
- Histórico comercial (automático)

STATUS DO CLIENTE
1. Prospect
2. Cliente ativo
3. Cliente inativo
4. Ex-cliente

REGRAS DE NEGÓCIO
- CNPJ deve ser único na base (sem duplicatas)
- Cliente pode ter múltiplos contatos vinculados
- Cliente pode ter múltiplas oportunidades simultaneamente
- Histórico exibe: interações, propostas, oportunidades e atividades
- Responsável pela conta deve ser um usuário ativo
- Ao converter um lead, o cliente é criado automaticamente

TELA DE CADASTRO
- Aba: Dados da empresa
- Aba: Contatos vinculados
- Aba: Oportunidades
- Aba: Histórico comercial
4
Contatos Pessoas vinculadas a cada cliente — múltiplos contatos por empresa com tipo e nível de inf...
MVP CRUD Incluso
v
OBJETIVO
Cadastro de pessoas (contatos) vinculadas a cada empresa/cliente.

CAMPOS PRINCIPAIS
- Nome completo
- Cargo / Departamento
- E-mail / Telefone / WhatsApp
- Tipo de contato
- Nível de influência (Alto / Médio / Baixo)
- Observações
- Contato principal? (sim/não)

TIPOS DE CONTATO
1. Decisor
2. Influenciador
3. Técnico
4. Financeiro
5. Compras
6. Usuário final

REGRAS
- Todo contato precisa estar vinculado a um cliente
- Um cliente pode ter N contatos
- Ao criar uma oportunidade, o contato principal é selecionado
- O mesmo contato pode aparecer em múltiplas oportunidades do mesmo cliente
- Contatos são exibidos em aba dentro da tela do cliente
5
Funil de Vendas Coração do CRM — visualização Kanban das oportunidades por etapa com probabilidade e valor...
MVP CRUD Incluso
v
OBJETIVO
Controle visual das etapas de venda em formato Kanban.

ETAPAS PADRÃO DO MVP
1. Lead novo — 5%
2. Primeiro contato — 10%
3. Qualificação — 20%
4. Diagnóstico — 35%
5. Proposta enviada — 50%
6. Negociação — 70%
7. Fechamento — 90%
8. Ganhou — 100%
9. Perdido — 0%

FUNCIONALIDADES
- Visualização Kanban (colunas por etapa)
- Arrastar oportunidade entre etapas (drag and drop)
- Cada coluna exibe: nome da etapa, total de oportunidades e valor somado
- Card da oportunidade: nome, cliente, valor, responsável, data prevista
- Filtros no Kanban: vendedor, produto, período de fechamento
- Gestor pode editar nomes e probabilidades das etapas

COMPORTAMENTOS ESPECIAIS
- Mover para "Ganhou" → modal para confirmar valor final
- Mover para "Perdido" → modal obrigatório de motivo de perda
- Oportunidades paradas há X dias recebem indicador visual de alerta

PROBABILIDADE SUGERIDA POR ETAPA
Lead novo: 5% | Primeiro contato: 10% | Qualificação: 20%
Diagnóstico: 35% | Proposta enviada: 50% | Negociação: 70%
Fechamento: 90% | Ganhou: 100% | Perdido: 0%
6
Oportunidades Cada possível venda vira uma oportunidade — valor, probabilidade, etapa, responsável e pró...
MVP CRUD Incluso
v
OBJETIVO
Registrar e controlar cada possível venda em andamento.

CAMPOS PRINCIPAIS
- Nome da oportunidade
- Cliente vinculado / Contato principal
- Produto ou serviço
- Valor estimado
- Valor recorrente mensal (se houver)
- Valor único (se houver)
- Probabilidade de fechamento (%)
- Etapa do funil
- Data prevista de fechamento
- Responsável comercial
- Origem
- Necessidade do cliente
- Próxima ação / Data da próxima ação
- Status / Motivo de perda (obrigatório se perdida)
- Observações

STATUS DA OPORTUNIDADE
1. Aberta
2. Em andamento
3. Parada
4. Ganha
5. Perdida
6. Cancelada

REGRAS DE NEGÓCIO
- Toda oportunidade deve estar em uma etapa do funil
- Ao ganhar: registrar valor final confirmado e data
- Ao perder: motivo de perda é obrigatório
- Oportunidade parada por X dias gera alerta automático
- Toda oportunidade deve ter próxima ação cadastrada
- Forecast = valor × probabilidade / 100
7
Atividades e Follow-ups Controle das ações comerciais — ligações, reuniões, visitas, follow-ups e tarefas com aler...
MVP CRUD Incluso
v
OBJETIVO
Controlar todas as ações comerciais do time de vendas.

TIPOS DE ATIVIDADE
1. Ligação
2. Reunião
3. E-mail
4. WhatsApp
5. Visita
6. Demonstração
7. Envio de proposta
8. Follow-up
9. Tarefa interna

CAMPOS PRINCIPAIS
- Tipo da atividade
- Cliente vinculado
- Oportunidade vinculada (opcional)
- Responsável
- Data e hora
- Prioridade (Alta / Média / Baixa)
- Status
- Descrição do que foi ou será feito
- Resultado (preenchido ao concluir)
- Próxima ação sugerida

STATUS
1. Pendente
2. Concluída
3. Atrasada
4. Cancelada

ALERTAS AUTOMÁTICOS
- Atividade vencida: não concluída após data e hora
- Proposta sem retorno em X dias
- Oportunidade sem movimentação em X dias
- Lead novo sem primeiro contato em X horas

TELAS
- Lista de atividades com filtros (tipo, status, responsável, data)
- Calendário simples: dia e semana
- Atividades vencidas destacadas no topo
- Modal "Concluir" com campo de resultado e próxima ação
8
Propostas Comerciais Controle de propostas — número automático, valor, desconto, validade, status e vínculo com...
MVP CRUD Incluso
v
OBJETIVO
Controlar propostas enviadas aos clientes com rastreamento de status e vínculo ao funil.

CAMPOS PRINCIPAIS
- Número da proposta (gerado automaticamente: PROP-0001)
- Cliente / Oportunidade vinculada
- Produto ou serviço
- Valor bruto / Desconto (% ou R$) / Valor final
- Validade da proposta (data)
- Condição de pagamento
- Prazo de entrega ou implantação
- Status
- Arquivo anexo (PDF)
- Observações

STATUS DA PROPOSTA
1. Rascunho
2. Enviada
3. Em negociação
4. Aprovada
5. Recusada
6. Vencida

REGRAS DE NEGÓCIO
- Número sequencial automático: PROP-0001, PROP-0002...
- Proposta aprovada → move oportunidade para "Ganha" automaticamente
- Proposta recusada → pergunta se deve mover para "Perdida"
- Proposta com validade expirada → status muda para "Vencida" automaticamente
- Vencida gera alerta no dashboard
9
Produtos e Serviços Catálogo do que a empresa vende — produtos, serviços, projetos e recorrentes com preço pad...
MVP CRUD Incluso
v
OBJETIVO
Catálogo centralizado dos produtos e serviços disponíveis para venda.

CAMPOS PRINCIPAIS
- Nome / Categoria
- Descrição detalhada
- Tipo
- Preço padrão (sugerido ao criar oportunidade)
- Custo estimado
- Margem estimada (% calculada automaticamente)
- Status (Ativo / Inativo)

TIPOS DE PRODUTO/SERVIÇO
1. Produto (venda única)
2. Serviço (execução pontual)
3. Projeto (escopo definido)
4. Mensalidade (recorrente mensal)
5. Contrato recorrente (anual ou multianual)

REGRAS
- Preço padrão é sugerido ao vincular ao criar oportunidade ou proposta, mas pode ser editado
- Margem calculada: (preço - custo) / preço × 100
- Produto inativo não aparece na seleção de novas oportunidades
- Inativar não deleta do histórico (mantém nas oportunidades e propostas existentes)
10
Motivos de Perda Cadastro obrigatório dos motivos pelos quais vendas não fecharam — base para análise e mel...
MVP CRUD Incluso
v
OBJETIVO
Registrar e analisar por que as oportunidades foram perdidas.

MOTIVOS PADRÃO DO MVP
1. Preço
2. Prazo de entrega
3. Concorrente escolhido
4. Sem orçamento no momento
5. Sem decisão interna
6. Produto não atende a necessidade
7. Cliente não respondeu
8. Projeto cancelado pelo cliente
9. Timing futuro — quer comprar depois
10. Condição comercial recusada

OBRIGATORIEDADE
Toda oportunidade marcada como Perdida DEVE ter:
- Motivo de perda (obrigatório, seleção)
- Comentário livre sobre o que aconteceu
- Data da perda (automática)
- Responsável pela oportunidade (automático)

USO NOS RELATÓRIOS
- Relatório de motivos de perda por período
- Ranking de motivos mais frequentes
- Motivos de perda por vendedor
- Análise para ajuste de preço, produto ou processo comercial
11
Metas Comerciais Controle de metas por vendedor — meta mensal, realizado, forecast, % atingido e ranking do...
MVP CRUD Incluso
v
OBJETIVO
Controlar metas comerciais individuais e acompanhar o desempenho do time.

CAMPOS PRINCIPAIS
- Vendedor
- Período (mês / ano)
- Meta mensal (R$)
- Receita realizada (calculada automaticamente: oportunidades ganhas no período)
- Receita prevista — Forecast ponderado das oportunidades abertas
- Percentual atingido (calculado: realizado / meta × 100)
- Gap para meta (calculado: meta - realizado)

INDICADORES DO MÓDULO
- Meta × realizado por vendedor
- Meta × forecast: projeção de atingimento
- Ranking de vendedores por receita no período
- Ticket médio por vendedor
- Quantidade de vendas ganhas no período

CÁLCULOS AUTOMÁTICOS
- Realizado = SUM(final_value) WHERE status = ganha no período
- Forecast = SUM(value × probability / 100) com fechamento previsto no período
- % atingido = realizado / meta × 100
- Gap = meta - realizado (negativo = abaixo da meta)
12
Forecast Básico Previsão de receita ponderada pelo pipeline — valor × probabilidade por vendedor, etapa e ...
MVP CRUD Incluso
v
OBJETIVO
Previsão de receita com base nas oportunidades ativas no pipeline.

FÓRMULA PRINCIPAL
Forecast = Valor da oportunidade × Probabilidade da etapa / 100

Exemplo: R$ 100.000 × 70% = R$ 70.000 de forecast ponderado

VISÕES DISPONÍVEIS
1. Forecast total do mês corrente
2. Forecast por vendedor
3. Forecast por etapa do funil
4. Forecast por produto ou serviço
5. Oportunidades com fechamento previsto em 30 dias
6. Oportunidades com fechamento previsto em 60 dias
7. Oportunidades com fechamento previsto em 90 dias

INDICADORES
- Forecast total vs. meta do mês
- Forecast por vendedor vs. meta individual
- Oportunidades de alto valor no pipeline
- Comparativo forecast vs. realizado do mês anterior

REGRAS
- Somente oportunidades Abertas e Em andamento entram no forecast
- Probabilidade base vem da etapa do funil, mas pode ser ajustada por oportunidade
- Oportunidades paradas há mais de X dias são sinalizadas no forecast
13
Usuários e Permissões Controle de acesso — perfis de administrador, gestor, vendedor, SDR e financeiro com permi...
MVP CRUD Incluso
v
OBJETIVO
Controlar usuários, perfis e permissões de acesso ao CRM.

PERFIS DO MVP
- Administrador: acesso total, configura o sistema
- Diretor / Gestor: vê toda a equipe, relatórios, metas e pipeline
- Vendedor: vê e edita seus próprios leads, clientes e oportunidades
- SDR: cria e qualifica leads, sem acesso ao funil completo
- Financeiro: vê propostas e valores, sem alterar o funil

PERMISSÕES BÁSICAS
- Criar lead / Editar lead / Excluir lead
- Criar cliente / Editar cliente
- Criar oportunidade / Editar oportunidade
- Mover etapa do funil
- Criar proposta / Editar proposta
- Ver relatórios / Exportar dados
- Gerenciar usuários (apenas admin)
- Configurar sistema (apenas admin)

CAMPOS DO USUÁRIO
- Nome completo / E-mail (login) / Senha (bcrypt)
- Perfil de acesso
- Status (Ativo / Inativo)
- Data de criação / Último acesso

REGRAS
- Vendedor só vê leads e oportunidades onde é responsável
- Gestor vê o time inteiro
- Admin gerencia usuários e configurações
- Usuário inativo não pode fazer login
- Senha obrigatoriamente criptografada (bcrypt)
Agentes
Agentes de IA
6 agentes incluídos
1
Agente Validador de CNPJ CRM Agente de CRM especializado em validação cadastral de empresas brasileiras a partir do CNP...
Incluso
v
Executar o processo seguindo este fluxo:

1. Receber os dados informados pelo usuário;
2. Verificar se o CNPJ foi informado;
3. Validar o formato do CNPJ;
4. Consultar fontes oficiais ou públicas confiáveis;
5. Buscar os dados cadastrais da empresa;
6. Consultar o CRM para verificar duplicidade;
7. Comparar os dados informados com os dados encontrados;
8. Classificar cada campo (CONFERE / DIVERGENTE / NÃO INFORMADO / NÃO ENCONTRADO NA FONTE / PRECISA DE CONFIRMAÇÃO);
9. Identificar divergências e alertas;
10. Gerar uma recomendação;
11. Preparar os dados sugeridos para cadastro;
12. Solicitar aprovação humana quando necessário;
13. Registrar logs da validação.

Ser objetivo, técnico e seguro. Não inventar dados, não assumir informações ausentes, não sobrescrever dados críticos sem confirmação.
2
Agente Qualificador de Leads CRM Agente de CRM especializado em qualificar leads novos, identificar potencial comercial, cl...
Incluso
v
1. Receber os dados do lead
2. Verificar se os dados mínimos foram informados
3. Consultar o CRM para identificar histórico ou duplicidade
4. Avaliar origem do lead
5. Avaliar mensagem enviada pelo cliente
6. Verificar produto ou serviço de interesse
7. Comparar o perfil do lead com o ICP da empresa
8. Classificar o lead como frio, morno ou quente
9. Definir prioridade baixa, média ou alta
10. Sugerir a próxima ação comercial
11. Criar tarefa para o vendedor, se permitido
12. Registrar a análise no CRM
3
Agente de Follow-up Comercial CRM Agente especializado em monitorar atividades comerciais, identificar contatos pendentes, s...
Incluso
v
1. Consultar atividades abertas
2. Verificar tarefas vencidas
3. Identificar oportunidades sem movimentação
4. Avaliar última interação com o cliente
5. Calcular tempo desde o último contato
6. Sugerir próxima mensagem de follow-up
7. Criar ou atualizar tarefa de follow-up
8. Alertar vendedor responsável
9. Registrar recomendação no CRM
4
Agente Gestor de Pipeline CRM Agente especializado em acompanhar oportunidades comerciais, analisar o pipeline de vendas...
Incluso
v
1. Consultar oportunidades abertas no CRM
2. Verificar etapa atual do funil
3. Avaliar data da última movimentação
4. Analisar valor estimado e probabilidade
5. Verificar existência de próxima ação
6. Identificar oportunidades sem próxima ação definida
7. Sugerir avanço, manutenção, alerta ou revisão de etapa
8. Identificar risco de perda
9. Atualizar campos permitidos no CRM
10. Gerar resumo para vendedor ou gestor
5
Agente Assistente de Propostas CRM Agente especializado em apoiar a criação, revisão e organização de propostas comerciais co...
Incluso
v
1. Receber dados da oportunidade
2. Consultar cadastro do cliente e validar CNPJ
3. Consultar produtos ou serviços solicitados
4. Verificar escopo da proposta
5. Validar dados obrigatórios
6. Conferir condições comerciais permitidas
7. Gerar estrutura de proposta
8. Apontar informações faltantes ou inconsistentes
9. Sugerir texto comercial para cada seção
10. Indicar necessidade de aprovação quando necessário
11. Registrar versão da proposta no CRM
6
Agente de Pós-venda e Retenção CRM Agente especializado em acompanhar clientes ativos após a venda, identificar riscos de can...
Incluso
v
1. Monitorar clientes ativos no CRM
2. Consultar contratos e status de atendimento
3. Verificar tickets abertos e reclamações
4. Analisar histórico de reclamações e NPS
5. Identificar queda de engajamento ou uso
6. Verificar vencimento de contrato
7. Identificar possibilidade de renovação ou expansão
8. Sugerir ação de retenção ou expansão
9. Criar tarefa para CS ou vendedor responsável
10. Registrar alerta no CRM

Projeto completo

Cabecalho, escopo, prompt principal, modulos, agentes, CRUD e MVP

Visao completa do projeto

Prompt CRM - Sales

# www.prompthubai.com.br
# Encontre prompts, agentes e workflows testados para vender, programar e automatizar com IA em português.

# Prompt CRM - Sales

Meta Prompt: Atue como Especialista em criação de agentes de IA para CRM, automação comercial, validação cadastral, integração com APIs públicas/oficiais e governança de dados.. Preciso criar Um agente de CRM para validar informações oficiais de CNPJ quando um cliente ou usuário solicitar um cadastro na base.

O agente deve funcionar como verificador cadastral duplo (double check), comparando os dados informados pelo usuário com fontes oficiais ou confiáveis antes de inserir, atualizar ou aprovar o cadastro no CRM..

## Meta Prompt
Atue como Especialista em criação de agentes de IA para CRM, automação comercial, validação cadastral, integração com APIs públicas/oficiais e governança de dados.. Preciso criar Um agente de CRM para validar informações oficiais de CNPJ quando um cliente ou usuário solicitar um cadastro na base.

O agente deve funcionar como verificador cadastral duplo (double check), comparando os dados informados pelo usuário com fontes oficiais ou confiáveis antes de inserir, atualizar ou aprovar o cadastro no CRM..
Contexto: A empresa precisa melhorar a qualidade da base de dados do CRM, evitando cadastros duplicados, CNPJs inválidos, razão social incorreta, endereço divergente, dados fiscais desatualizados ou informações incompletas.

Hoje, quando um usuário ou cliente solicita um novo cadastro, ele pode informar dados manualmente: CNPJ, razão social, nome fantasia, endereço, telefone, e-mail e contato comercial.

O agente deverá consultar fontes oficiais ou públicas confiáveis: Receita Federal, SERPRO/Conecta GOV, Dados Abertos da Receita, Brasil API, CNPJ.ws, ReceitaWS, Sintegra, cadastro estadual, ViaCEP, IBGE e a própria base interna do CRM.

O objetivo é validar os dados antes de gravar na base, indicando divergências, riscos, duplicidades e necessidade de aprovação humana.
Publico-alvo: Usuários internos do CRM, equipe comercial, equipe administrativa, pré-vendas, financeiro, cadastro, compliance e gestores responsáveis pela qualidade da base de clientes.

O material também deve servir para desenvolvedores, analistas de produto e equipes técnicas que irão implementar o agente no CRM.
Objetivo do resultado: Criar um prompt profissional e estruturado para um agente de CRM capaz de:

- Receber dados informados pelo usuário;
- Identificar e validar o CNPJ;
- Consultar fontes oficiais ou confiáveis;
- Comparar dados informados com dados encontrados;
- Verificar duplicidade no CRM;
- Classificar campos como: conferem, divergentes ou pendentes;
- Sugerir dados corretos para cadastro;
- Solicitar aprovação humana quando necessário;
- Gerar saída estruturada para integração com CRM/API;
- Registrar logs e auditoria da validação.
Escopo: O prompt deve incluir os seguintes blocos:

1. Nome do agente
2. Papel / descrição
3. Objetivo principal
4. Skill — como deve executar
5. Gatilho — quando deve executar
6. Ferramentas — onde atua
7. Dados — o que consulta
8. Entrada esperada
9. Saída esperada
10. Regras — limites e decisões
11. Nível de autonomia
12. Critérios de decisão
13. Tratamento de erros
14. Logs e auditoria
15. Aprovação humana
16. Fontes de consulta
17. Regras de prioridade entre fontes
18. Saída em JSON para integração com CRM

Fontes a considerar:
Receita Federal, SERPRO/Conecta GOV, Dados Abertos da Receita Federal, Brasil API, CNPJ.ws, ReceitaWS, Sintegra, Cadastro estadual, Cadastro municipal, IBGE, ViaCEP, CRM interno, ERP, sistema financeiro, sistema de contratos, histórico comercial, logs de validação.
Restricoes: O agente NÃO deve:

- Inventar dados ausentes;
- Cadastrar empresa sem CNPJ válido;
- Ignorar divergências críticas;
- Criar cadastro duplicado;
- Atualizar dados fiscais sem validação;
- Excluir registros;
- Alterar preço, desconto, limite de crédito ou contrato;
- Aprovar cadastro irregular sem aprovação humana;
- Usar dados sem registrar a fonte;
- Tratar telefone, e-mail ou site como informação fiscal oficial;
- Gravar ou atualizar dados críticos sem confirmação quando houver divergência.

O agente deve respeitar LGPD, usar apenas dados necessários para finalidade cadastral e comercial, e manter rastreabilidade das decisões.
Formato da resposta: Documento estruturado com títulos, subtítulos, listas e exemplos práticos. Incluir exemplos em JSON para integração com CRM/API.

A resposta deve conter:

- Prompt completo do agente;
- Estrutura de campos;
- Regras de decisão;
- Fontes de consulta;
- Critérios de aprovação automática;
- Critérios de revisão manual;
- Critérios de bloqueio;
- Modelo de saída textual;
- Modelo de saída JSON;
- Checklist final de validação.
Nivel de detalhe: Alto / Profissional / Pronto para produção.
Criterios de qualidade: A resposta deve ser clara, prática, profissional e aplicável em um CRM real. Padrão de mercado, com foco em:

- Governança;
- Segurança;
- Rastreabilidade;
- Automação;
- Integração com APIs;
- Redução de erro cadastral;
- Qualidade da base de dados;
- Aprovação humana quando necessário;
- Escalabilidade para MVP e produção.

Resposta específica para um agente de CRM que valida CNPJ e dados cadastrais empresariais. Não genérica.
Entregas:
- Um prompt completo e profissional para o agente de CRM validador de CNPJ.
- Uma estrutura técnica com entrada esperada, saída esperada, fontes de consulta, regras de decisão, nível de autonomia e tratamento de erros.
- Um modelo de resposta do agente com tabela comparativa e JSON final para integração com CRM.

## Cabecalho
- Tipo: Projeto
- Categoria: Vibe Coding
- Modulos: 13
- Agentes: 6

## Escopo
CRM padrão de mercado com foco em vendas, usando o anexo como referência. O CRM deve atender empresas B2B com vendas consultivas, contratos recorrentes, projetos de longo prazo e gestão comercial completa. 


Inclua módulos de leads, clientes, contatos, oportunidades, funil de vendas, atividades, agenda, propostas, produtos e serviços, contratos, metas, forecast, comissões, dashboards, permissões, integrações, automações e IA comercial.

Considere como fluxo principal:
Lead → Qualificação → Oportunidade → Diagnóstico → Proposta → Negociação → Fechamento → Contrato → Renovação → Upsell/Cross-sell

## Prompt Principal
Prompt para criação de CRM padrão de mercado com foco em vendas

Crie a especificação completa de um CRM padrão de mercado com foco em vendas, voltado para empresas B2B que precisam controlar leads, clientes, oportunidades comerciais, propostas, contratos, metas, forecast, atividades comerciais, carteira de clientes e relatórios gerenciais.

Use como base o conteúdo do anexo enviado, que descreve as principais funcionalidades esperadas para um CRM comercial moderno.

O objetivo é construir um CRM robusto, escalável, simples de usar e com visão clara do processo comercial, desde a entrada do lead até o fechamento da venda, contrato, renovação, upsell e cross-sell.

1. Objetivo do sistema

Descrever o CRM como uma plataforma para:

Capturar e organizar leads;
Gerenciar clientes e contatos;
Controlar oportunidades comerciais;
Acompanhar o funil de vendas;
Automatizar follow-ups;
Criar e acompanhar propostas comerciais;
Controlar contratos e recorrência;
Gerenciar metas comerciais;
Fazer previsão de vendas;
Acompanhar indicadores e dashboards;
Apoiar gestores, vendedores, SDRs, pré-vendas, marketing, financeiro e diretoria.

O CRM deve ajudar a empresa a vender mais, reduzir perda de oportunidades, melhorar previsibilidade de receita e centralizar todo o histórico comercial do cliente.

## MVP
MVP de CRM padrão de mercado com foco em vendas, pensado para começar enxuto, mas já com base forte para evoluir depois.

MVP — CRM com foco em vendas
1. Objetivo do MVP

Criar a primeira versão de um CRM comercial para controlar:

Leads → Clientes → Oportunidades → Propostas → Follow-ups → Fechamento → Relatórios

O MVP deve resolver o problema principal: dar visibilidade ao time comercial sobre quem está sendo atendido, em qual etapa está cada venda, quanto existe no pipeline e quais ações precisam ser feitas.

A base vem das funcionalidades principais do anexo: cadastro de leads/clientes, funil, oportunidades, atividades, propostas, metas, forecast e relatórios comerciais.

## CRUD
CRUD — MVP CRM com foco em vendas
Visão geral do fluxo

O CRM deve seguir este fluxo principal:

Lead → Cliente → Oportunidade → Proposta → Atividades/Follow-ups → Fechamento → Relatórios

A ideia é começar enxuto, mas com estrutura pronta para evoluir depois com automações, WhatsApp, e-mail, ERP, comissão, contratos e IA.

1. CRUD de Usuários

Usado para controlar vendedores, gestores e administradores.

| Campo         |     Tipo | Obrigatório | Observação                 |
| ------------- | -------: | ----------: | -------------------------- |
| id            | UUID/INT |         Sim | Identificador              |
| nome          |    Texto |         Sim | Nome do usuário            |
| email         |    Texto |         Sim | Login                      |
| telefone      |    Texto |         Não | WhatsApp ou celular        |
| cargo         |    Texto |         Não | Ex: Vendedor, SDR, Gerente |
| perfil        |     Enum |         Sim | admin, gestor, vendedor    |
| status        |     Enum |         Sim | ativo, inativo             |
| data_criacao  |     Data |         Sim | Automático                 |
| ultimo_acesso |     Data |         Não | Controle de uso            |


Ações CRUD
Ação	Descrição
Criar	Cadastrar novo usuário
Listar	Ver usuários cadastrados
Visualizar	Ver detalhes do usuário
Editar	Alterar dados e perfil
Inativar	Remover acesso sem apagar histórico

Endpoints sugeridos
POST   /usuarios
GET    /usuarios
GET    /usuarios/{id}
PUT    /usuarios/{id}
PATCH  /usuarios/{id}/inativar

## Modulos

### 1. Módulos do MVP
Tela inicial com visão rápida da operação.
criar 

Indicadores principais
Total de leads;
Leads novos;
Leads em atendimento;
Oportunidades abertas;
Valor total do pipeline;
Propostas enviadas;
Vendas ganhas;
Vendas perdidas;
Forecast do mês;
Atividades atrasadas;
Ranking de vendedores.
Filtros
Período;
Vendedor;
Etapa do funil;
Origem do lead;
Produto ou serviço;
Status da oportunidade.
MVP: Escopo do MVP
Incluído no MVP
O MVP do Dashboard Comercial deve conter:
1.	Cards de indicadores principais;
2.	Filtros comerciais;
3.	Gráfico de pipeline por etapa;
4.	Lista de atividades atrasadas;
5.	Ranking de vendedores;
6.	Forecast do mês;
7.	Vendas ganhas e perdidas;
8.	Atualização automática dos dados com base nos registros do CRM;
9.	Controle de visualização por perfil de usuário.

Fora do MVP inicial
Para manter o MVP enxuto, ficam fora da primeira versão:
•	Dashboard customizável por usuário;
•	Exportação avançada em PDF;
•	BI integrado externo;
•	Power BI embarcado;
•	IA preditiva;
•	Alertas inteligentes por machine learning;
•	Comparativo histórico avançado;
•	Drill-down analítico completo;
•	Dashboard financeiro detalhado.
Esses recursos podem entrar em fases futuras.
CRUD: Exemplo
{
  "nome": "Dashboard Comercial Geral",
  "descricao": "Painel principal da operação comercial",
  "perfil_acesso": "gestor",
  "empresa_id": "uuid_empresa",
  "periodo_padrao": "mes_atual",
  "ativo": true
}

### 2. Leads
Controle dos potenciais clientes antes de virarem oportunidade — qualificação, atendimento e conversão.
OBJETIVO
Controlar potenciais clientes desde a entrada até a qualificação e conversão.

CAMPOS PRINCIPAIS
- Nome do lead / Empresa / CNPJ ou CPF
- Segmento / Porte da empresa
- Cidade / Estado
- Nome do contato / Cargo
- E-mail / Telefone / WhatsApp
- Origem do lead (site, indicação, evento, anúncio, prospecção...)
- Produto ou serviço de interesse
- Status do lead
- Responsável comercial
- Data de entrada / Primeiro contato / Última interação
- Próxima ação / Data da próxima ação
- Observações

STATUS DO LEAD
1. Novo
2. Em contato
3. Qualificado
4. Não qualificado
5. Convertido em oportunidade
6. Perdido

REGRAS DE NEGÓCIO
- Todo lead precisa ter um responsável atribuído
- Lead qualificado pode ser convertido: cria Cliente + Oportunidade automaticamente
- Lead perdido exige motivo de perda obrigatório
- Lead sem contato por X dias gera alerta no dashboard
- Ao converter, o lead fica como "Convertido" e não pode ser editado

TELA DE LISTA
- Tabela com colunas configuráveis
- Filtros: status, responsável, origem, período, segmento
- Busca por nome, empresa, CNPJ, e-mail
- Ações rápidas: editar, converter, perder
- Botão "Novo Lead"
MVP: ÉPICO 2 — Leads
- Criar formulário de cadastro de lead
- Criar listagem de leads com filtros e busca
- Criar controle de status do lead
- Criar fluxo de conversão: lead → cliente + oportunidade
- Criar alerta de lead sem contato após X dias
- Tornar motivo de perda obrigatório ao marcar como perdido
- Criar histórico de interações do lead
- Criar importação de leads por planilha (fase 2)
CRUD: TABELA: leads
- id BIGINT PRIMARY KEY AUTO_INCREMENT
- project_id BIGINT NOT NULL
- name VARCHAR(255) NOT NULL
- company VARCHAR(255)
- cnpj_cpf VARCHAR(20)
- segment VARCHAR(100)
- company_size ENUM('micro','pequena','media','grande','enterprise')
- city VARCHAR(100), state CHAR(2)
- contact_name VARCHAR(255), contact_role VARCHAR(100)
- email VARCHAR(255), phone VARCHAR(20), whatsapp VARCHAR(20)
- source VARCHAR(100)
- interest VARCHAR(255)
- status ENUM('novo','em_contato','qualificado','nao_qualificado','convertido','perdido') DEFAULT 'novo'
- responsible_id BIGINT FK users.id
- loss_reason_id BIGINT FK loss_reasons.id NULL
- loss_comment TEXT NULL
- entry_date DATE, first_contact_date DATE NULL, last_interaction_date DATE NULL
- next_action TEXT NULL, next_action_date DATE NULL
- notes TEXT NULL
- customer_id BIGINT FK customers.id NULL
- opportunity_id BIGINT FK opportunities.id NULL
- created_at TIMESTAMP, updated_at TIMESTAMP

CRUD
- Listar: SELECT * FROM leads WHERE project_id = :pid ORDER BY entry_date DESC
- Filtrar por status: WHERE status = :status
- Filtrar por responsável: WHERE responsible_id = :uid
- Converter: UPDATE leads SET status = 'convertido', customer_id = :cid, opportunity_id = :oid WHERE id = :id

### 3. Clientes
Base central de empresas e clientes — dados cadastrais, responsável, status e histórico comercial.
OBJETIVO
Base central de todas as empresas atendidas ou em atendimento.

CAMPOS PRINCIPAIS
- Razão social / Nome fantasia
- CNPJ (único na base)
- Segmento / Porte
- Site
- Cidade / Estado / Endereço completo
- Status do cliente
- Responsável pela conta
- Origem (como entrou na base)
- Observações
- Histórico comercial (automático)

STATUS DO CLIENTE
1. Prospect
2. Cliente ativo
3. Cliente inativo
4. Ex-cliente

REGRAS DE NEGÓCIO
- CNPJ deve ser único na base (sem duplicatas)
- Cliente pode ter múltiplos contatos vinculados
- Cliente pode ter múltiplas oportunidades simultaneamente
- Histórico exibe: interações, propostas, oportunidades e atividades
- Responsável pela conta deve ser um usuário ativo
- Ao converter um lead, o cliente é criado automaticamente

TELA DE CADASTRO
- Aba: Dados da empresa
- Aba: Contatos vinculados
- Aba: Oportunidades
- Aba: Histórico comercial
MVP: ÉPICO 3 — Clientes e Contatos
- Criar formulário de cadastro de cliente
- Criar listagem com filtros (status, responsável, cidade, segmento)
- Busca por nome, CNPJ, cidade, responsável
- Exibir histórico comercial completo do cliente
- Vincular lead convertido automaticamente ao cliente criado
- Validar CNPJ único na base antes de salvar
- Exibir oportunidades vinculadas na tela do cliente
CRUD: TABELA: customers
- id BIGINT PRIMARY KEY AUTO_INCREMENT
- project_id BIGINT NOT NULL
- company_name VARCHAR(255) NOT NULL
- trade_name VARCHAR(255) NULL
- cnpj VARCHAR(18) UNIQUE
- segment VARCHAR(100) NULL
- company_size ENUM('micro','pequena','media','grande','enterprise') NULL
- website VARCHAR(255) NULL
- city VARCHAR(100) NULL, state CHAR(2) NULL
- address TEXT NULL
- status ENUM('prospect','ativo','inativo','ex_cliente') DEFAULT 'prospect'
- responsible_id BIGINT FK users.id NULL
- source VARCHAR(100) NULL
- notes TEXT NULL
- created_at TIMESTAMP, updated_at TIMESTAMP

RELACIONAMENTOS
- customers 1:N contacts
- customers 1:N opportunities
- customers 1:N activities
- customers 1:N proposals
- leads 1:1 customers (quando convertido)

### 4. Contatos
Pessoas vinculadas a cada cliente — múltiplos contatos por empresa com tipo e nível de influência.
OBJETIVO
Cadastro de pessoas (contatos) vinculadas a cada empresa/cliente.

CAMPOS PRINCIPAIS
- Nome completo
- Cargo / Departamento
- E-mail / Telefone / WhatsApp
- Tipo de contato
- Nível de influência (Alto / Médio / Baixo)
- Observações
- Contato principal? (sim/não)

TIPOS DE CONTATO
1. Decisor
2. Influenciador
3. Técnico
4. Financeiro
5. Compras
6. Usuário final

REGRAS
- Todo contato precisa estar vinculado a um cliente
- Um cliente pode ter N contatos
- Ao criar uma oportunidade, o contato principal é selecionado
- O mesmo contato pode aparecer em múltiplas oportunidades do mesmo cliente
- Contatos são exibidos em aba dentro da tela do cliente
MVP: ÉPICO 3 — Clientes e Contatos
- Criar cadastro de contatos vinculado ao cliente
- Permitir múltiplos contatos por cliente
- Definir tipo e nível de influência
- Selecionar contato principal ao criar ou editar oportunidade
- Exibir lista de contatos dentro da tela do cliente
- Buscar contato pelo nome ao criar oportunidade
CRUD: TABELA: contacts
- id BIGINT PRIMARY KEY AUTO_INCREMENT
- customer_id BIGINT NOT NULL FK customers.id
- name VARCHAR(255) NOT NULL
- role VARCHAR(100) NULL
- department VARCHAR(100) NULL
- email VARCHAR(255) NULL
- phone VARCHAR(20) NULL
- whatsapp VARCHAR(20) NULL
- type ENUM('decisor','influenciador','tecnico','financeiro','compras','usuario_final') NULL
- influence_level ENUM('alto','medio','baixo') NULL
- is_primary BOOLEAN DEFAULT FALSE
- notes TEXT NULL
- created_at TIMESTAMP, updated_at TIMESTAMP

CRUD
- Listar por cliente: SELECT * FROM contacts WHERE customer_id = :cid ORDER BY is_primary DESC, name ASC
- Definir principal: UPDATE contacts SET is_primary = 0 WHERE customer_id = :cid; UPDATE contacts SET is_primary = 1 WHERE id = :id

### 5. Funil de Vendas
Coração do CRM — visualização Kanban das oportunidades por etapa com probabilidade e valor por coluna.
OBJETIVO
Controle visual das etapas de venda em formato Kanban.

ETAPAS PADRÃO DO MVP
1. Lead novo — 5%
2. Primeiro contato — 10%
3. Qualificação — 20%
4. Diagnóstico — 35%
5. Proposta enviada — 50%
6. Negociação — 70%
7. Fechamento — 90%
8. Ganhou — 100%
9. Perdido — 0%

FUNCIONALIDADES
- Visualização Kanban (colunas por etapa)
- Arrastar oportunidade entre etapas (drag and drop)
- Cada coluna exibe: nome da etapa, total de oportunidades e valor somado
- Card da oportunidade: nome, cliente, valor, responsável, data prevista
- Filtros no Kanban: vendedor, produto, período de fechamento
- Gestor pode editar nomes e probabilidades das etapas

COMPORTAMENTOS ESPECIAIS
- Mover para "Ganhou" → modal para confirmar valor final
- Mover para "Perdido" → modal obrigatório de motivo de perda
- Oportunidades paradas há X dias recebem indicador visual de alerta

PROBABILIDADE SUGERIDA POR ETAPA
Lead novo: 5% | Primeiro contato: 10% | Qualificação: 20%
Diagnóstico: 35% | Proposta enviada: 50% | Negociação: 70%
Fechamento: 90% | Ganhou: 100% | Perdido: 0%
MVP: ÉPICO 4 — Oportunidades e Funil
- Criar visualização Kanban com colunas por etapa
- Implementar drag and drop entre etapas
- Calcular e exibir valor total por coluna
- Calcular forecast ponderado (valor × probabilidade)
- Permitir configuração de etapas pelo administrador
- Criar modal de confirmação ao mover para Ganhou
- Criar modal obrigatório de motivo de perda ao mover para Perdido
- Registrar histórico de mudança de etapa por oportunidade
- Atualizar dashboard automaticamente ao mover oportunidade
CRUD: TABELA: pipeline_stages
- id BIGINT PRIMARY KEY AUTO_INCREMENT
- project_id BIGINT NOT NULL
- name VARCHAR(100) NOT NULL
- probability TINYINT UNSIGNED DEFAULT 0
- sort_order TINYINT UNSIGNED DEFAULT 0
- color VARCHAR(7) NULL
- is_won BOOLEAN DEFAULT FALSE
- is_lost BOOLEAN DEFAULT FALSE
- created_at TIMESTAMP, updated_at TIMESTAMP

SEED PADRÃO
INSERT INTO pipeline_stages (project_id, name, probability, sort_order, is_won, is_lost) VALUES
(1, 'Lead novo', 5, 1, 0, 0),
(1, 'Primeiro contato', 10, 2, 0, 0),
(1, 'Qualificação', 20, 3, 0, 0),
(1, 'Diagnóstico', 35, 4, 0, 0),
(1, 'Proposta enviada', 50, 5, 0, 0),
(1, 'Negociação', 70, 6, 0, 0),
(1, 'Fechamento', 90, 7, 0, 0),
(1, 'Ganhou', 100, 8, 1, 0),
(1, 'Perdido', 0, 9, 0, 1);

QUERIES KANBAN
-- Valor por etapa
SELECT stage_id, COUNT(*) as qtd, SUM(value) as total
FROM opportunities WHERE status IN ('aberta','em_andamento')
GROUP BY stage_id

### 6. Oportunidades
Cada possível venda vira uma oportunidade — valor, probabilidade, etapa, responsável e próxima ação.
OBJETIVO
Registrar e controlar cada possível venda em andamento.

CAMPOS PRINCIPAIS
- Nome da oportunidade
- Cliente vinculado / Contato principal
- Produto ou serviço
- Valor estimado
- Valor recorrente mensal (se houver)
- Valor único (se houver)
- Probabilidade de fechamento (%)
- Etapa do funil
- Data prevista de fechamento
- Responsável comercial
- Origem
- Necessidade do cliente
- Próxima ação / Data da próxima ação
- Status / Motivo de perda (obrigatório se perdida)
- Observações

STATUS DA OPORTUNIDADE
1. Aberta
2. Em andamento
3. Parada
4. Ganha
5. Perdida
6. Cancelada

REGRAS DE NEGÓCIO
- Toda oportunidade deve estar em uma etapa do funil
- Ao ganhar: registrar valor final confirmado e data
- Ao perder: motivo de perda é obrigatório
- Oportunidade parada por X dias gera alerta automático
- Toda oportunidade deve ter próxima ação cadastrada
- Forecast = valor × probabilidade / 100
MVP: ÉPICO 4 — Oportunidades e Funil
- Criar formulário de cadastro de oportunidade
- Vincular oportunidade ao cliente, contato e funil
- Calcular forecast ponderado automaticamente
- Criar alerta para oportunidades paradas
- Registrar histórico de mudança de etapa
- Obrigar motivo de perda ao fechar como perdida
- Registrar valor final confirmado ao fechar como ganha
- Vincular atividades e propostas à oportunidade
CRUD: TABELA: opportunities
- id BIGINT PRIMARY KEY AUTO_INCREMENT
- project_id BIGINT NOT NULL
- name VARCHAR(255) NOT NULL
- customer_id BIGINT FK customers.id
- contact_id BIGINT FK contacts.id NULL
- product_id BIGINT FK products_services.id NULL
- value DECIMAL(15,2) DEFAULT 0
- recurring_value DECIMAL(15,2) NULL
- one_time_value DECIMAL(15,2) NULL
- probability TINYINT UNSIGNED DEFAULT 0
- stage_id BIGINT FK pipeline_stages.id
- expected_close_date DATE NULL
- responsible_id BIGINT FK users.id
- source VARCHAR(100) NULL
- customer_need TEXT NULL
- next_action TEXT NULL, next_action_date DATE NULL
- status ENUM('aberta','em_andamento','parada','ganha','perdida','cancelada') DEFAULT 'aberta'
- loss_reason_id BIGINT FK loss_reasons.id NULL
- loss_comment TEXT NULL
- final_value DECIMAL(15,2) NULL
- notes TEXT NULL
- won_at TIMESTAMP NULL, lost_at TIMESTAMP NULL
- created_at TIMESTAMP, updated_at TIMESTAMP

### 7. Atividades e Follow-ups
Controle das ações comerciais — ligações, reuniões, visitas, follow-ups e tarefas com alertas de vencimento.
OBJETIVO
Controlar todas as ações comerciais do time de vendas.

TIPOS DE ATIVIDADE
1. Ligação
2. Reunião
3. E-mail
4. WhatsApp
5. Visita
6. Demonstração
7. Envio de proposta
8. Follow-up
9. Tarefa interna

CAMPOS PRINCIPAIS
- Tipo da atividade
- Cliente vinculado
- Oportunidade vinculada (opcional)
- Responsável
- Data e hora
- Prioridade (Alta / Média / Baixa)
- Status
- Descrição do que foi ou será feito
- Resultado (preenchido ao concluir)
- Próxima ação sugerida

STATUS
1. Pendente
2. Concluída
3. Atrasada
4. Cancelada

ALERTAS AUTOMÁTICOS
- Atividade vencida: não concluída após data e hora
- Proposta sem retorno em X dias
- Oportunidade sem movimentação em X dias
- Lead novo sem primeiro contato em X horas

TELAS
- Lista de atividades com filtros (tipo, status, responsável, data)
- Calendário simples: dia e semana
- Atividades vencidas destacadas no topo
- Modal "Concluir" com campo de resultado e próxima ação
MVP: ÉPICO 5 — Atividades e Follow-ups
- Criar cadastro de atividades comerciais
- Vincular atividade ao cliente e à oportunidade
- Criar alerta automático de atividade vencida
- Pedir próxima ação ao concluir atividade
- Exibir calendário simples de atividades do dia e semana
- Criar notificação de lead sem primeiro contato
- Criar notificação de oportunidade sem movimentação
- Exibir atividades atrasadas no dashboard
CRUD: TABELA: activities
- id BIGINT PRIMARY KEY AUTO_INCREMENT
- project_id BIGINT NOT NULL
- type ENUM('ligacao','reuniao','email','whatsapp','visita','demonstracao','proposta','followup','tarefa')
- customer_id BIGINT FK customers.id NULL
- opportunity_id BIGINT FK opportunities.id NULL
- responsible_id BIGINT FK users.id NOT NULL
- scheduled_at DATETIME NOT NULL
- priority ENUM('alta','media','baixa') DEFAULT 'media'
- status ENUM('pendente','concluida','atrasada','cancelada') DEFAULT 'pendente'
- description TEXT NULL
- result TEXT NULL
- next_action TEXT NULL, next_action_date DATE NULL
- completed_at TIMESTAMP NULL
- created_at TIMESTAMP, updated_at TIMESTAMP

QUERIES
-- Atividades atrasadas do usuário
SELECT * FROM activities WHERE responsible_id = :uid AND status = 'pendente' AND scheduled_at < NOW()

-- Atividades do dia
SELECT * FROM activities WHERE responsible_id = :uid AND DATE(scheduled_at) = CURDATE() ORDER BY scheduled_at ASC

### 8. Propostas Comerciais
Controle de propostas — número automático, valor, desconto, validade, status e vínculo com oportunidade.
OBJETIVO
Controlar propostas enviadas aos clientes com rastreamento de status e vínculo ao funil.

CAMPOS PRINCIPAIS
- Número da proposta (gerado automaticamente: PROP-0001)
- Cliente / Oportunidade vinculada
- Produto ou serviço
- Valor bruto / Desconto (% ou R$) / Valor final
- Validade da proposta (data)
- Condição de pagamento
- Prazo de entrega ou implantação
- Status
- Arquivo anexo (PDF)
- Observações

STATUS DA PROPOSTA
1. Rascunho
2. Enviada
3. Em negociação
4. Aprovada
5. Recusada
6. Vencida

REGRAS DE NEGÓCIO
- Número sequencial automático: PROP-0001, PROP-0002...
- Proposta aprovada → move oportunidade para "Ganha" automaticamente
- Proposta recusada → pergunta se deve mover para "Perdida"
- Proposta com validade expirada → status muda para "Vencida" automaticamente
- Vencida gera alerta no dashboard
MVP: ÉPICO 6 — Propostas
- Criar cadastro de proposta com número sequencial automático
- Vincular proposta à oportunidade do funil
- Controlar status com fluxo: Rascunho → Enviada → Aprovada/Recusada
- Permitir upload de arquivo PDF
- Aprovar proposta e mover oportunidade para Ganha
- Recusar proposta e perguntar sobre oportunidade
- Gerar alerta de proposta vencida no dashboard
- Listar propostas com filtros por status, cliente e valor
CRUD: TABELA: proposals
- id BIGINT PRIMARY KEY AUTO_INCREMENT
- project_id BIGINT NOT NULL
- number VARCHAR(20) UNIQUE NOT NULL
- customer_id BIGINT FK customers.id NOT NULL
- opportunity_id BIGINT FK opportunities.id NULL
- product_id BIGINT FK products_services.id NULL
- gross_value DECIMAL(15,2) NOT NULL DEFAULT 0
- discount_value DECIMAL(15,2) NOT NULL DEFAULT 0
- final_value DECIMAL(15,2) NOT NULL DEFAULT 0
- valid_until DATE NOT NULL
- payment_condition VARCHAR(255) NULL
- delivery_term VARCHAR(255) NULL
- status ENUM('rascunho','enviada','em_negociacao','aprovada','recusada','vencida') DEFAULT 'rascunho'
- attachment_path VARCHAR(500) NULL
- notes TEXT NULL
- sent_at TIMESTAMP NULL
- approved_at TIMESTAMP NULL
- refused_at TIMESTAMP NULL
- created_at TIMESTAMP, updated_at TIMESTAMP

PRÓXIMO NÚMERO
SELECT LPAD(COUNT(*) + 1, 4, '0') FROM proposals WHERE project_id = :pid → 'PROP-0001'

### 9. Produtos e Serviços
Catálogo do que a empresa vende — produtos, serviços, projetos e recorrentes com preço padrão e margem.
OBJETIVO
Catálogo centralizado dos produtos e serviços disponíveis para venda.

CAMPOS PRINCIPAIS
- Nome / Categoria
- Descrição detalhada
- Tipo
- Preço padrão (sugerido ao criar oportunidade)
- Custo estimado
- Margem estimada (% calculada automaticamente)
- Status (Ativo / Inativo)

TIPOS DE PRODUTO/SERVIÇO
1. Produto (venda única)
2. Serviço (execução pontual)
3. Projeto (escopo definido)
4. Mensalidade (recorrente mensal)
5. Contrato recorrente (anual ou multianual)

REGRAS
- Preço padrão é sugerido ao vincular ao criar oportunidade ou proposta, mas pode ser editado
- Margem calculada: (preço - custo) / preço × 100
- Produto inativo não aparece na seleção de novas oportunidades
- Inativar não deleta do histórico (mantém nas oportunidades e propostas existentes)
MVP: ÉPICO 8 — Administração
- Criar CRUD de produtos e serviços
- Definir tipos de produto com descrição
- Calcular margem automaticamente ao preencher preço e custo
- Vincular produtos a oportunidades e propostas
- Filtrar apenas produtos ativos na seleção de novas oportunidades
- Inativar produto sem deletar histórico
- Listar produtos com filtro por tipo e status
CRUD: TABELA: products_services
- id BIGINT PRIMARY KEY AUTO_INCREMENT
- project_id BIGINT NOT NULL
- name VARCHAR(255) NOT NULL
- category VARCHAR(100) NULL
- description TEXT NULL
- type ENUM('produto','servico','projeto','mensalidade','recorrente') NOT NULL
- price DECIMAL(15,2) NOT NULL DEFAULT 0
- cost DECIMAL(15,2) NOT NULL DEFAULT 0
- margin DECIMAL(5,2) GENERATED ALWAYS AS ((price - cost) / price * 100) VIRTUAL
- status ENUM('ativo','inativo') DEFAULT 'ativo'
- created_at TIMESTAMP, updated_at TIMESTAMP

CRUD
- Listar ativos: SELECT * FROM products_services WHERE project_id = :pid AND status = 'ativo' ORDER BY name
- Inativar: UPDATE products_services SET status = 'inativo' WHERE id = :id

### 10. Motivos de Perda
Cadastro obrigatório dos motivos pelos quais vendas não fecharam — base para análise e melhoria comercial.
OBJETIVO
Registrar e analisar por que as oportunidades foram perdidas.

MOTIVOS PADRÃO DO MVP
1. Preço
2. Prazo de entrega
3. Concorrente escolhido
4. Sem orçamento no momento
5. Sem decisão interna
6. Produto não atende a necessidade
7. Cliente não respondeu
8. Projeto cancelado pelo cliente
9. Timing futuro — quer comprar depois
10. Condição comercial recusada

OBRIGATORIEDADE
Toda oportunidade marcada como Perdida DEVE ter:
- Motivo de perda (obrigatório, seleção)
- Comentário livre sobre o que aconteceu
- Data da perda (automática)
- Responsável pela oportunidade (automático)

USO NOS RELATÓRIOS
- Relatório de motivos de perda por período
- Ranking de motivos mais frequentes
- Motivos de perda por vendedor
- Análise para ajuste de preço, produto ou processo comercial
MVP: ÉPICO 8 — Administração
- Criar CRUD de motivos de perda (admin)
- Tornar obrigatório ao fechar oportunidade como perdida
- Incluir motivos de perda nos relatórios comerciais
- Criar relatório de análise de motivos por período e vendedor
- Incluir motivos no dashboard (gráfico de pizza)
- Criar motivos padrão no seed inicial do sistema
CRUD: TABELA: loss_reasons
- id BIGINT PRIMARY KEY AUTO_INCREMENT
- project_id BIGINT NOT NULL
- name VARCHAR(255) NOT NULL
- description TEXT NULL
- status ENUM('ativo','inativo') DEFAULT 'ativo'
- sort_order INT DEFAULT 0
- created_at TIMESTAMP, updated_at TIMESTAMP

USO EM opportunities
- loss_reason_id BIGINT FK loss_reasons.id NULL
- loss_comment TEXT NULL
- lost_at TIMESTAMP NULL

SEED PADRÃO
INSERT INTO loss_reasons (project_id, name, sort_order) VALUES
(1, 'Preço', 1), (1, 'Prazo', 2), (1, 'Concorrente', 3),
(1, 'Sem orçamento', 4), (1, 'Sem decisão', 5),
(1, 'Produto não atende', 6), (1, 'Cliente não respondeu', 7),
(1, 'Projeto cancelado', 8), (1, 'Timing futuro', 9),
(1, 'Condição comercial recusada', 10);

RELATÓRIO
SELECT lr.name, COUNT(o.id) as qtd, SUM(o.value) as valor_perdido
FROM opportunities o JOIN loss_reasons lr ON lr.id = o.loss_reason_id
WHERE o.status = 'perdida' GROUP BY lr.id ORDER BY qtd DESC

### 11. Metas Comerciais
Controle de metas por vendedor — meta mensal, realizado, forecast, % atingido e ranking do time.
OBJETIVO
Controlar metas comerciais individuais e acompanhar o desempenho do time.

CAMPOS PRINCIPAIS
- Vendedor
- Período (mês / ano)
- Meta mensal (R$)
- Receita realizada (calculada automaticamente: oportunidades ganhas no período)
- Receita prevista — Forecast ponderado das oportunidades abertas
- Percentual atingido (calculado: realizado / meta × 100)
- Gap para meta (calculado: meta - realizado)

INDICADORES DO MÓDULO
- Meta × realizado por vendedor
- Meta × forecast: projeção de atingimento
- Ranking de vendedores por receita no período
- Ticket médio por vendedor
- Quantidade de vendas ganhas no período

CÁLCULOS AUTOMÁTICOS
- Realizado = SUM(final_value) WHERE status = ganha no período
- Forecast = SUM(value × probability / 100) com fechamento previsto no período
- % atingido = realizado / meta × 100
- Gap = meta - realizado (negativo = abaixo da meta)
MVP: ÉPICO 8 — Metas e Administração
- Criar cadastro de metas por vendedor e período (mês/ano)
- Calcular realizado automaticamente a partir das oportunidades ganhas
- Calcular forecast automaticamente a partir do pipeline
- Criar ranking de vendedores por receita e por meta atingida
- Exibir metas e realizado no dashboard
- Criar relatório de metas vs. realizado por período
- Criar alerta quando vendedor estiver abaixo de X% da meta
CRUD: TABELA: sales_goals
- id BIGINT PRIMARY KEY AUTO_INCREMENT
- project_id BIGINT NOT NULL
- user_id BIGINT NOT NULL FK users.id
- period_month TINYINT NOT NULL
- period_year SMALLINT NOT NULL
- goal_value DECIMAL(15,2) NOT NULL
- notes TEXT NULL
- created_at TIMESTAMP, updated_at TIMESTAMP
- UNIQUE KEY (project_id, user_id, period_month, period_year)

QUERIES DE CÁLCULO
-- Realizado do mês por vendedor
SELECT responsible_id, SUM(final_value)
FROM opportunities WHERE status = 'ganha'
AND MONTH(won_at) = :m AND YEAR(won_at) = :y
GROUP BY responsible_id

-- Forecast do mês por vendedor
SELECT responsible_id, SUM(value * probability / 100)
FROM opportunities WHERE status IN ('aberta','em_andamento')
AND MONTH(expected_close_date) = :m AND YEAR(expected_close_date) = :y
GROUP BY responsible_id

-- Ranking
SELECT u.name, SUM(o.final_value) as realizado, sg.goal_value as meta,
ROUND(SUM(o.final_value) / sg.goal_value * 100, 1) as pct
FROM opportunities o
JOIN users u ON u.id = o.responsible_id
LEFT JOIN sales_goals sg ON sg.user_id = o.responsible_id AND sg.period_month = MONTH(NOW())
WHERE o.status = 'ganha' AND MONTH(o.won_at) = MONTH(NOW())
GROUP BY u.id ORDER BY realizado DESC

### 12. Forecast Básico
Previsão de receita ponderada pelo pipeline — valor × probabilidade por vendedor, etapa e produto.
OBJETIVO
Previsão de receita com base nas oportunidades ativas no pipeline.

FÓRMULA PRINCIPAL
Forecast = Valor da oportunidade × Probabilidade da etapa / 100

Exemplo: R$ 100.000 × 70% = R$ 70.000 de forecast ponderado

VISÕES DISPONÍVEIS
1. Forecast total do mês corrente
2. Forecast por vendedor
3. Forecast por etapa do funil
4. Forecast por produto ou serviço
5. Oportunidades com fechamento previsto em 30 dias
6. Oportunidades com fechamento previsto em 60 dias
7. Oportunidades com fechamento previsto em 90 dias

INDICADORES
- Forecast total vs. meta do mês
- Forecast por vendedor vs. meta individual
- Oportunidades de alto valor no pipeline
- Comparativo forecast vs. realizado do mês anterior

REGRAS
- Somente oportunidades Abertas e Em andamento entram no forecast
- Probabilidade base vem da etapa do funil, mas pode ser ajustada por oportunidade
- Oportunidades paradas há mais de X dias são sinalizadas no forecast
MVP: ÉPICO 4 e 7 — Oportunidades e Relatórios
- Calcular forecast ponderado automaticamente por oportunidade
- Exibir forecast total no dashboard
- Criar visão de forecast por vendedor com comparativo de meta
- Criar visão de forecast por etapa do funil
- Criar visão de fechamentos previstos para 30, 60 e 90 dias
- Criar relatório comparativo de forecast vs. realizado
- Sinalizar oportunidades paradas no forecast
CRUD: QUERIES PRINCIPAIS

-- Forecast total do mês
SELECT SUM(value * probability / 100) as forecast_total
FROM opportunities
WHERE status IN ('aberta', 'em_andamento')
AND MONTH(expected_close_date) = MONTH(NOW())
AND YEAR(expected_close_date) = YEAR(NOW())

-- Forecast por vendedor
SELECT u.name, SUM(o.value * o.probability / 100) as forecast
FROM opportunities o JOIN users u ON u.id = o.responsible_id
WHERE o.status IN ('aberta', 'em_andamento')
AND MONTH(o.expected_close_date) = MONTH(NOW())
GROUP BY u.id, u.name ORDER BY forecast DESC

-- Fechamentos em 30 dias
SELECT o.name, c.company_name, o.value, o.probability, o.expected_close_date, u.name as vendedor
FROM opportunities o
JOIN customers c ON c.id = o.customer_id
JOIN users u ON u.id = o.responsible_id
WHERE o.expected_close_date BETWEEN CURDATE() AND DATE_ADD(CURDATE(), INTERVAL 30 DAY)
AND o.status IN ('aberta', 'em_andamento')
ORDER BY o.expected_close_date ASC, o.value DESC

-- Forecast por etapa
SELECT ps.name as etapa, COUNT(o.id) as qtd, SUM(o.value) as valor_bruto, SUM(o.value * o.probability / 100) as forecast
FROM opportunities o JOIN pipeline_stages ps ON ps.id = o.stage_id
WHERE o.status IN ('aberta', 'em_andamento')
GROUP BY ps.id ORDER BY ps.sort_order

### 13. Usuários e Permissões
Controle de acesso — perfis de administrador, gestor, vendedor, SDR e financeiro com permissões granulares.
OBJETIVO
Controlar usuários, perfis e permissões de acesso ao CRM.

PERFIS DO MVP
- Administrador: acesso total, configura o sistema
- Diretor / Gestor: vê toda a equipe, relatórios, metas e pipeline
- Vendedor: vê e edita seus próprios leads, clientes e oportunidades
- SDR: cria e qualifica leads, sem acesso ao funil completo
- Financeiro: vê propostas e valores, sem alterar o funil

PERMISSÕES BÁSICAS
- Criar lead / Editar lead / Excluir lead
- Criar cliente / Editar cliente
- Criar oportunidade / Editar oportunidade
- Mover etapa do funil
- Criar proposta / Editar proposta
- Ver relatórios / Exportar dados
- Gerenciar usuários (apenas admin)
- Configurar sistema (apenas admin)

CAMPOS DO USUÁRIO
- Nome completo / E-mail (login) / Senha (bcrypt)
- Perfil de acesso
- Status (Ativo / Inativo)
- Data de criação / Último acesso

REGRAS
- Vendedor só vê leads e oportunidades onde é responsável
- Gestor vê o time inteiro
- Admin gerencia usuários e configurações
- Usuário inativo não pode fazer login
- Senha obrigatoriamente criptografada (bcrypt)
MVP: ÉPICO 1 — Autenticação
- Criar login com e-mail e senha
- Criar recuperação de senha por e-mail com token
- Criar controle de sessão com timeout
- Criar perfis de acesso (roles)

ÉPICO 8 — Administração de Usuários
- Criar CRUD de usuários pelo administrador
- Definir e associar perfil a cada usuário
- Implementar filtro de dados por responsável (vendedor vê só os seus)
- Criar log de acesso (último login)
- Inativar usuário sem excluir histórico
CRUD: TABELAS

users
- id BIGINT PRIMARY KEY AUTO_INCREMENT
- name VARCHAR(255) NOT NULL
- email VARCHAR(255) UNIQUE NOT NULL
- password VARCHAR(255) NOT NULL
- role ENUM('admin','gestor','vendedor','sdr','financeiro') DEFAULT 'vendedor'
- status ENUM('ativo','inativo') DEFAULT 'ativo'
- last_login_at TIMESTAMP NULL
- created_at TIMESTAMP, updated_at TIMESTAMP

roles (permissões granulares — fase 2)
- id BIGINT PRIMARY KEY
- name VARCHAR(100) NOT NULL
- permissions JSON
  Exemplo: {"create_lead":true,"view_reports":false,"manage_users":false}

QUERIES DE PERMISSÃO
-- Leads visíveis pelo vendedor
SELECT * FROM leads WHERE project_id = :pid AND responsible_id = :uid

-- Leads visíveis pelo gestor/admin (todos)
SELECT * FROM leads WHERE project_id = :pid

-- Verificar permissão
SELECT JSON_EXTRACT(r.permissions, '$.create_lead') as can_create
FROM users u JOIN roles r ON r.id = u.role_id WHERE u.id = :uid

## Agentes

### 1. Agente Validador de CNPJ CRM
Agente de CRM especializado em validação cadastral de empresas brasileiras a partir do CNPJ. Atua como camada de double check cadastral, conferindo informações com dados oficiais antes de criar ou atualizar cadastros.
Executar o processo seguindo este fluxo:

1. Receber os dados informados pelo usuário;
2. Verificar se o CNPJ foi informado;
3. Validar o formato do CNPJ;
4. Consultar fontes oficiais ou públicas confiáveis;
5. Buscar os dados cadastrais da empresa;
6. Consultar o CRM para verificar duplicidade;
7. Comparar os dados informados com os dados encontrados;
8. Classificar cada campo (CONFERE / DIVERGENTE / NÃO INFORMADO / NÃO ENCONTRADO NA FONTE / PRECISA DE CONFIRMAÇÃO);
9. Identificar divergências e alertas;
10. Gerar uma recomendação;
11. Preparar os dados sugeridos para cadastro;
12. Solicitar aprovação humana quando necessário;
13. Registrar logs da validação.

Ser objetivo, técnico e seguro. Não inventar dados, não assumir informações ausentes, não sobrescrever dados críticos sem confirmação.

### 2. Agente Qualificador de Leads CRM
Agente de CRM especializado em qualificar leads novos, identificar potencial comercial, classificar prioridade de atendimento e sugerir a próxima ação para o vendedor.Analisa os dados recebidos de um lead e determina se ele é frio, morno ou quente, com base em critérios comerciais, perfil de cliente ideal (ICP), urgência, interesse, orçamento, segmento e aderência ao produto ou serviço.
1. Receber os dados do lead
2. Verificar se os dados mínimos foram informados
3. Consultar o CRM para identificar histórico ou duplicidade
4. Avaliar origem do lead
5. Avaliar mensagem enviada pelo cliente
6. Verificar produto ou serviço de interesse
7. Comparar o perfil do lead com o ICP da empresa
8. Classificar o lead como frio, morno ou quente
9. Definir prioridade baixa, média ou alta
10. Sugerir a próxima ação comercial
11. Criar tarefa para o vendedor, se permitido
12. Registrar a análise no CRM

### 3. Agente de Follow-up Comercial CRM
Agente especializado em monitorar atividades comerciais, identificar contatos pendentes, sugerir mensagens de follow-up e evitar que leads, oportunidades ou clientes fiquem sem retorno.Sua função é garantir cadência comercial e disciplina de atendimento.
1. Consultar atividades abertas
2. Verificar tarefas vencidas
3. Identificar oportunidades sem movimentação
4. Avaliar última interação com o cliente
5. Calcular tempo desde o último contato
6. Sugerir próxima mensagem de follow-up
7. Criar ou atualizar tarefa de follow-up
8. Alertar vendedor responsável
9. Registrar recomendação no CRM

### 4. Agente Gestor de Pipeline CRM
Agente especializado em acompanhar oportunidades comerciais, analisar o pipeline de vendas, identificar riscos, sugerir mudanças de etapa e apoiar previsibilidade comercial.Ajuda gestores e vendedores a entenderem o que está avançando, o que está parado e o que precisa de ação imediata.
1. Consultar oportunidades abertas no CRM
2. Verificar etapa atual do funil
3. Avaliar data da última movimentação
4. Analisar valor estimado e probabilidade
5. Verificar existência de próxima ação
6. Identificar oportunidades sem próxima ação definida
7. Sugerir avanço, manutenção, alerta ou revisão de etapa
8. Identificar risco de perda
9. Atualizar campos permitidos no CRM
10. Gerar resumo para vendedor ou gestor

### 5. Agente Assistente de Propostas CRM
Agente especializado em apoiar a criação, revisão e organização de propostas comerciais com base nos dados da oportunidade, produtos, serviços, condições comerciais e histórico do cliente.Sua função é preparar propostas mais consistentes, reduzir erros e garantir que informações críticas estejam completas antes do envio ao cliente.
1. Receber dados da oportunidade
2. Consultar cadastro do cliente e validar CNPJ
3. Consultar produtos ou serviços solicitados
4. Verificar escopo da proposta
5. Validar dados obrigatórios
6. Conferir condições comerciais permitidas
7. Gerar estrutura de proposta
8. Apontar informações faltantes ou inconsistentes
9. Sugerir texto comercial para cada seção
10. Indicar necessidade de aprovação quando necessário
11. Registrar versão da proposta no CRM

### 6. Agente de Pós-venda e Retenção CRM
Agente especializado em acompanhar clientes ativos após a venda, identificar riscos de cancelamento, oportunidades de expansão, necessidade de suporte e sinais de insatisfação.Sua função é ajudar a empresa a manter clientes, aumentar satisfação e gerar novas oportunidades comerciais dentro da base ativa.
1. Monitorar clientes ativos no CRM
2. Consultar contratos e status de atendimento
3. Verificar tickets abertos e reclamações
4. Analisar histórico de reclamações e NPS
5. Identificar queda de engajamento ou uso
6. Verificar vencimento de contrato
7. Identificar possibilidade de renovação ou expansão
8. Sugerir ação de retenção ou expansão
9. Criar tarefa para CS ou vendedor responsável
10. Registrar alerta no CRM

Todos os modulos

13 modulos deste projeto

1. Módulos do MVP

Tela inicial com visão rápida da operação.

MVP CRUD Incluso
criar 

Indicadores principais
Total de leads;
Leads novos;
Leads em atendimento;
Oportunidades abertas;
Valor total do pipeline;
Propostas enviadas;
Vendas ganhas;
Vendas perdidas;
Forecast do mês;
Atividades atrasadas;
Ranking de vendedores.
Filtros
Período;
Vendedor;
Etapa do funil;
Origem do lead;
Produto ou serviço;
Status da oportunidade.

2. Leads

Controle dos potenciais clientes antes de virarem oportunidade — qualificação, atendimento e conversão.

MVP CRUD Incluso
OBJETIVO
Controlar potenciais clientes desde a entrada até a qualificação e conversão.

CAMPOS PRINCIPAIS
- Nome do lead / Empresa / CNPJ ou CPF
- Segmento / Porte da empresa
- Cidade / Estado
- Nome do contato / Cargo
- E-mail / Telefone / WhatsApp
- Origem do lead (site, indicação, evento, anúncio, prospecção...)
- Produto ou serviço de interesse
- Status do lead
- Responsável comercial
- Data de entrada / Primeiro contato / Última interação
- Próxima ação / Data da próxima ação
- Observações

STATUS DO LEAD
1. Novo
2. Em contato
3. Qualificado
4. Não qualificado
5. Convertido em oportunidade
6. Perdido

REGRAS DE NEGÓCIO
- Todo lead precisa ter um responsável atribuído
- Lead qualificado pode ser convertido: cria Cliente + Oportunidade automaticamente
- Lead perdido exige motivo de perda obrigatório
- Lead sem contato por X dias gera alerta no dashboard
- Ao converter, o lead fica como "Convertido" e não pode ser editado

TELA DE LISTA
- Tabela com colunas configuráveis
- Filtros: status, responsável, origem, período, segmento
- Busca por nome, empresa, CNPJ, e-mail
- Ações rápidas: editar, converter, perder
- Botão "Novo Lead"

3. Clientes

Base central de empresas e clientes — dados cadastrais, responsável, status e histórico comercial.

MVP CRUD Incluso
OBJETIVO
Base central de todas as empresas atendidas ou em atendimento.

CAMPOS PRINCIPAIS
- Razão social / Nome fantasia
- CNPJ (único na base)
- Segmento / Porte
- Site
- Cidade / Estado / Endereço completo
- Status do cliente
- Responsável pela conta
- Origem (como entrou na base)
- Observações
- Histórico comercial (automático)

STATUS DO CLIENTE
1. Prospect
2. Cliente ativo
3. Cliente inativo
4. Ex-cliente

REGRAS DE NEGÓCIO
- CNPJ deve ser único na base (sem duplicatas)
- Cliente pode ter múltiplos contatos vinculados
- Cliente pode ter múltiplas oportunidades simultaneamente
- Histórico exibe: interações, propostas, oportunidades e atividades
- Responsável pela conta deve ser um usuário ativo
- Ao converter um lead, o cliente é criado automaticamente

TELA DE CADASTRO
- Aba: Dados da empresa
- Aba: Contatos vinculados
- Aba: Oportunidades
- Aba: Histórico comercial

4. Contatos

Pessoas vinculadas a cada cliente — múltiplos contatos por empresa com tipo e nível de influência.

MVP CRUD Incluso
OBJETIVO
Cadastro de pessoas (contatos) vinculadas a cada empresa/cliente.

CAMPOS PRINCIPAIS
- Nome completo
- Cargo / Departamento
- E-mail / Telefone / WhatsApp
- Tipo de contato
- Nível de influência (Alto / Médio / Baixo)
- Observações
- Contato principal? (sim/não)

TIPOS DE CONTATO
1. Decisor
2. Influenciador
3. Técnico
4. Financeiro
5. Compras
6. Usuário final

REGRAS
- Todo contato precisa estar vinculado a um cliente
- Um cliente pode ter N contatos
- Ao criar uma oportunidade, o contato principal é selecionado
- O mesmo contato pode aparecer em múltiplas oportunidades do mesmo cliente
- Contatos são exibidos em aba dentro da tela do cliente

5. Funil de Vendas

Coração do CRM — visualização Kanban das oportunidades por etapa com probabilidade e valor por coluna.

MVP CRUD Incluso
OBJETIVO
Controle visual das etapas de venda em formato Kanban.

ETAPAS PADRÃO DO MVP
1. Lead novo — 5%
2. Primeiro contato — 10%
3. Qualificação — 20%
4. Diagnóstico — 35%
5. Proposta enviada — 50%
6. Negociação — 70%
7. Fechamento — 90%
8. Ganhou — 100%
9. Perdido — 0%

FUNCIONALIDADES
- Visualização Kanban (colunas por etapa)
- Arrastar oportunidade entre etapas (drag and drop)
- Cada coluna exibe: nome da etapa, total de oportunidades e valor somado
- Card da oportunidade: nome, cliente, valor, responsável, data prevista
- Filtros no Kanban: vendedor, produto, período de fechamento
- Gestor pode editar nomes e probabilidades das etapas

COMPORTAMENTOS ESPECIAIS
- Mover para "Ganhou" → modal para confirmar valor final
- Mover para "Perdido" → modal obrigatório de motivo de perda
- Oportunidades paradas há X dias recebem indicador visual de alerta

PROBABILIDADE SUGERIDA POR ETAPA
Lead novo: 5% | Primeiro contato: 10% | Qualificação: 20%
Diagnóstico: 35% | Proposta enviada: 50% | Negociação: 70%
Fechamento: 90% | Ganhou: 100% | Perdido: 0%

6. Oportunidades

Cada possível venda vira uma oportunidade — valor, probabilidade, etapa, responsável e próxima ação.

MVP CRUD Incluso
OBJETIVO
Registrar e controlar cada possível venda em andamento.

CAMPOS PRINCIPAIS
- Nome da oportunidade
- Cliente vinculado / Contato principal
- Produto ou serviço
- Valor estimado
- Valor recorrente mensal (se houver)
- Valor único (se houver)
- Probabilidade de fechamento (%)
- Etapa do funil
- Data prevista de fechamento
- Responsável comercial
- Origem
- Necessidade do cliente
- Próxima ação / Data da próxima ação
- Status / Motivo de perda (obrigatório se perdida)
- Observações

STATUS DA OPORTUNIDADE
1. Aberta
2. Em andamento
3. Parada
4. Ganha
5. Perdida
6. Cancelada

REGRAS DE NEGÓCIO
- Toda oportunidade deve estar em uma etapa do funil
- Ao ganhar: registrar valor final confirmado e data
- Ao perder: motivo de perda é obrigatório
- Oportunidade parada por X dias gera alerta automático
- Toda oportunidade deve ter próxima ação cadastrada
- Forecast = valor × probabilidade / 100

7. Atividades e Follow-ups

Controle das ações comerciais — ligações, reuniões, visitas, follow-ups e tarefas com alertas de vencimento.

MVP CRUD Incluso
OBJETIVO
Controlar todas as ações comerciais do time de vendas.

TIPOS DE ATIVIDADE
1. Ligação
2. Reunião
3. E-mail
4. WhatsApp
5. Visita
6. Demonstração
7. Envio de proposta
8. Follow-up
9. Tarefa interna

CAMPOS PRINCIPAIS
- Tipo da atividade
- Cliente vinculado
- Oportunidade vinculada (opcional)
- Responsável
- Data e hora
- Prioridade (Alta / Média / Baixa)
- Status
- Descrição do que foi ou será feito
- Resultado (preenchido ao concluir)
- Próxima ação sugerida

STATUS
1. Pendente
2. Concluída
3. Atrasada
4. Cancelada

ALERTAS AUTOMÁTICOS
- Atividade vencida: não concluída após data e hora
- Proposta sem retorno em X dias
- Oportunidade sem movimentação em X dias
- Lead novo sem primeiro contato em X horas

TELAS
- Lista de atividades com filtros (tipo, status, responsável, data)
- Calendário simples: dia e semana
- Atividades vencidas destacadas no topo
- Modal "Concluir" com campo de resultado e próxima ação

8. Propostas Comerciais

Controle de propostas — número automático, valor, desconto, validade, status e vínculo com oportunidade.

MVP CRUD Incluso
OBJETIVO
Controlar propostas enviadas aos clientes com rastreamento de status e vínculo ao funil.

CAMPOS PRINCIPAIS
- Número da proposta (gerado automaticamente: PROP-0001)
- Cliente / Oportunidade vinculada
- Produto ou serviço
- Valor bruto / Desconto (% ou R$) / Valor final
- Validade da proposta (data)
- Condição de pagamento
- Prazo de entrega ou implantação
- Status
- Arquivo anexo (PDF)
- Observações

STATUS DA PROPOSTA
1. Rascunho
2. Enviada
3. Em negociação
4. Aprovada
5. Recusada
6. Vencida

REGRAS DE NEGÓCIO
- Número sequencial automático: PROP-0001, PROP-0002...
- Proposta aprovada → move oportunidade para "Ganha" automaticamente
- Proposta recusada → pergunta se deve mover para "Perdida"
- Proposta com validade expirada → status muda para "Vencida" automaticamente
- Vencida gera alerta no dashboard

9. Produtos e Serviços

Catálogo do que a empresa vende — produtos, serviços, projetos e recorrentes com preço padrão e margem.

MVP CRUD Incluso
OBJETIVO
Catálogo centralizado dos produtos e serviços disponíveis para venda.

CAMPOS PRINCIPAIS
- Nome / Categoria
- Descrição detalhada
- Tipo
- Preço padrão (sugerido ao criar oportunidade)
- Custo estimado
- Margem estimada (% calculada automaticamente)
- Status (Ativo / Inativo)

TIPOS DE PRODUTO/SERVIÇO
1. Produto (venda única)
2. Serviço (execução pontual)
3. Projeto (escopo definido)
4. Mensalidade (recorrente mensal)
5. Contrato recorrente (anual ou multianual)

REGRAS
- Preço padrão é sugerido ao vincular ao criar oportunidade ou proposta, mas pode ser editado
- Margem calculada: (preço - custo) / preço × 100
- Produto inativo não aparece na seleção de novas oportunidades
- Inativar não deleta do histórico (mantém nas oportunidades e propostas existentes)

10. Motivos de Perda

Cadastro obrigatório dos motivos pelos quais vendas não fecharam — base para análise e melhoria comercial.

MVP CRUD Incluso
OBJETIVO
Registrar e analisar por que as oportunidades foram perdidas.

MOTIVOS PADRÃO DO MVP
1. Preço
2. Prazo de entrega
3. Concorrente escolhido
4. Sem orçamento no momento
5. Sem decisão interna
6. Produto não atende a necessidade
7. Cliente não respondeu
8. Projeto cancelado pelo cliente
9. Timing futuro — quer comprar depois
10. Condição comercial recusada

OBRIGATORIEDADE
Toda oportunidade marcada como Perdida DEVE ter:
- Motivo de perda (obrigatório, seleção)
- Comentário livre sobre o que aconteceu
- Data da perda (automática)
- Responsável pela oportunidade (automático)

USO NOS RELATÓRIOS
- Relatório de motivos de perda por período
- Ranking de motivos mais frequentes
- Motivos de perda por vendedor
- Análise para ajuste de preço, produto ou processo comercial

11. Metas Comerciais

Controle de metas por vendedor — meta mensal, realizado, forecast, % atingido e ranking do time.

MVP CRUD Incluso
OBJETIVO
Controlar metas comerciais individuais e acompanhar o desempenho do time.

CAMPOS PRINCIPAIS
- Vendedor
- Período (mês / ano)
- Meta mensal (R$)
- Receita realizada (calculada automaticamente: oportunidades ganhas no período)
- Receita prevista — Forecast ponderado das oportunidades abertas
- Percentual atingido (calculado: realizado / meta × 100)
- Gap para meta (calculado: meta - realizado)

INDICADORES DO MÓDULO
- Meta × realizado por vendedor
- Meta × forecast: projeção de atingimento
- Ranking de vendedores por receita no período
- Ticket médio por vendedor
- Quantidade de vendas ganhas no período

CÁLCULOS AUTOMÁTICOS
- Realizado = SUM(final_value) WHERE status = ganha no período
- Forecast = SUM(value × probability / 100) com fechamento previsto no período
- % atingido = realizado / meta × 100
- Gap = meta - realizado (negativo = abaixo da meta)

12. Forecast Básico

Previsão de receita ponderada pelo pipeline — valor × probabilidade por vendedor, etapa e produto.

MVP CRUD Incluso
OBJETIVO
Previsão de receita com base nas oportunidades ativas no pipeline.

FÓRMULA PRINCIPAL
Forecast = Valor da oportunidade × Probabilidade da etapa / 100

Exemplo: R$ 100.000 × 70% = R$ 70.000 de forecast ponderado

VISÕES DISPONÍVEIS
1. Forecast total do mês corrente
2. Forecast por vendedor
3. Forecast por etapa do funil
4. Forecast por produto ou serviço
5. Oportunidades com fechamento previsto em 30 dias
6. Oportunidades com fechamento previsto em 60 dias
7. Oportunidades com fechamento previsto em 90 dias

INDICADORES
- Forecast total vs. meta do mês
- Forecast por vendedor vs. meta individual
- Oportunidades de alto valor no pipeline
- Comparativo forecast vs. realizado do mês anterior

REGRAS
- Somente oportunidades Abertas e Em andamento entram no forecast
- Probabilidade base vem da etapa do funil, mas pode ser ajustada por oportunidade
- Oportunidades paradas há mais de X dias são sinalizadas no forecast

13. Usuários e Permissões

Controle de acesso — perfis de administrador, gestor, vendedor, SDR e financeiro com permissões granulares.

MVP CRUD Incluso
OBJETIVO
Controlar usuários, perfis e permissões de acesso ao CRM.

PERFIS DO MVP
- Administrador: acesso total, configura o sistema
- Diretor / Gestor: vê toda a equipe, relatórios, metas e pipeline
- Vendedor: vê e edita seus próprios leads, clientes e oportunidades
- SDR: cria e qualifica leads, sem acesso ao funil completo
- Financeiro: vê propostas e valores, sem alterar o funil

PERMISSÕES BÁSICAS
- Criar lead / Editar lead / Excluir lead
- Criar cliente / Editar cliente
- Criar oportunidade / Editar oportunidade
- Mover etapa do funil
- Criar proposta / Editar proposta
- Ver relatórios / Exportar dados
- Gerenciar usuários (apenas admin)
- Configurar sistema (apenas admin)

CAMPOS DO USUÁRIO
- Nome completo / E-mail (login) / Senha (bcrypt)
- Perfil de acesso
- Status (Ativo / Inativo)
- Data de criação / Último acesso

REGRAS
- Vendedor só vê leads e oportunidades onde é responsável
- Gestor vê o time inteiro
- Admin gerencia usuários e configurações
- Usuário inativo não pode fazer login
- Senha obrigatoriamente criptografada (bcrypt)

Todos os agentes

6 agentes deste projeto

1. Agente Validador de CNPJ CRM

Agente de CRM especializado em validação cadastral de empresas brasileiras a partir do CNPJ. Atua como camada de double check cadastral, conferindo informações com dados oficiais antes de criar ou atualizar cadastros.

Incluso
Executar o processo seguindo este fluxo:

1. Receber os dados informados pelo usuário;
2. Verificar se o CNPJ foi informado;
3. Validar o formato do CNPJ;
4. Consultar fontes oficiais ou públicas confiáveis;
5. Buscar os dados cadastrais da empresa;
6. Consultar o CRM para verificar duplicidade;
7. Comparar os dados informados com os dados encontrados;
8. Classificar cada campo (CONFERE / DIVERGENTE / NÃO INFORMADO / NÃO ENCONTRADO NA FONTE / PRECISA DE CONFIRMAÇÃO);
9. Identificar divergências e alertas;
10. Gerar uma recomendação;
11. Preparar os dados sugeridos para cadastro;
12. Solicitar aprovação humana quando necessário;
13. Registrar logs da validação.

Ser objetivo, técnico e seguro. Não inventar dados, não assumir informações ausentes, não sobrescrever dados críticos sem confirmação.

2. Agente Qualificador de Leads CRM

Agente de CRM especializado em qualificar leads novos, identificar potencial comercial, classificar prioridade de atendimento e sugerir a próxima ação para o vendedor.Analisa os dados recebidos de um lead e determina se ele é frio, morno ou quente, com base em critérios comerciais, perfil de cliente ideal (ICP), urgência, interesse, orçamento, segmento e aderência ao produto ou serviço.

Incluso
1. Receber os dados do lead
2. Verificar se os dados mínimos foram informados
3. Consultar o CRM para identificar histórico ou duplicidade
4. Avaliar origem do lead
5. Avaliar mensagem enviada pelo cliente
6. Verificar produto ou serviço de interesse
7. Comparar o perfil do lead com o ICP da empresa
8. Classificar o lead como frio, morno ou quente
9. Definir prioridade baixa, média ou alta
10. Sugerir a próxima ação comercial
11. Criar tarefa para o vendedor, se permitido
12. Registrar a análise no CRM

3. Agente de Follow-up Comercial CRM

Agente especializado em monitorar atividades comerciais, identificar contatos pendentes, sugerir mensagens de follow-up e evitar que leads, oportunidades ou clientes fiquem sem retorno.Sua função é garantir cadência comercial e disciplina de atendimento.

Incluso
1. Consultar atividades abertas
2. Verificar tarefas vencidas
3. Identificar oportunidades sem movimentação
4. Avaliar última interação com o cliente
5. Calcular tempo desde o último contato
6. Sugerir próxima mensagem de follow-up
7. Criar ou atualizar tarefa de follow-up
8. Alertar vendedor responsável
9. Registrar recomendação no CRM

4. Agente Gestor de Pipeline CRM

Agente especializado em acompanhar oportunidades comerciais, analisar o pipeline de vendas, identificar riscos, sugerir mudanças de etapa e apoiar previsibilidade comercial.Ajuda gestores e vendedores a entenderem o que está avançando, o que está parado e o que precisa de ação imediata.

Incluso
1. Consultar oportunidades abertas no CRM
2. Verificar etapa atual do funil
3. Avaliar data da última movimentação
4. Analisar valor estimado e probabilidade
5. Verificar existência de próxima ação
6. Identificar oportunidades sem próxima ação definida
7. Sugerir avanço, manutenção, alerta ou revisão de etapa
8. Identificar risco de perda
9. Atualizar campos permitidos no CRM
10. Gerar resumo para vendedor ou gestor

5. Agente Assistente de Propostas CRM

Agente especializado em apoiar a criação, revisão e organização de propostas comerciais com base nos dados da oportunidade, produtos, serviços, condições comerciais e histórico do cliente.Sua função é preparar propostas mais consistentes, reduzir erros e garantir que informações críticas estejam completas antes do envio ao cliente.

Incluso
1. Receber dados da oportunidade
2. Consultar cadastro do cliente e validar CNPJ
3. Consultar produtos ou serviços solicitados
4. Verificar escopo da proposta
5. Validar dados obrigatórios
6. Conferir condições comerciais permitidas
7. Gerar estrutura de proposta
8. Apontar informações faltantes ou inconsistentes
9. Sugerir texto comercial para cada seção
10. Indicar necessidade de aprovação quando necessário
11. Registrar versão da proposta no CRM

6. Agente de Pós-venda e Retenção CRM

Agente especializado em acompanhar clientes ativos após a venda, identificar riscos de cancelamento, oportunidades de expansão, necessidade de suporte e sinais de insatisfação.Sua função é ajudar a empresa a manter clientes, aumentar satisfação e gerar novas oportunidades comerciais dentro da base ativa.

Incluso
1. Monitorar clientes ativos no CRM
2. Consultar contratos e status de atendimento
3. Verificar tickets abertos e reclamações
4. Analisar histórico de reclamações e NPS
5. Identificar queda de engajamento ou uso
6. Verificar vencimento de contrato
7. Identificar possibilidade de renovação ou expansão
8. Sugerir ação de retenção ou expansão
9. Criar tarefa para CS ou vendedor responsável
10. Registrar alerta no CRM

Prompts Relacionados

Criar SaaS Completo com Vibe Coding no Lovable
Vibe Coding Lovable
Prompt operacional Ideal para Builders e SaaS

Criar SaaS Completo com Vibe Coding no Lovable

MVP, fluxo de produto e interface

Prompt mestre para criar um SaaS funcional do zero usando Lovable e vibe coding, com auth, dashboard e pagamentos.

Economia: 1 sprint de base Entrega: prompt + estrutura Avaliado pela comunidade
Criar App Mobile com Login Social no Lovable
Vibe Coding Lovable
Prompt operacional Ideal para Builders e SaaS

Criar App Mobile com Login Social no Lovable

MVP, fluxo de produto e interface

Prompt para criar aplicativos mobile PWA com autenticação social completa usando Lovable e Supabase.

Economia: 1 sprint de base Entrega: prompt + estrutura Pronto para adaptar
Plano: Rate limit por usuário
Vibe Coding Bolt
Prompt operacional Ideal para Builders e SaaS

Plano: Rate limit por usuário

MVP, fluxo de produto e interface

Proteger endpoint sensível com limite de uso por usuário. Prompt estruturado com passos, formato de saída e critérios de…

Economia: 1 sprint de base Entrega: prompt + estrutura Pronto para adaptar