CRM 与 ERP 销售一体化改造计划

一、现状分析

1.1 当前问题

问题	说明
客户数据独立	CRM 客户 (`crm_customer`) 和 ERP 客户 (`erp_customer`) 是两张完全独立的表，无法共享
产品数据独立	CRM 产品 (`crm_product`) 和 ERP 产品 (`erp_product`) 独立维护
合同与订单脱节	CRM 合同审批通过后无法自动生成 ERP 销售订单
回款数据独立	CRM 回款 (`crm_receivable`) 和 ERP 收款单 (`erp_finance_receipt`) 无关联
销售流程断裂	线索 → 客户 → 商机 → 合同 → 订单 → 出库 → 收款，流程在合同和订单之间断裂

1.2 改造目标

根据需求描述，改造目标为：

统一客户管理 - CRM 客户作为统一客户主数据，ERP 使用 CRM 客户
统一产品管理 - ERP 产品作为产品主数据，CRM 使用 ERP 产品
销售流程打通 - 合同审批通过后可生成销售订单，实现全流程追溯
销售数据联动 - 销售订单状态实时同步，支持销售决策分析
营销数据报表 - 整合 CRM 和 ERP 数据，提供完整的销售分析报表

二、分批改造计划

Phase 1: 客户数据统一（预计 2 天）

目标: 统一客户主数据，ERP 销售模块使用 CRM 客户

改造内容:

序号	改造项	说明
1.1	创建 CRM 客户 API 模块	暴露客户查询接口供 ERP 调用
1.2	ERP 销售订单关联 CRM 客户	`erp_sale_order.customer_id` 改为关联 `crm_customer.id`
1.3	ERP 销售出库关联 CRM 客户	`erp_sale_out.customer_id` 改为关联 `crm_customer.id`
1.4	ERP 销售退货关联 CRM 客户	`erp_sale_return.customer_id` 改为关联 `crm_customer.id`
1.5	ERP 收款单关联 CRM 客户	`erp_finance_receipt.customer_id` 改为关联 `crm_customer.id`
1.6	废弃 ERP 客户表	标记废弃，保留数据迁移接口

涉及文件:
- 新增: yudao-module-crm-api/ 模块
- 修改: ErpSaleOrderDO.java, ErpSaleOutDO.java, ErpSaleReturnDO.java
- 修改: ErpSaleOrderServiceImpl.java, ErpSaleOutServiceImpl.java, ErpSaleReturnServiceImpl.java

Phase 2: 产品数据统一（预计 1 天）

目标: 统一产品主数据，CRM 使用 ERP 产品

改造内容:

序号	改造项	说明
2.1	创建 ERP 产品 API 模块	暴露产品查询接口供 CRM 调用
2.2	CRM 商机产品关联 ERP 产品	`crm_business_product.product_id` 改为关联 `erp_product.id`
2.3	CRM 合同产品关联 ERP 产品	`crm_contract_product.product_id` 改为关联 `erp_product.id`
2.4	废弃 CRM 产品表	标记废弃，保留数据迁移接口

涉及文件:
- 新增: yudao-module-erp-api/ 模块（如果不存在）
- 修改: CrmBusinessProductDO.java, CrmContractProductDO.java
- 修改: CRM 商机/合同 Service 层

Phase 3: 合同生成销售订单（预计 2 天）

目标: CRM 合同审批通过后可生成 ERP 销售订单

改造内容:

序号	改造项	说明
3.1	ERP 销售订单增加关联合同字段	新增 `contract_id`, `contract_no` 字段
3.2	CRM 合同增加订单关联字段	新增 `order_id`, `order_no` 字段
3.3	合同生成订单接口	合同审批通过后，调用 ERP 服务生成销售订单
3.4	合同状态监听器	监听合同审批通过事件，自动/手动触发订单生成

涉及文件:
- 修改: ErpSaleOrderDO.java, CrmContractDO.java
- 新增: CrmContractToOrderService.java
- 修改: CrmContractStatusListener.java

Phase 4: 销售全流程追溯（预计 1 天）

目标: 实现从线索到收款的完整销售流程追溯

改造内容:

序号	改造项	说明
4.1	商机关联销售订单	`crm_business` 增加订单关联，支持商机直接下单
4.2	销售订单状态回写	出库/退货/收款状态实时回写到订单和关联合同
4.3	全流程查询接口	提供按客户/商机/合同查询完整销售链路的接口

涉及文件:
- 修改: CrmBusinessDO.java
- 新增: CrmSaleTraceService.java

Phase 5: 营销数据报表（预计 2 天）

目标: 整合 CRM 和 ERP 数据，提供销售决策报表

改造内容:

序号	改造项	说明
5.1	销售漏斗分析增强	整合 ERP 订单数据，展示从商机到订单的转化率
5.2	客户销售分析	按客户统计：商机金额、合同金额、订单金额、出库金额、收款金额
5.3	销售业绩分析	整合 CRM 商机/合同和 ERP 订单/收款，计算销售业绩
5.4	销售趋势分析	按时间维度分析销售趋势
5.5	销售排行榜	综合排名：商机、合同、订单、收款

涉及文件:
- 修改: CRM 统计相关 Service
- 新增: CrmErpSalesStatisticsService.java

Phase 6: 数据迁移与清理（预计 1 天）

目标: 将现有数据迁移到统一结构

改造内容:

序号	改造项	说明
6.1	ERP 客户迁移到 CRM	数据迁移 SQL 脚本
6.2	CRM 产品迁移到 ERP	数据迁移 SQL 脚本
6.3	数据校验脚本	验证迁移后数据完整性

三、改造优先级建议

优先级	Phase	说明
P0	Phase 1	客户统一是基础，必须最先完成
P0	Phase 2	产品统一是基础，必须最先完成
P1	Phase 3	合同生成订单是核心业务流程
P1	Phase 4	全流程追溯是合规要求
P2	Phase 5	报表分析可后续完善
P2	Phase 6	数据迁移可在系统稳定后进行

四、技术方案要点

4.1 跨模块调用方案

使用模块间 API 调用：
- CRM 提供 CrmCustomerApi 供 ERP 调用
- ERP 提供 ErpProductApi、ErpSaleOrderApi 供 CRM 调用

4.2 数据一致性方案

使用 Spring Event 进行模块间事件通知
关键操作使用事务保证一致性
增加数据同步状态字段，支持异常恢复

4.3 权限控制方案

CRM 客户沿用现有的团队权限机制
ERP 模块通过 API 查询客户时，需校验数据权限

五、风险与注意事项

风险	应对措施
现有数据迁移复杂	提供迁移脚本和回滚脚本，分批迁移
跨模块调用性能	使用缓存减少 API 调用，批量查询优化
权限控制复杂	统一权限校验逻辑，复用 CRM 权限服务
业务流程变更	充分测试，提供用户培训文档

六、交付物

每个 Phase 完成后交付：
1. SQL 脚本 - 表结构变更、数据迁移
2. 前端文档 - 接口变更、页面修改说明
3. 测试用例 - 功能测试、回归测试