ESTA DOCUMENTAÇÃO ESTÁ EM DESENVOLVIMENTO E CONSTANTE ATUALIZAÇÃO.

CRM — Pipelines Kanban

Documentação do pipeline visual de vendas, estágios do funil, probabilidades de fechamento e gatilhos de transição de negócios.

O Pipeline Visual (Kanban)

O funil de vendas do CRM é exposto como um quadro Kanban no frontend. Cada lead é um card que avança por colunas representativas dos estágios de conversão.

Novo 10%
Contato 25%
Qualificado 50%
Proposta 75%
Fechado 100%

Modelo de Dados (DevCod ORM: `Pipeline` & `PipelineStage`)

O lead representa uma oportunidade no pipeline. Abaixo está a modelagem DevCod ORM:

{`
model Pipeline {
  id         String          @id @default(cuid())
  siteId     String
  name       String
  createdAt  DateTime        @default(now())
  updatedAt  DateTime        @updatedAt
  archivedAt DateTime?
  leads      Lead[]
  stages     PipelineStage[]
}

model PipelineStage {
  id          String    @id @default(cuid())
  siteId      String
  name        String
  probability Float     @default(0.0)
  order       Int       @default(0)
  color       String    @default("#007AFF")
  createdAt   DateTime  @default(now())
  pipelineId  String
  updatedAt   DateTime  @default(now()) @updatedAt
  archivedAt  DateTime?
  leads       Lead[]
  pipeline    Pipeline  @relation(fields: [pipelineId], references: [id], onDelete: Cascade)
}
          `}

Gatilhos de Transição (Automation Hooks)

Mover um lead no quadro Kanban altera instantaneamente o campo status no banco. Essa mutação dispara automaticamente:

  • Disparo de Eventos: Gera o evento lead.status_changed processado pelo motor de automações (Flow Builder).
  • Roteamento de IA: Se o lead entrar no estágio "Qualificado", a IA Nova pode ser configurada para redigir uma proposta ou iniciar uma sequência de nutrição diferenciada.
Próximo: CRM — Lead Scoring →