# 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 | 否 | 备注 |

**响应：**

```json
{
  "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`

```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`（物料）
3. **品牌数据**：由 WMS 模块维护，不需要单独的 MDM 品牌页面
4. **ID 映射**：部分数据 ID 有偏移，注意查询关联数据
5. **权限配置**：需要为新页面配置菜单和权限