#CRM 2.0 系统详细设计

#1. 系统概述与设计理念

#1.1 系统定位

本系统是基于 NocoBase 无代码平台构建的 CRM 2.0 销售管理平台。核心目标是：

让销售专注于建立客户关系，而非数据录入和重复性分析

系统通过工作流自动化处理常规任务，并借助 AI 辅助完成线索评分、商机分析等工作，帮助销售团队提升效率。

#1.2 设计理念

#理念一：完整的销售漏斗

端到端销售流程：

为什么这样设计？

#理念二：可配置的销售管线

不同行业可以自定义销售管线阶段，无需修改代码。

#理念三：模块化设计

• 核心模块（客户+商机）必需，其他模块可按需启用
• 禁用模块不需要修改代码，通过 NocoBase 界面配置即可
• 每个模块独立设计，降低耦合度

#2. 模块架构与定制化

#2.1 模块概述

CRM 系统采用模块化架构设计——每个模块可以根据业务需求独立启用或禁用。

#2.2 模块依赖关系

#2.3 预配置版本

#2.4 模块-数据表映射

#核心模块数据表（始终必需）

#2.5 如何禁用模块

在 NocoBase 管理后台隐藏该模块的菜单入口即可，无需修改代码或删除数据表。

#3. 核心实体与数据模型

#3.1 实体关系概述

#3.2 核心数据表详情

#3.2.1 线索表（nb_crm_leads）

采用简化的 4 阶段工作流的线索管理。

阶段流程：

新建 → 跟进中 → 已验证 → 转化为客户/商机
         ↓          ↓
      不合格      不合格

关键字段：

#3.2.2 客户表（nb_crm_customers）

支持外贸业务的客户/公司管理。

关键字段：

#3.2.3 商机表（nb_crm_opportunities）

采用可配置销售管线阶段的销售商机管理。

关键字段：

#3.2.4 报价表（nb_crm_quotations）

支持多币种和审批流程的报价管理。

状态流程：

草稿 → 待审批 → 已批准 → 已发送 → 已接受/已拒绝/已过期
           ↓
       被驳回 → 修改 → 草稿

关键字段：

#3.2.5 订单表（nb_crm_orders）

含收款跟踪的订单管理。

关键字段：

#3.3 数据表汇总

#CRM 业务表

#基础数据表（公共模块）

#3.4 辅助表

#3.4.1 评论表（nb_crm_comments）

通用评论/备注表，可关联到多种业务对象。

#3.4.2 客户共享表（nb_crm_customer_shares）

实现客户的多人协作和权限共享。

#3.4.3 商机协作者表（nb_crm_opportunity_users）

支持商机的销售团队协作。

#3.4.4 地区表（nb_cbo_regions）

国家/地区基础数据字典。

#4. 线索生命周期

线索管理采用简化的 4 阶段工作流，新线索创建时可通过工作流自动触发 AI 评分，辅助销售快速识别高质量线索。

#4.1 状态定义

#4.2 状态流程图

#4.3 线索转化流程

转化界面同时提供三个选项，用户可选择创建或关联：

• 客户：创建新客户 或 关联现有客户
• 联系人：创建新联系人（关联到客户）
• 商机：必须创建商机

转化后记录：

• converted_customer_id：关联的客户 ID
• converted_contact_id：关联的联系人 ID
• converted_opportunity_id：创建的商机 ID

#5. 商机生命周期

商机管理采用可配置的销售管线阶段。商机阶段变更时可自动触发 AI 赢率预测，帮助销售识别风险和机会。

#5.1 可配置阶段

阶段存储在 nb_crm_opportunity_stages 表中，可以自定义：

#5.2 管线流程

#5.3 停滞检测

无活动的商机将被标记：

-- 计算停滞天数
UPDATE nb_crm_opportunities
SET stagnant_days = EXTRACT(DAY FROM NOW() - last_activity_at)
WHERE stage NOT IN ('won', 'lost');

#5.4 赢/丢单处理

赢单时：

1. 更新阶段为 'won'
2. 记录实际成交日期
3. 更新客户状态为 'active'
4. 触发订单创建（如果报价被接受）

