物料分类统一使用 mdm_item_category - 前端联调方案
变更说明
物料分类已从 MES 模块迁移到 MDM 模块统一管理：
- 原 MES 分类表 mes_md_item_type 保留但不再维护
- 统一使用 MDM 分类表 mdm_item_category
- MES 模块通过兼容层读取 MDM 分类数据
涉及页面
- MDM 物料分类管理页面（主要维护入口）
- MDM 物料管理页面（新增/编辑物料选择分类）
- MES 物料管理页面（新增/编辑物料选择分类）
业务流程与数据带入
- 物料分类统一使用
mdm_item_category 表，MDM 和 MES 模块共用同一套分类数据
- 分类新增
itemOrProduct 字段兼容 MES 的 ITEM/PRODUCT 标识
- 物料类型字段
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 |
否 |
备注 |
响应示例：
{
"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 获取，本地表作为回退 |
注意事项
- 菜单变更：MES 的"物料产品分类"菜单已禁用，统一使用 MDM 的"物料分类"菜单
- 数据一致性：两表数据已同步，后续维护只需操作 MDM 分类
- API 兼容：MES 分类接口保留，底层读取 MDM 数据，前端可继续使用
- 字段转换：前端展示时，
itemOrProduct 值需转换为中文（ITEM=物料，PRODUCT=产品）
