From 3c592887b97b838fd2005910015355e50727a025 Mon Sep 17 00:00:00 2001
From: YunaiV <zhijiantianya@gmail.com>
Date: Sun, 24 May 2026 23:11:02 +0800
Subject: [PATCH] =?UTF-8?q?feat(mes)=EF=BC=9A=E7=BB=9F=E4=B8=80=20dv?=
 =?UTF-8?q?=E3=80=81cal=E3=80=81md=20=E7=9A=84=E4=BB=A3=E7=A0=81=E8=A7=84?=
 =?UTF-8?q?=E8=8C=83?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../web-antd/src/views/mes/cal/plan/index.vue |  8 +++-
 .../web-antd/src/views/mes/cal/team/index.vue |  8 +++-
 .../src/views/mes/dv/checkplan/index.vue      |  8 +++-
 .../views/mes/dv/checkplan/modules/form.vue   | 14 ++++---
 .../src/views/mes/dv/checkrecord/index.vue    |  8 +++-
 .../views/mes/dv/checkrecord/modules/form.vue | 10 +++--
 .../src/views/mes/dv/machinery/index.vue      |  8 +++-
 .../views/mes/dv/machinery/modules/form.vue   | 11 +++--
 .../src/views/mes/dv/machinery/type/index.vue | 23 ++++++++---
 .../mes/dv/machinery/type/modules/form.vue    | 31 +++++++++-----
 .../src/views/mes/dv/maintenrecord/index.vue  |  8 +++-
 .../mes/dv/maintenrecord/modules/form.vue     | 10 +++--
 .../src/views/mes/dv/repair/index.vue         |  8 +++-
 .../src/views/mes/dv/repair/modules/form.vue  |  2 +
 .../src/views/mes/dv/subject/index.vue        |  8 +++-
 .../src/views/mes/dv/subject/modules/form.vue | 14 ++++---
 .../src/views/mes/md/client/modules/form.vue  | 10 ++---
 .../src/views/mes/md/item/modules/form.vue    | 10 ++---
 .../src/views/mes/md/item/type/index.vue      |  8 +++-
 .../views/mes/md/workstation/modules/form.vue | 10 ++---
 .../md/workstation/workshop/modules/form.vue  | 10 ++---
 .../web-ele/src/api/mes/dv/machinery/index.ts | 40 +++++++++++++++++++
 .../src/views/mes/cal/holiday/index.vue       | 16 +++++---
 apps/web-ele/src/views/mes/cal/plan/index.vue |  8 +++-
 apps/web-ele/src/views/mes/cal/team/index.vue |  8 +++-
 .../src/views/mes/dv/checkplan/index.vue      |  8 +++-
 .../views/mes/dv/checkplan/modules/form.vue   | 14 ++++---
 .../src/views/mes/dv/checkrecord/index.vue    |  8 +++-
 .../views/mes/dv/checkrecord/modules/form.vue | 10 +++--
 .../src/views/mes/dv/machinery/index.vue      |  8 +++-
 .../views/mes/dv/machinery/modules/form.vue   | 11 +++--
 .../src/views/mes/dv/machinery/type/index.vue | 23 ++++++++---
 .../mes/dv/machinery/type/modules/form.vue    | 31 +++++++++-----
 .../src/views/mes/dv/maintenrecord/index.vue  |  8 +++-
 .../mes/dv/maintenrecord/modules/form.vue     | 10 +++--
 .../web-ele/src/views/mes/dv/repair/index.vue |  8 +++-
 .../src/views/mes/dv/repair/modules/form.vue  |  2 +
 .../src/views/mes/dv/subject/index.vue        |  8 +++-
 .../src/views/mes/dv/subject/modules/form.vue | 14 ++++---
 .../src/views/mes/md/client/modules/form.vue  | 10 ++---
 .../src/views/mes/md/item/modules/form.vue    | 10 ++---
 .../src/views/mes/md/item/type/index.vue      |  8 +++-
 .../views/mes/md/workstation/modules/form.vue | 10 ++---
 .../md/workstation/workshop/modules/form.vue  | 10 ++---
 44 files changed, 363 insertions(+), 147 deletions(-)

diff --git a/apps/web-antd/src/views/mes/cal/plan/index.vue b/apps/web-antd/src/views/mes/cal/plan/index.vue
index 7f834ade2..bf6e77dbb 100644
--- a/apps/web-antd/src/views/mes/cal/plan/index.vue
+++ b/apps/web-antd/src/views/mes/cal/plan/index.vue
@@ -2,7 +2,7 @@
 import type { VxeTableGridOptions } from '#/adapter/vxe-table';
 import type { MesCalPlanApi } from '#/api/mes/cal/plan';
 
-import { Page, useVbenModal } from '@vben/common-ui';
+import { DocAlert, Page, useVbenModal } from '@vben/common-ui';
 import { downloadFileFromBlobPart } from '@vben/utils';
 
 import { Button, message } from 'ant-design-vue';
