From 6bb27899c1f1ae0454bbf41c5ebbf6c1f34d1a5d Mon Sep 17 00:00:00 2001
From: YunaiV <zhijiantianya@gmail.com>
Date: Sun, 15 Feb 2026 14:03:59 +0800
Subject: [PATCH] =?UTF-8?q?feat(mes):=20=E6=96=B0=E5=A2=9E=E7=89=A9?=
 =?UTF-8?q?=E6=96=99=E4=BA=A7=E5=93=81=E5=88=86=E7=B1=BB=E4=B8=8E=E7=89=A9?=
 =?UTF-8?q?=E6=96=99=E4=BA=A7=E5=93=81=E7=AE=A1=E7=90=86?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

迁移 ktg-mes 的 md_item_type 和 md_item 两张表到 yudao-module-mes，
包含完整的 CRUD、树形分类、物料分页查询、enrichment 等功能。

后端新增 17 个文件（1337 行）：
- DO: MesMdItemTypeDO（树形分类）、MesMdItemDO（物料产品）
- VO: 分类 3 个（List/Save/Resp）、物料 3 个（Page/Save/Resp）
- Mapper: 2 个（BaseMapperX，纯 Java，无 XML）
- Service: 4 个（接口 + 实现）
- Controller: 2 个（/mes/md/item-type、/mes/md/item）
- ErrorCodeConstants 追加 9 个错误码

关键业务逻辑：
- 分类：父分类递归环路检测、同级名称/编码唯一性、删除保护（子分类+物料）
- 物料：编码/名称全局唯一、分类存在校验、安全库存联动清零
- enrichment：物料 RespVO 通过 Service 关联填充 itemTypeName、itemOrProduct
- 循环依赖：MesMdItemTypeServiceImpl 用 @Lazy 注入 MesMdItemService

plan: plans/swirling-stirring-metcalfe.md
---
 src/api/mes/md/item/index.ts                  |  58 +++++
 src/api/mes/md/item/type/index.ts             |  51 ++++
 src/views/mes/md/item/MdItemForm.vue          | 219 +++++++++++++++++
 src/views/mes/md/item/index.vue               | 231 ++++++++++++++++++
 src/views/mes/md/item/type/MdItemTypeForm.vue | 167 +++++++++++++
 src/views/mes/md/item/type/index.vue          | 214 ++++++++++++++++
 6 files changed, 940 insertions(+)
 create mode 100644 src/api/mes/md/item/index.ts
 create mode 100644 src/api/mes/md/item/type/index.ts
 create mode 100644 src/views/mes/md/item/MdItemForm.vue
 create mode 100644 src/views/mes/md/item/index.vue
 create mode 100644 src/views/mes/md/item/type/MdItemTypeForm.vue
 create mode 100644 src/views/mes/md/item/type/index.vue

