#Design Detalhado do Sistema CRM 2.0

#1. Visão Geral do Sistema e Filosofia de Design

#1.1 Posicionamento do Sistema

Este sistema é uma Plataforma de Gestão de Vendas CRM 2.0 construída sobre a plataforma no-code NocoBase. O objetivo central é:

Permitir que as vendas se concentrem em construir relacionamentos com os clientes, e não na entrada de dados e análises repetitivas.

O sistema automatiza tarefas rotineiras por meio de fluxos de trabalho e utiliza IA para auxiliar na pontuação de leads, análise de oportunidades e outras tarefas, ajudando as equipes de vendas a aumentar a eficiência.

#1.2 Filosofia de Design

#Princípio 1: Funil de Vendas Completo

Processo de Vendas de Ponta a Ponta:

Por que projetar desta forma?

#Princípio 2: Pipeline de Vendas Configurável

Diferentes setores podem personalizar os estágios do pipeline de vendas sem modificar o código.

#Princípio 3: Design Modular

• Módulos principais (Clientes + Oportunidades) são obrigatórios; outros módulos podem ser ativados conforme a necessidade.
• A desativação de módulos não requer alterações de código; é feita através da interface de configuração do NocoBase.
• Cada módulo é projetado de forma independente para reduzir o acoplamento.

#2. Arquitetura de Módulos e Customização

#2.1 Visão Geral dos Módulos

O sistema CRM adota um design de arquitetura modular — cada módulo pode ser ativado ou desativado independentemente com base nos requisitos do negócio.

#2.2 Dependências de Módulos

#2.3 Versões Pré-configuradas

#2.4 Mapeamento de Módulo para Coleção

#Coleções de Módulos Core (Sempre Necessárias)

#2.5 Como Desativar Módulos

Basta ocultar a entrada do menu para o módulo na interface de administração do NocoBase; não há necessidade de modificar o código ou excluir coleções.

#3. Entidades Principais e Modelo de Dados

#3.1 Visão Geral do Relacionamento de Entidades

#3.2 Detalhes das Coleções Principais

#3.2.1 Leads (nb_crm_leads)

Gestão de leads usando um fluxo de trabalho simplificado de 4 estágios.

Processo de Estágio:

Novo → Em andamento → Qualificado → Convertido em Cliente/Oportunidade
         ↓              ↓
   Desqualificado  Desqualificado

Campos Principais:

#3.2.2 Clientes (nb_crm_customers)

Gestão de Clientes/Empresas com suporte a negócios internacionais.

Campos Principais:

#3.2.3 Oportunidades (nb_crm_opportunities)

Gestão de oportunidades de vendas com estágios de pipeline configuráveis.

Campos Principais:

#3.2.4 Cotações (nb_crm_quotations)

Gestão de cotações com suporte a multimoeda e fluxos de trabalho de aprovação.

Fluxo de Status:

Rascunho → Aprovação Pendente → Aprovado → Enviado → Aceito/Rejeitado/Expirado
                 ↓
             Rejeitado → Editar → Rascunho

Campos Principais:

#3.2.5 Pedidos (nb_crm_orders)

Gestão de pedidos incluindo rastreamento de pagamentos.

Campos Principais:

#3.3 Resumo das Coleções

#Coleções de Negócio do CRM

#Coleções de Dados Base (Módulos Comuns)

#3.4 Coleções Auxiliares

#3.4.1 Comentários (nb_crm_comments)

Coleção genérica de comentários/notas que pode ser associada a vários objetos de negócio.

#3.4.2 Compartilhamento de Clientes (nb_crm_customer_shares)

Permite colaboração entre várias pessoas e compartilhamento de permissões para clientes.

#3.4.3 Colaboradores da Oportunidade (nb_crm_opportunity_users)

Suporta a colaboração da equipe de vendas em oportunidades.

#3.4.4 Regiões (nb_cbo_regions)

Dicionário de dados base de Países/Regiões.

