CRM Comercial¶
Em produção. O funil comercial roda dentro do sistema, com a taxonomia que a cliente já usava no ClickUp.
A operação vivia inteiramente no ClickUp, fora do sistema: o time não tinha visão do funil na plataforma, os dados do lead não conversavam com Vendas e Alunos, e todo relatório dependia de exportação manual.
Pipelines¶
Um pipeline é um funil, entidade de primeira classe, com suas próprias etapas. Existem porque não toda operação é funil de vendas: um pipeline Financeiro não tem as mesmas etapas que o comercial.
Pipelines aparecem como subgrupo dinâmico do Comercial no menu, e cada um é um destino de navegação. Antes eram escolhidos por um seletor dentro da tela, gravado na querystring, que na prática não trocava de pipeline.
Autorização por pipeline¶
A autorização é por vínculo, na tabela profile_pipeline_access, com ver e editar como colunas. Quem pode abrir o comercial não vê todos os funis por isso: é possível dar a um perfil o funil de indicações sem dar o de reengajamento.
As 12 etapas¶
A ordem abaixo é a do seeder de taxonomia. A cor é a do ClickUp, e o papel é o que as métricas consultam.
| # | Etapa | Grupo | Papel (role) |
|---|---|---|---|
| 1 | aguardando contato | open |
nenhum |
| 2 | pronto pra contactar | unstarted |
nenhum |
| 3 | contato inicial feito | unstarted |
contato_feito |
| 4 | em qualificação | custom |
qualificado |
| 5 | reunião agendada | custom |
reuniao_agendada |
| 6 | reunião confirmada | custom |
reuniao_agendada |
| 7 | follow-up | custom |
reuniao_realizada |
| 8 | contato futuro | custom |
nenhum |
| 9 | remarcar reunião | custom |
reuniao_agendada |
| 10 | perdido | done |
perdido |
| 11 | desqualificado | done |
perdido |
| 12 | venda realizada | closed |
ganho |
A semântica vem do papel, nunca do slug nem da posição
Três etapas diferentes têm o papel reuniao_agendada, e duas têm perdido. Marcos do funil, contagem de leads ativos e métricas do Painel consultam o papel. Slug é identificador, não semântica, e a posição muda quando alguém reordena o funil. Ver AD-008.
A taxonomia espelhada¶
| O que | Quantidade | Onde |
|---|---|---|
| Etapas | 12, por pipeline | crm_lead_stages |
| Origens do lead | 27 | crm_lead_origins |
| Faixas de faturamento | reais, do ClickUp | crm_revenue_ranges |
| Motivos de desqualificação | do ClickUp | crm_disqualification_reasons |
Taxonomia vem do banco, nunca do frontend
Tudo acima é servido ao cliente por endpoint de metadados. Nada disso é lista fixa no código da tela. Ver AD-003.
Regras de operação¶
- A etapa muda por ação explícita de quem opera, nunca por efeito colateral.
- Toda interação com o lead fica em
crm_lead_interactions. - Falha de rede com o ClickUp nunca bloqueia o trabalho local: o lead fica pendente e é reenviado.
Da etapa ganha até a venda¶
Chegar em "venda realizada" não cria contrato. Quem cria é a tela de venda, e isso é deliberado: antes existiam duas telas que não conversavam, e a de fechamento apenas marcava o lead como ganho e gravava um nome de produto de taxonomia própria.