diff --git a/src/api/mes/md/item/index.ts b/src/api/mes/md/item/index.ts
new file mode 100644
index 000000000..b64bd75b3
--- /dev/null
+++ b/src/api/mes/md/item/index.ts
@@ -0,0 +1,58 @@
+import request from '@/config/axios'
+
+// MES 物料产品 VO
+export interface MdItemVO {
+  id: number // 物料编号
+  code: string // 物料编码
+  name: string // 物料名称
+  specification: string // 规格型号
+  unitOfMeasure: string // 单位编码
+  itemTypeId: number // 物料分类编号
+  itemTypeName?: string // 物料分类名称
+  itemOrProduct?: string // 物料/产品标识
+  status: number // 状态
+  safeStockFlag: boolean // 是否启用安全库存
+  minStock: number // 最低库存量
+  maxStock: number // 最高库存量
+  highValue: boolean // 是否高值物料
+  batchFlag: boolean // 是否启用批次管理
+  remark: string // 备注
+}
+
+// MES 物料产品 API
+export const MdItemApi = {
+  // 查询物料产品分页
+  getItemPage: async (params: any) => {
+    return await request.get({ url: `/mes/md/item/page`, params })
+  },
+
+  // 查询物料产品精简列表
+  getItemSimpleList: async () => {
+    return await request.get({ url: `/mes/md/item/simple-list` })
+  },
+
+  // 查询物料产品详情
+  getItem: async (id: number) => {
+    return await request.get({ url: `/mes/md/item/get?id=` + id })
+  },
+
+  // 新增物料产品
+  createItem: async (data: MdItemVO) => {
+    return await request.post({ url: `/mes/md/item/create`, data })
+  },
+
+  // 修改物料产品
+  updateItem: async (data: MdItemVO) => {
+    return await request.put({ url: `/mes/md/item/update`, data })
+  },
+
+  // 删除物料产品
+  deleteItem: async (id: number) => {
+    return await request.delete({ url: `/mes/md/item/delete?id=` + id })
+  },
+
+  // 导出物料产品 Excel
+  exportItem: async (params: any) => {
+    return await request.download({ url: `/mes/md/item/export-excel`, params })
+  }
+}
diff --git a/src/api/mes/md/item/type/index.ts b/src/api/mes/md/item/type/index.ts
new file mode 100644
index 000000000..3833b9995
--- /dev/null
+++ b/src/api/mes/md/item/type/index.ts
@@ -0,0 +1,51 @@
+import request from '@/config/axios'
+
+// MES 物料产品分类 VO
+export interface MdItemTypeVO {
+  id: number // 分类编号
+  parentId: number // 父分类编号
+  code: string // 分类编码
+  name: string // 分类名称
+  itemOrProduct: string // 物料/产品标识
+  sort: number // 显示排序
+  status: number // 状态
+  remark: string // 备注
+}
+
+// MES 物料产品分类 API
+export const MdItemTypeApi = {
+  // 查询物料产品分类列表
+  getItemTypeList: async (params?: any) => {
+    return await request.get({ url: `/mes/md/item-type/list`, params })
+  },
+
+  // 查询物料产品分类精简列表
+  getItemTypeSimpleList: async () => {
+    return await request.get({ url: `/mes/md/item-type/simple-list` })
+  },
+
+  // 查询物料产品分类详情
+  getItemType: async (id: number) => {
+    return await request.get({ url: `/mes/md/item-type/get?id=` + id })
+  },
+
+  // 新增物料产品分类
+  createItemType: async (data: MdItemTypeVO) => {
+    return await request.post({ url: `/mes/md/item-type/create`, data })
+  },
+
+  // 修改物料产品分类
+  updateItemType: async (data: MdItemTypeVO) => {
+    return await request.put({ url: `/mes/md/item-type/update`, data })
+  },
+
+  // 删除物料产品分类
+  deleteItemType: async (id: number) => {
+    return await request.delete({ url: `/mes/md/item-type/delete?id=` + id })
+  },
+
+  // 导出物料产品分类 Excel
+  exportItemType: async (params: any) => {
+    return await request.download({ url: `/mes/md/item-type/export-excel`, params })
+  }
+}
diff --git a/src/views/mes/md/item/MdItemForm.vue b/src/views/mes/md/item/MdItemForm.vue
new file mode 100644
index 000000000..6dded1f0d
--- /dev/null
+++ b/src/views/mes/md/item/MdItemForm.vue
@@ -0,0 +1,219 @@
+<!-- MES 物料产品的新增/修改 -->
+<template>
+  <Dialog :title="dialogTitle" v-model="dialogVisible">
+    <el-form
+      ref="formRef"
+      :model="formData"
+      :rules="formRules"
+      label-width="120px"
+      v-loading="formLoading"
+    >
+      <!-- TODO @AI：一行 3 个？ -->
+      <el-row :gutter="20">
+        <el-col :span="12">
+          <!-- TODO @AI：有个生成按钮，类似 /Users/yunai/Java/yudao-all-in-one/yudao-ui-admin-vue3/src/views/iot/product/product/ProductForm.vue -->
+          <!-- TODO @芋艿：先做个假的，ai；把交互做通；后续会有个后端接口 -->
+          <el-form-item label="物料编码" prop="code">
+            <el-input v-model="formData.code" placeholder="请输入物料编码" />
+          </el-form-item>
+        </el-col>
+        <el-col :span="12">
+          <el-form-item label="物料名称" prop="name">
+            <el-input v-model="formData.name" placeholder="请输入物料名称" />
+          </el-form-item>
+        </el-col>
+        <el-col :span="12">
+          <el-form-item label="规格型号" prop="specification">
+            <el-input v-model="formData.specification" placeholder="请输入规格型号" />
+          </el-form-item>
+        </el-col>
+        <el-col :span="12">
+          <el-form-item label="单位" prop="unitOfMeasure">
+            <el-input v-model="formData.unitOfMeasure" placeholder="请输入单位编码" />
+          </el-form-item>
+        </el-col>
+        <el-col :span="12">
+          <el-form-item label="物料分类" prop="itemTypeId">
+            <el-tree-select
+              v-model="formData.itemTypeId"
+              :data="itemTypeList"
+              :props="defaultProps"
+              check-strictly
+              default-expand-all
+              placeholder="请选择物料分类"
+              class="w-1/1"
+            />
+          </el-form-item>
+        </el-col>
+        <el-col :span="12">
+          <el-form-item label="状态" prop="status">
+            <el-radio-group v-model="formData.status">
+              <el-radio
+                v-for="dict in getIntDictOptions(DICT_TYPE.COMMON_STATUS)"
+                :key="dict.value"
+                :value="dict.value"
+              >
+                {{ dict.label }}
+              </el-radio>
+            </el-radio-group>
+          </el-form-item>
+        </el-col>
+        <el-col :span="12">
+          <el-form-item label="高值物料" prop="highValue">
+            <el-switch v-model="formData.highValue" />
+          </el-form-item>
+        </el-col>
+        <el-col :span="12">
+          <el-form-item label="批次管理" prop="batchFlag">
+            <el-switch v-model="formData.batchFlag" />
+          </el-form-item>
+        </el-col>
+        <el-col :span="12">
+          <el-form-item label="安全库存" prop="safeStockFlag">
+            <el-switch v-model="formData.safeStockFlag" />
+          </el-form-item>
+        </el-col>
+        <el-col :span="12" v-if="formData.safeStockFlag">
+          <el-form-item label="最低库存量" prop="minStock">
+            <el-input-number
+              v-model="formData.minStock"
+              placeholder="请输入最低库存量"
+              :min="0"
+              :precision="4"
+              class="!w-1/1"
+            />
+          </el-form-item>
+        </el-col>
+        <el-col :span="12" v-if="formData.safeStockFlag">
+          <el-form-item label="最高库存量" prop="maxStock">
+            <el-input-number
+              v-model="formData.maxStock"
+              placeholder="请输入最高库存量"
+              :min="0"
+              :precision="4"
+              class="!w-1/1"
+            />
+          </el-form-item>
+        </el-col>
+        <el-col :span="24">
+          <el-form-item label="备注" prop="remark">
+            <el-input type="textarea" v-model="formData.remark" placeholder="请输入备注" />
+          </el-form-item>
+        </el-col>
+      </el-row>
+    </el-form>
+    <!-- TODO @AI：底部的 tab 有 BOM组成、批次属性、替代品、SIP、SOP；做法类似：/Users/yunai/Java/yudao-all-in-one/yudao-ui-admin-vue3/src/views/member/user/detail 有很多 tab；只有修改时，才展示 -->
+    <!-- TODO @AI：是不是要有个组件，BarcodeImg 二维码查看； -->
+    <template #footer>
+      <el-button @click="submitForm" type="primary" :disabled="formLoading">确 定</el-button>
+      <el-button @click="dialogVisible = false">取 消</el-button>
+    </template>
+  </Dialog>
+</template>
+<script setup lang="ts">
+import { getIntDictOptions, DICT_TYPE } from '@/utils/dict'
+import { MdItemApi, MdItemVO } from '@/api/mes/md/item'
+import { MdItemTypeApi, MdItemTypeVO } from '@/api/mes/md/item/type'
+import { CommonStatusEnum } from '@/utils/constants'
+import { defaultProps, handleTree } from '@/utils/tree'
+
+/** MES 物料产品 表单 */
+defineOptions({ name: 'MdItemForm' })
+
+const { t } = useI18n() // 国际化
+const message = useMessage() // 消息弹窗
+
+const dialogVisible = ref(false) // 弹窗的是否展示
+const dialogTitle = ref('') // 弹窗的标题
+const formLoading = ref(false) // 表单的加载中：1）修改时的数据加载；2）提交的按钮禁用
+const formType = ref('') // 表单的类型：create - 新增；update - 修改
+const formData = ref({
+  id: undefined,
+  code: undefined,
+  name: undefined,
+  specification: undefined,
+  unitOfMeasure: undefined, // TODO @芋艿：等等关联的组件搞完，我们补充下！另外，这个字段貌似改成 unitMeasureId 更好？
+  itemTypeId: undefined,
+  status: CommonStatusEnum.ENABLE,
+  safeStockFlag: false,
+  minStock: 0,
+  maxStock: 0,
+  highValue: false,
+  batchFlag: true,
+  remark: undefined
+})
+const formRules = reactive({
+  code: [{ required: true, message: '物料编码不能为空', trigger: 'blur' }],
+  name: [{ required: true, message: '物料名称不能为空', trigger: 'blur' }],
+  unitOfMeasure: [{ required: true, message: '单位编码不能为空', trigger: 'blur' }],
+  itemTypeId: [{ required: true, message: '物料分类不能为空', trigger: 'blur' }],
+  status: [{ required: true, message: '状态不能为空', trigger: 'blur' }]
+})
+const formRef = ref() // 表单 Ref
+const itemTypeList = ref<MdItemTypeVO[]>([]) // 物料分类列表
+
+/** 打开弹窗 */
+const open = async (type: string, id?: number) => {
+  dialogVisible.value = true
+  dialogTitle.value = t('action.' + type)
+  formType.value = type
+  resetForm()
+  // 修改时，设置数据
+  if (id) {
+    formLoading.value = true
+    try {
+      formData.value = await MdItemApi.getItem(id)
+    } finally {
+      formLoading.value = false
+    }
+  }
+  // 物料分类
+  const categoryData = await MdItemTypeApi.getItemTypeSimpleList()
+  itemTypeList.value = handleTree(categoryData, 'id', 'parentId')
+}
+defineExpose({ open }) // 提供 open 方法，用于打开弹窗
+
+/** 提交表单 */
+const emit = defineEmits(['success']) // 定义 success 事件，用于操作成功后的回调
+const submitForm = async () => {
+  // 校验表单
+  await formRef.value.validate()
+  // 提交请求
+  formLoading.value = true
+  try {
+    const data = formData.value as unknown as MdItemVO
+    if (formType.value === 'create') {
+      await MdItemApi.createItem(data)
+      message.success(t('common.createSuccess'))
+    } else {
+      await MdItemApi.updateItem(data)
+      message.success(t('common.updateSuccess'))
+    }
+    dialogVisible.value = false
+    // 发送操作成功的事件
+    emit('success')
+  } finally {
+    formLoading.value = false
+  }
+}
+
+/** 重置表单 */
+const resetForm = () => {
+  formData.value = {
+    id: undefined,
+    code: undefined,
+    name: undefined,
+    specification: undefined,
+    unitOfMeasure: undefined,
+    itemTypeId: undefined,
+    status: CommonStatusEnum.ENABLE,
+    safeStockFlag: false,
+    minStock: 0,
+    maxStock: 0,
+    highValue: false,
+    batchFlag: true,
+    remark: undefined
+  }
+  formRef.value?.resetFields()
+}
+</script>
diff --git a/src/views/mes/md/item/index.vue b/src/views/mes/md/item/index.vue
new file mode 100644
index 000000000..75a4026eb
--- /dev/null
+++ b/src/views/mes/md/item/index.vue
@@ -0,0 +1,231 @@
+<template>
+  <ContentWrap>
+    <!-- 搜索工作栏 -->
+    <el-form
+      class="-mb-15px"
+      :model="queryParams"
+      ref="queryFormRef"
+      :inline="true"
+      label-width="68px"
+    >
+      <el-form-item label="物料编码" prop="code">
+        <el-input
+          v-model="queryParams.code"
+          placeholder="请输入物料编码"
+          clearable
+          @keyup.enter="handleQuery"
+          class="!w-240px"
+        />
+      </el-form-item>
+      <el-form-item label="物料名称" prop="name">
+        <el-input
+          v-model="queryParams.name"
+          placeholder="请输入物料名称"
+          clearable
+          @keyup.enter="handleQuery"
+          class="!w-240px"
+        />
+      </el-form-item>
+      <!-- TODO @AI：需要类似 /Users/yunai/Java/yudao-all-in-one/yudao-ui-admin-vue3/src/views/system/user，放在左侧； -->
+      <!-- TODO @AI：检索的时候，选择父分类时，子分类也要检索出来； -->
+      <el-form-item label="物料分类" prop="itemTypeId">
+        <el-tree-select
+          v-model="queryParams.itemTypeId"
+          :data="itemTypeList"
+          :props="defaultProps"
+          check-strictly
+          default-expand-all
+          placeholder="请选择物料分类"
+          clearable
+          class="!w-240px"
+        />
+      </el-form-item>
+      <el-form-item label="状态" prop="status">
+        <el-select v-model="queryParams.status" placeholder="请选择状态" clearable class="!w-240px">
+          <el-option
+            v-for="dict in getIntDictOptions(DICT_TYPE.COMMON_STATUS)"
+            :key="dict.value"
+            :label="dict.label"
+            :value="dict.value"
+          />
+        </el-select>
+      </el-form-item>
+      <el-form-item>
+        <el-button @click="handleQuery"><Icon icon="ep:search" class="mr-5px" /> 搜索</el-button>
+        <el-button @click="resetQuery"><Icon icon="ep:refresh" class="mr-5px" /> 重置</el-button>
+        <el-button
+          type="primary"
+          plain
+          @click="openForm('create')"
+          v-hasPermi="['mes:md-item:create']"
+        >
+          <Icon icon="ep:plus" class="mr-5px" /> 新增
+        </el-button>
+        <el-button
+          type="success"
+          plain
+          @click="handleExport"
+          :loading="exportLoading"
+          v-hasPermi="['mes:md-item:export']"
+        >
+          <Icon icon="ep:download" class="mr-5px" /> 导出
+        </el-button>
+      </el-form-item>
+    </el-form>
+  </ContentWrap>
+
+  <!-- 列表 -->
+  <ContentWrap>
+    <el-table v-loading="loading" :data="list" :stripe="true" :show-overflow-tooltip="true">
+      <el-table-column label="物料编码" align="center" prop="code" />
+      <el-table-column label="物料名称" align="center" prop="name" />
+      <el-table-column label="规格型号" align="center" prop="specification" />
+      <!-- TODO @AI：放到 constants 里 -->
+      <el-table-column label="单位" align="center" prop="unitOfMeasure" />
+      <el-table-column label="物料分类" align="center" prop="itemTypeName" />
+      <el-table-column label="物料/产品" align="center" prop="itemOrProduct" />
+      <el-table-column label="状态" align="center" prop="status">
+        <template #default="scope">
+          <dict-tag :type="DICT_TYPE.COMMON_STATUS" :value="scope.row.status" />
+        </template>
+      </el-table-column>
+      <!-- TODO @AI：设置安全库存 -->
+      <el-table-column
+        label="创建时间"
+        align="center"
+        prop="createTime"
+        :formatter="dateFormatter"
+        width="180px"
+      />
+      <el-table-column label="操作" align="center" width="110">
+        <!-- TODO @芋艿：【标签打印】 -->
+        <template #default="scope">
+          <el-button
+            link
+            type="primary"
+            @click="openForm('update', scope.row.id)"
+            v-hasPermi="['mes:md-item:update']"
+          >
+            编辑
+          </el-button>
+          <el-button
+            link
+            type="danger"
+            @click="handleDelete(scope.row.id)"
+            v-hasPermi="['mes:md-item:delete']"
+          >
+            删除
+          </el-button>
+        </template>
+      </el-table-column>
+    </el-table>
+    <!-- 分页 -->
+    <Pagination
+      :total="total"
+      v-model:page="queryParams.pageNo"
+      v-model:limit="queryParams.pageSize"
+      @pagination="getList"
+    />
+  </ContentWrap>
+
+  <!-- 表单弹窗：添加/修改 -->
+  <MdItemForm ref="formRef" @success="getList" />
+</template>
+
+<script setup lang="ts">
+import { getIntDictOptions, DICT_TYPE } from '@/utils/dict'
+import { dateFormatter } from '@/utils/formatTime'
+import { handleTree } from '@/utils/tree'
+import { defaultProps } from '@/utils/tree'
+import download from '@/utils/download'
+import { MdItemApi, MdItemVO } from '@/api/mes/md/item'
+import { MdItemTypeApi, MdItemTypeVO } from '@/api/mes/md/item/type'
+import MdItemForm from './MdItemForm.vue'
+
+/** MES 物料产品 列表 */
+defineOptions({ name: 'MesMdItem' })
+
+const message = useMessage() // 消息弹窗
+const { t } = useI18n() // 国际化
+
+const loading = ref(true) // 列表的加载中
+const list = ref<MdItemVO[]>([]) // 列表的数据
+const total = ref(0) // 列表的总页数
+const queryParams = reactive({
+  pageNo: 1,
+  pageSize: 10,
+  code: undefined,
+  name: undefined,
+  itemTypeId: undefined,
+  status: undefined
+})
+const queryFormRef = ref() // 搜索的表单
+const exportLoading = ref(false) // 导出的加载中
+const itemTypeList = ref<MdItemTypeVO[]>([]) // 物料分类列表
+
+/** 查询列表 */
+const getList = async () => {
+  loading.value = true
+  try {
+    const data = await MdItemApi.getItemPage(queryParams)
+    list.value = data.list
+    total.value = data.total
+  } finally {
+    loading.value = false
+  }
+}
+
+/** 搜索按钮操作 */
+const handleQuery = () => {
+  queryParams.pageNo = 1
+  getList()
+}
+
+/** 重置按钮操作 */
+const resetQuery = () => {
+  queryFormRef.value.resetFields()
+  handleQuery()
+}
+
+/** 添加/修改操作 */
+const formRef = ref()
+const openForm = (type: string, id?: number) => {
+  formRef.value.open(type, id)
+}
+
+/** 删除按钮操作 */
+const handleDelete = async (id: number) => {
+  try {
+    // 删除的二次确认
+    await message.delConfirm()
+    // 发起删除
+    await MdItemApi.deleteItem(id)
+    message.success(t('common.delSuccess'))
+    // 刷新列表
+    await getList()
+  } catch {}
+}
+
+/** 导出按钮操作 */
+const handleExport = async () => {
+  try {
+    // 导出的二次确认
+    await message.exportConfirm()
+    // 发起导出
+    exportLoading.value = true
+    const data = await MdItemApi.exportItem(queryParams)
+    download.excel(data, '物料产品.xls')
+  } catch {
+  } finally {
+    exportLoading.value = false
+  }
+}
+
+/** 初始化 **/
+onMounted(async () => {
+  await getList()
+  // 物料分类
+  const categoryData = await MdItemTypeApi.getItemTypeSimpleList()
+  itemTypeList.value = handleTree(categoryData)
+})
+</script>
diff --git a/src/views/mes/md/item/type/MdItemTypeForm.vue b/src/views/mes/md/item/type/MdItemTypeForm.vue
new file mode 100644
index 000000000..0b84ed6f5
--- /dev/null
+++ b/src/views/mes/md/item/type/MdItemTypeForm.vue
@@ -0,0 +1,167 @@
+<!-- MES 物料产品分类表单 -->
+<template>
+  <Dialog :title="dialogTitle" v-model="dialogVisible">
+    <el-form
+      ref="formRef"
+      :model="formData"
+      :rules="formRules"
+      label-width="120px"
+      v-loading="formLoading"
+    >
+      <el-form-item label="上级分类" prop="parentId">
+        <el-tree-select
+          v-model="formData.parentId"
+          :data="itemTypeTree"
+          :props="defaultProps"
+          check-strictly
+          default-expand-all
+          placeholder="请选择上级分类"
+          class="w-1/1"
+        />
+      </el-form-item>
+      <el-form-item label="分类编码" prop="code">
+        <el-input v-model="formData.code" placeholder="请输入分类编码" />
+      </el-form-item>
+      <el-form-item label="分类名称" prop="name">
+        <el-input v-model="formData.name" placeholder="请输入分类名称" />
+      </el-form-item>
+      <el-form-item label="物料/产品标识" prop="itemOrProduct">
+        <!-- TODO @AI：搞个 mes/constants，类似 ts；然后这个字段要翻译掉；另外，MdItemTypeForm 里的相关，也要通过这个方式复用； -->
+        <el-radio-group v-model="formData.itemOrProduct">
+          <el-radio value="ITEM">物料</el-radio>
+          <el-radio value="PRODUCT">产品</el-radio>
+        </el-radio-group>
+      </el-form-item>
+      <el-form-item label="显示排序" prop="sort">
+        <el-input-number v-model="formData.sort" :min="0" :precision="0" class="!w-1/1" />
+      </el-form-item>
+      <el-form-item label="状态" prop="status">
+        <el-radio-group v-model="formData.status">
+          <el-radio
+            v-for="dict in getIntDictOptions(DICT_TYPE.COMMON_STATUS)"
+            :key="dict.value"
+            :value="dict.value"
+          >
+            {{ dict.label }}
+          </el-radio>
+        </el-radio-group>
+      </el-form-item>
+      <el-form-item label="备注" prop="remark">
+        <el-input type="textarea" v-model="formData.remark" placeholder="请输入备注" />
+      </el-form-item>
+    </el-form>
+    <template #footer>
+      <el-button @click="submitForm" type="primary" :disabled="formLoading">确 定</el-button>
+      <el-button @click="dialogVisible = false">取 消</el-button>
+    </template>
+  </Dialog>
+</template>
+<script setup lang="ts">
+import { getIntDictOptions, DICT_TYPE } from '@/utils/dict'
+import { MdItemTypeApi, MdItemTypeVO } from '@/api/mes/md/item/type'
+import { defaultProps, handleTree } from '@/utils/tree'
+import { CommonStatusEnum } from '@/utils/constants'
+
+defineOptions({ name: 'MdItemTypeForm' })
+
+const { t } = useI18n() // 国际化
+const message = useMessage() // 消息弹窗
+
+const dialogVisible = ref(false) // 弹窗的是否展示
+const dialogTitle = ref('') // 弹窗的标题
+const formLoading = ref(false) // 表单的加载中：1）修改时的数据加载；2）提交的按钮禁用
+const formType = ref('') // 表单的类型：create - 新增；update - 修改
+const formData = ref({
+  id: undefined,
+  parentId: undefined,
+  code: undefined,
+  name: undefined,
+  itemOrProduct: 'ITEM',
+  sort: 0,
+  status: CommonStatusEnum.ENABLE,
+  remark: undefined
+})
+const formRules = reactive({
+  parentId: [{ required: true, message: '上级分类不能为空', trigger: 'blur' }],
+  code: [{ required: true, message: '分类编码不能为空', trigger: 'blur' }],
+  name: [{ required: true, message: '分类名称不能为空', trigger: 'blur' }],
+  itemOrProduct: [{ required: true, message: '物料/产品标识不能为空', trigger: 'blur' }],
+  sort: [{ required: true, message: '显示排序不能为空', trigger: 'blur' }],
+  status: [{ required: true, message: '状态不能为空', trigger: 'blur' }]
+})
+const formRef = ref() // 表单 Ref
+const itemTypeTree = ref() // 树形结构
+
+/** 打开弹窗 */
+const open = async (type: string, id?: number, parentId?: number) => {
+  dialogVisible.value = true
+  dialogTitle.value = t('action.' + type)
+  formType.value = type
+  resetForm()
+  // 修改时，设置数据
+  if (id) {
+    formLoading.value = true
+    try {
+      formData.value = await MdItemTypeApi.getItemType(id)
+    } finally {
+      formLoading.value = false
+    }
+  }
+  // 新增子分类时，设置父分类
+  if (parentId) {
+    // TODO @AI：TS2322: Type number is not assignable to type undefined 报错；
+    formData.value.parentId = parentId
+  }
+  await getItemTypeTree()
+}
+defineExpose({ open }) // 提供 open 方法，用于打开弹窗
+
+/** 提交表单 */
+const emit = defineEmits(['success']) // 定义 success 事件，用于操作成功后的回调
+const submitForm = async () => {
+  // 校验表单
+  await formRef.value.validate()
+  // 提交请求
+  formLoading.value = true
+  try {
+    const data = formData.value as unknown as MdItemTypeVO
+    if (formType.value === 'create') {
+      await MdItemTypeApi.createItemType(data)
+      message.success(t('common.createSuccess'))
+    } else {
+      await MdItemTypeApi.updateItemType(data)
+      message.success(t('common.updateSuccess'))
+    }
+    dialogVisible.value = false
+    // 发送操作成功的事件
+    emit('success')
+  } finally {
+    formLoading.value = false
+  }
+}
+
+/** 重置表单 */
+const resetForm = () => {
+  formData.value = {
+    id: undefined,
+    parentId: undefined,
+    code: undefined,
+    name: undefined,
+    // TODO @AI：使用 constants 里的枚举。
+    itemOrProduct: 'ITEM',
+    sort: 0,
+    status: CommonStatusEnum.ENABLE,
+    remark: undefined
+  }
+  formRef.value?.resetFields()
+}
+
+/** 获得物料产品分类树 */
+const getItemTypeTree = async () => {
+  itemTypeTree.value = []
+  const data = await MdItemTypeApi.getItemTypeList()
+  const root: Tree = { id: 0, name: '顶级分类', children: [] }
+  root.children = handleTree(data)
+  itemTypeTree.value.push(root)
+}
+</script>
diff --git a/src/views/mes/md/item/type/index.vue b/src/views/mes/md/item/type/index.vue
new file mode 100644
index 000000000..cd686161a
--- /dev/null
+++ b/src/views/mes/md/item/type/index.vue
@@ -0,0 +1,214 @@
+<!-- MES 物料产品分类列表 -->
+<template>
+  <ContentWrap>
+    <!-- 搜索工作栏 -->
+    <el-form
+      class="-mb-15px"
+      :model="queryParams"
+      ref="queryFormRef"
+      :inline="true"
+      label-width="68px"
+    >
+      <el-form-item label="分类名称" prop="name">
+        <el-input
+          v-model="queryParams.name"
+          placeholder="请输入分类名称"
+          clearable
+          @keyup.enter="handleQuery"
+          class="!w-240px"
+        />
+      </el-form-item>
+      <el-form-item label="状态" prop="status">
+        <el-select v-model="queryParams.status" placeholder="请选择状态" clearable class="!w-240px">
+          <el-option
+            v-for="dict in getIntDictOptions(DICT_TYPE.COMMON_STATUS)"
+            :key="dict.value"
+            :label="dict.label"
+            :value="dict.value"
+          />
+        </el-select>
+      </el-form-item>
+      <el-form-item>
+        <el-button @click="handleQuery"><Icon icon="ep:search" class="mr-5px" /> 搜索</el-button>
+        <el-button @click="resetQuery"><Icon icon="ep:refresh" class="mr-5px" /> 重置</el-button>
+        <el-button
+          type="primary"
+          plain
+          @click="openForm('create')"
+          v-hasPermi="['mes:md-item-type:create']"
+        >
+          <Icon icon="ep:plus" class="mr-5px" /> 新增
+        </el-button>
+        <!-- TODO @AI：不需要导出 -->
+        <el-button
+          type="success"
+          plain
+          @click="handleExport"
+          :loading="exportLoading"
+          v-hasPermi="['mes:md-item-type:export']"
+        >
+          <Icon icon="ep:download" class="mr-5px" /> 导出
+        </el-button>
+        <el-button type="danger" plain @click="toggleExpandAll">
+          <Icon icon="ep:sort" class="mr-5px" /> 展开/折叠
+        </el-button>
+      </el-form-item>
+    </el-form>
+  </ContentWrap>
+
+  <!-- 列表 -->
+  <ContentWrap>
+    <el-table
+      v-loading="loading"
+      :data="list"
+      :stripe="true"
+      :show-overflow-tooltip="true"
+      row-key="id"
+      :default-expand-all="isExpandAll"
+      v-if="refreshTable"
+    >
+      <el-table-column label="分类名称" align="left" prop="name" />
+      <el-table-column label="分类编码" align="center" prop="code" />
+      <!-- TODO @AI：搞个 mes/constants，类似 ts；然后这个字段要翻译掉；另外，MdItemTypeForm 里的相关，也要通过这个方式复用； -->
+      <el-table-column label="物料/产品" align="center" prop="itemOrProduct" />
+      <el-table-column label="排序" align="center" prop="sort" />
+      <el-table-column label="状态" align="center" prop="status">
+        <template #default="scope">
+          <dict-tag :type="DICT_TYPE.COMMON_STATUS" :value="scope.row.status" />
+        </template>
+      </el-table-column>
+      <el-table-column
+        label="创建时间"
+        align="center"
+        prop="createTime"
+        :formatter="dateFormatter"
+        width="180px"
+      />
+      <el-table-column label="操作" align="center" width="200">
+        <template #default="scope">
+          <el-button
+            link
+            type="primary"
+            @click="openForm('create', undefined, scope.row.id)"
+            v-hasPermi="['mes:md-item-type:create']"
+          >
+            新增子分类
+          </el-button>
+          <el-button
+            link
+            type="primary"
+            @click="openForm('update', scope.row.id)"
+            v-hasPermi="['mes:md-item-type:update']"
+          >
+            编辑
+          </el-button>
+          <el-button
+            link
+            type="danger"
+            @click="handleDelete(scope.row.id)"
+            v-hasPermi="['mes:md-item-type:delete']"
+          >
+            删除
+          </el-button>
+        </template>
+      </el-table-column>
+    </el-table>
+  </ContentWrap>
+
+  <!-- 表单弹窗：添加/修改 -->
+  <MdItemTypeForm ref="formRef" @success="getList" />
+</template>
+
+<script setup lang="ts">
+import { getIntDictOptions, DICT_TYPE } from '@/utils/dict'
+import { dateFormatter } from '@/utils/formatTime'
+import { handleTree } from '@/utils/tree'
+import download from '@/utils/download'
+import { MdItemTypeApi, MdItemTypeVO } from '@/api/mes/md/item/type'
+import MdItemTypeForm from './MdItemTypeForm.vue'
+
+defineOptions({ name: 'MesMdItemType' })
+
+const message = useMessage() // 消息弹窗
+const { t } = useI18n() // 国际化
+
+const loading = ref(true) // 列表的加载中
+const list = ref<MdItemTypeVO[]>([]) // 列表的数据
+const queryParams = reactive({
+  name: undefined,
+  status: undefined
+})
+const queryFormRef = ref() // 搜索的表单
+const exportLoading = ref(false) // 导出的加载中
+
+/** 查询列表 */
+const getList = async () => {
+  loading.value = true
+  try {
+    const data = await MdItemTypeApi.getItemTypeList(queryParams)
+    list.value = handleTree(data)
+  } finally {
+    loading.value = false
+  }
+}
+
+/** 搜索按钮操作 */
+const handleQuery = () => {
+  getList()
+}
+
+/** 重置按钮操作 */
+const resetQuery = () => {
+  queryFormRef.value.resetFields()
+  handleQuery()
+}
+
+/** 添加/修改操作 */
+const formRef = ref()
+const openForm = (type: string, id?: number, parentId?: number) => {
+  formRef.value.open(type, id, parentId)
+}
+
+/** 删除按钮操作 */
+const handleDelete = async (id: number) => {
+  try {
+    // 删除的二次确认
+    await message.delConfirm()
+    // 发起删除
+    await MdItemTypeApi.deleteItemType(id)
+    message.success(t('common.delSuccess'))
+    // 刷新列表
+    await getList()
+  } catch {}
+}
+
+/** 导出按钮操作 */
+const handleExport = async () => {
+  try {
+    // 导出的二次确认
+    await message.exportConfirm()
+    // 发起导出
+    exportLoading.value = true
+    const data = await MdItemTypeApi.exportItemType(queryParams)
+    download.excel(data, '物料产品分类.xls')
+  } catch {
+  } finally {
+    exportLoading.value = false
+  }
+}
+
+/** 展开/折叠操作 */
+const isExpandAll = ref(true) // 是否展开，默认全部展开
+const refreshTable = ref(true) // 重新渲染表格状态
+const toggleExpandAll = async () => {
+  refreshTable.value = false
+  isExpandAll.value = !isExpandAll.value
+  await nextTick()
+  refreshTable.value = true
+}
+
+/** 初始化 **/
+onMounted(() => {
+  getList()
+})
+</script>