#4. Ciclo de Vida do Lead

A gestão de leads utiliza um fluxo de trabalho simplificado de 4 estágios. Quando um novo lead é criado, um fluxo de trabalho pode acionar automaticamente a pontuação por IA para ajudar as vendas a identificar rapidamente leads de alta qualidade.

#4.1 Definições de Status

#4.2 Fluxograma de Status

#4.3 Processo de Conversão de Leads

A interface de conversão oferece três opções simultaneamente; você pode optar por criar ou associar:

• Cliente: Criar um novo cliente OU associar a um cliente existente.
• Contato: Criar um novo contato (associado ao cliente).
• Oportunidade: Uma oportunidade deve ser criada.

Registros Pós-conversão:

• converted_customer_id: ID do Cliente Associado
• converted_contact_id: ID do Contato Associado
• converted_opportunity_id: ID da Oportunidade Criada

#5. Ciclo de Vida da Oportunidade

A gestão de oportunidades utiliza estágios de pipeline de vendas configuráveis. Quando o estágio de uma oportunidade muda, ele pode acionar automaticamente a previsão de probabilidade de ganho por IA para ajudar as vendas a identificar riscos e oportunidades.

#5.1 Estágios Configuráveis

Os estágios são armazenados na coleção nb_crm_opportunity_stages e podem ser personalizados:

#5.2 Fluxo do Pipeline

#5.3 Detecção de Estagnação

Oportunidades sem atividade serão sinalizadas:

-- Calcular dias de estagnação
UPDATE nb_crm_opportunities
SET stagnant_days = EXTRACT(DAY FROM NOW() - last_activity_at)
WHERE stage NOT IN ('won', 'lost');

#5.4 Tratamento de Ganho/Perda

Quando Ganho:

1. Atualizar estágio para 'won'.
2. Registrar data de fechamento real.
3. Atualizar status do cliente para 'active'.
4. Acionar criação de pedido (se uma cotação foi aceita).

Quando Perdido:

1. Atualizar estágio para 'lost'.
2. Registrar motivo da perda.
3. Registrar ID do concorrente (se perdido para um concorrente).
4. Notificar o gerente.

#6. Ciclo de Vida da Cotação

#6.1 Definições de Status

#6.2 Regras de Aprovação (A serem finalizadas)

Os fluxos de trabalho de aprovação são acionados com base nas seguintes condições:

#6.3 Suporte Multimoeda

#Filosofia de Design

Use USD como a moeda base unificada para todos os relatórios e análises. Cada registro de valor armazena:

• Moeda e valor originais (o que o cliente vê)
• Taxa de câmbio no momento da transação
• Valor equivalente em USD (para comparação interna)

#Dicionário de Moedas (nb_cbo_currencies)

A configuração de moedas usa uma coleção de dados base comum, suportando gestão dinâmica. O campo current_rate armazena a taxa de câmbio atual, atualizada por uma tarefa agendada a partir do registro mais recente em nb_crm_exchange_rates.

#Histórico de Taxas de Câmbio (nb_crm_exchange_rates)

Registra dados históricos de taxas de câmbio. Uma tarefa agendada sincroniza as taxas mais recentes para nb_cbo_currencies.current_rate.

Nota: As cotações são associadas à coleção nb_cbo_currencies via chave estrangeira currency_id, e a taxa de câmbio é recuperada diretamente do campo current_rate. Oportunidades e pedidos usam um campo VARCHAR currency para armazenar o código da moeda.

#Padrão de Campos de Valor

Coleções contendo valores seguem este padrão:

Aplicado a:

• nb_crm_opportunities.amount → amount_usd
• nb_crm_quotations.total_amount → total_amount_usd

#Integração de Fluxo de Trabalho

Lógica de Recuperação de Taxa de Câmbio:

1. Recuperar a taxa de câmbio diretamente de nb_cbo_currencies.current_rate durante as operações de negócio.
2. Transações em USD: Taxa = 1.0, nenhuma busca necessária.
3. current_rate é sincronizado por uma tarefa agendada a partir do último registro de nb_crm_exchange_rates.

