【基础】物料产品、分类、计量单位

物料产品模块，由 yudao-module-mes 后端模块的 md 包实现，主要有物料产品管理、物料产品分类、计量单位等功能。

• 物料产品：MES 系统最核心的基础数据，几乎所有业务模块（生产、仓库、质检）都依赖于此。
• 物料产品分类：以树形结构组织物料和产品的分类体系，区分「物料」与「产品」两种类型，为物料产品提供归类管理。
• 计量单位：定义物料产品的度量基准，支持主单位与辅助单位的换算关系配置。

1. 物料产品分类

物料产品分类，由 MesMdItemTypeController 提供接口。

1.1 表结构

省略 creator/create_time/updater/update_time/deleted/tenant_id 等通用字段

CREATE TABLE `mes_md_item_type` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '分类编号',
  `code` varchar(64) NOT NULL COMMENT '分类编码',
  `name` varchar(255) NOT NULL COMMENT '分类名称',
  `sort` int NOT NULL DEFAULT '0' COMMENT '显示排序',
  `remark` varchar(500) DEFAULT '' COMMENT '备注',

  `parent_id` bigint NOT NULL DEFAULT '0' COMMENT '父分类编号',

  `item_or_product` varchar(20) NOT NULL COMMENT '物料/产品标识',

  `status` tinyint NOT NULL DEFAULT '0' COMMENT '状态',

  PRIMARY KEY (`id`)
) ENGINE=InnoDB COMMENT='MES 物料产品分类表';

① parent_id 为父分类编号，顶级分类为 0，支持无限层级树形结构。

② item_or_product 为物料/产品标识，对应 MesMdItemTypeEnum 枚举，区分该分类下挂的是物料（ITEM）还是产品（PRODUCT）。

系统建议将从供应商采购且本厂不生产的物资指定为「物料」，将任何可以生产的物资指定为「产品」（实际生产中，同一个对象既可能是物料也可能是半成品/产品）。

③ status 为分类状态，对应 CommonStatusEnum 枚举。

1.2 管理后台

对应 [MES 系统 -> 基础数据 -> 物料产品分类] 菜单，对应 yudao-ui-admin-vue3 项目的 @/views/mes/md/item/type 目录。

系统采用树形结构组织整个工厂中使用到的物料和产品分类信息，用户可根据工厂实际情况自行指定父子级关系。

列表

页面以树形表格展示所有物料产品分类，支持按分类名称和状态搜索，可展开/折叠整棵分类树。每行操作栏提供「新增子分类」「编辑」「删除」按钮（顶级分类不可删除）。

新增

点击【新增】按钮，弹出分类新增表单。需要选择上级分类、填写分类编码（支持自动生成）和名称，并指定当前分类是「物料」还是「产品」。在父级分类行点击「新增子分类」按钮时，上级分类会自动填充为当前行。

2. 计量单位

计量单位，由 MesMdUnitMeasureController 提供接口。

2.1 表结构

省略 creator/create_time/updater/update_time/deleted/tenant_id 等通用字段

CREATE TABLE `mes_md_unit_measure` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '单位编号',
  `code` varchar(64) NOT NULL COMMENT '单位编码',
  `name` varchar(255) NOT NULL COMMENT '单位名称',
  `remark` varchar(500) DEFAULT '' COMMENT '备注',

  `primary_flag` bit(1) NOT NULL DEFAULT b'1' COMMENT '是否主单位',

  `primary_id` bigint DEFAULT NULL COMMENT '主单位编号',

  `change_rate` decimal(12,4) DEFAULT NULL COMMENT '与主单位换算比例',

  `status` tinyint NOT NULL DEFAULT '0' COMMENT '状态',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB COMMENT='MES 计量单位表';

① primary_flag 标识是否为主单位。计量单位分为主单位和非主单位两种，主单位可被其它辅助单位引用作为换算基准。

