# 物料分类统一使用 mdm_item_category - 前端联调方案

## 变更说明

物料分类已从 MES 模块迁移到 MDM 模块统一管理：
- 原 MES 分类表 `mes_md_item_type` 保留但不再维护
- 统一使用 MDM 分类表 `mdm_item_category`
- MES 模块通过兼容层读取 MDM 分类数据

## 涉及页面

- MDM 物料分类管理页面（主要维护入口）
- MDM 物料管理页面（新增/编辑物料选择分类）
- MES 物料管理页面（新增/编辑物料选择分类）

## 业务流程与数据带入

1. 物料分类统一使用 `mdm_item_category` 表，MDM 和 MES 模块共用同一套分类数据
2. 分类新增 `itemOrProduct` 字段兼容 MES 的 ITEM/PRODUCT 标识
3. 物料类型字段 `itemType` 用于快速选择：1原料、2半成品、3成品、4辅料

## 字段映射

| MDM 字段 (mdm_item_category) | MES 字段 (mes_md_item_type) | 说明 |
|------------------------------|----------------------------|------|
| id | id | 分类编号 |
| code | code | 分类编码 |
| name | name | 分类名称 |
| parentId | parentId | 父分类编号 |
| itemType (Integer) | itemOrProduct (String) | 类型标识 |
| sort | sort | 排序 |
| status | status | 状态 |
| remark | remark | 备注 |

### itemType 与 itemOrProduct 映射关系

| itemType | 说明 | itemOrProduct |
|----------|------|---------------|
| 1 | 物料 | ITEM |
| 2 | 产品 | PRODUCT |
| 3 | 半成品 | ITEM |
| NULL | 全部 | - |

## API

### MDM 分类管理（主要接口）

| 方法 | 路径 | 说明 |
|------|------|------|
| POST | /admin-api/mdm/category/create | 创建物料分类 |
| PUT | /admin-api/mdm/category/update | 更新物料分类 |
| DELETE | /admin-api/mdm/category/delete | 删除物料分类 |
| GET | /admin-api/mdm/category/get | 获取单个分类 |
| GET | /admin-api/mdm/category/list | 获取分类列表 |
| GET | /admin-api/mdm/category/list-all-simple | 获取启用的分类列表（下拉框） |

**请求参数（MdmItemCategorySaveReqVO）：**

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| id | Long | 否 | 分类编号（更新时必填） |
| parentId | Long | 否 | 父分类编号 |
| code | String | 是 | 分类编码 |
| name | String | 是 | 分类名称 |
| itemType | Integer | 否 | 适用物料类型：1物料、2产品、3半成品、NULL全部 |
| itemOrProduct | String | 否 | 物料/产品标识：ITEM、PRODUCT（兼容MES） |
| sort | Integer | 否 | 排序 |
| status | Integer | 是 | 状态：0启用、1禁用 |
| remark | String | 否 | 备注 |

**响应示例：**

```json
{
  "code": 0,
  "data": {
    "id": 1,
    "parentId": 0,
    "code": "RAW001",
    "name": "原料",
    "itemType": 1,
    "itemOrProduct": "ITEM",
    "sort": 0,
    "status": 0
  }
}
```

### MES 分类接口（兼容保留）

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | /admin-api/mes/md/item-type/list | 获取物料分类列表 |
| GET | /admin-api/mes/md/item-type/simple-list | 获取精简列表（下拉框） |

> 注意：MES 分类接口底层已改为读取 MDM 分类数据，建议前端统一使用 MDM 分类接口。

## 字段展示规则

| 字段 | 展示位置 | 说明 |
|------|----------|------|
| categoryId / itemTypeId | 新增/编辑表单 | 物料分类下拉框，数据来源：mdm_item_category |
| itemType | 新增/编辑表单 | 物料类型快捷选择：1原料、2半成品、3成品、4辅料 |
| itemOrProduct | 分类表单 | 物料/产品标识，用于 MES 兼容 |

## 业务规则说明

| 场景 | 规则 |
|------|------|
| 分类管理 | 统一在 MDM 模块管理，MES 模块只读 |
| 分类删除 | 有子分类或有物料引用时不可删除 |
| 物料同步 | MDM 物料同步到 MES 时，分类 ID 保持一致 |
| 兼容性 | MES 分类服务优先从 MDM 获取，本地表作为回退 |

## 注意事项

1. **菜单变更**：MES 的"物料产品分类"菜单已禁用，统一使用 MDM 的"物料分类"菜单
2. **数据一致性**：两表数据已同步，后续维护只需操作 MDM 分类
3. **API 兼容**：MES 分类接口保留，底层读取 MDM 数据，前端可继续使用
4. **字段转换**：前端展示时，`itemOrProduct` 值需转换为中文（ITEM=物料，PRODUCT=产品）