丢单时：

1. 更新阶段为 'lost'
2. 记录丢单原因
3. 记录竞争对手 ID（如果输给竞争对手）
4. 通知经理

#6. 报价生命周期

#6.1 状态定义

#6.2 审批规则（待完善）

审批流程基于以下条件触发：

#6.3 多币种支持

#设计理念

使用 美元作为统一基础货币 用于所有报表和分析。每条金额记录存储：

• 原始货币和金额（客户看到的）
• 交易时的汇率
• 美元等值金额（用于内部比较）

#货币字典表（nb_cbo_currencies）

货币配置采用公共基础数据表，支持动态管理。current_rate 字段存储当前汇率，由定时任务从 nb_crm_exchange_rates 最近日期的记录同步更新。

#汇率历史表（nb_crm_exchange_rates）

记录历史汇率数据，定时任务会将最新汇率同步到 nb_cbo_currencies.current_rate。

说明：报价单通过 currency_id 外键关联到 nb_cbo_currencies 表，汇率直接从 current_rate 字段获取。商机和订单使用 currency VARCHAR 字段存储货币代码。

#金额字段模式

含金额的表遵循此模式：

应用于：

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

#工作流集成

汇率获取逻辑：

1. 业务操作时直接从 nb_cbo_currencies.current_rate 获取汇率
2. 美元交易：汇率 = 1.0，无需查找
3. current_rate 由定时任务从 nb_crm_exchange_rates 最新记录同步

#6.4 版本管理

当报价被拒绝或过期时，可以复制为新版本：

QT-20260119-001 v1 → 已拒绝
QT-20260119-001 v2 → 已发送
QT-20260119-001 v3 → 已接受

#7. 订单生命周期

#7.1 订单概述

订单在报价被接受时创建，代表已确认的业务承诺。

#7.2 订单状态定义

#7.3 订单数据模型

#nb_crm_orders

#nb_crm_order_items

#7.4 收款跟踪

#nb_crm_payments

#8. 客户生命周期

#8.1 客户概述

客户在线索转化或商机赢单时创建。系统跟踪从获客到拥护者的完整生命周期。

#8.2 客户状态定义

#8.3 客户健康度评分

基于多个因素计算客户健康度：

健康度阈值：

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 客户分群

#自动分群

#9. 邮件集成

#9.1 概述

NocoBase 提供内置邮件集成插件，支持 Gmail 和 Outlook。邮件同步到系统后，可通过工作流自动触发 AI 分析邮件情感和意图，辅助销售快速了解客户态度。

#9.2 邮件同步

支持的邮箱：

• Gmail（通过 OAuth 2.0）
• Outlook/Microsoft 365（通过 OAuth 2.0）

同步行为：

• 发送和接收邮件双向同步
• 自动关联邮件到 CRM 记录（线索、联系人、商机）
• 附件存储在 NocoBase 文件系统

#9.3 邮件-CRM 关联 (待完善)

#9.4 邮件模板

销售可以使用预设模板：

#10. AI 辅助能力

#10.1 AI 员工团队

CRM 系统集成 NocoBase AI 插件，复用以下内置 AI 员工，并针对 CRM 场景配置专属任务：

#10.2 AI 任务列表

AI 能力分为两类，相互独立：

#一、AI 员工（前端区块触发）

通过前端 AI 员工区块，用户直接与 AI 对话交互，获取分析与建议。

#二、工作流 LLM 节点（后端自动执行）

嵌套在工作流中的 LLM 节点，通过数据表事件、操作事件、定时任务等方式自动触发，与 AI 员工无关。

说明：工作流 LLM 节点使用提示词和 Schema 输出结构化 JSON，解析后写入业务数据字段，无需用户介入。

#10.3 数据库中的 AI 字段

#11. 工作流引擎

#11.1 已实现工作流

#11.2 待实现工作流

#12. 菜单与界面设计

#12.1 后台管理结构

#12.2 仪表盘视图

#销售经理视图

#销售代表视图

#高管视图

文档版本: v2.0 | 更新日期: 2026-02-06