② primary_id 为主单位编号，当 primary_flag = false（非主单位）时，需要选择对应的主单位（关联 mes_md_unit_measure 表的 id 字段），并指定与主单位的换算关系。

change_rate 为与主单位的换算比例，精度 4 位小数。例如主单位为「千克」，辅助单位「克」的换算比例为 0.0010。

③ status 为单位状态，对应 CommonStatusEnum 枚举。

2.2 管理后台

对应 [MES 系统 -> 基础数据 -> 计量单位] 菜单，对应 yudao-ui-admin-vue3 项目的 @/views/mes/md/unitmeasure 目录。

列表

页面展示所有计量单位，支持按单位编码、名称和状态搜索，并提供导出功能。列表清晰展示每个单位的编码、名称、是否主单位、与主单位换算比例等信息。

新增

点击【新增】按钮，弹出单位新增表单。主要填写单位编码和名称。如果选择「非主单位」，则需要选择对应的主单位，并指定与主单位的换算关系。

3. 物料产品

物料产品，由 MesMdItemController 提供接口。

3.1 表结构

省略 creator/create_time/updater/update_time/deleted/tenant_id 等通用字段

CREATE TABLE `mes_md_item` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '物料编号',
  `code` varchar(64) NOT NULL COMMENT '物料编码',
  `name` varchar(255) NOT NULL COMMENT '物料名称',
  `specification` varchar(500) DEFAULT NULL COMMENT '规格型号',
  `remark` varchar(500) DEFAULT '' COMMENT '备注',

  `unit_measure_id` bigint NOT NULL DEFAULT '0' COMMENT '计量单位编号',

  `item_type_id` bigint NOT NULL DEFAULT '0' COMMENT '物料分类编号',

  `status` tinyint NOT NULL DEFAULT '0' COMMENT '状态',

  `safe_stock_flag` bit(1) NOT NULL DEFAULT b'0' COMMENT '是否启用安全库存',
  `min_stock` decimal(12,4) NOT NULL DEFAULT '0.0000' COMMENT '最低库存量',
  `max_stock` decimal(12,4) NOT NULL DEFAULT '0.0000' COMMENT '最高库存量',

  `high_value` bit(1) NOT NULL DEFAULT b'0' COMMENT '是否高值物料',

  `batch_flag` bit(1) NOT NULL DEFAULT b'1' COMMENT '是否启用批次管理',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB COMMENT='MES 物料产品表';

① item_type_id 为物料分类编号，关联 mes_md_item_type 表的 id 字段。通过分类的 item_or_product 字段区分当前记录是物料还是产品。

② unit_measure_id 为计量单位编号，关联 mes_md_unit_measure 表的 id 字段。

③ safe_stock_flag 为安全库存开关。启用后 min_stock（最低库存量）、max_stock（最高库存量）生效，用于库存预警；关闭时自动清零。

④ batch_flag 为批次管理开关。启用批次管理后，物料在启用（status 切换为开启）前需完成批次属性配置（见下方 ★ 批次属性配置）；批次属性保存时，系统会校验至少勾选一个属性。

⑤ high_value 为高值物料标记，仅作为信息标识，无特别的业务逻辑。

⑥ status 为物料状态，对应 CommonStatusEnum 枚举。注意：启用产品类（PRODUCT）物料时，会校验是否已配置 BOM。

该表包含四个子表，在管理后台的修改弹窗中以 Tab 页形式维护：

• mes_md_product_bom（产品 BOM）：产品级物料清单，定义生产该产品需要消耗的物料/半成品。
• mes_md_item_batch_config（批次属性配置）：配置该物料在批次管理中需要记录哪些属性。
• mes_md_product_sip（SIP 检验规程）：挂载该物料的 SIP 检验标准文件。
• mes_md_product_sop（SOP 操作规程）：配置该产品在某道工序中的标准操作规程。
• 替代品（预留 Tab，暂未开放）：用于维护物料的替代关系，当前仅 UI 预留，功能尚未实现。

