From b15cd9021e03852005fefb4bf999ee46fc74462d Mon Sep 17 00:00:00 2001
From: YunaiV <zhijiantianya@gmail.com>
Date: Mon, 16 Feb 2026 21:12:42 +0800
Subject: [PATCH] =?UTF-8?q?feat(mes):=20=E6=96=B0=E5=A2=9E=E5=B7=A5?=
 =?UTF-8?q?=E5=85=B7=E7=AE=A1=E7=90=86(TM)=E6=A8=A1=E5=9D=97=E5=89=8D?=
 =?UTF-8?q?=E7=AB=AF=E9=A1=B5=E9=9D=A2?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

新增工具类型和工具台账的 API、列表页和表单弹窗，
dict.ts 补充 MES_TM_TOOL_STATUS 和 MES_TM_MAINTEN_TYPE 字典类型。
---
 src/api/mes/tm/tool/index.ts                |  52 ++++
 src/api/mes/tm/tool/type/index.ts           |  50 ++++
 src/views/mes/tm/tool/ToolForm.vue          | 237 ++++++++++++++++++
 src/views/mes/tm/tool/index.vue             | 263 ++++++++++++++++++++
 src/views/mes/tm/tool/type/ToolTypeForm.vue | 156 ++++++++++++
 src/views/mes/tm/tool/type/index.vue        | 214 ++++++++++++++++
 6 files changed, 972 insertions(+)
 create mode 100644 src/api/mes/tm/tool/index.ts
 create mode 100644 src/api/mes/tm/tool/type/index.ts
 create mode 100644 src/views/mes/tm/tool/ToolForm.vue
 create mode 100644 src/views/mes/tm/tool/index.vue
 create mode 100644 src/views/mes/tm/tool/type/ToolTypeForm.vue
 create mode 100644 src/views/mes/tm/tool/type/index.vue