@@ -89,6 +89,12 @@ const [Grid, gridApi] = useVbenVxeGrid({
 
 <template>
   <Page auto-content-height>
+    <template #doc>
+      <DocAlert
+        title="【排班】排班计划、排班日历"
+        url="https://doc.iocoder.cn/mes/cal/calendar/"
+      />
+    </template>
     <FormModal @success="handleRefresh" />
     <Grid table-title="排班计划列表">
       <template #toolbar-tools>
diff --git a/apps/web-antd/src/views/mes/cal/team/index.vue b/apps/web-antd/src/views/mes/cal/team/index.vue
index 42336c7da..d5d10fb95 100644
--- a/apps/web-antd/src/views/mes/cal/team/index.vue
+++ b/apps/web-antd/src/views/mes/cal/team/index.vue
@@ -2,7 +2,7 @@
 import type { VxeTableGridOptions } from '#/adapter/vxe-table';
 import type { MesCalTeamApi } from '#/api/mes/cal/team';
 
-import { Page, useVbenModal } from '@vben/common-ui';
+import { DocAlert, Page, useVbenModal } from '@vben/common-ui';
 import { downloadFileFromBlobPart } from '@vben/utils';
 
 import { Button, message } from 'ant-design-vue';
@@ -93,6 +93,12 @@ const [Grid, gridApi] = useVbenVxeGrid({
 
 <template>
   <Page auto-content-height>
+    <template #doc>
+      <DocAlert
+        title="【排班】班组设置、节假日设置"
+        url="https://doc.iocoder.cn/mes/cal/team/"
+      />
+    </template>
     <FormModal @success="handleRefresh" />
     <Grid table-title="班组列表">
       <template #toolbar-tools>
diff --git a/apps/web-antd/src/views/mes/dv/checkplan/index.vue b/apps/web-antd/src/views/mes/dv/checkplan/index.vue
index 844ac68f9..0f9ada592 100644
--- a/apps/web-antd/src/views/mes/dv/checkplan/index.vue
+++ b/apps/web-antd/src/views/mes/dv/checkplan/index.vue
@@ -3,7 +3,7 @@ import type { VxeTableGridOptions } from '#/adapter/vxe-table';
 import type { MesDvCheckPlanApi } from '#/api/mes/dv/checkplan';
 import type { ActionItem } from '#/components/table-action/typing';
 
-import { Page, useVbenModal } from '@vben/common-ui';
+import { DocAlert, Page, useVbenModal } from '@vben/common-ui';
 import { downloadFileFromBlobPart } from '@vben/utils';
 
 import { Button, message } from 'ant-design-vue';
@@ -156,6 +156,12 @@ const [Grid, gridApi] = useVbenVxeGrid({
 </script>
 <template>
   <Page auto-content-height>
+    <template #doc>
+      <DocAlert
+        title="【设备】点检保养项目、点检保养方案"
+        url="https://doc.iocoder.cn/mes/dv/check-plan/"
+      />
+    </template>
     <FormModal @success="handleRefresh" />
     <Grid table-title="点检保养方案列表">
       <template #toolbar-tools>
diff --git a/apps/web-antd/src/views/mes/dv/checkplan/modules/form.vue b/apps/web-antd/src/views/mes/dv/checkplan/modules/form.vue
index 2c0e4eff6..516b8a532 100644
--- a/apps/web-antd/src/views/mes/dv/checkplan/modules/form.vue
+++ b/apps/web-antd/src/views/mes/dv/checkplan/modules/form.vue
@@ -23,12 +23,12 @@ const formMode = ref<FormMode>('create');
 const subTabsName = ref('machinery');
 const formData = ref<MesDvCheckPlanApi.CheckPlan>();
 const isDetail = computed(() => formMode.value === 'detail');
-const getTitle = computed(
-  () =>
-    ({ create: '新增点检保养方案', update: '修改点检保养方案', detail: '查看点检保养方案' })[
-      formMode.value
-    ],
-);
+const getTitle = computed(() => {
+  if (formMode.value === 'detail') {
+    return '查看点检保养方案';
+  }
+  return formMode.value === 'update' ? '修改点检保养方案' : '新增点检保养方案';
+});
 
 const [Form, formApi] = useVbenForm({
   commonConfig: {
@@ -43,6 +43,8 @@ const [Form, formApi] = useVbenForm({
   schema: [],
   showDefaultActions: false,
 });
+
+/** 表单 schema 需要 formApi 引用，所以通过 setState 设置 schema */
 formApi.setState({ schema: useFormSchema(formApi) });
 
 const [Modal, modalApi] = useVbenModal({
diff --git a/apps/web-antd/src/views/mes/dv/checkrecord/index.vue b/apps/web-antd/src/views/mes/dv/checkrecord/index.vue
index 44867b21e..cc76f8423 100644
--- a/apps/web-antd/src/views/mes/dv/checkrecord/index.vue
+++ b/apps/web-antd/src/views/mes/dv/checkrecord/index.vue
@@ -2,7 +2,7 @@
 import type { VxeTableGridOptions } from '#/adapter/vxe-table';
 import type { MesDvCheckRecordApi } from '#/api/mes/dv/checkrecord';
 
-import { Page, useVbenModal } from '@vben/common-ui';
+import { DocAlert, Page, useVbenModal } from '@vben/common-ui';
 import { downloadFileFromBlobPart } from '@vben/utils';
 
 import { Button, message } from 'ant-design-vue';
@@ -92,6 +92,12 @@ const [Grid, gridApi] = useVbenVxeGrid({
 </script>
 <template>
   <Page auto-content-height>
+    <template #doc>
+      <DocAlert
+        title="【设备】点检记录、保养记录、维修单"
+        url="https://doc.iocoder.cn/mes/dv/check-record/"
+      />
+    </template>
     <FormModal @success="handleRefresh" />
     <Grid table-title="点检记录列表">
       <template #toolbar-tools>
diff --git a/apps/web-antd/src/views/mes/dv/checkrecord/modules/form.vue b/apps/web-antd/src/views/mes/dv/checkrecord/modules/form.vue
index 0b63b10fb..d8093f428 100644
--- a/apps/web-antd/src/views/mes/dv/checkrecord/modules/form.vue
+++ b/apps/web-antd/src/views/mes/dv/checkrecord/modules/form.vue
@@ -29,10 +29,12 @@ const isDetail = computed(() => formMode.value === 'detail');
 const canSubmit = computed(
   () => formMode.value === 'update' && formData.value?.status === MesDvCheckRecordStatusEnum.DRAFT,
 );
-const getTitle = computed(
-  () =>
-    ({ create: '新增点检记录', update: '修改点检记录', detail: '查看点检记录' })[formMode.value],
-);
+const getTitle = computed(() => {
+  if (formMode.value === 'detail') {
+    return '查看点检记录';
+  }
+  return formMode.value === 'update' ? '修改点检记录' : '新增点检记录';
+});
 
 const [Form, formApi] = useVbenForm({
   commonConfig: {
diff --git a/apps/web-antd/src/views/mes/dv/machinery/index.vue b/apps/web-antd/src/views/mes/dv/machinery/index.vue
index 97b3c19f6..cac7195df 100644
--- a/apps/web-antd/src/views/mes/dv/machinery/index.vue
+++ b/apps/web-antd/src/views/mes/dv/machinery/index.vue
@@ -5,7 +5,7 @@ import type { MesDvMachineryTypeApi } from '#/api/mes/dv/machinery/type';
 
 import { ref } from 'vue';
 
-import { Page, useVbenModal } from '@vben/common-ui';
+import { DocAlert, Page, useVbenModal } from '@vben/common-ui';
 import { downloadFileFromBlobPart } from '@vben/utils';
 
 import { Button, message } from 'ant-design-vue';
@@ -115,6 +115,12 @@ const [Grid, gridApi] = useVbenVxeGrid({
 
 <template>
   <Page auto-content-height>
+    <template #doc>
+      <DocAlert
+        title="【设备】设备类型、设备台账"
+        url="https://doc.iocoder.cn/mes/dv/device/"
+      />
+    </template>
     <FormModal @success="handleRefresh" />
     <ImportModal @success="handleRefresh" />
     <div class="flex h-full w-full">
diff --git a/apps/web-antd/src/views/mes/dv/machinery/modules/form.vue b/apps/web-antd/src/views/mes/dv/machinery/modules/form.vue
index 5860a6744..e8f590eed 100644
--- a/apps/web-antd/src/views/mes/dv/machinery/modules/form.vue
+++ b/apps/web-antd/src/views/mes/dv/machinery/modules/form.vue
@@ -26,9 +26,12 @@ const subTabsName = ref('check'); // 当前资源页签
 const formData = ref<MesDvMachineryApi.Machinery>();
 const barcodeDetailRef = ref<InstanceType<typeof BarcodeDetail>>(); // 条码详情弹窗
 const isDetail = computed(() => formMode.value === 'detail'); // 是否查看模式
-const getTitle = computed(
-  () => ({ create: '新增设备', update: '修改设备', detail: '查看设备' })[formMode.value],
-);
+const getTitle = computed(() => {
+  if (formMode.value === 'detail') {
+    return '查看设备';
+  }
+  return formMode.value === 'update' ? '修改设备' : '新增设备';
+});
 
 const [Form, formApi] = useVbenForm({
   commonConfig: {
@@ -43,6 +46,8 @@ const [Form, formApi] = useVbenForm({
   schema: [],
   showDefaultActions: false,
 });
+
+/** 表单 schema 需要 formApi 引用，所以通过 setState 设置 schema */
 formApi.setState({ schema: useFormSchema(formApi, formMode) });
 
 /** 查看设备条码 */
diff --git a/apps/web-antd/src/views/mes/dv/machinery/type/index.vue b/apps/web-antd/src/views/mes/dv/machinery/type/index.vue
index e1ccc36a7..bcb0c6d1f 100644
--- a/apps/web-antd/src/views/mes/dv/machinery/type/index.vue
+++ b/apps/web-antd/src/views/mes/dv/machinery/type/index.vue
@@ -4,7 +4,7 @@ import type { MesDvMachineryTypeApi } from '#/api/mes/dv/machinery/type';
 
 import { ref } from 'vue';
 
-import { Page, useVbenModal } from '@vben/common-ui';
+import { DocAlert, Page, useVbenModal } from '@vben/common-ui';
 import { handleTree } from '@vben/utils';
 
 import { message } from 'ant-design-vue';
@@ -35,13 +35,18 @@ function handleRefresh() {
 }
 
 /** 创建设备类型 */
-function handleCreate(parentId = 0) {
-  formModalApi.setData({ parentId, type: 'create' }).open();
+function handleCreate() {
+  formModalApi.setData(null).open();
+}
+
+/** 添加下级设备类型 */
+function handleAppend(row: MesDvMachineryTypeApi.MachineryType) {
+  formModalApi.setData({ parentId: row.id }).open();
 }
 
 /** 编辑设备类型 */
 function handleEdit(row: MesDvMachineryTypeApi.MachineryType) {
-  formModalApi.setData({ id: row.id, type: 'update' }).open();
+  formModalApi.setData(row).open();
 }
 
 /** 删除设备类型 */
@@ -94,6 +99,12 @@ const [Grid, gridApi] = useVbenVxeGrid({
 
 <template>
   <Page auto-content-height>
+    <template #doc>
+      <DocAlert
+        title="【设备】设备类型、设备台账"
+        url="https://doc.iocoder.cn/mes/dv/device/"
+      />
+    </template>
     <FormModal @success="handleRefresh" />
     <Grid table-title="设备类型列表">
       <template #toolbar-tools>
@@ -104,7 +115,7 @@ const [Grid, gridApi] = useVbenVxeGrid({
               type: 'primary',
               icon: ACTION_ICON.ADD,
               auth: ['mes:dv-machinery-type:create'],
-              onClick: handleCreate.bind(null, 0),
+              onClick: handleCreate,
             },
             {
               label: isExpanded ? '收缩' : '展开',
@@ -122,7 +133,7 @@ const [Grid, gridApi] = useVbenVxeGrid({
               type: 'link',
               icon: ACTION_ICON.ADD,
               auth: ['mes:dv-machinery-type:create'],
-              onClick: handleCreate.bind(null, row.id),
+              onClick: handleAppend.bind(null, row),
             },
             {
               label: $t('common.edit'),
diff --git a/apps/web-antd/src/views/mes/dv/machinery/type/modules/form.vue b/apps/web-antd/src/views/mes/dv/machinery/type/modules/form.vue
index ce3b2bc1b..bf17aed85 100644
--- a/apps/web-antd/src/views/mes/dv/machinery/type/modules/form.vue
+++ b/apps/web-antd/src/views/mes/dv/machinery/type/modules/form.vue
@@ -17,10 +17,13 @@ import { $t } from '#/locales';
 
 import { useFormSchema } from '../data';
 
-
 const emit = defineEmits(['success']);
-const formMode = ref<'create' | 'update'>('create'); // 表单模式
-const getTitle = computed(() => (formMode.value === 'create' ? '新增设备类型' : '修改设备类型'));
+const formData = ref<MesDvMachineryTypeApi.MachineryType>();
+const getTitle = computed(() => {
+  return formData.value?.id
+    ? $t('ui.actionTitle.edit', ['设备类型'])
+    : $t('ui.actionTitle.create', ['设备类型']);
+});
 
 const [Form, formApi] = useVbenForm({
   commonConfig: {
@@ -48,7 +51,10 @@ const [Modal, modalApi] = useVbenModal({
     // 提交表单
     const data = (await formApi.getValues()) as MesDvMachineryTypeApi.MachineryType;
     try {
-      await (data.id ? updateMachineryType(data) : createMachineryType(data));
+      await (formData.value?.id
+        ? updateMachineryType(data)
+        : createMachineryType(data));
+      // 关闭并提示
       await modalApi.close();
       emit('success');
       message.success($t('ui.actionMessage.operationSuccess'));
@@ -58,18 +64,25 @@ const [Modal, modalApi] = useVbenModal({
   },
   async onOpenChange(isOpen: boolean) {
     if (!isOpen) {
+      formData.value = undefined;
       return;
     }
     await formApi.resetForm();
-    const data = modalApi.getData<{ id?: number; parentId?: number; type?: 'create' | 'update' }>();
-    formMode.value = data?.type || 'create';
-    if (!data?.id) {
-      await formApi.setValues({ parentId: data?.parentId ?? 0 });
+    // 加载数据
+    const data = modalApi.getData<MesDvMachineryTypeApi.MachineryType>();
+    if (!data || !data.id) {
+      formData.value = data || undefined;
+      if (data) {
+        // 设置上级类型
+        await formApi.setValues(data);
+      }
       return;
     }
     modalApi.lock();
     try {
-      await formApi.setValues(await getMachineryType(data.id));
+      formData.value = await getMachineryType(data.id);
+      // 设置到 values
+      await formApi.setValues(formData.value);
     } finally {
       modalApi.unlock();
     }
diff --git a/apps/web-antd/src/views/mes/dv/maintenrecord/index.vue b/apps/web-antd/src/views/mes/dv/maintenrecord/index.vue
index e4917ba21..3aa1f4e5f 100644
--- a/apps/web-antd/src/views/mes/dv/maintenrecord/index.vue
+++ b/apps/web-antd/src/views/mes/dv/maintenrecord/index.vue
@@ -2,7 +2,7 @@
 import type { VxeTableGridOptions } from '#/adapter/vxe-table';
 import type { MesDvMaintenRecordApi } from '#/api/mes/dv/maintenrecord';
 
-import { Page, useVbenModal } from '@vben/common-ui';
+import { DocAlert, Page, useVbenModal } from '@vben/common-ui';
 import { downloadFileFromBlobPart } from '@vben/utils';
 
 import { Button, message } from 'ant-design-vue';
@@ -96,6 +96,12 @@ const [Grid, gridApi] = useVbenVxeGrid({
 </script>
 <template>
   <Page auto-content-height>
+    <template #doc>
+      <DocAlert
+        title="【设备】点检记录、保养记录、维修单"
+        url="https://doc.iocoder.cn/mes/dv/check-record/"
+      />
+    </template>
     <FormModal @success="handleRefresh" />
     <Grid table-title="保养记录列表">
       <template #toolbar-tools>
diff --git a/apps/web-antd/src/views/mes/dv/maintenrecord/modules/form.vue b/apps/web-antd/src/views/mes/dv/maintenrecord/modules/form.vue
index 8fbfdd8e1..e2f445119 100644
--- a/apps/web-antd/src/views/mes/dv/maintenrecord/modules/form.vue
+++ b/apps/web-antd/src/views/mes/dv/maintenrecord/modules/form.vue
@@ -32,10 +32,12 @@ const canSubmit = computed(
   () =>
     formMode.value === 'update' && formData.value?.status === MesDvMaintenRecordStatusEnum.PREPARE,
 );
-const getTitle = computed(
-  () =>
-    ({ create: '新增保养记录', update: '修改保养记录', detail: '查看保养记录' })[formMode.value],
-);
+const getTitle = computed(() => {
+  if (formMode.value === 'detail') {
+    return '查看保养记录';
+  }
+  return formMode.value === 'update' ? '修改保养记录' : '新增保养记录';
+});
 
 const [Form, formApi] = useVbenForm({
   commonConfig: {
diff --git a/apps/web-antd/src/views/mes/dv/repair/index.vue b/apps/web-antd/src/views/mes/dv/repair/index.vue
index c7c502d4b..dc91fa735 100644
--- a/apps/web-antd/src/views/mes/dv/repair/index.vue
+++ b/apps/web-antd/src/views/mes/dv/repair/index.vue
@@ -2,7 +2,7 @@
 import type { VxeTableGridOptions } from '#/adapter/vxe-table';
 import type { MesDvRepairApi } from '#/api/mes/dv/repair';
 
-import { Page, useVbenModal } from '@vben/common-ui';
+import { DocAlert, Page, useVbenModal } from '@vben/common-ui';
 import { downloadFileFromBlobPart } from '@vben/utils';
 
 import { Button, message } from 'ant-design-vue';
@@ -98,6 +98,12 @@ const [Grid, gridApi] = useVbenVxeGrid({
 </script>
 <template>
   <Page auto-content-height>
+    <template #doc>
+      <DocAlert
+        title="【设备】点检记录、保养记录、维修单"
+        url="https://doc.iocoder.cn/mes/dv/check-record/"
+      />
+    </template>
     <FormModal @success="handleRefresh" />
     <Grid table-title="维修工单列表">
       <template #toolbar-tools>
diff --git a/apps/web-antd/src/views/mes/dv/repair/modules/form.vue b/apps/web-antd/src/views/mes/dv/repair/modules/form.vue
index 2cb844f5f..1914e68d2 100644
--- a/apps/web-antd/src/views/mes/dv/repair/modules/form.vue
+++ b/apps/web-antd/src/views/mes/dv/repair/modules/form.vue
@@ -56,6 +56,8 @@ const [Form, formApi] = useVbenForm({
   schema: [],
   showDefaultActions: false,
 });
+
+/** 表单 schema 需要 formApi 引用，所以通过 setState 设置 schema */
 formApi.setState({ schema: useFormSchema(formApi) });
 
 /** 提交维修工单 */
diff --git a/apps/web-antd/src/views/mes/dv/subject/index.vue b/apps/web-antd/src/views/mes/dv/subject/index.vue
index 99e7ace61..6aabbdeea 100644
--- a/apps/web-antd/src/views/mes/dv/subject/index.vue
+++ b/apps/web-antd/src/views/mes/dv/subject/index.vue
@@ -2,7 +2,7 @@
 import type { VxeTableGridOptions } from '#/adapter/vxe-table';
 import type { MesDvSubjectApi } from '#/api/mes/dv/subject';
 
-import { Page, useVbenModal } from '@vben/common-ui';
+import { DocAlert, Page, useVbenModal } from '@vben/common-ui';
 import { downloadFileFromBlobPart } from '@vben/utils';
 
 import { Button, message } from 'ant-design-vue';
@@ -92,6 +92,12 @@ const [Grid, gridApi] = useVbenVxeGrid({
 
 <template>
   <Page auto-content-height>
+    <template #doc>
+      <DocAlert
+        title="【设备】点检保养项目、点检保养方案"
+        url="https://doc.iocoder.cn/mes/dv/check-plan/"
+      />
+    </template>
     <FormModal @success="handleRefresh" />
     <Grid table-title="点检保养项目列表">
       <template #toolbar-tools>
diff --git a/apps/web-antd/src/views/mes/dv/subject/modules/form.vue b/apps/web-antd/src/views/mes/dv/subject/modules/form.vue
index d69d77707..6a1fead3a 100644
--- a/apps/web-antd/src/views/mes/dv/subject/modules/form.vue
+++ b/apps/web-antd/src/views/mes/dv/subject/modules/form.vue
@@ -18,12 +18,12 @@ type FormMode = 'create' | 'detail' | 'update';
 const emit = defineEmits(['success']);
 const formMode = ref<FormMode>('create'); // 表单模式
 const isDetail = computed(() => formMode.value === 'detail'); // 是否查看模式
-const getTitle = computed(
-  () =>
-    ({ create: '新增点检保养项目', update: '修改点检保养项目', detail: '查看点检保养项目' })[
-      formMode.value
-    ],
-);
+const getTitle = computed(() => {
+  if (formMode.value === 'detail') {
+    return '查看点检保养项目';
+  }
+  return formMode.value === 'update' ? '修改点检保养项目' : '新增点检保养项目';
+});
 
 const [Form, formApi] = useVbenForm({
   commonConfig: {
@@ -38,6 +38,8 @@ const [Form, formApi] = useVbenForm({
   schema: [],
   showDefaultActions: false,
 });
+
+/** 表单 schema 需要 formApi 引用，所以通过 setState 设置 schema */
 formApi.setState({ schema: useFormSchema(formApi) });
 
 const [Modal, modalApi] = useVbenModal({
diff --git a/apps/web-antd/src/views/mes/md/client/modules/form.vue b/apps/web-antd/src/views/mes/md/client/modules/form.vue
index 5b4cc4fee..4f4d2dda7 100644
--- a/apps/web-antd/src/views/mes/md/client/modules/form.vue
+++ b/apps/web-antd/src/views/mes/md/client/modules/form.vue
@@ -24,12 +24,10 @@ const formData = ref<MesMdClientApi.Client>();
 
 const isDetail = computed(() => formMode.value === 'detail'); // 是否查看模式
 const getTitle = computed(() => {
-  const titles: Record<FormMode, string> = {
-    create: '新增客户',
-    update: '修改客户',
-    detail: '查看客户',
-  };
-  return titles[formMode.value];
+  if (formMode.value === 'detail') {
+    return '查看客户';
+  }
+  return formMode.value === 'update' ? '修改客户' : '新增客户';
 });
 
 const [Form, formApi] = useVbenForm({
diff --git a/apps/web-antd/src/views/mes/md/item/modules/form.vue b/apps/web-antd/src/views/mes/md/item/modules/form.vue
index 53af2592f..40eeed34b 100644
--- a/apps/web-antd/src/views/mes/md/item/modules/form.vue
+++ b/apps/web-antd/src/views/mes/md/item/modules/form.vue
@@ -29,12 +29,10 @@ const barcodeDetailRef = ref<InstanceType<typeof BarcodeDetail>>(); // 条码详
 
 const isDetail = computed(() => formMode.value === 'detail'); // 是否查看模式
 const getTitle = computed(() => {
-  const titles: Record<FormMode, string> = {
-    create: '新增物料/产品',
-    update: '修改物料/产品',
-    detail: '查看物料/产品',
-  };
-  return titles[formMode.value];
+  if (formMode.value === 'detail') {
+    return '查看物料/产品';
+  }
+  return formMode.value === 'update' ? '修改物料/产品' : '新增物料/产品';
 });
 const currentItemOrProduct = computed(
   () => formData.value?.itemOrProduct || '',
diff --git a/apps/web-antd/src/views/mes/md/item/type/index.vue b/apps/web-antd/src/views/mes/md/item/type/index.vue
index c7f2333b1..ff10b86c4 100644
--- a/apps/web-antd/src/views/mes/md/item/type/index.vue
+++ b/apps/web-antd/src/views/mes/md/item/type/index.vue
@@ -4,7 +4,7 @@ import type { MesMdItemTypeApi } from '#/api/mes/md/item/type';
 
 import { ref } from 'vue';
 
-import { Page, useVbenModal } from '@vben/common-ui';
+import { DocAlert, Page, useVbenModal } from '@vben/common-ui';
 
 import { message } from 'ant-design-vue';
 
@@ -102,6 +102,12 @@ const [Grid, gridApi] = useVbenVxeGrid({
 
 <template>
   <Page auto-content-height>
+    <template #doc>
+      <DocAlert
+        title="【基础】物料产品、分类、计量单位"
+        url="https://doc.iocoder.cn/mes/md/product/"
+      />
+    </template>
     <FormModal @success="handleRefresh" />
     <Grid table-title="物料分类列表">
       <template #toolbar-tools>
diff --git a/apps/web-antd/src/views/mes/md/workstation/modules/form.vue b/apps/web-antd/src/views/mes/md/workstation/modules/form.vue
index b8983ebd3..e1358c8e6 100644
--- a/apps/web-antd/src/views/mes/md/workstation/modules/form.vue
+++ b/apps/web-antd/src/views/mes/md/workstation/modules/form.vue
@@ -32,12 +32,10 @@ const barcodeDetailRef = ref<InstanceType<typeof BarcodeDetail>>(); // 条码详
 
 const isDetail = computed(() => formMode.value === 'detail'); // 是否查看模式
 const getTitle = computed(() => {
-  const titles: Record<FormMode, string> = {
-    create: '新增工作站',
-    update: '修改工作站',
-    detail: '查看工作站',
-  };
-  return titles[formMode.value];
+  if (formMode.value === 'detail') {
+    return '查看工作站';
+  }
+  return formMode.value === 'update' ? '修改工作站' : '新增工作站';
 });
 
 const [Form, formApi] = useVbenForm({
diff --git a/apps/web-antd/src/views/mes/md/workstation/workshop/modules/form.vue b/apps/web-antd/src/views/mes/md/workstation/workshop/modules/form.vue
index b6c39452f..f09ab589e 100644
--- a/apps/web-antd/src/views/mes/md/workstation/workshop/modules/form.vue
+++ b/apps/web-antd/src/views/mes/md/workstation/workshop/modules/form.vue
@@ -28,12 +28,10 @@ const barcodeDetailRef = ref<InstanceType<typeof BarcodeDetail>>(); // 条码详
 
 const isDetail = computed(() => formMode.value === 'detail'); // 是否查看模式
 const getTitle = computed(() => {
-  const titles: Record<FormMode, string> = {
-    create: '新增车间',
-    update: '修改车间',
-    detail: '查看车间',
-  };
-  return titles[formMode.value];
+  if (formMode.value === 'detail') {
+    return '查看车间';
+  }
+  return formMode.value === 'update' ? '修改车间' : '新增车间';
 });
 
 const [Form, formApi] = useVbenForm({
diff --git a/apps/web-ele/src/api/mes/dv/machinery/index.ts b/apps/web-ele/src/api/mes/dv/machinery/index.ts
index e4c02f1c4..07a3190b6 100644
--- a/apps/web-ele/src/api/mes/dv/machinery/index.ts
+++ b/apps/web-ele/src/api/mes/dv/machinery/index.ts
@@ -20,6 +20,13 @@ export namespace MesDvMachineryApi {
     remark?: string; // 备注
     createTime?: Date; // 创建时间
   }
+
+  /** 设备导入结果 */
+  export interface MachineryImportRespVO {
+    createCodes?: string[]; // 新增成功的设备编码
+    failureCodes?: Record<string, string>; // 导入失败的设备编码及原因
+    updateCodes?: string[]; // 更新成功的设备编码
+  }
 }
 
 /** 查询设备分页 */
@@ -43,3 +50,36 @@ export function getMachinery(id: number) {
     `/mes/dv/machinery/get?id=${id}`,
   );
 }
+
+/** 新增设备 */
+export function createMachinery(data: MesDvMachineryApi.Machinery) {
+  return requestClient.post('/mes/dv/machinery/create', data);
+}
+
+/** 修改设备 */
+export function updateMachinery(data: MesDvMachineryApi.Machinery) {
+  return requestClient.put('/mes/dv/machinery/update', data);
+}
+
+/** 删除设备 */
+export function deleteMachinery(id: number) {
+  return requestClient.delete(`/mes/dv/machinery/delete?id=${id}`);
+}
+
+/** 导出设备 */
+export function exportMachinery(params: any) {
+  return requestClient.download('/mes/dv/machinery/export-excel', { params });
+}
+
+/** 下载设备导入模板 */
+export function importMachineryTemplate() {
+  return requestClient.download('/mes/dv/machinery/get-import-template');
+}
+
+/** 导入设备 */
+export function importMachinery(file: File, updateSupport: boolean) {
+  return requestClient.upload<MesDvMachineryApi.MachineryImportRespVO>(
+    `/mes/dv/machinery/import?updateSupport=${updateSupport}`,
+    { file },
+  );
+}
diff --git a/apps/web-ele/src/views/mes/cal/holiday/index.vue b/apps/web-ele/src/views/mes/cal/holiday/index.vue
index b72573b79..5c36d8b77 100644
--- a/apps/web-ele/src/views/mes/cal/holiday/index.vue
+++ b/apps/web-ele/src/views/mes/cal/holiday/index.vue
@@ -1,9 +1,7 @@
 <script lang="ts" setup>
 import type { Dayjs } from 'dayjs';
 
-import type { CalendarDateType } from 'element-plus';
-
-import { onMounted, ref, watch } from 'vue';
+import { computed, onMounted, ref, watch } from 'vue';
 
 import { useAccess } from '@vben/access';
 import { DocAlert, Page, useVbenModal } from '@vben/common-ui';
@@ -26,6 +24,14 @@ const holidaySet = ref(new Set<string>()); // 节假日日期集合
 const lastFetchedMonth = ref(''); // 上次加载月份
 const { hasAccessByCodes } = useAccess();
 
+/** ElCalendar v-model 桥接：内部用 Dayjs，组件需要 Date */
+const calendarValue = computed({
+  get: () => currentDate.value.toDate(),
+  set: (val: Date) => {
+    currentDate.value = dayjs(val);
+  },
+});
+
 const [HolidayFormModal, holidayFormModalApi] = useVbenModal({
   connectedComponent: HolidayForm,
   destroyOnClose: true,
@@ -55,7 +61,7 @@ async function getList() {
 }
 
 /** 点击日期：打开假期设置弹窗 */
-function handleDayClick(data: { day: string; type: CalendarDateType }) {
+function handleDayClick(data: { date: Date; day: string; type: string }) {
   // 非当前月日期，不处理（避免切换月份）
   if (data.type !== 'current-month') {
     return;
@@ -130,7 +136,7 @@ onMounted(getList);
     </template>
     <HolidayFormModal @success="getList" />
     <div class="bg-card overflow-hidden rounded-md">
-      <ElCalendar v-model="currentDate" class="mes-holiday-calendar">
+      <ElCalendar v-model="calendarValue" class="mes-holiday-calendar">
         <template #date-cell="{ data }">
           <div
             class="hover:bg-muted/50 h-full cursor-pointer p-1 text-left transition"
diff --git a/apps/web-ele/src/views/mes/cal/plan/index.vue b/apps/web-ele/src/views/mes/cal/plan/index.vue
index 75c94baf1..3400ddd5a 100644
--- a/apps/web-ele/src/views/mes/cal/plan/index.vue
+++ b/apps/web-ele/src/views/mes/cal/plan/index.vue
@@ -2,7 +2,7 @@
 import type { VxeTableGridOptions } from '#/adapter/vxe-table';
 import type { MesCalPlanApi } from '#/api/mes/cal/plan';
 
-import { Page, useVbenModal } from '@vben/common-ui';
+import { DocAlert, Page, useVbenModal } from '@vben/common-ui';
 import { downloadFileFromBlobPart } from '@vben/utils';
 
 import { ElButton, ElLoading, ElMessage } from 'element-plus';
@@ -86,6 +86,12 @@ const [Grid, gridApi] = useVbenVxeGrid({
 
 <template>
   <Page auto-content-height>
+    <template #doc>
+      <DocAlert
+        title="【排班】排班计划、排班日历"
+        url="https://doc.iocoder.cn/mes/cal/calendar/"
+      />
+    </template>
     <FormModal @success="handleRefresh" />
     <Grid table-title="排班计划列表">
       <template #toolbar-tools>
diff --git a/apps/web-ele/src/views/mes/cal/team/index.vue b/apps/web-ele/src/views/mes/cal/team/index.vue
index 700bc0b2b..723b68782 100644
--- a/apps/web-ele/src/views/mes/cal/team/index.vue
+++ b/apps/web-ele/src/views/mes/cal/team/index.vue
@@ -2,7 +2,7 @@
 import type { VxeTableGridOptions } from '#/adapter/vxe-table';
 import type { MesCalTeamApi } from '#/api/mes/cal/team';
 
-import { Page, useVbenModal } from '@vben/common-ui';
+import { DocAlert, Page, useVbenModal } from '@vben/common-ui';
 import { downloadFileFromBlobPart } from '@vben/utils';
 
 import { ElButton, ElLoading, ElMessage } from 'element-plus';
@@ -90,6 +90,12 @@ const [Grid, gridApi] = useVbenVxeGrid({
 
 <template>
   <Page auto-content-height>
+    <template #doc>
+      <DocAlert
+        title="【排班】班组设置、节假日设置"
+        url="https://doc.iocoder.cn/mes/cal/team/"
+      />
+    </template>
     <FormModal @success="handleRefresh" />
     <Grid table-title="班组列表">
       <template #toolbar-tools>
diff --git a/apps/web-ele/src/views/mes/dv/checkplan/index.vue b/apps/web-ele/src/views/mes/dv/checkplan/index.vue
index b3ff98571..493af75d0 100644
--- a/apps/web-ele/src/views/mes/dv/checkplan/index.vue
+++ b/apps/web-ele/src/views/mes/dv/checkplan/index.vue
@@ -3,7 +3,7 @@ import type { VxeTableGridOptions } from '#/adapter/vxe-table';
 import type { MesDvCheckPlanApi } from '#/api/mes/dv/checkplan';
 import type { ActionItem } from '#/components/table-action/typing';
 
-import { Page, useVbenModal } from '@vben/common-ui';
+import { DocAlert, Page, useVbenModal } from '@vben/common-ui';
 import { downloadFileFromBlobPart } from '@vben/utils';
 
 import { ElButton, ElLoading, ElMessage } from 'element-plus';
@@ -156,6 +156,12 @@ const [Grid, gridApi] = useVbenVxeGrid({
 </script>
 <template>
   <Page auto-content-height>
+    <template #doc>
+      <DocAlert
+        title="【设备】点检保养项目、点检保养方案"
+        url="https://doc.iocoder.cn/mes/dv/check-plan/"
+      />
+    </template>
     <FormModal @success="handleRefresh" />
     <Grid table-title="点检保养方案列表">
       <template #toolbar-tools>
diff --git a/apps/web-ele/src/views/mes/dv/checkplan/modules/form.vue b/apps/web-ele/src/views/mes/dv/checkplan/modules/form.vue
index bd9d76e80..14b3a5b5f 100644
--- a/apps/web-ele/src/views/mes/dv/checkplan/modules/form.vue
+++ b/apps/web-ele/src/views/mes/dv/checkplan/modules/form.vue
@@ -23,12 +23,12 @@ const formMode = ref<FormMode>('create');
 const subTabsName = ref('machinery');
 const formData = ref<MesDvCheckPlanApi.CheckPlan>();
 const isDetail = computed(() => formMode.value === 'detail');
-const getTitle = computed(
-  () =>
-    ({ create: '新增点检保养方案', update: '修改点检保养方案', detail: '查看点检保养方案' })[
-      formMode.value
-    ],
-);
+const getTitle = computed(() => {
+  if (formMode.value === 'detail') {
+    return '查看点检保养方案';
+  }
+  return formMode.value === 'update' ? '修改点检保养方案' : '新增点检保养方案';
+});
 
 const [Form, formApi] = useVbenForm({
   commonConfig: {
@@ -43,6 +43,8 @@ const [Form, formApi] = useVbenForm({
   schema: [],
   showDefaultActions: false,
 });
+
+/** 表单 schema 需要 formApi 引用，所以通过 setState 设置 schema */
 formApi.setState({ schema: useFormSchema(formApi) });
 
 const [Modal, modalApi] = useVbenModal({
diff --git a/apps/web-ele/src/views/mes/dv/checkrecord/index.vue b/apps/web-ele/src/views/mes/dv/checkrecord/index.vue
index e6973e32f..f29ff2d05 100644
--- a/apps/web-ele/src/views/mes/dv/checkrecord/index.vue
+++ b/apps/web-ele/src/views/mes/dv/checkrecord/index.vue
@@ -2,7 +2,7 @@
 import type { VxeTableGridOptions } from '#/adapter/vxe-table';
 import type { MesDvCheckRecordApi } from '#/api/mes/dv/checkrecord';
 
-import { Page, useVbenModal } from '@vben/common-ui';
+import { DocAlert, Page, useVbenModal } from '@vben/common-ui';
 import { downloadFileFromBlobPart } from '@vben/utils';
 
 import { ElButton, ElLoading, ElMessage } from 'element-plus';
@@ -91,6 +91,12 @@ const [Grid, gridApi] = useVbenVxeGrid({
 </script>
 <template>
   <Page auto-content-height>
+    <template #doc>
+      <DocAlert
+        title="【设备】点检记录、保养记录、维修单"
+        url="https://doc.iocoder.cn/mes/dv/check-record/"
+      />
+    </template>
     <FormModal @success="handleRefresh" />
     <Grid table-title="点检记录列表">
       <template #toolbar-tools>
diff --git a/apps/web-ele/src/views/mes/dv/checkrecord/modules/form.vue b/apps/web-ele/src/views/mes/dv/checkrecord/modules/form.vue
index ec4f86bdc..cbbc3557a 100644
--- a/apps/web-ele/src/views/mes/dv/checkrecord/modules/form.vue
+++ b/apps/web-ele/src/views/mes/dv/checkrecord/modules/form.vue
@@ -29,10 +29,12 @@ const isDetail = computed(() => formMode.value === 'detail');
 const canSubmit = computed(
   () => formMode.value === 'update' && formData.value?.status === MesDvCheckRecordStatusEnum.DRAFT,
 );
-const getTitle = computed(
-  () =>
-    ({ create: '新增点检记录', update: '修改点检记录', detail: '查看点检记录' })[formMode.value],
-);
+const getTitle = computed(() => {
+  if (formMode.value === 'detail') {
+    return '查看点检记录';
+  }
+  return formMode.value === 'update' ? '修改点检记录' : '新增点检记录';
+});
 
 const [Form, formApi] = useVbenForm({
   commonConfig: {
diff --git a/apps/web-ele/src/views/mes/dv/machinery/index.vue b/apps/web-ele/src/views/mes/dv/machinery/index.vue
index df5b632b5..97b0adde5 100644
--- a/apps/web-ele/src/views/mes/dv/machinery/index.vue
+++ b/apps/web-ele/src/views/mes/dv/machinery/index.vue
@@ -5,7 +5,7 @@ import type { MesDvMachineryTypeApi } from '#/api/mes/dv/machinery/type';
 
 import { ref } from 'vue';
 
-import { Page, useVbenModal } from '@vben/common-ui';
+import { DocAlert, Page, useVbenModal } from '@vben/common-ui';
 import { downloadFileFromBlobPart } from '@vben/utils';
 
 import { ElButton, ElLoading, ElMessage } from 'element-plus';
@@ -112,6 +112,12 @@ const [Grid, gridApi] = useVbenVxeGrid({
 
 <template>
   <Page auto-content-height>
+    <template #doc>
+      <DocAlert
+        title="【设备】设备类型、设备台账"
+        url="https://doc.iocoder.cn/mes/dv/device/"
+      />
+    </template>
     <FormModal @success="handleRefresh" />
     <ImportModal @success="handleRefresh" />
     <div class="flex h-full w-full">
diff --git a/apps/web-ele/src/views/mes/dv/machinery/modules/form.vue b/apps/web-ele/src/views/mes/dv/machinery/modules/form.vue
index 67cf156da..4165ef0bf 100644
--- a/apps/web-ele/src/views/mes/dv/machinery/modules/form.vue
+++ b/apps/web-ele/src/views/mes/dv/machinery/modules/form.vue
@@ -26,9 +26,12 @@ const subTabsName = ref('check'); // 当前资源页签
 const formData = ref<MesDvMachineryApi.Machinery>();
 const barcodeDetailRef = ref<InstanceType<typeof BarcodeDetail>>(); // 条码详情弹窗
 const isDetail = computed(() => formMode.value === 'detail'); // 是否查看模式
-const getTitle = computed(
-  () => ({ create: '新增设备', update: '修改设备', detail: '查看设备' })[formMode.value],
-);
+const getTitle = computed(() => {
+  if (formMode.value === 'detail') {
+    return '查看设备';
+  }
+  return formMode.value === 'update' ? '修改设备' : '新增设备';
+});
 
 const [Form, formApi] = useVbenForm({
   commonConfig: {
@@ -43,6 +46,8 @@ const [Form, formApi] = useVbenForm({
   schema: [],
   showDefaultActions: false,
 });
+
+/** 表单 schema 需要 formApi 引用，所以通过 setState 设置 schema */
 formApi.setState({ schema: useFormSchema(formApi, formMode) });
 
 /** 查看设备条码 */
diff --git a/apps/web-ele/src/views/mes/dv/machinery/type/index.vue b/apps/web-ele/src/views/mes/dv/machinery/type/index.vue
index ecde7c3c8..96a81dc2d 100644
--- a/apps/web-ele/src/views/mes/dv/machinery/type/index.vue
+++ b/apps/web-ele/src/views/mes/dv/machinery/type/index.vue
@@ -4,7 +4,7 @@ import type { MesDvMachineryTypeApi } from '#/api/mes/dv/machinery/type';
 
 import { ref } from 'vue';
 
-import { Page, useVbenModal } from '@vben/common-ui';
+import { DocAlert, Page, useVbenModal } from '@vben/common-ui';
 import { handleTree } from '@vben/utils';
 
 import { ElLoading, ElMessage } from 'element-plus';
@@ -35,13 +35,18 @@ function handleRefresh() {
 }
 
 /** 创建设备类型 */
-function handleCreate(parentId = 0) {
-  formModalApi.setData({ parentId, type: 'create' }).open();
+function handleCreate() {
+  formModalApi.setData(null).open();
+}
+
+/** 添加下级设备类型 */
+function handleAppend(row: MesDvMachineryTypeApi.MachineryType) {
+  formModalApi.setData({ parentId: row.id }).open();
 }
 
 /** 编辑设备类型 */
 function handleEdit(row: MesDvMachineryTypeApi.MachineryType) {
-  formModalApi.setData({ id: row.id, type: 'update' }).open();
+  formModalApi.setData(row).open();
 }
 
 /** 删除设备类型 */
@@ -93,6 +98,12 @@ const [Grid, gridApi] = useVbenVxeGrid({
 
 <template>
   <Page auto-content-height>
+    <template #doc>
+      <DocAlert
+        title="【设备】设备类型、设备台账"
+        url="https://doc.iocoder.cn/mes/dv/device/"
+      />
+    </template>
     <FormModal @success="handleRefresh" />
     <Grid table-title="设备类型列表">
       <template #toolbar-tools>
@@ -103,7 +114,7 @@ const [Grid, gridApi] = useVbenVxeGrid({
               type: 'primary',
               icon: ACTION_ICON.ADD,
               auth: ['mes:dv-machinery-type:create'],
-              onClick: handleCreate.bind(null, 0),
+              onClick: handleCreate,
             },
             {
               label: isExpanded ? '收缩' : '展开',
@@ -122,7 +133,7 @@ const [Grid, gridApi] = useVbenVxeGrid({
               link: true,
               icon: ACTION_ICON.ADD,
               auth: ['mes:dv-machinery-type:create'],
-              onClick: handleCreate.bind(null, row.id),
+              onClick: handleAppend.bind(null, row),
             },
             {
               label: $t('common.edit'),
diff --git a/apps/web-ele/src/views/mes/dv/machinery/type/modules/form.vue b/apps/web-ele/src/views/mes/dv/machinery/type/modules/form.vue
index 4426721c9..5a3aae39c 100644
--- a/apps/web-ele/src/views/mes/dv/machinery/type/modules/form.vue
+++ b/apps/web-ele/src/views/mes/dv/machinery/type/modules/form.vue
@@ -17,10 +17,13 @@ import { $t } from '#/locales';
 
 import { useFormSchema } from '../data';
 
-
 const emit = defineEmits(['success']);
-const formMode = ref<'create' | 'update'>('create'); // 表单模式
-const getTitle = computed(() => (formMode.value === 'create' ? '新增设备类型' : '修改设备类型'));
+const formData = ref<MesDvMachineryTypeApi.MachineryType>();
+const getTitle = computed(() => {
+  return formData.value?.id
+    ? $t('ui.actionTitle.edit', ['设备类型'])
+    : $t('ui.actionTitle.create', ['设备类型']);
+});
 
 const [Form, formApi] = useVbenForm({
   commonConfig: {
@@ -48,7 +51,10 @@ const [Modal, modalApi] = useVbenModal({
     // 提交表单
     const data = (await formApi.getValues()) as MesDvMachineryTypeApi.MachineryType;
     try {
-      await (data.id ? updateMachineryType(data) : createMachineryType(data));
+      await (formData.value?.id
+        ? updateMachineryType(data)
+        : createMachineryType(data));
+      // 关闭并提示
       await modalApi.close();
       emit('success');
       ElMessage.success($t('ui.actionMessage.operationSuccess'));
@@ -58,18 +64,25 @@ const [Modal, modalApi] = useVbenModal({
   },
   async onOpenChange(isOpen: boolean) {
     if (!isOpen) {
+      formData.value = undefined;
       return;
     }
     await formApi.resetForm();
-    const data = modalApi.getData<{ id?: number; parentId?: number; type?: 'create' | 'update' }>();
-    formMode.value = data?.type || 'create';
-    if (!data?.id) {
-      await formApi.setValues({ parentId: data?.parentId ?? 0 });
+    // 加载数据
+    const data = modalApi.getData<MesDvMachineryTypeApi.MachineryType>();
+    if (!data || !data.id) {
+      formData.value = data || undefined;
+      if (data) {
+        // 设置上级类型
+        await formApi.setValues(data);
+      }
       return;
     }
     modalApi.lock();
     try {
-      await formApi.setValues(await getMachineryType(data.id));
+      formData.value = await getMachineryType(data.id);
+      // 设置到 values
+      await formApi.setValues(formData.value);
     } finally {
       modalApi.unlock();
     }
diff --git a/apps/web-ele/src/views/mes/dv/maintenrecord/index.vue b/apps/web-ele/src/views/mes/dv/maintenrecord/index.vue
index 0e6a3b738..b2d7045c9 100644
--- a/apps/web-ele/src/views/mes/dv/maintenrecord/index.vue
+++ b/apps/web-ele/src/views/mes/dv/maintenrecord/index.vue
@@ -2,7 +2,7 @@
 import type { VxeTableGridOptions } from '#/adapter/vxe-table';
 import type { MesDvMaintenRecordApi } from '#/api/mes/dv/maintenrecord';
 
-import { Page, useVbenModal } from '@vben/common-ui';
+import { DocAlert, Page, useVbenModal } from '@vben/common-ui';
 import { downloadFileFromBlobPart } from '@vben/utils';
 
 import { ElButton, ElLoading, ElMessage } from 'element-plus';
@@ -95,6 +95,12 @@ const [Grid, gridApi] = useVbenVxeGrid({
 </script>
 <template>
   <Page auto-content-height>
+    <template #doc>
+      <DocAlert
+        title="【设备】点检记录、保养记录、维修单"
+        url="https://doc.iocoder.cn/mes/dv/check-record/"
+      />
+    </template>
     <FormModal @success="handleRefresh" />
     <Grid table-title="保养记录列表">
       <template #toolbar-tools>
diff --git a/apps/web-ele/src/views/mes/dv/maintenrecord/modules/form.vue b/apps/web-ele/src/views/mes/dv/maintenrecord/modules/form.vue
index 596530b8b..2aa64705f 100644
--- a/apps/web-ele/src/views/mes/dv/maintenrecord/modules/form.vue
+++ b/apps/web-ele/src/views/mes/dv/maintenrecord/modules/form.vue
@@ -32,10 +32,12 @@ const canSubmit = computed(
   () =>
     formMode.value === 'update' && formData.value?.status === MesDvMaintenRecordStatusEnum.PREPARE,
 );
-const getTitle = computed(
-  () =>
-    ({ create: '新增保养记录', update: '修改保养记录', detail: '查看保养记录' })[formMode.value],
-);
+const getTitle = computed(() => {
+  if (formMode.value === 'detail') {
+    return '查看保养记录';
+  }
+  return formMode.value === 'update' ? '修改保养记录' : '新增保养记录';
+});
 
 const [Form, formApi] = useVbenForm({
   commonConfig: {
diff --git a/apps/web-ele/src/views/mes/dv/repair/index.vue b/apps/web-ele/src/views/mes/dv/repair/index.vue
index fd2e6f7fd..0b765e81b 100644
--- a/apps/web-ele/src/views/mes/dv/repair/index.vue
+++ b/apps/web-ele/src/views/mes/dv/repair/index.vue
@@ -2,7 +2,7 @@
 import type { VxeTableGridOptions } from '#/adapter/vxe-table';
 import type { MesDvRepairApi } from '#/api/mes/dv/repair';
 
-import { Page, useVbenModal } from '@vben/common-ui';
+import { DocAlert, Page, useVbenModal } from '@vben/common-ui';
 import { downloadFileFromBlobPart } from '@vben/utils';
 
 import { ElButton, ElLoading, ElMessage } from 'element-plus';
@@ -95,6 +95,12 @@ const [Grid, gridApi] = useVbenVxeGrid({
 </script>
 <template>
   <Page auto-content-height>
+    <template #doc>
+      <DocAlert
+        title="【设备】点检记录、保养记录、维修单"
+        url="https://doc.iocoder.cn/mes/dv/check-record/"
+      />
+    </template>
     <FormModal @success="handleRefresh" />
     <Grid table-title="维修工单列表">
       <template #toolbar-tools>
diff --git a/apps/web-ele/src/views/mes/dv/repair/modules/form.vue b/apps/web-ele/src/views/mes/dv/repair/modules/form.vue
index 81f5699aa..a50e83cdb 100644
--- a/apps/web-ele/src/views/mes/dv/repair/modules/form.vue
+++ b/apps/web-ele/src/views/mes/dv/repair/modules/form.vue
@@ -56,6 +56,8 @@ const [Form, formApi] = useVbenForm({
   schema: [],
   showDefaultActions: false,
 });
+
+/** 表单 schema 需要 formApi 引用，所以通过 setState 设置 schema */
 formApi.setState({ schema: useFormSchema(formApi) });
 
 /** 提交维修工单 */
diff --git a/apps/web-ele/src/views/mes/dv/subject/index.vue b/apps/web-ele/src/views/mes/dv/subject/index.vue
index 53ac51d00..336a80cd1 100644
--- a/apps/web-ele/src/views/mes/dv/subject/index.vue
+++ b/apps/web-ele/src/views/mes/dv/subject/index.vue
@@ -2,7 +2,7 @@
 import type { VxeTableGridOptions } from '#/adapter/vxe-table';
 import type { MesDvSubjectApi } from '#/api/mes/dv/subject';
 
-import { Page, useVbenModal } from '@vben/common-ui';
+import { DocAlert, Page, useVbenModal } from '@vben/common-ui';
 import { downloadFileFromBlobPart } from '@vben/utils';
 
 import { ElButton, ElLoading, ElMessage } from 'element-plus';
@@ -89,6 +89,12 @@ const [Grid, gridApi] = useVbenVxeGrid({
 
 <template>
   <Page auto-content-height>
+    <template #doc>
+      <DocAlert
+        title="【设备】点检保养项目、点检保养方案"
+        url="https://doc.iocoder.cn/mes/dv/check-plan/"
+      />
+    </template>
     <FormModal @success="handleRefresh" />
     <Grid table-title="点检保养项目列表">
       <template #toolbar-tools>
diff --git a/apps/web-ele/src/views/mes/dv/subject/modules/form.vue b/apps/web-ele/src/views/mes/dv/subject/modules/form.vue
index 5987d5cfd..5608a0023 100644
--- a/apps/web-ele/src/views/mes/dv/subject/modules/form.vue
+++ b/apps/web-ele/src/views/mes/dv/subject/modules/form.vue
@@ -18,12 +18,12 @@ type FormMode = 'create' | 'detail' | 'update';
 const emit = defineEmits(['success']);
 const formMode = ref<FormMode>('create'); // 表单模式
 const isDetail = computed(() => formMode.value === 'detail'); // 是否查看模式
-const getTitle = computed(
-  () =>
-    ({ create: '新增点检保养项目', update: '修改点检保养项目', detail: '查看点检保养项目' })[
-      formMode.value
-    ],
-);
+const getTitle = computed(() => {
+  if (formMode.value === 'detail') {
+    return '查看点检保养项目';
+  }
+  return formMode.value === 'update' ? '修改点检保养项目' : '新增点检保养项目';
+});
 
 const [Form, formApi] = useVbenForm({
   commonConfig: {
@@ -38,6 +38,8 @@ const [Form, formApi] = useVbenForm({
   schema: [],
   showDefaultActions: false,
 });
+
+/** 表单 schema 需要 formApi 引用，所以通过 setState 设置 schema */
 formApi.setState({ schema: useFormSchema(formApi) });
 
 const [Modal, modalApi] = useVbenModal({
diff --git a/apps/web-ele/src/views/mes/md/client/modules/form.vue b/apps/web-ele/src/views/mes/md/client/modules/form.vue
index 1c003ef0c..5b0fa0f41 100644
--- a/apps/web-ele/src/views/mes/md/client/modules/form.vue
+++ b/apps/web-ele/src/views/mes/md/client/modules/form.vue
@@ -24,12 +24,10 @@ const formData = ref<MesMdClientApi.Client>();
 
 const isDetail = computed(() => formMode.value === 'detail'); // 是否查看模式
 const getTitle = computed(() => {
-  const titles: Record<FormMode, string> = {
-    create: '新增客户',
-    update: '修改客户',
-    detail: '查看客户',
-  };
-  return titles[formMode.value];
+  if (formMode.value === 'detail') {
+    return '查看客户';
+  }
+  return formMode.value === 'update' ? '修改客户' : '新增客户';
 });
 
 const [Form, formApi] = useVbenForm({
diff --git a/apps/web-ele/src/views/mes/md/item/modules/form.vue b/apps/web-ele/src/views/mes/md/item/modules/form.vue
index b29e9a957..b9681d9e9 100644
--- a/apps/web-ele/src/views/mes/md/item/modules/form.vue
+++ b/apps/web-ele/src/views/mes/md/item/modules/form.vue
@@ -29,12 +29,10 @@ const barcodeDetailRef = ref<InstanceType<typeof BarcodeDetail>>(); // 条码详
 
 const isDetail = computed(() => formMode.value === 'detail'); // 是否查看模式
 const getTitle = computed(() => {
-  const titles: Record<FormMode, string> = {
-    create: '新增物料/产品',
-    update: '修改物料/产品',
-    detail: '查看物料/产品',
-  };
-  return titles[formMode.value];
+  if (formMode.value === 'detail') {
+    return '查看物料/产品';
+  }
+  return formMode.value === 'update' ? '修改物料/产品' : '新增物料/产品';
 });
 const currentItemOrProduct = computed(
   () => formData.value?.itemOrProduct || '',
diff --git a/apps/web-ele/src/views/mes/md/item/type/index.vue b/apps/web-ele/src/views/mes/md/item/type/index.vue
index dceaef395..be0612713 100644
--- a/apps/web-ele/src/views/mes/md/item/type/index.vue
+++ b/apps/web-ele/src/views/mes/md/item/type/index.vue
@@ -4,7 +4,7 @@ import type { MesMdItemTypeApi } from '#/api/mes/md/item/type';
 
 import { ref } from 'vue';
 
-import { Page, useVbenModal } from '@vben/common-ui';
+import { DocAlert, Page, useVbenModal } from '@vben/common-ui';
 
 import { ElLoading, ElMessage } from 'element-plus';
 
@@ -101,6 +101,12 @@ const [Grid, gridApi] = useVbenVxeGrid({
 
 <template>
   <Page auto-content-height>
+    <template #doc>
+      <DocAlert
+        title="【基础】物料产品、分类、计量单位"
+        url="https://doc.iocoder.cn/mes/md/product/"
+      />
+    </template>
     <FormModal @success="handleRefresh" />
     <Grid table-title="物料分类列表">
       <template #toolbar-tools>
diff --git a/apps/web-ele/src/views/mes/md/workstation/modules/form.vue b/apps/web-ele/src/views/mes/md/workstation/modules/form.vue
index f43deb8a0..b8680ca88 100644
--- a/apps/web-ele/src/views/mes/md/workstation/modules/form.vue
+++ b/apps/web-ele/src/views/mes/md/workstation/modules/form.vue
@@ -32,12 +32,10 @@ const barcodeDetailRef = ref<InstanceType<typeof BarcodeDetail>>(); // 条码详
 
 const isDetail = computed(() => formMode.value === 'detail'); // 是否查看模式
 const getTitle = computed(() => {
-  const titles: Record<FormMode, string> = {
-    create: '新增工作站',
-    update: '修改工作站',
-    detail: '查看工作站',
-  };
-  return titles[formMode.value];
+  if (formMode.value === 'detail') {
+    return '查看工作站';
+  }
+  return formMode.value === 'update' ? '修改工作站' : '新增工作站';
 });
 
 const [Form, formApi] = useVbenForm({
diff --git a/apps/web-ele/src/views/mes/md/workstation/workshop/modules/form.vue b/apps/web-ele/src/views/mes/md/workstation/workshop/modules/form.vue
index b2a7b3a96..822009e42 100644
--- a/apps/web-ele/src/views/mes/md/workstation/workshop/modules/form.vue
+++ b/apps/web-ele/src/views/mes/md/workstation/workshop/modules/form.vue
@@ -28,12 +28,10 @@ const barcodeDetailRef = ref<InstanceType<typeof BarcodeDetail>>(); // 条码详
 
 const isDetail = computed(() => formMode.value === 'detail'); // 是否查看模式
 const getTitle = computed(() => {
-  const titles: Record<FormMode, string> = {
-    create: '新增车间',
-    update: '修改车间',
-    detail: '查看车间',
-  };
-  return titles[formMode.value];
+  if (formMode.value === 'detail') {
+    return '查看车间';
+  }
+  return formMode.value === 'update' ? '修改车间' : '新增车间';
 });
 
 const [Form, formApi] = useVbenForm({