Forecasting CRM
v1.0.0
Manual Crm Forecasting
user_manual
public
forecasting-crm
10
06/10/2026 10:39
· Des.Julio
# Manual de teste — Forecasting no CRM (chamado 0000570491)
**Sistema:** Vendor CRM · **Ambiente de teste:** homologação · **Grupo de empresa:** agentes
**Onde fica:** menu **CRM → Forecasting** (`/crm/forecasting`) e o card **Previsão Comercial** dentro de qualquer negociação.
## 1. O que foi entregue
1. **Card "Previsão Comercial"** na negociação (página e modal): valor estimado, probabilidade, previsão de fechamento, previsão de faturamento e motivo da previsão.
2. **Tela Forecasting**: 9 indicadores, 4 gráficos, filtros, detalhamento em grade e exportação para Excel/PDF.
3. **Permissão nova:** módulo **Forecasting** (grupo CRM), somente leitura.
## 2. Antes de começar
| # | Verificação | Como fazer |
| --- | --- | --- |
| 1 | Usuário com acesso ao grupo agentes em homologação | Entrar no painel e escolher o grupo agentes |
| 2 | Módulo Forecasting liberado no perfil do usuário | No cadastro do perfil, marcar o módulo "Forecasting" (grupo CRM). Sem ele o item não aparece no menu CRM |
| 3 | Ambiente atualizado | Se a tela der erro de "coluna não encontrada" ou o menu não existir mesmo com o módulo liberado, avise o desenvolvimento: falta rodar a migration e o seeder do módulo no ambiente |
| 4 | Usuário de teste | Des.Julio (gerente do departamento "Ti"). Para o teste de permissões use também Des.Felipe (usuário comum, não gerente) |
**Dados de teste já preparados no grupo agentes:** 263 negociações com previsão entre **out/2026 e mar/2027** (Prospect, Lead, Oportunidade e Cliente, todas no "Pipeline teste"), 12 ganhas e 3 perdidas em outubro. O grupo **não tem meta cadastrada** nem nota fiscal ligada a negociação (ver seção 10).
> Os valores de referência abaixo foram medidos em 05/10/2026. Se alguém alterar negociações do grupo agentes, os números mudam. O período padrão da tela é sempre o **mês atual**: em novembro, escolha o período de **01/10/2026 a 31/10/2026** para comparar com esta tabela.
## 3. Teste do card "Previsão Comercial"
Abra uma negociação: **CRM → Negociações** e clique numa linha (abre o modal), ou abra a página da negociação. O card fica na coluna da esquerda, abaixo de **Estratégia** e acima de **Datas**. O antigo bloco "Valor Médio" foi substituído por ele.
| # | Passo | Resultado esperado | OK? |
| --- | --- | --- | --- |
| 3.1 | Abrir uma negociação sem nenhuma previsão preenchida | O card mostra "Não informada" e o botão Informar | ☐ |
| 3.2 | Clicar em Informar (ou no lápis) | Abre o formulário com: Valor estimado, Probabilidade (%), Previsão de fechamento, Previsão de faturamento (opcional), Motivo da previsão (opcional) | ☐ |
| 3.3 | Preencher valor 10000, deixar a probabilidade em branco, fechamento 31/10/2026 e clicar Salvar | Aparece "Previsão comercial atualizada". O card mostra a data 31/10/2026 (não 30/10), a probabilidade da etapa com a marca "sugerido pela etapa" e o Valor ponderado | ☐ |
| 3.4 | Conferir o valor ponderado | = Valor estimado × Probabilidade ÷ 100 (ex.: R$ 10.000 com 40% → R$ 4.000,00) | ☐ |
| 3.5 | Editar, informar probabilidade 70 e salvar | Mostra 70% sem a marca "sugerido pela etapa". O ponderado muda para R$ 7.000,00 | ☐ |
| 3.6 | Editar e clicar em Usar a da etapa (xx%), depois salvar | A probabilidade volta ao valor da etapa e a marca "sugerido pela etapa" reaparece | ☐ |
| 3.7 | Tentar probabilidade 101 ou negativa | O campo não aceita (limite de 0 a 100) | ☐ |
| 3.8 | Informar faturamento 15/11/2026 e motivo "Cliente aprovou orçamento"; salvar | Os dois aparecem no card | ☐ |
| 3.9 | Editar, apagar a data de fechamento e salvar | A data volta para "—" (limpar é permitido) | ☐ |
| 3.10 | Editar e clicar Cancelar | Nada é gravado; o card volta ao que estava | ☐ |
| 3.11 | Fechar e reabrir a negociação | Os dados continuam salvos | ☐ |
| 3.12 | Repetir 3.3 abrindo pela página da negociação e depois pelo modal | Mesmo comportamento nos dois | ☐ |
| 3.13 | Abrir uma negociação sem etapa do funil e sem probabilidade | A probabilidade aparece como "—" e o valor ponderado não é exibido | ☐ |
| 3.14 | Entrar com um usuário sem permissão de edição na negociação | O lápis e o botão Informar não aparecem; o card só exibe | ☐ |
## 4. Acesso à tela
| # | Passo | Resultado esperado | OK? |
| --- | --- | --- | --- |
| 4.1 | No menu CRM, procurar Forecasting (logo abaixo de "Análise") | O item existe e abre /crm/forecasting | ☐ |
| 4.2 | Com um usuário sem o módulo Forecasting, olhar o menu CRM | O item não aparece | ☐ |
| 4.3 | Com esse mesmo usuário, digitar /crm/forecasting na barra do navegador | A tela não abre (acesso bloqueado ou redirecionamento) | ☐ |
## 5. Indicadores (cards)
Ao abrir a tela, o período é o **mês atual** (chip "Previsão de fechamento: 01/10/2026 a 31/10/2026").
| # | Passo | Resultado esperado | OK? |
| --- | --- | --- | --- |
| 5.1 | Conferir que há 9 cards: Valor total previsto, Valor ponderado, Oportunidades, Ticket médio, Clientes em negociação, Meta do período, Atingimento da meta, Faturado, Previsto − faturado | Todos presentes | ☐ |
| 5.2 | Passar o mouse no ? de cada card | Aparece a explicação do cálculo | ☐ |
| 5.3 | Período 01/10/2026 a 31/10/2026 no grupo agentes | Valor total previsto R$ 985.700,00 · Valor ponderado R$ 263.025,00 · Oportunidades 76 · Ticket médio R$ 12.969,74 · Clientes 76 | ☐ |
| 5.4 | Conferir o ticket médio | = Valor total previsto ÷ Oportunidades | ☐ |
| 5.5 | Card Previsto − faturado | = Valor ponderado − Faturado. Verde quando positivo, vermelho quando negativo | ☐ |
| 5.6 | Cards Meta e Atingimento no grupo agentes | Meta: "Sem meta cadastrada" · Atingimento: "—" (esperado, ver seção 10) | ☐ |
| 5.7 | Card Faturado no grupo agentes | R$ 0,00 · "0 notas · ganho R$ 246.600,00" | ☐ |
| 5.8 | Faixa de avisos acima dos cards | Aviso de 2.261 negociações em andamento sem data prevista, com link Ver negociações | ☐ |
| 5.9 | Clicar em Atualizar (ícone de seta no canto) | Os números recarregam sem erro | ☐ |
## 6. Filtros
Clique em **Filtros**. O painel tem 4 grupos: **Período**, **Comercial**, **Cliente** e **Oportunidade**. Depois de **Aplicar**, cada filtro vira um **chip** removível ao lado do período.
| # | Passo | Resultado esperado | OK? |
| --- | --- | --- | --- |
| 6.1 | Atalhos de período: Mês atual, Próximo mês, Próximos 3 meses, Ano atual | Preenchem início e fim corretos; ao aplicar, os cards e gráficos mudam | ☐ |
| 6.2 | Período personalizado 01/10/2026 a 31/03/2027 | Oportunidades 263 · Valor ponderado R$ 1.135.428,00 | ☐ |
| 6.3 | Informar só a data início (deixar o fim vazio) | O fim é completado com o último dia do mês do início; o chip mostra as duas datas | ☐ |
| 6.4 | Informar fim anterior ao início | Mensagem de erro de período, sem quebrar a tela | ☐ |
| 6.5 | Filtro Vendedor (escolher um) | Cards, gráficos e grade passam a mostrar só as negociações dele | ☐ |
| 6.6 | Filtro Equipe comercial | Idem para a equipe | ☐ |
| 6.7 | Filtro Supervisor / Gerente | Mostra as negociações das equipes geridas por essa pessoa | ☐ |
| 6.8 | Filtro Empresa / Filial | Só entram negociações que têm pedido dessa empresa (ver seção 11) | ☐ |
| 6.9 | Filtro Cliente (digitar 3 letras ou mais) | A lista é buscada conforme digita; ao escolher, filtra | ☐ |
| 6.10 | Filtros Segmento, Estado e Cidade | A cidade só habilita depois de escolher o estado | ☐ |
| 6.11 | Filtro Origem do lead | Filtra pela origem | ☐ |
| 6.12 | Filtro Status da oportunidade (Prospect, Lead, Oportunidade) | Filtra só o previsto. Ganhas e perdidas não aparecem como opção | ☐ |
| 6.13 | Filtros Pipeline e Etapa do funil | Filtram pela etapa | ☐ |
| 6.14 | Combinar 2 ou mais filtros | Os resultados respeitam todos ao mesmo tempo | ☐ |
| 6.15 | Clicar no x de um chip | Só aquele filtro sai; a tela recarrega | ☐ |
| 6.16 | Clicar em Limpar | Saem todos os chips, o período é mantido | ☐ |
| 6.17 | Aplicar um filtro, sair da tela e voltar | Os filtros continuam; o período volta para o mês atual (esperado) | ☐ |
## 7. Gráficos
> **Forecast por mês**
> *O que mostrar: o gráfico de barras com Previsto bruto, Ponderado e Faturado, no período 01/10/2026 a 31/03/2027 (6 meses).*
> 
> **Forecast por vendedor / equipe**
> *O que mostrar: as barras horizontais, com o seletor Vendedor/Equipe visível. Se possível, um print de cada opção.*
> 
> **Funil por etapa**
> *O que mostrar: o funil e a tabela ao lado (Etapa, Prob., Oport., Ponderado, %).*
> 
> **Evolução das oportunidades**
> *O que mostrar: as linhas de Criadas, Ganhas e Perdidas com os nomes no fim de cada linha (confirmar que não ficam um sobre o outro). Período 01/07/2026 a 31/10/2026.*
> 
| # | Gráfico | O que conferir | OK? |
| --- | --- | --- | --- |
| 7.1 | Forecast por mês | Barras de Previsto bruto, Ponderado e Faturado por mês. Com o período out/2026–mar/2027 aparecem os 6 meses. Passar o mouse mostra o valor e "N oportunidades · ganho R$ …" | ☐ |
| 7.2 | Clicar numa barra do gráfico por mês | O período da tela passa a ser aquele mês | ☐ |
| 7.3 | Forecast por vendedor / equipe | Alternar Vendedor ↔ Equipe. Mostra os 10 maiores e, se houver mais, "Outros (n)". A soma bate com o card Valor ponderado | ☐ |
| 7.4 | Clicar numa barra de vendedor ou equipe | Aplica o filtro correspondente (aparece o chip) | ☐ |
| 7.5 | Oportunidades por etapa do funil | Funil + tabela ao lado (etapa, Prob., Oport., Ponderado, %). Com out/2026–mar/2027: 10% = 75 · 15% = 75 · 20% = 66 · 25% = 38 · 40% = 9 oportunidades | ☐ |
| 7.6 | Clicar numa etapa do funil | Aplica o filtro "Etapa do funil" | ☐ |
| 7.7 | Evolução das oportunidades | Linhas de Criadas, Ganhas e Perdidas. Em período de até 3 meses o eixo é por semana ("sem. 28/09"); acima disso, por mês. Os nomes das séries aparecem no fim das linhas sem ficar um sobre o outro | ☐ |
| 7.8 | Período 01/07/2026 a 31/10/2026 na evolução | Criadas 30 / 29 / 48 / 39 · Ganhas 0 / 2 / 4 / 12 · Perdidas 5 / 2 / 2 / 3 (jul / ago / set / out) | ☐ |
| 7.9 | Botão Ver tabela em cada gráfico | Mostra os mesmos números em tabela; Ver gráfico volta | ☐ |
| 7.10 | Aplicar um filtro | Todos os gráficos mudam juntos | ☐ |
| 7.11 | Trocar o tema claro ↔ escuro (ícone de lua no topo) | Os gráficos se repintam na hora, com cores legíveis nos dois temas | ☐ |
## 8. Detalhamento e exportação
Fica no fim da página, na seção **Detalhamento**.
> **Detalhamento (grade)**
> *O que mostrar: a seção Detalhamento com o seletor de recorte (com as contagens), as colunas, a barra de probabilidade e o **rodapé de totais** visível.*
> 
> **Exportação**
> *O que mostrar: o menu de exportação da grade aberto (CSV, Excel, PDF) e, em outro print, o arquivo Excel ou PDF gerado aberto.*
> 
| # | Passo | Resultado esperado | OK? |
| --- | --- | --- | --- |
| 8.1 | Rolar até o fim da página | A grade carrega ao aparecer (pode mostrar "carregando" por alguns segundos) | ☐ |
| 8.2 | Seletor de recorte: Previsto, Ganhas no período, Sem data prevista (cada um com a contagem entre parênteses) | A contagem de cada um bate com os cards: Previsto = Oportunidades (76) · Ganhas = 12 · Sem data prevista = 2.261 | ☐ |
| 8.3 | Conferir o número de linhas do recorte Previsto | = card Oportunidades | ☐ |
| 8.4 | Conferir o rodapé de totais (Valor e Ponderado) no recorte Previsto | Valor = R$ 985.700,00 · Ponderado = R$ 263.025,00 (iguais aos cards) | ☐ |
| 8.5 | Recorte Ganhas no período | 12 linhas, soma de Valor = R$ 246.600,00 | ☐ |
| 8.6 | Colunas visíveis | Nº, Cliente, Valor, Probabilidade (com barra), Ponderado, Previsão de fechamento, Vendedor, Etapa atual, Última interação | ☐ |
| 8.7 | Abrir o seletor Colunas da grade | Dá para ligar: Previsão de faturamento, Ganha em, Equipe, Status e Motivo da previsão | ☐ |
| 8.8 | Probabilidade herdada da etapa | A barra mostra a marca "etapa" ao lado do percentual | ☐ |
| 8.9 | Ordenar e filtrar por coluna; usar a busca global | Funcionam sobre o recorte carregado | ☐ |
| 8.10 | Clicar numa linha | Abre o modal da negociação. Salvar algo nele atualiza a tela | ☐ |
| 8.11 | Clicar nos cards (Valor total previsto, Valor ponderado, Oportunidades, Ticket médio, Clientes, Previsto − faturado) | A página rola até o detalhamento e seleciona o recorte Previsto | ☐ |
| 8.12 | Clicar nos cards Faturado, Meta e Atingimento | Não são clicáveis (esperado) | ☐ |
| 8.13 | Clicar em Ver negociações no aviso de "sem data prevista" | Rola até o detalhamento no recorte Sem data prevista | ☐ |
| 8.14 | Menu de exportação da grade → Excel | Baixa um .xlsx. Nome do arquivo = "Forecast - Previsto - 01-10-2026 a 31-10-2026". Colunas e linhas iguais à grade; probabilidade como texto ("70% etapa") | ☐ |
| 8.15 | Exportar PDF | Baixa o PDF com as colunas visíveis e o rodapé de totais | ☐ |
| 8.16 | Exportar CSV | Baixa o arquivo | ☐ |
| 8.17 | Aplicar um filtro e exportar de novo | O arquivo traz só o que está filtrado | ☐ |
| 8.18 | Recorte Sem data prevista sem filtros | Se houver mais de 10.000 linhas, aparece o aviso "Mostrando X de Y negociações. Refine os filtros…" | ☐ |
## 9. Permissões (RF07)
| # | Passo | Resultado esperado | OK? |
| --- | --- | --- | --- |
| 9.1 | Entrar com Des.Julio (gerente de "Ti") e anotar as Oportunidades de out/2026 | Valor de referência: 76 | ☐ |
| 9.2 | Entrar com Des.Felipe (usuário comum) e abrir o Forecasting no mesmo período | Vê menos oportunidades que o Des.Julio | ☐ |
| 9.3 | Com Des.Felipe, ir em CRM → Negociações e filtrar por previsão de fechamento no mesmo período | O número de negociações bate com o card Oportunidades do Forecasting | ☐ |
| 9.4 | Com Des.Felipe, filtrar Vendedor = outro usuário | Não aparecem negociações que ele não pode ver, e a Meta não mostra o valor de outra pessoa | ☐ |
## 10. Meta e atingimento
A meta **não é cadastrada no painel**: ela vem do **ERP (Delphi)**, tabela de metas de vendedores, e é sincronizada. Para o usuário do CRM enxergá-la, ele precisa estar **vinculado a um vendedor** no cadastro.
| # | Cenário | Resultado esperado | OK? |
| --- | --- | --- | --- |
| 10.1 | Grupo agentes, período out/2026 (sem meta cadastrada) | Meta "Sem meta cadastrada" e Atingimento "—" | ☐ |
| 10.2 | Base com meta (por exemplo, a base da CELPLAC, empresa 0001): período de um mês que tenha meta no ERP | Meta = soma das metas dos vendedores do recorte naquele mês | ☐ |
| 10.3 | Mesmo cenário | Atingimento = Faturado ÷ Meta · o card mostra também o projetado = (Faturado + Valor ponderado) ÷ Meta | ☐ |
| 10.4 | Período que corta o mês ao meio (ex.: 10/10 a 20/10) | A meta considerada é a do mês inteiro (esperado) | ☐ |
| 10.5 | Filtrar um usuário sem vínculo com vendedor | Aviso: "N usuário(s) do filtro não está(ão) vinculado(s) a um vendedor do ERP…" | ☐ |
## 11. Faturado e conferência com o ERP
O **Faturado** soma as notas fiscais **autorizadas** de saída, emitidas no período, dos **pedidos que estão ligados às negociações**. Notas canceladas ou com erro ficam fora.
| # | Passo | Resultado esperado | OK? |
| --- | --- | --- | --- |
| 11.1 | Em uma base com negociações ligadas a pedidos faturados (CELPLAC / empresa 0001), abrir o Forecasting no mês de uma nota conhecida | O card Faturado traz a soma dessas notas e o número de notas | ☐ |
| 11.2 | Comparar com o ERP: faturamento do mês dos pedidos vinculados a negociações | Os valores batem | ☐ |
| 11.3 | Conferir uma nota cancelada do mesmo mês | Ela não entra no Faturado | ☐ |
| 11.4 | Filtro Empresa / Filial = empresa da nota | O Faturado considera só as notas dessa empresa | ☐ |
## 12. Regras de negócio para conferir
| Regra | Como verificar |
| --- | --- |
| RN01 Só oportunidades ativas | Cancele uma negociação com previsão no período (Cancelar negociação). O card Oportunidades diminui em 1 |
| RN02 Valor ponderado = valor × probabilidade | Teste 3.4 e coluna Ponderado da grade |
| RN04 Perdidas e canceladas fora do forecast | Perca uma negociação do período: ela some do Previsto |
| RN05 Ganhas entram no realizado | Ganhe uma negociação: sai do Previsto e aparece em "Ganhas no período" |
| RN06 Período padrão = mês atual | Seção 5 |
| RN07 Gráficos acompanham os filtros | Teste 7.10 |
## 13. Comportamentos esperados (não são defeito)
- **Filial e Empresa são o mesmo filtro** e funcionam pelos **pedidos vinculados** à negociação. Negociação sem pedido some quando ele está ligado.
- **Supervisor e Gerente são o mesmo filtro** (o cadastro só distingue "gerente do departamento").
- **"Cancelada" = negociação inativa** (o CRM não tem status Cancelado).
- **"Nº" na grade** é o início do identificador da negociação; o CRM não tem número de oportunidade próprio.
- **Negociação em andamento sem data prevista de fechamento** não entra em nenhum mês do forecast; ela só aparece no aviso e no recorte "Sem data prevista".
- **Negociação sem etapa e sem probabilidade** pesa 0% no valor ponderado (o aviso "sem probabilidade" conta quantas).
- **Filtro de Status** vale só para o previsto; Ganhas, Faturado e Evolução o ignoram.
- **Período máximo:** 5 anos. **Grade:** até 10.000 linhas por vez.
- Dados de teste do grupo agentes foram **criados para demonstração** (nomes de clientes reais da base de homologação, valores e datas simulados).
## 14. Como registrar o resultado
Para cada item: marque ☐ → ✅ (passou) ou ❌ (falhou). Em caso de falha, anexe ao ticket:
1. **Número do passo** (ex.: 7.8) e o resultado obtido × esperado.
2. **Print da tela inteira**, com o período e os chips de filtro visíveis.
3. **Usuário, grupo de empresa e horário** do teste.
4. Se houver mensagem de erro, o texto exato; se possível, o print do console do navegador (tecla F12 → aba Console).
5. Para erros de exportação: o arquivo gerado.