CRM 与 ERP 销售一体化改造 - 前端文档

概述

本次改造将 CRM 客户作为统一客户主数据，ERP 销售模块（销售订单、销售出库、销售退货、收款单）统一使用 CRM 客户。

一、改造清单

后端改造（已完成）

文件	改动说明
`yudao-module-crm-api/`	新增 CRM 客户 API 模块
`CrmCustomerApi.java`	新增客户 API 接口
`CrmCustomerRespDTO.java`	新增客户 DTO
`CrmCustomerApiImpl.java`	实现 CRM 客户 API
`ErpSaleOrderServiceImpl.java`	使用 CRM 客户 API
`ErpFinanceReceiptServiceImpl.java`	使用 CRM 客户 API
`ErpSaleOrderController.java`	使用 CRM 客户 API
`ErpSaleOrderDO.java`	更新注释关联 CRM 客户
`ErpSaleOutDO.java`	更新注释关联 CRM 客户
`ErpSaleReturnDO.java`	更新注释关联 CRM 客户
`ErpFinanceReceiptDO.java`	更新注释关联 CRM 客户

后端改造（待完成）

文件	改动说明
`ErpSaleOutController.java`	使用 CRM 客户 API
`ErpSaleReturnController.java`	使用 CRM 客户 API
`ErpFinanceReceiptController.java`	使用 CRM 客户 API

二、涉及页面

ERP 销售模块

页面	路径	改动说明
销售订单列表	`/erp/sale/order/index`	客户选择改为 CRM 客户选择组件
销售订单表单	`/erp/sale/order/form`	客户选择改为 CRM 客户选择组件
销售出库列表	`/erp/sale/out/index`	客户选择改为 CRM 客户选择组件
销售出库表单	`/erp/sale/out/form`	客户选择改为 CRM 客户选择组件
销售退货列表	`/erp/sale/return/index`	客户选择改为 CRM 客户选择组件
销售退货表单	`/erp/sale/return/form`	客户选择改为 CRM 客户选择组件
收款单列表	`/erp/finance/receipt/index`	客户选择改为 CRM 客户选择组件
收款单表单	`/erp/finance/receipt/form`	客户选择改为 CRM 客户选择组件

三、客户选择组件

3.1 使用 CRM 客户选择组件

ERP 销售模块的客户选择统一使用 CRM 客户选择组件。

<!-- 原来：ERP 客户选择 -->
<el-select v-model="form.customerId" placeholder="请选择客户">
  <el-option
    v-for="item in customerList"
    :key="item.id"
    :label="item.name"
    :value="item.id"
  />
</el-select>

<!-- 改为：CRM 客户选择组件 -->
<CrmCustomerSelect v-model="form.customerId" />

3.2 CRM 客户 API

方法	路径	说明
GET	/crm/customer/simple-list	获取客户精简列表（用于下拉选择）
GET	/crm/customer/list-by-ids	批量获取客户信息

客户精简列表响应：

{
  "code": 0,
  "data": [
    {
      "id": 1,
      "name": "客户A",
      "mobile": "13800138000",
      "telephone": "0571-12345678",
      "ownerUserName": "张三"
    }
  ]
}

四、废弃的 ERP 客户管理

4.1 ERP 客户管理页面废弃

以下页面标记为废弃，建议在菜单中隐藏或删除：

/erp/customer/index - ERP 客户列表
/erp/customer/form - ERP 客户表单

五、SQL 执行

见 docs/crm_erp_integration_sql.sql

六、改造完成状态

Phase	内容	状态
Phase 1	客户数据统一 - ERP 使用 CRM 客户	已完成
Phase 2	产品数据统一 - CRM/ERP 使用 MDM 物料	已完成
Phase 3	合同生成销售订单	已完成
Phase 4	销售全流程追溯	已完成
Phase 5	营销数据报表	已完成
Phase 6	数据迁移与清理	已完成

七、产出文档清单

文档	说明
`docs/crm_erp_integration_frontend.md`	CRM 客户一体化前端文档
`docs/crm_erp_integration_sql.sql`	SQL 变更脚本
`docs/mdm_product_integration_frontend.md`	MDM 产品一体化前端文档
`docs/contract_generate_order_frontend.md`	合同生成订单前端文档
`docs/sales_traceability_frontend.md`	销售追溯前端文档
`docs/marketing_report_frontend.md`	营销报表前端文档