diff --git a/src/api/mes/tm/tool/index.ts b/src/api/mes/tm/tool/index.ts
new file mode 100644
index 000000000..3e79add31
--- /dev/null
+++ b/src/api/mes/tm/tool/index.ts
@@ -0,0 +1,52 @@
+import request from '@/config/axios'
+
+// MES 工具台账 VO
+export interface TmToolVO {
+  id: number // 编号
+  code: string // 工具编码
+  name: string // 工具名称
+  brand: string // 品牌
+  spec: string // 型号规格
+  toolTypeId: number // 工具类型编号
+  toolTypeName: string // 工具类型名称
+  quantity: number // 数量
+  quantityAvailable: number // 可用数量
+  maintenType: number // 保养维护类型
+  nextMaintenPeriod: number // 下次保养周期（次数）
+  nextMaintenDate: Date // 下次保养日期
+  status: number // 状态
+  remark: string // 备注
+}
+
+// MES 工具台账 API
+export const TmToolApi = {
+  // 查询工具台账分页
+  getToolPage: async (params: any) => {
+    return await request.get({ url: `/mes/tm/tool/page`, params })
+  },
+
+  // 查询工具台账详情
+  getTool: async (id: number) => {
+    return await request.get({ url: `/mes/tm/tool/get?id=` + id })
+  },
+
+  // 新增工具台账
+  createTool: async (data: TmToolVO) => {
+    return await request.post({ url: `/mes/tm/tool/create`, data })
+  },
+
+  // 修改工具台账
+  updateTool: async (data: TmToolVO) => {
+    return await request.put({ url: `/mes/tm/tool/update`, data })
+  },
+
+  // 删除工具台账
+  deleteTool: async (id: number) => {
+    return await request.delete({ url: `/mes/tm/tool/delete?id=` + id })
+  },
+
+  // 导出工具台账 Excel
+  exportTool: async (params: any) => {
+    return await request.download({ url: `/mes/tm/tool/export-excel`, params })
+  }
+}
diff --git a/src/api/mes/tm/tool/type/index.ts b/src/api/mes/tm/tool/type/index.ts
new file mode 100644
index 000000000..47b146394
--- /dev/null
+++ b/src/api/mes/tm/tool/type/index.ts
@@ -0,0 +1,50 @@
+import request from '@/config/axios'
+
+// MES 工具类型 VO
+export interface TmToolTypeVO {
+  id: number // 编号
+  code: string // 类型编码
+  name: string // 类型名称
+  codeFlag: boolean // 是否编码管理
+  maintenType: number // 保养维护类型
+  maintenPeriod: number // 保养周期
+  remark: string // 备注
+}
+
+// MES 工具类型 API
+export const TmToolTypeApi = {
+  // 查询工具类型分页
+  getToolTypePage: async (params: any) => {
+    return await request.get({ url: `/mes/tm/tool-type/page`, params })
+  },
+
+  // 查询工具类型精简列表
+  getToolTypeSimpleList: async () => {
+    return await request.get({ url: `/mes/tm/tool-type/simple-list` })
+  },
+
+  // 查询工具类型详情
+  getToolType: async (id: number) => {
+    return await request.get({ url: `/mes/tm/tool-type/get?id=` + id })
+  },
+
+  // 新增工具类型
+  createToolType: async (data: TmToolTypeVO) => {
+    return await request.post({ url: `/mes/tm/tool-type/create`, data })
+  },
+
+  // 修改工具类型
+  updateToolType: async (data: TmToolTypeVO) => {
+    return await request.put({ url: `/mes/tm/tool-type/update`, data })
+  },
+
+  // 删除工具类型
+  deleteToolType: async (id: number) => {
+    return await request.delete({ url: `/mes/tm/tool-type/delete?id=` + id })
+  },
+
+  // 导出工具类型 Excel
+  exportToolType: async (params: any) => {
+    return await request.download({ url: `/mes/tm/tool-type/export-excel`, params })
+  }
+}
diff --git a/src/views/mes/tm/tool/ToolForm.vue b/src/views/mes/tm/tool/ToolForm.vue
new file mode 100644
index 000000000..298934df2
--- /dev/null
+++ b/src/views/mes/tm/tool/ToolForm.vue
@@ -0,0 +1,237 @@
+<!-- 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="name">
+        <el-input v-model="formData.name" placeholder="请输入工具名称" />
+      </el-form-item>
+      <el-form-item label="工具类型" prop="toolTypeId">
+        <el-select
+          v-model="formData.toolTypeId"
+          placeholder="请选择工具类型"
+          class="!w-1/1"
+          @change="handleToolTypeChange"
+        >
+          <el-option
+            v-for="item in toolTypeList"
+            :key="item.id"
+            :label="item.name"
+            :value="item.id"
+          />
+        </el-select>
+      </el-form-item>
+      <el-form-item label="工具编码" prop="code">
+        <el-input v-model="formData.code" placeholder="请输入工具编码" />
+      </el-form-item>
+      <el-form-item label="品牌" prop="brand">
+        <el-input v-model="formData.brand" placeholder="请输入品牌" />
+      </el-form-item>
+      <el-form-item label="型号规格" prop="spec">
+        <el-input v-model="formData.spec" placeholder="请输入型号规格" />
+      </el-form-item>
+      <el-form-item label="数量" prop="quantity">
+        <el-input-number
+          v-model="formData.quantity"
+          :min="1"
+          :disabled="selectedToolType?.codeFlag === true"
+          class="!w-1/1"
+        />
+      </el-form-item>
+      <el-form-item label="可用数量" prop="quantityAvailable">
+        <el-input-number v-model="formData.quantityAvailable" :min="0" class="!w-1/1" />
+      </el-form-item>
+      <el-form-item label="保养维护类型" prop="maintenType">
+        <el-select
+          v-model="formData.maintenType"
+          placeholder="请选择保养维护类型"
+          clearable
+          class="!w-1/1"
+        >
+          <el-option
+            v-for="dict in getIntDictOptions(DICT_TYPE.MES_TM_MAINTEN_TYPE)"
+            :key="dict.value"
+            :label="dict.label"
+            :value="dict.value"
+          />
+        </el-select>
+      </el-form-item>
+      <el-form-item
+        label="下次保养日期"
+        prop="nextMaintenDate"
+        v-if="formData.maintenType === 1"
+      >
+        <el-date-picker
+          v-model="formData.nextMaintenDate"
+          type="datetime"
+          placeholder="请选择下次保养日期"
+          value-format="x"
+          class="!w-1/1"
+        />
+      </el-form-item>
+      <el-form-item
+        label="下次保养周期"
+        prop="nextMaintenPeriod"
+        v-if="formData.maintenType === 2"
+      >
+        <el-input-number
+          v-model="formData.nextMaintenPeriod"
+          :min="1"
+          placeholder="请输入下次保养周期（次数）"
+          class="!w-1/1"
+        />
+      </el-form-item>
+      <el-form-item label="状态" prop="status">
+        <el-select v-model="formData.status" placeholder="请选择状态" class="!w-1/1">
+          <el-option
+            v-for="dict in getIntDictOptions(DICT_TYPE.MES_TM_TOOL_STATUS)"
+            :key="dict.value"
+            :label="dict.label"
+            :value="dict.value"
+          />
+        </el-select>
+      </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 { TmToolApi, TmToolVO } from '@/api/mes/tm/tool'
+import { TmToolTypeApi, TmToolTypeVO } from '@/api/mes/tm/tooltype'
+
+defineOptions({ name: 'ToolForm' })
+
+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 as unknown as number,
+  code: undefined as unknown as string,
+  name: undefined as unknown as string,
+  brand: undefined as unknown as string,
+  spec: undefined as unknown as string,
+  toolTypeId: undefined as unknown as number,
+  quantity: 1 as number,
+  quantityAvailable: 1 as number,
+  maintenType: undefined as unknown as number,
+  nextMaintenPeriod: undefined as unknown as number,
+  nextMaintenDate: undefined as unknown as string,
+  status: 1 as number,
+  remark: undefined as unknown as string
+})
+const formRules = reactive({
+  name: [{ required: true, message: '工具名称不能为空', trigger: 'blur' }],
+  toolTypeId: [{ required: true, message: '工具类型不能为空', trigger: 'change' }],
+  quantity: [{ required: true, message: '数量不能为空', trigger: 'blur' }],
+  status: [{ required: true, message: '状态不能为空', trigger: 'change' }]
+})
+const formRef = ref() // 表单 Ref
+const toolTypeList = ref<TmToolTypeVO[]>([]) // 工具类型列表
+const selectedToolType = ref<TmToolTypeVO>() // 当前选中的工具类型
+
+/** 打开弹窗 */
+const open = async (type: string, id?: number) => {
+  dialogVisible.value = true
+  dialogTitle.value = t('action.' + type)
+  formType.value = type
+  resetForm()
+  // 加载工具类型列表
+  toolTypeList.value = await TmToolTypeApi.getToolTypeSimpleList()
+  // 修改时，设置数据
+  if (id) {
+    formLoading.value = true
+    try {
+      formData.value = await TmToolApi.getTool(id)
+      // 设置选中的工具类型
+      selectedToolType.value = toolTypeList.value.find(
+        (item) => item.id === formData.value.toolTypeId
+      )
+    } finally {
+      formLoading.value = false
+    }
+  }
+}
+defineExpose({ open }) // 提供 open 方法，用于打开弹窗
+
+/** 工具类型变更 */
+const handleToolTypeChange = (toolTypeId: number) => {
+  selectedToolType.value = toolTypeList.value.find((item) => item.id === toolTypeId)
+  // 如果是编码管理，数量锁定为 1
+  if (selectedToolType.value?.codeFlag === true) {
+    formData.value.quantity = 1
+    formData.value.quantityAvailable = 1
+  }
+}
+
+/** 提交表单 */
+const emit = defineEmits(['success']) // 定义 success 事件，用于操作成功后的回调
+const submitForm = async () => {
+  // 校验表单
+  await formRef.value.validate()
+  // 根据保养类型清空互斥字段
+  // TODO @AI：可以忽略，后端处理了。
+  if (formData.value.maintenType === 1) {
+    formData.value.nextMaintenPeriod = undefined as unknown as number
+  } else if (formData.value.maintenType === 2) {
+    formData.value.nextMaintenDate = undefined as unknown as string
+  } else {
+    formData.value.nextMaintenPeriod = undefined as unknown as number
+    formData.value.nextMaintenDate = undefined as unknown as string
+  }
+  // 提交请求
+  formLoading.value = true
+  try {
+    const data = formData.value as unknown as TmToolVO
+    if (formType.value === 'create') {
+      await TmToolApi.createTool(data)
+      message.success(t('common.createSuccess'))
+    } else {
+      await TmToolApi.updateTool(data)
+      message.success(t('common.updateSuccess'))
+    }
+    dialogVisible.value = false
+    // 发送操作成功的事件
+    emit('success')
+  } finally {
+    formLoading.value = false
+  }
+}
+
+/** 重置表单 */
+const resetForm = () => {
+  // TODO @AI：linter 报错；
+  formData.value = {
+    id: undefined,
+    code: undefined,
+    name: undefined,
+    brand: undefined,
+    spec: undefined,
+    toolTypeId: undefined,
+    quantity: 1,
+    quantityAvailable: 1,
+    maintenType: undefined,
+    nextMaintenPeriod: undefined,
+    nextMaintenDate: undefined,
+    status: 1, // TODO @AI：枚举；
+    remark: undefined
+  }
+  selectedToolType.value = undefined
+  formRef.value?.resetFields()
+}
+</script>
diff --git a/src/views/mes/tm/tool/index.vue b/src/views/mes/tm/tool/index.vue
new file mode 100644
index 000000000..37d96ebea
--- /dev/null
+++ b/src/views/mes/tm/tool/index.vue
@@ -0,0 +1,263 @@
+<!-- MES 工具台账列表 -->
+<template>
+  <ContentWrap>
+    <!-- 搜索工作栏 -->
+    <el-form
+      class="-mb-15px"
+      :model="queryParams"
+      ref="queryFormRef"
+      :inline="true"
+      label-width="100px"
+    >
+      <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>
+      <el-form-item label="工具类型" prop="toolTypeId">
+        <el-select
+          v-model="queryParams.toolTypeId"
+          placeholder="请选择工具类型"
+          clearable
+          class="!w-240px"
+        >
+          <el-option
+            v-for="item in toolTypeList"
+            :key="item.id"
+            :label="item.name"
+            :value="item.id"
+          />
+        </el-select>
+      </el-form-item>
+      <el-form-item label="品牌" prop="brand">
+        <el-input
+          v-model="queryParams.brand"
+          placeholder="请输入品牌"
+          clearable
+          @keyup.enter="handleQuery"
+          class="!w-240px"
+        />
+      </el-form-item>
+      <el-form-item label="型号规格" prop="spec">
+        <el-input
+          v-model="queryParams.spec"
+          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.MES_TM_TOOL_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:tm-tool:create']"
+        >
+          <Icon icon="ep:plus" class="mr-5px" /> 新增
+        </el-button>
+        <el-button
+          type="success"
+          plain
+          @click="handleExport"
+          :loading="exportLoading"
+          v-hasPermi="['mes:tm-tool: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="brand" />
+      <el-table-column label="型号规格" align="center" prop="spec" />
+      <el-table-column label="工具类型" align="center" prop="toolTypeName" />
+      <el-table-column label="数量" align="center" prop="quantity" />
+      <el-table-column label="可用数量" align="center" prop="quantityAvailable" />
+      <el-table-column label="保养维护类型" align="center" prop="maintenType">
+        <template #default="scope">
+          <dict-tag :type="DICT_TYPE.MES_TM_MAINTEN_TYPE" :value="scope.row.maintenType" />
+        </template>
+      </el-table-column>
+      <el-table-column label="下次保养" align="center" width="150">
+        <template #default="scope">
+          <span v-if="scope.row.maintenType === 1">
+            {{ scope.row.nextMaintenDate ? formatDate(scope.row.nextMaintenDate) : '-' }}
+          </span>
+          <span v-else-if="scope.row.maintenType === 2">
+            {{ scope.row.nextMaintenPeriod != null ? scope.row.nextMaintenPeriod + ' 次' : '-' }}
+          </span>
+          <span v-else>-</span>
+        </template>
+      </el-table-column>
+      <el-table-column label="状态" align="center" prop="status">
+        <template #default="scope">
+          <dict-tag :type="DICT_TYPE.MES_TM_TOOL_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="130">
+        <template #default="scope">
+          <el-button
+            link
+            type="primary"
+            @click="openForm('update', scope.row.id)"
+            v-hasPermi="['mes:tm-tool:update']"
+          >
+            编辑
+          </el-button>
+          <el-button
+            link
+            type="danger"
+            @click="handleDelete(scope.row.id)"
+            v-hasPermi="['mes:tm-tool: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>
+
+  <!-- 表单弹窗：添加/修改 -->
+  <ToolForm ref="formRef" @success="getList" />
+</template>
+
+<script setup lang="ts">
+import { dateFormatter, formatDate } from '@/utils/formatTime'
+import download from '@/utils/download'
+import { TmToolApi, TmToolVO } from '@/api/mes/tm/tool'
+import { TmToolTypeApi, TmToolTypeVO } from '@/api/mes/tm/tooltype'
+import ToolForm from './ToolForm.vue'
+import { DICT_TYPE, getIntDictOptions } from '@/utils/dict'
+
+defineOptions({ name: 'MesTmTool' })
+
+const message = useMessage() // 消息弹窗
+const { t } = useI18n() // 国际化
+
+const loading = ref(true) // 列表的加载中
+const list = ref<TmToolVO[]>([]) // 列表的数据
+const total = ref(0) // 列表的总页数
+const queryParams = reactive({
+  pageNo: 1,
+  pageSize: 10,
+  code: undefined,
+  name: undefined,
+  toolTypeId: undefined,
+  brand: undefined,
+  spec: undefined,
+  status: undefined
+})
+const queryFormRef = ref() // 搜索的表单
+const exportLoading = ref(false) // 导出的加载中
+const toolTypeList = ref<TmToolTypeVO[]>([]) // 工具类型列表
+
+/** 查询列表 */
+const getList = async () => {
+  loading.value = true
+  try {
+    const data = await TmToolApi.getToolPage(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 TmToolApi.deleteTool(id)
+    message.success(t('common.delSuccess'))
+    // 刷新列表
+    await getList()
+  } catch {}
+}
+
+/** 导出按钮操作 */
+const handleExport = async () => {
+  try {
+    // 导出的二次确认
+    await message.exportConfirm()
+    // 发起导出
+    exportLoading.value = true
+    const data = await TmToolApi.exportTool(queryParams)
+    download.excel(data, '工具台账.xls')
+  } catch {
+  } finally {
+    exportLoading.value = false
+  }
+}
+
+/** 初始化 **/
+onMounted(async () => {
+  await getList()
+  // 加载工具类型列表
+  toolTypeList.value = await TmToolTypeApi.getToolTypeSimpleList()
+})
+</script>
diff --git a/src/views/mes/tm/tool/type/ToolTypeForm.vue b/src/views/mes/tm/tool/type/ToolTypeForm.vue
new file mode 100644
index 000000000..5b0afaa81
--- /dev/null
+++ b/src/views/mes/tm/tool/type/ToolTypeForm.vue
@@ -0,0 +1,156 @@
+<!-- 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="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="codeFlag">
+        <!-- TODO @AI: linter -->
+        <el-radio-group v-model="formData.codeFlag">
+          <el-radio
+            v-for="dict in getBoolDictOptions(DICT_TYPE.INFRA_BOOLEAN_STRING)"
+            :key="dict.value"
+            :value="dict.value"
+          >
+            {{ dict.label }}
+          </el-radio>
+        </el-radio-group>
+      </el-form-item>
+      <el-form-item label="保养维护类型" prop="maintenType">
+        <el-select
+          v-model="formData.maintenType"
+          placeholder="请选择保养维护类型"
+          clearable
+          class="!w-1/1"
+        >
+          <el-option
+            v-for="dict in getIntDictOptions(DICT_TYPE.MES_TM_MAINTEN_TYPE)"
+            :key="dict.value"
+            :label="dict.label"
+            :value="dict.value"
+          />
+        </el-select>
+      </el-form-item>
+      <el-form-item
+        label="保养周期"
+        prop="maintenPeriod"
+        v-if="formData.maintenType === 1"
+      >
+        <el-input-number
+          v-model="formData.maintenPeriod"
+          :min="1"
+          placeholder="请输入保养周期（天）"
+          class="!w-1/1"
+        />
+      </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 { getBoolDictOptions, getIntDictOptions, DICT_TYPE } from '@/utils/dict'
+import { TmToolTypeApi, TmToolTypeVO } from '@/api/mes/tm/tooltype'
+
+defineOptions({ name: 'ToolTypeForm' })
+
+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 as unknown as number,
+  code: undefined as unknown as string,
+  name: undefined as unknown as string,
+  codeFlag: true as boolean,
+  maintenType: undefined as unknown as number,
+  maintenPeriod: undefined as unknown as number,
+  remark: undefined as unknown as string
+})
+const formRules = reactive({
+  code: [{ required: true, message: '类型编码不能为空', trigger: 'blur' }],
+  name: [{ required: true, message: '类型名称不能为空', trigger: 'blur' }],
+  codeFlag: [{ required: true, message: '是否编码管理不能为空', trigger: 'blur' }]
+})
+const formRef = ref() // 表单 Ref
+
+/** 打开弹窗 */
+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 TmToolTypeApi.getToolType(id)
+    } finally {
+      formLoading.value = false
+    }
+  }
+}
+defineExpose({ open }) // 提供 open 方法，用于打开弹窗
+
+/** 提交表单 */
+const emit = defineEmits(['success']) // 定义 success 事件，用于操作成功后的回调
+const submitForm = async () => {
+  // 校验表单
+  await formRef.value.validate()
+  // 如果不是定期维护，清空保养周期
+  // TODO @AI：字典判断；另外，后端已经处理，貌似可以不处理，前端；
+  if (formData.value.maintenType !== 1) {
+    formData.value.maintenPeriod = undefined as unknown as number
+  }
+  // 提交请求
+  formLoading.value = true
+  try {
+    const data = formData.value as unknown as TmToolTypeVO
+    if (formType.value === 'create') {
+      await TmToolTypeApi.createToolType(data)
+      message.success(t('common.createSuccess'))
+    } else {
+      await TmToolTypeApi.updateToolType(data)
+      message.success(t('common.updateSuccess'))
+    }
+    dialogVisible.value = false
+    // 发送操作成功的事件
+    emit('success')
+  } finally {
+    formLoading.value = false
+  }
+}
+
+/** 重置表单 */
+// TODO @AI：linter 报错；参考下别的模块处理策略；
+const resetForm = () => {
+  formData.value = {
+    id: undefined,
+    code: undefined,
+    name: undefined,
+    codeFlag: true,
+    maintenType: undefined,
+    maintenPeriod: undefined,
+    remark: undefined
+  }
+  formRef.value?.resetFields()
+}
+</script>
diff --git a/src/views/mes/tm/tool/type/index.vue b/src/views/mes/tm/tool/type/index.vue
new file mode 100644
index 000000000..60f934ced
--- /dev/null
+++ b/src/views/mes/tm/tool/type/index.vue
@@ -0,0 +1,214 @@
+<!-- MES 工具类型列表 -->
+<template>
+  <ContentWrap>
+    <!-- 搜索工作栏 -->
+    <el-form
+      class="-mb-15px"
+      :model="queryParams"
+      ref="queryFormRef"
+      :inline="true"
+      label-width="100px"
+    >
+      <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>
+      <el-form-item label="保养维护类型" prop="maintenType">
+        <el-select
+          v-model="queryParams.maintenType"
+          placeholder="请选择保养维护类型"
+          clearable
+          class="!w-240px"
+        >
+          <el-option
+            v-for="dict in getIntDictOptions(DICT_TYPE.MES_TM_MAINTEN_TYPE)"
+            :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:tm-tool-type:create']"
+        >
+          <Icon icon="ep:plus" class="mr-5px" /> 新增
+        </el-button>
+        <el-button
+          type="success"
+          plain
+          @click="handleExport"
+          :loading="exportLoading"
+          v-hasPermi="['mes:tm-tool-type: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="codeFlag">
+        <template #default="scope">
+          <dict-tag :type="DICT_TYPE.INFRA_BOOLEAN_STRING" :value="scope.row.codeFlag" />
+        </template>
+      </el-table-column>
+      <el-table-column label="保养维护类型" align="center" prop="maintenType">
+        <template #default="scope">
+          <dict-tag :type="DICT_TYPE.MES_TM_MAINTEN_TYPE" :value="scope.row.maintenType" />
+        </template>
+      </el-table-column>
+      <el-table-column label="保养周期" align="center" prop="maintenPeriod" />
+      <el-table-column label="备注" align="center" prop="remark" />
+      <el-table-column
+        label="创建时间"
+        align="center"
+        prop="createTime"
+        :formatter="dateFormatter"
+        width="180px"
+      />
+      <el-table-column label="操作" align="center" width="130">
+        <template #default="scope">
+          <el-button
+            link
+            type="primary"
+            @click="openForm('update', scope.row.id)"
+            v-hasPermi="['mes:tm-tool-type:update']"
+          >
+            编辑
+          </el-button>
+          <el-button
+            link
+            type="danger"
+            @click="handleDelete(scope.row.id)"
+            v-hasPermi="['mes:tm-tool-type: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>
+
+  <!-- 表单弹窗：添加/修改 -->
+  <ToolTypeForm ref="formRef" @success="getList" />
+</template>
+
+<script setup lang="ts">
+import { dateFormatter } from '@/utils/formatTime'
+import download from '@/utils/download'
+import { TmToolTypeApi, TmToolTypeVO } from '@/api/mes/tm/tooltype'
+import ToolTypeForm from './ToolTypeForm.vue'
+import { DICT_TYPE, getIntDictOptions } from '@/utils/dict'
+
+defineOptions({ name: 'MesTmToolType' })
+
+const message = useMessage() // 消息弹窗
+const { t } = useI18n() // 国际化
+
+const loading = ref(true) // 列表的加载中
+const list = ref<TmToolTypeVO[]>([]) // 列表的数据
+const total = ref(0) // 列表的总页数
+const queryParams = reactive({
+  pageNo: 1,
+  pageSize: 10,
+  code: undefined,
+  name: undefined,
+  maintenType: undefined
+})
+const queryFormRef = ref() // 搜索的表单
+const exportLoading = ref(false) // 导出的加载中
+
+/** 查询列表 */
+const getList = async () => {
+  loading.value = true
+  try {
+    const data = await TmToolTypeApi.getToolTypePage(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 TmToolTypeApi.deleteToolType(id)
+    message.success(t('common.delSuccess'))
+    // 刷新列表
+    await getList()
+  } catch {}
+}
+
+/** 导出按钮操作 */
+const handleExport = async () => {
+  try {
+    // 导出的二次确认
+    await message.exportConfirm()
+    // 发起导出
+    exportLoading.value = true
+    const data = await TmToolTypeApi.exportToolType(queryParams)
+    download.excel(data, '工具类型.xls')
+  } catch {
+  } finally {
+    exportLoading.value = false
+  }
+}
+
+/** 初始化 **/
+onMounted(() => {
+  getList()
+})
+</script>