3.2 管理后台

对应 [MES 系统 -> 基础数据 -> 物料产品管理] 菜单，对应 yudao-ui-admin-vue3 项目的 @/views/mes/md/item 目录。

列表

页面左侧为分类树，点击分类可过滤右侧物料列表。

新增

点击【新增】按钮，弹出物料新增表单。

修改

点击【编辑】按钮，弹出物料修改表单，底部包含以下 Tab 页：

★ 产品 BOM（物料详情 Tab）：产品类物料的 BOM（Bill of Materials）组成清单，由 mes_md_product_bom 表存储。启用产品类物料前需先配置 BOM。点击「新增」按钮，可在弹出的物料产品清单中选择当前产品生产时需要消耗的物料/半成品。例如：产成品「螺丝刀」的 BOM 应配置为「螺丝刀刀头」和「螺丝刀刀柄」；「螺丝刀刀头」的 BOM 应配置为「螺纹钢」；「螺丝刀刀柄」的 BOM 应配置为「PVC 颗粒」。按照此逻辑可一直追溯到原材料级别。由 MesMdProductBomController 提供接口。 mes_md_product_bom 表结构 省略 creator/create_time/updater/update_time/deleted/tenant_id 等通用字段

CREATE TABLE `mes_md_product_bom` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT 'BOM 编号',
  `item_id` bigint NOT NULL COMMENT '物料产品 ID（父产品）',
  `bom_item_id` bigint NOT NULL COMMENT 'BOM 物料 ID（子物料）',
  `quantity` decimal(12,4) NOT NULL DEFAULT '0.0000' COMMENT '物料使用比例',
  `status` tinyint NOT NULL DEFAULT '0' COMMENT '是否启用',
  `remark` varchar(500) DEFAULT NULL COMMENT '备注',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB COMMENT='MES 产品BOM表（物料清单）';

① item_id 为父产品编号，关联 mes_md_item 表的 id 字段，表示这个 BOM 属于哪个产品。

② bom_item_id 为子物料编号，同样关联 mes_md_item 表的 id 字段，表示生产该产品所需的原材料。

③ quantity 为物料使用比例，即生产一个父产品需要多少数量的子物料。

★ 批次属性配置（物料详情 Tab）：由 mes_md_item_batch_config 表存储，配置该物料在批次管理中需要记录哪些属性（生产日期、有效期、供应商、客户等）。由 MesMdItemBatchConfigController 提供接口。 mes_md_item_batch_config 表结构 省略 creator/create_time/updater/update_time/deleted/tenant_id 等通用字段

