编辑 | blame | 历史 | 原始文档

MDM 主数据模块改造 - 前端变更文档（第一阶段）

概述

本次改造将 ERP、MES、WMS 三个模块的物料/产品数据统一到 MDM（主数据管理）模块。

改造范围：基础数据（单位）

注意：
- 物料类型（itemType）为枚举字段（1:物料, 2:产品, 3:半成品），不需要单独维护页面
- 品牌数据由 WMS 维护，不需要单独的 MDM 品牌页面

一、MDM 计量单位页面

涉及页面

  • 新增页面：/mdm/unit - MDM 计量单位管理

API 变更

方法 路径 说明
POST /mdm/unit/create 创建单位
PUT /mdm/unit/update 更新单位
DELETE /mdm/unit/delete 删除单位
GET /mdm/unit/get 获取单位
GET /mdm/unit/page 获取单位分页
GET /mdm/unit/list-by-ids 获取单位列表

请求参数（创建/更新）：

参数 类型 必填 说明
id Long 否 单位编号（更新时必填）
code String 是 单位编码
name String 是 单位名称
primaryFlag Boolean 否 是否主单位
primaryId Long 否 主单位编号
changeRate BigDecimal 否 与主单位换算比例
status Integer 是 状态（0:启用, 1:禁用）
remark String 否 备注

响应：

{
  "code": 0,
  "data": {
    "id": 1,
    "code": "PCS",
    "name": "个",
    "primaryFlag": true,
    "primaryId": null,
    "changeRate": 1,
    "status": 0,
    "remark": "",
    "createTime": "2024-01-01 12:00:00"
  },
  "msg": "操作成功"
}

二、ERP 产品管理页面修改

涉及页面

  • /erp/product - ERP 产品管理（保留，数据源变更）

前端修改点

物料类型固定为 itemType = 2（产品），前端无需维护该字段。

三、MES 物料管理页面修改

涉及页面

  • /mes/md/item - MES 物料管理（保留，数据源变更）

前端修改点

物料类型固定为 itemType = 1（物料），前端无需维护该字段。

四、WMS 商品管理页面修改

涉及页面

  • /wms/item - WMS 商品管理（保留，数据源变更）

前端修改点

物料类型固定为 itemType = 1（物料），前端无需维护该字段。

五、新增前端 API 文件

文件路径：src/api/mdm/unit.js

import request from '@/utils/request'

// 创建计量单位
export function createUnit(data) {
  return request({
    url: '/mdm/unit/create',
    method: 'post',
    data: data
  })
}

// 更新计量单位
export function updateUnit(data) {
  return request({
    url: '/mdm/unit/update',
    method: 'put',
    data: data
  })
}

// 删除计量单位
export function deleteUnit(id) {
  return request({
    url: '/mdm/unit/delete?id=' + id,
    method: 'delete'
  })
}

// 获取计量单位
export function getUnit(id) {
  return request({
    url: '/mdm/unit/get?id=' + id,
    method: 'get'
  })
}

// 获取计量单位分页
export function getUnitPage(params) {
  return request({
    url: '/mdm/unit/page',
    method: 'get',
    params: params
  })
}

// 获取计量单位列表
export function getUnitListByIds(ids) {
  return request({
    url: '/mdm/unit/list-by-ids?ids=' + ids,
    method: 'get'
  })
}

六、注意事项

  1. 数据兼容：迁移期间，原模块页面保留，但数据源变更为 MDM
  2. 物料类型字段：itemType 为枚举字段，不需要单独维护页面
  • ERP 产品：itemType = 2（产品）
  • MES 物料：itemType = 1（物料）
  • WMS 商品：itemType = 1（物料）
  1. 品牌数据：由 WMS 模块维护，不需要单独的 MDM 品牌页面
  2. ID 映射：部分数据 ID 有偏移，注意查询关联数据
  3. 权限配置：需要为新页面配置菜单和权限