#6.4 Gestão de Versão

Quando uma cotação é rejeitada ou expira, ela pode ser duplicada como uma nova versão:

QT-20260119-001 v1 → Rejeitado
QT-20260119-001 v2 → Enviado
QT-20260119-001 v3 → Aceito

#7. Ciclo de Vida do Pedido

#7.1 Visão Geral do Pedido

Os pedidos são criados quando uma cotação é aceita, representando um compromisso de negócio confirmado.

#7.2 Definições de Status do Pedido

#7.3 Modelo de Dados do Pedido

#nb_crm_orders

#nb_crm_order_items

#7.4 Rastreamento de Pagamento

#nb_crm_payments

#8. Ciclo de Vida do Cliente

#8.1 Visão Geral do Cliente

Os clientes são criados durante a conversão de leads ou quando uma oportunidade é ganha. O sistema rastreia o ciclo de vida completo, desde a aquisição até a promoção (advocacy).

#8.2 Definições de Status do Cliente

#8.3 Pontuação de Saúde do Cliente

A saúde do cliente é calculada com base em múltiplos fatores:

Limiares de Saúde:

if (health_score >= 90) status = 'advocate';
else if (health_score >= 70) status = 'active';
else if (health_score >= 50) status = 'growing';
else status = 'at_risk';

#8.4 Segmentação de Clientes

#Segmentação Automatizada

#9. Integração de E-mail

#9.1 Visão Geral

O NocoBase fornece um plugin de integração de e-mail integrado que suporta Gmail e Outlook. Uma vez que os e-mails são sincronizados, os fluxos de trabalho podem acionar automaticamente a análise de IA do sentimento e intenção do e-mail, ajudando as vendas a entender rapidamente as atitudes dos clientes.

#9.2 Sincronização de E-mail

Provedores Suportados:

• Gmail (via OAuth 2.0)
• Outlook/Microsoft 365 (via OAuth 2.0)

Comportamento de Sincronização:

• Sincronização bidirecional de e-mails enviados e recebidos.
• Associação automática de e-mails aos registros do CRM (Leads, Contatos, Oportunidades).
• Anexos armazenados no sistema de arquivos do NocoBase.

#9.3 Associação E-mail-CRM (A ser finalizada)

#9.4 Modelos de E-mail

As vendas podem usar modelos predefinidos:

#10. Recursos Assistidos por IA

#10.1 Equipe de Funcionários de IA

O sistema CRM integra o plugin de IA do NocoBase, utilizando os seguintes funcionários de IA integrados, configurados com tarefas específicas do CRM:

#10.2 Lista de Tarefas de IA

Os recursos de IA são divididos em duas categorias independentes:

#I. Funcionários de IA (Acionados por Blocos de Frontend)

Os usuários interagem diretamente com a IA através de blocos de Funcionários de IA no frontend para obter análises e sugestões.

#II. Nós de LLM em Fluxos de Trabalho (Execução Automatizada de Backend)

Nós de LLM aninhados em fluxos de trabalho, acionados automaticamente por eventos de coleção, eventos de ação ou tarefas agendadas, independentes dos Funcionários de IA.

Nota: Os nós de LLM de fluxo de trabalho usam prompts e saída de Schema para JSON estruturado, que é analisado e gravado nos campos de dados de negócio sem intervenção do usuário.

#10.3 Campos de IA no Banco de Dados

#11. Mecanismo de Fluxo de Trabalho

#11.1 Fluxos de Trabalho Implementados

#11.2 Fluxos de Trabalho a Implementar

#12. Design de Menu e Interface

#12.1 Estrutura Administrativa

#12.2 Visualizações de Painel

#Visão do Gerente de Vendas

#Visão do Representante de Vendas

#Visão Executiva

Versão do Documento: v2.0 | Atualizado em: 06-02-2026