CREATE TABLE `mes_md_item_batch_config` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '编号',

  `item_id` bigint NOT NULL COMMENT '物料编号',

  `produce_date_flag` bit(1) NOT NULL DEFAULT b'0' COMMENT '批次属性-生产日期',
  `expire_date_flag` bit(1) NOT NULL DEFAULT b'0' COMMENT '批次属性-有效期',
  `receipt_date_flag` bit(1) NOT NULL DEFAULT b'0' COMMENT '批次属性-入库日期',
  `vendor_flag` bit(1) NOT NULL DEFAULT b'0' COMMENT '批次属性-供应商',
  `client_flag` bit(1) NOT NULL DEFAULT b'0' COMMENT '批次属性-客户',
  `sales_order_code_flag` bit(1) NOT NULL DEFAULT b'0' COMMENT '批次属性-销售订单编号',
  `purchase_order_code_flag` bit(1) NOT NULL DEFAULT b'0' COMMENT '批次属性-采购订单编号',
  `work_order_flag` bit(1) NOT NULL DEFAULT b'0' COMMENT '批次属性-生产工单',
  `task_flag` bit(1) NOT NULL DEFAULT b'0' COMMENT '批次属性-生产任务',
  `workstation_flag` bit(1) NOT NULL DEFAULT b'0' COMMENT '批次属性-工作站',
  `tool_flag` bit(1) NOT NULL DEFAULT b'0' COMMENT '批次属性-工具',
  `mold_flag` bit(1) NOT NULL DEFAULT b'0' COMMENT '批次属性-模具',
  `lot_number_flag` bit(1) NOT NULL DEFAULT b'0' COMMENT '批次属性-生产批号',
  `quality_status_flag` bit(1) NOT NULL DEFAULT b'0' COMMENT '批次属性-质量状态',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_item_id` (`item_id`)
) ENGINE=InnoDB COMMENT='MES 物料批次属性配置表';

① item_id 关联 mes_md_item 表的 id 字段，一对一关系。每个 *_flag 字段控制该物料在仓库批次流转时是否需要记录对应属性。

② 各 *_flag 字段为布尔开关，按需勾选。勾选后，该属性将纳入批次管理的记录范围。例如勾选 vendor_flag，表示该物料的批次需要记录供应商信息；勾选 expire_date_flag，表示需要记录有效期。具体的下游消费逻辑（如生产工单中 clientFlag=true 时客户必填）由各业务模块自行实现。

★ SIP 检验规程（物料详情 Tab）：由 mes_md_product_sip 表存储，挂载该物料的 SIP 检验标准文件。由 MesMdProductSipController 提供接口。 mes_md_product_sip 表结构 省略 creator/create_time/updater/update_time/deleted/tenant_id 等通用字段

CREATE TABLE `mes_md_product_sip` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT 'SIP 编号',
  `title` varchar(255) DEFAULT NULL COMMENT '标题',
  `description` varchar(500) DEFAULT NULL COMMENT '详细描述',
  `url` varchar(255) DEFAULT NULL COMMENT '图片地址',
  `sort` int DEFAULT NULL COMMENT '排列顺序',

  `item_id` bigint NOT NULL COMMENT '物料产品 ID',
  `process_id` bigint DEFAULT NULL COMMENT '工序 ID',
  `remark` varchar(500) DEFAULT NULL COMMENT '备注',

  PRIMARY KEY (`id`)
) ENGINE=InnoDB COMMENT='MES 产品标准检验程序表（SIP）';

① item_id 关联 mes_md_item 表的 id 字段，表示该 SIP 属于哪个物料产品。

② process_id 关联工序表，指定该检验规程对应的生产工序。

③ url 为检验规程的图片地址，支持上传检验标准截图等图片资料。

★ SOP 操作规程（物料详情 Tab）：由 mes_md_product_sop 表存储，用于维护当前产品在指定工序上的 SOP（Standard Operating Procedure，标准操作规程）资料。用户可将 SOP 信息扫描为图片上传，绑定到对应工序。由 MesMdProductSopController 提供接口。 mes_md_product_sop 表结构 省略 creator/create_time/updater/update_time/deleted/tenant_id 等通用字段

CREATE TABLE `mes_md_product_sop` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT 'SOP 编号',
  `title` varchar(255) DEFAULT NULL COMMENT '标题',
  `description` varchar(500) DEFAULT NULL COMMENT '详细描述',
  `url` varchar(255) DEFAULT NULL COMMENT '图片地址',
  `sort` int DEFAULT NULL COMMENT '排列顺序',
  `remark` varchar(500) DEFAULT NULL COMMENT '备注',

  `item_id` bigint NOT NULL COMMENT '物料产品 ID',

  `process_id` bigint DEFAULT NULL COMMENT '工序 ID',

  PRIMARY KEY (`id`)
) ENGINE=InnoDB COMMENT='MES 产品标准作业程序表（SOP）';

① item_id 关联 mes_md_item 表的 id 字段，表示该 SOP 属于哪个物料产品。

② process_id 关联工序表，指定该操作规程对应的生产工序，详见 《【生产】工序设置、工艺流程》。