MDM 产品数据一体化改造 - 前端文档

概述

本次改造将 MDM 物料作为统一产品主数据，CRM 和 ERP 模块的产品数据统一使用 MDM 物料（itemType=2 产品类型）。

一、改造清单

后端改造（已完成）

二、涉及页面

ERP 产品管理

CRM 产品管理

MDM 物料管理

三、数据模型映射

MDM 物料类型

字段映射（MDM -> ERP）

字段映射（MDM -> CRM）

四、API 接口

MDM 物料 API

ERP 产品 API（保持不变）

CRM 产品 API（保持不变）

五、前端修改点

5.1 产品选择组件（可选优化）

如果需要统一产品选择体验，可以创建 MDM 物料选择组件：

<!-- MdmItemSelect.vue -->
<template>
  <el-select v-model="selectedValue" placeholder="请选择产品" filterable>
    <el-option
      v-for="item in itemList"
      :key="item.id"
      :label="item.name"
      :value="item.id"
    >
      <span>{{ item.name }}</span>
      <span style="color: #999; margin-left: 8px;">{{ item.barCode }}</span>
    </el-option>
  </el-select>
</template>

<script>
import { getItemList } from '@/api/mdm/item'

export default {
  props: {
    value: [Number, String],
    itemType: {
      type: Number,
      default: 2 // 默认产品类型
    }
  },
  data() {
    return {
      itemList: []
    }
  },
  computed: {
    selectedValue: {
      get() {
        return this.value
      },
      set(val) {
        this.$emit('input', val)
      }
    }
  },
  created() {
    this.loadItemList()
  },
  methods: {
    async loadItemList() {
      const { data } = await getItemList({ itemType: this.itemType, status: 0 })
      this.itemList = data
    }
  }
}
</script>

5.2 使用方式

<!-- ERP 销售订单中选择产品 -->
<MdmItemSelect v-model="form.productId" :item-type="2" />

<!-- 采购订单中选择物料 -->
<MdmItemSelect v-model="form.itemId" :item-type="1" />

六、注意事项

6.1 数据迁移

如果已有 ERP 或 CRM 产品数据，需要迁移到 MDM 物料表：

-- 迁移 ERP 产品到 MDM 物料（示例）
INSERT INTO mdm_item (id, code, name, bar_code, specification, category_id, unit_measure_id,
    item_type, status, purchase_price, sales_price, cost_price, expiry_day, weight, remark,
    creator, create_time, updater, update_time, deleted, tenant_id)
SELECT
    id,
    bar_code AS code,
    name,
    bar_code,
    standard AS specification,
    category_id,
    unit_id AS unit_measure_id,
    2 AS item_type, -- 产品类型
    status,
    purchase_price,
    sale_price AS sales_price,
    min_price AS cost_price,
    expiry_day,
    weight,
    remark,
    creator,
    create_time,
    updater,
    update_time,
    deleted,
    tenant_id
FROM erp_product
WHERE deleted = 0;

-- 迁移 CRM 产品到 MDM 物料（需要处理 ID 冲突）
-- 注意：如果 ID 与 ERP 产品冲突，需要重新分配 ID 并更新关联数据

6.2 接口兼容性

• ERP 和 CRM 的产品接口保持不变，前端无需修改
• 数据实际从 MDM 获取，对前端透明
• 创建/更新操作通过 MDM API 执行

6.3 权限管理

• CRM 产品保留本地记录用于权限管理
• 产品 ID 与 MDM 物料 ID 保持一致
• 权限验证仍然通过 CRM 权限系统

6.4 废弃说明

• erp_product 表：保留但不再作为主数据源
• crm_product 表：保留用于权限管理，数据同步自 MDM
• 建议后续版本在前端菜单中统一使用 MDM 物料管理

七、后续计划