From f98cef8c71d1b62d5e591ef150a8a6f8b3f95325 Mon Sep 17 00:00:00 2001
From: YunaiV <zhijiantianya@gmail.com>
Date: Sun, 5 Oct 2025 09:00:39 +0800
Subject: [PATCH] =?UTF-8?q?feat=EF=BC=9A=E3=80=90antd=E3=80=91=E3=80=90erp?=
 =?UTF-8?q?=20=E7=B3=BB=E7=BB=9F=E3=80=91stock/check=201/1=20=E9=87=8D?=
 =?UTF-8?q?=E6=9E=84=E5=AE=8C=E6=88=90?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../src/views/erp/stock/check/data.ts         | 168 ++++----
 .../src/views/erp/stock/check/index.vue       | 154 ++++----
 .../views/erp/stock/check/modules/form.vue    | 119 ++----
 .../erp/stock/check/modules/item-form.vue     | 308 +++++++++++++++
 .../check/modules/stock-check-item-form.vue   | 374 ------------------
 5 files changed, 497 insertions(+), 626 deletions(-)
 create mode 100644 apps/web-antd/src/views/erp/stock/check/modules/item-form.vue
 delete mode 100644 apps/web-antd/src/views/erp/stock/check/modules/stock-check-item-form.vue

diff --git a/apps/web-antd/src/views/erp/stock/check/data.ts b/apps/web-antd/src/views/erp/stock/check/data.ts
index 95b3e9fcc..36ddef0e3 100644
--- a/apps/web-antd/src/views/erp/stock/check/data.ts
+++ b/apps/web-antd/src/views/erp/stock/check/data.ts
@@ -4,62 +4,58 @@ import type { VxeTableGridOptions } from '#/adapter/vxe-table';
 import { DICT_TYPE } from '@vben/constants';
 import { getDictOptions } from '@vben/hooks';
 
-import { createRequiredValidation } from '#/adapter/vxe-table';
 import { getProductSimpleList } from '#/api/erp/product/product';
 import { getWarehouseSimpleList } from '#/api/erp/stock/warehouse';
 import { getSimpleUserList } from '#/api/system/user';
+import { getRangePickerDefaultProps } from '#/utils';
 
 /** 表单的配置项 */
 export function useFormSchema(formType: string): VbenFormSchema[] {
   return [
     {
-      component: 'Input',
-      componentProps: {
-        style: { display: 'none' },
-      },
       fieldName: 'id',
-      label: 'ID',
-      hideLabel: true,
-      formItemClass: 'hidden',
+      component: 'Input',
+      dependencies: {
+        triggerFields: [''],
+        show: () => false,
+      },
     },
     {
+      fieldName: 'no',
+      label: '盘点单号',
       component: 'Input',
       componentProps: {
         placeholder: '系统自动生成',
         disabled: true,
       },
-      fieldName: 'no',
-      label: '盘点单号',
     },
     {
+      fieldName: 'checkTime',
+      label: '盘点时间',
       component: 'DatePicker',
       componentProps: {
         placeholder: '选择盘点时间',
         showTime: true,
         format: 'YYYY-MM-DD HH:mm:ss',
         valueFormat: 'x',
-        style: { width: '100%' },
       },
-      disabled: formType === 'detail',
-      fieldName: 'checkTime',
-      label: '盘点时间',
       rules: 'required',
     },
     {
+      fieldName: 'remark',
+      label: '备注',
       component: 'Textarea',
       componentProps: {
         placeholder: '请输入备注',
-        autoSize: { minRows: 2, maxRows: 4 },
-        class: 'w-full',
+        autoSize: { minRows: 1, maxRows: 1 },
+        disabled: formType === 'detail',
       },
-      disabled: formType === 'detail',
-      fieldName: 'remark',
-      label: '备注',
-      formItemClass: 'col-span-3',
+      formItemClass: 'col-span-2',
     },
     {
+      fieldName: 'fileUrl',
+      label: '附件',
       component: 'FileUpload',
-      disabled: formType === 'detail',
       componentProps: {
         maxNumber: 1,
         maxSize: 10,
@@ -74,15 +70,13 @@ export function useFormSchema(formType: string): VbenFormSchema[] {
           'jpeg',
           'png',
         ],
-        showDescription: true,
+        showDescription: formType !== 'detail',
+        disabled: formType === 'detail',
       },
-      fieldName: 'fileUrl',
-      label: '附件',
       formItemClass: 'col-span-3',
     },
     {
-      fieldName: 'product',
-      disabled: formType === 'detail',
+      fieldName: 'items',
       label: '产品清单',
       component: 'Input',
       formItemClass: 'col-span-3',
@@ -90,10 +84,8 @@ export function useFormSchema(formType: string): VbenFormSchema[] {
   ];
 }
 
-/** 库存盘点清单表格列定义 */
-export function useStockCheckItemTableColumns(
-  isValidating?: any,
-): VxeTableGridOptions['columns'] {
+/** 表单的明细表格列 */
+export function useFormItemColumns(): VxeTableGridOptions['columns'] {
   return [
     { type: 'seq', title: '序号', minWidth: 50, fixed: 'left' },
     {
@@ -101,19 +93,17 @@ export function useStockCheckItemTableColumns(
       title: '仓库名称',
       minWidth: 150,
       slots: { default: 'warehouseId' },
-      className: createRequiredValidation(isValidating, 'warehouseId'),
     },
     {
       field: 'productId',
       title: '产品名称',
       minWidth: 200,
       slots: { default: 'productId' },
-      className: createRequiredValidation(isValidating, 'productId'),
     },
     {
       field: 'stockCount',
       title: '账面库存',
-      minWidth: 100,
+      minWidth: 80,
     },
     {
       field: 'productBarCode',
@@ -125,38 +115,40 @@ export function useStockCheckItemTableColumns(
       title: '单位',
       minWidth: 80,
     },
+    {
+      field: 'remark',
+      title: '备注',
+      minWidth: 150,
+      slots: { default: 'remark' },
+    },
     {
       field: 'actualCount',
       title: '实际库存',
       minWidth: 120,
+      fixed: 'right',
       slots: { default: 'actualCount' },
-      className: createRequiredValidation(isValidating, 'actualCount'),
     },
     {
       field: 'count',
       title: '盈亏数量',
       minWidth: 120,
-      slots: { default: 'count' },
-      className: createRequiredValidation(isValidating, 'count'),
+      fixed: 'right',
+      formatter: 'formatAmount3',
     },
     {
       field: 'productPrice',
       title: '产品单价',
       minWidth: 120,
+      fixed: 'right',
       slots: { default: 'productPrice' },
     },
     {
       field: 'totalPrice',
-      title: '合计金额',
+      title: '金额',
       minWidth: 120,
+      fixed: 'right',
       formatter: 'formatAmount2',
     },
-    {
-      field: 'remark',
-      title: '备注',
-      minWidth: 150,
-      slots: { default: 'remark' },
-    },
     {
       title: '操作',
       width: 50,
@@ -187,8 +179,10 @@ export function useGridFormSchema(): VbenFormSchema[] {
         allowClear: true,
         showSearch: true,
         api: getProductSimpleList,
-        labelField: 'name',
-        valueField: 'id',
+        fieldNames: {
+          label: 'name',
+          value: 'id',
+        },
       },
     },
     {
@@ -196,10 +190,8 @@ export function useGridFormSchema(): VbenFormSchema[] {
       label: '盘点时间',
       component: 'RangePicker',
       componentProps: {
-        placeholder: ['开始日期', '结束日期'],
-        showTime: true,
-        format: 'YYYY-MM-DD HH:mm:ss',
-        valueFormat: 'YYYY-MM-DD HH:mm:ss',
+        ...getRangePickerDefaultProps(),
+        allowClear: true,
       },
     },
     {
@@ -211,27 +203,10 @@ export function useGridFormSchema(): VbenFormSchema[] {
         allowClear: true,
         showSearch: true,
         api: getWarehouseSimpleList,
-        labelField: 'name',
-        valueField: 'id',
-      },
-    },
-    {
-      fieldName: 'status',
-      label: '状态',
-      component: 'Select',
-      componentProps: {
-        placeholder: '请选择状态',
-        allowClear: true,
-        options: getDictOptions(DICT_TYPE.ERP_AUDIT_STATUS, 'number'),
-      },
-    },
-    {
-      fieldName: 'remark',
-      label: '备注',
-      component: 'Input',
-      componentProps: {
-        placeholder: '请输入备注',
-        allowClear: true,
+        fieldNames: {
+          label: 'name',
+          value: 'id',
+        },
       },
     },
     {
@@ -243,8 +218,29 @@ export function useGridFormSchema(): VbenFormSchema[] {
         allowClear: true,
         showSearch: true,
         api: getSimpleUserList,
-        labelField: 'nickname',
-        valueField: 'id',
+        fieldNames: {
+          label: 'nickname',
+          value: 'id',
+        },
+      },
+    },
+    {
+      fieldName: 'status',
+      label: '状态',
+      component: 'Select',
+      componentProps: {
+        options: getDictOptions(DICT_TYPE.ERP_AUDIT_STATUS, 'number'),
+        placeholder: '请选择状态',
+        allowClear: true,
+      },
+    },
+    {
+      fieldName: 'remark',
+      label: '备注',
+      component: 'Input',
+      componentProps: {
+        placeholder: '请输入备注',
+        allowClear: true,
       },
     },
   ];
@@ -261,44 +257,42 @@ export function useGridColumns(): VxeTableGridOptions['columns'] {
     {
       field: 'no',
       title: '盘点单号',
-      minWidth: 180,
+      width: 200,
+      fixed: 'left',
     },
     {
       field: 'productNames',
       title: '产品信息',
-      minWidth: 200,
       showOverflow: 'tooltip',
+      minWidth: 120,
     },
     {
       field: 'checkTime',
-      title: '出库时间',
-      minWidth: 180,
-      cellRender: {
-        name: 'CellDateTime',
-      },
+      title: '盘点时间',
+      width: 160,
+      formatter: 'formatDate',
     },
     {
       field: 'creatorName',
       title: '创建人',
-      minWidth: 100,
+      minWidth: 120,
     },
     {
       field: 'totalCount',
-      title: '数量',
+      title: '总数量',
       formatter: 'formatAmount3',
-      minWidth: 100,
+      minWidth: 120,
     },
     {
       field: 'totalPrice',
-      title: '金额',
+      title: '总金额',
       formatter: 'formatAmount2',
-      minWidth: 100,
+      minWidth: 120,
     },
     {
       field: 'status',
       title: '状态',
-      minWidth: 90,
-      fixed: 'right',
+      minWidth: 120,
       cellRender: {
         name: 'CellDict',
         props: { type: DICT_TYPE.ERP_AUDIT_STATUS },
@@ -306,7 +300,7 @@ export function useGridColumns(): VxeTableGridOptions['columns'] {
     },
     {
       title: '操作',
-      width: 300,
+      width: 220,
       fixed: 'right',
       slots: { default: 'actions' },
     },
diff --git a/apps/web-antd/src/views/erp/stock/check/index.vue b/apps/web-antd/src/views/erp/stock/check/index.vue
index 941f8eba8..e41dda017 100644
--- a/apps/web-antd/src/views/erp/stock/check/index.vue
+++ b/apps/web-antd/src/views/erp/stock/check/index.vue
@@ -2,8 +2,10 @@
 import type { VxeTableGridOptions } from '#/adapter/vxe-table';
 import type { ErpStockCheckApi } from '#/api/erp/stock/check';
 
+import { ref } from 'vue';
+
 import { DocAlert, Page, useVbenModal } from '@vben/common-ui';
-import { downloadFileFromBlobPart } from '@vben/utils';
+import { downloadFileFromBlobPart, isEmpty } from '@vben/utils';
 
 import { message } from 'ant-design-vue';
 
@@ -17,71 +19,84 @@ import {
 import { $t } from '#/locales';
 
 import { useGridColumns, useGridFormSchema } from './data';
-import StockInForm from './modules/form.vue';
+import Form from './modules/form.vue';
 
-/** 库存盘点管理 */
+/** ERP 库存盘点单列表 */
 defineOptions({ name: 'ErpStockCheck' });
 
 const [FormModal, formModalApi] = useVbenModal({
-  connectedComponent: StockInForm,
+  connectedComponent: Form,
   destroyOnClose: true,
 });
 
 /** 刷新表格 */
-function onRefresh() {
+function handleRefresh() {
   gridApi.query();
 }
 
-/** 导出库存盘点单 */
+/** 导出表格 */
 async function handleExport() {
   const data = await exportStockCheck(await gridApi.formApi.getValues());
   downloadFileFromBlobPart({ fileName: '库存盘点单.xls', source: data });
 }
 
-/** 新增/编辑/详情 */
-function openForm(type: string, id?: number) {
-  formModalApi.setData({ type, id }).open();
+/** 新增库存盘点单 */
+function handleCreate() {
+  formModalApi.setData({ type: 'create' }).open();
 }
 
-/** 删除 */
-async function handleDelete(ids: any[]) {
+/** 编辑库存盘点单 */
+function handleEdit(row: ErpStockCheckApi.StockCheck) {
+  formModalApi.setData({ type: 'edit', id: row.id }).open();
+}
+
+/** 删除库存盘点单 */
+async function handleDelete(ids: number[]) {
   const hideLoading = message.loading({
-    content: '删除中...',
+    content: $t('ui.actionMessage.deleting'),
     duration: 0,
-    key: 'action_process_msg',
   });
   try {
     await deleteStockCheck(ids);
-    message.success({
-      content: '删除成功',
-      key: 'action_process_msg',
-    });
-    onRefresh();
+    message.success($t('ui.actionMessage.deleteSuccess'));
+    handleRefresh();
   } finally {
     hideLoading();
   }
 }
 
-/** 审核/反审核 */
-async function handleUpdateStatus(id: any, status: number) {
-  const statusText = status === 20 ? '审核' : '反审核';
+/** 审批/反审批操作 */
+async function handleUpdateStatus(
+  row: ErpStockCheckApi.StockCheck,
+  status: number,
+) {
   const hideLoading = message.loading({
-    content: `${statusText}中...`,
+    content: `确定${status === 20 ? '审批' : '反审批'}该盘点单吗？`,
     duration: 0,
-    key: 'action_process_msg',
   });
   try {
-    await updateStockCheckStatus({ id, status });
-    message.success({
-      content: `${statusText}成功`,
-      key: 'action_process_msg',
-    });
-    onRefresh();
+    await updateStockCheckStatus({ id: row.id!, status });
+    message.success(`${status === 20 ? '审批' : '反审批'}成功`);
+    handleRefresh();
   } finally {
     hideLoading();
   }
 }
 
+const checkedIds = ref<number[]>([]);
+function handleRowCheckboxChange({
+  records,
+}: {
+  records: ErpStockCheckApi.StockCheck[];
+}) {
+  checkedIds.value = records.map((item) => item.id!);
+}
+
+/** 查看详情 */
+function handleDetail(row: ErpStockCheckApi.StockCheck) {
+  formModalApi.setData({ type: 'detail', id: row.id }).open();
+}
+
 const [Grid, gridApi] = useVbenVxeGrid({
   formOptions: {
     schema: useGridFormSchema(),
@@ -103,15 +118,17 @@ const [Grid, gridApi] = useVbenVxeGrid({
     },
     rowConfig: {
       keyField: 'id',
+      isHover: true,
     },
     toolbarConfig: {
       refresh: true,
       search: true,
     },
-    checkboxConfig: {
-      reserve: true,
-    },
   } as VxeTableGridOptions<ErpStockCheckApi.StockCheck>,
+  gridEvents: {
+    checkboxAll: handleRowCheckboxChange,
+    checkboxChange: handleRowCheckboxChange,
+  },
 });
 </script>
 
@@ -123,97 +140,86 @@ const [Grid, gridApi] = useVbenVxeGrid({
         url="https://doc.iocoder.cn/erp/stock-move-check/"
       />
     </template>
+
+    <FormModal @success="handleRefresh" />
     <Grid table-title="库存盘点单列表">
       <template #toolbar-tools>
         <TableAction
           :actions="[
             {
-              label: $t('ui.actionTitle.create', ['库存盘点']),
+              label: $t('ui.actionTitle.create', ['库存盘点单']),
               type: 'primary',
               icon: ACTION_ICON.ADD,
               auth: ['erp:stock-check:create'],
-              onClick: () => openForm('create'),
+              onClick: handleCreate,
             },
             {
               label: $t('ui.actionTitle.export'),
-              type: 'default',
+              type: 'primary',
               icon: ACTION_ICON.DOWNLOAD,
               auth: ['erp:stock-check:export'],
               onClick: handleExport,
             },
             {
               label: '批量删除',
-              type: 'default',
+              type: 'primary',
               danger: true,
+              disabled: isEmpty(checkedIds),
               icon: ACTION_ICON.DELETE,
               auth: ['erp:stock-check:delete'],
               popConfirm: {
-                title: '是否删除所选中数据？',
-                confirm: () => {
-                  const checkboxRecords = gridApi.grid.getCheckboxRecords();
-                  if (checkboxRecords.length === 0) {
-                    message.warning('请选择要删除的数据');
-                    return;
-                  }
-                  handleDelete(checkboxRecords.map((item) => item.id));
-                },
+                title: `是否删除所选中数据？`,
+                confirm: handleDelete.bind(null, checkedIds),
               },
             },
           ]"
         />
       </template>
-
       <template #actions="{ row }">
         <TableAction
           :actions="[
             {
-              label: '详情',
+              label: $t('common.detail'),
+              type: 'link',
               icon: ACTION_ICON.VIEW,
               auth: ['erp:stock-check:query'],
-              onClick: () => openForm('detail', row.id),
+              onClick: handleDetail.bind(null, row),
             },
             {
-              label: '编辑',
-              auth: ['erp:stock-check:update'],
+              label: $t('common.edit'),
+              type: 'link',
               icon: ACTION_ICON.EDIT,
-              disabled: row.status !== 10,
-              onClick: () => openForm('update', row.id),
+              auth: ['erp:stock-check:update'],
+              ifShow: () => row.status !== 20,
+              onClick: handleEdit.bind(null, row),
             },
             {
-              label: '审核',
-              auth: ['erp:stock-check:update'],
-              ifShow: row.status === 10,
+              label: row.status === 10 ? '审批' : '反审批',
+              type: 'link',
+              auth: ['erp:stock-check:update-status'],
               popConfirm: {
-                title: '确认要审核该盘点单吗？',
-                confirm: () => handleUpdateStatus(row.id, 20),
+                title: `确认${row.status === 10 ? '审批' : '反审批'}${row.no}吗？`,
+                confirm: handleUpdateStatus.bind(
+                  null,
+                  row,
+                  row.status === 10 ? 20 : 10,
+                ),
               },
             },
             {
-              label: '反审核',
-              danger: true,
-              auth: ['erp:stock-check:update'],
-              ifShow: row.status === 20,
-              popConfirm: {
-                title: '确认要反审核该盘点单吗？',
-                confirm: () => handleUpdateStatus(row.id, 10),
-              },
-            },
-            {
-              label: '删除',
+              label: $t('common.delete'),
+              type: 'link',
               danger: true,
+              color: 'error',
               auth: ['erp:stock-check:delete'],
-              disabled: row.status !== 10,
               popConfirm: {
-                title: '确认要删除该盘点单吗？',
-                confirm: () => handleDelete([row.id]),
+                title: $t('ui.actionMessage.deleteConfirm', [row.no]),
+                confirm: handleDelete.bind(null, [row.id!]),
               },
             },
           ]"
         />
       </template>
     </Grid>
-
-    <!-- 表单弹窗 -->
-    <FormModal @success="onRefresh" />
   </Page>
 </template>
diff --git a/apps/web-antd/src/views/erp/stock/check/modules/form.vue b/apps/web-antd/src/views/erp/stock/check/modules/form.vue
index 7999e0038..96eb0c969 100644
--- a/apps/web-antd/src/views/erp/stock/check/modules/form.vue
+++ b/apps/web-antd/src/views/erp/stock/check/modules/form.vue
@@ -1,7 +1,7 @@
 <script lang="ts" setup>
 import type { ErpStockCheckApi } from '#/api/erp/stock/check';
 
-import { computed, nextTick, ref } from 'vue';
+import { computed, ref } from 'vue';
 
 import { useVbenModal } from '@vben/common-ui';
 
@@ -12,22 +12,25 @@ import {
   createStockCheck,
   getStockCheck,
   updateStockCheck,
-  updateStockCheckStatus,
 } from '#/api/erp/stock/check';
+import { $t } from '#/locales';
 
 import { useFormSchema } from '../data';
-import StockInItemForm from './stock-check-item-form.vue';
+import ItemForm from './item-form.vue';
 
 const emit = defineEmits(['success']);
 const formData = ref<ErpStockCheckApi.StockCheck>();
-const formType = ref('');
-const itemFormRef = ref();
+const formType = ref(''); // 表单类型：'create' | 'edit' | 'detail'
+const itemFormRef = ref<InstanceType<typeof ItemForm>>();
 
-const getTitle = computed(() => {
-  if (formType.value === 'create') return '添加库存盘点单';
-  if (formType.value === 'update') return '编辑库存盘点单';
-  return '库存盘点单详情';
-});
+/* eslint-disable unicorn/no-nested-ternary */
+const getTitle = computed(() =>
+  formType.value === 'create'
+    ? $t('ui.actionTitle.create', ['库存盘点单'])
+    : formType.value === 'edit'
+      ? $t('ui.actionTitle.edit', ['库存盘点单'])
+      : '库存盘点单详情',
+);
 
 const [Form, formApi] = useVbenForm({
   commonConfig: {
@@ -42,11 +45,13 @@ const [Form, formApi] = useVbenForm({
   showDefaultActions: false,
 });
 
+/** 更新盘点单项 */
 const handleUpdateItems = (items: ErpStockCheckApi.StockCheckItem[]) => {
   formData.value = modalApi.getData<ErpStockCheckApi.StockCheck>();
-  if (formData.value) {
-    formData.value.items = items;
-  }
+  formData.value.items = items;
+  formApi.setValues({
+    items,
+  });
 };
 
 /** 创建或更新库存盘点单 */
@@ -56,44 +61,19 @@ const [Modal, modalApi] = useVbenModal({
     if (!valid) {
       return;
     }
-    await nextTick();
-
     const itemFormInstance = Array.isArray(itemFormRef.value)
       ? itemFormRef.value[0]
       : itemFormRef.value;
-    if (itemFormInstance && typeof itemFormInstance.validate === 'function') {
-      try {
-        const isValid = await itemFormInstance.validate();
-        if (!isValid) {
-          message.error('产品清单验证失败，请检查必填项');
-          return;
-        }
-      } catch (error: any) {
-        message.error(error.message || '产品清单验证失败');
-        return;
-      }
-    } else {
-      message.error('产品清单验证方法不存在');
-      return;
-    }
-
-    // 验证产品清单不能为空
-    if (!formData.value?.items || formData.value.items.length === 0) {
-      message.error('产品清单不能为空，请至少添加一个产品');
+    try {
+      itemFormInstance.validate();
+    } catch (error: any) {
+      message.error(error.message || '子表单验证失败');
       return;
     }
 
     modalApi.lock();
     // 提交表单
     const data = (await formApi.getValues()) as ErpStockCheckApi.StockCheck;
-    data.items = formData.value?.items?.map((item) => ({
-      ...item,
-      id: undefined,
-    }));
-    // 将文件数组转换为字符串
-    if (data.fileUrl && Array.isArray(data.fileUrl)) {
-      data.fileUrl = data.fileUrl.length > 0 ? data.fileUrl[0] : '';
-    }
     try {
       await (formType.value === 'create'
         ? createStockCheck(data)
@@ -101,7 +81,7 @@ const [Modal, modalApi] = useVbenModal({
       // 关闭并提示
       await modalApi.close();
       emit('success');
-      message.success(formType.value === 'create' ? '新增成功' : '更新成功');
+      message.success($t('ui.actionMessage.operationSuccess'));
     } finally {
       modalApi.unlock();
     }
@@ -113,77 +93,34 @@ const [Modal, modalApi] = useVbenModal({
     }
     // 加载数据
     const data = modalApi.getData<{ id?: number; type: string }>();
-    if (!data) {
-      return;
-    }
     formType.value = data.type;
+    formApi.setDisabled(formType.value === 'detail');
     formApi.updateSchema(useFormSchema(formType.value));
-    if (!data.id) {
-      // 初始化空的表单数据
-      formData.value = { items: [] } as unknown as ErpStockCheckApi.StockCheck;
-      await nextTick();
-      const itemFormInstance = Array.isArray(itemFormRef.value)
-        ? itemFormRef.value[0]
-        : itemFormRef.value;
-      if (itemFormInstance && typeof itemFormInstance.init === 'function') {
-        itemFormInstance.init([]);
-      }
-      // 如果是新增，自动添加一行
-      if (formType.value === 'create' && itemFormInstance) {
-        itemFormInstance.handleAdd();
-      }
+    if (!data || !data.id) {
       return;
     }
-
     modalApi.lock();
     try {
       formData.value = await getStockCheck(data.id);
       // 设置到 values
       await formApi.setValues(formData.value);
-      // 初始化子表单
-      await nextTick();
-      const itemFormInstance = Array.isArray(itemFormRef.value)
-        ? itemFormRef.value[0]
-        : itemFormRef.value;
-      if (itemFormInstance && typeof itemFormInstance.init === 'function') {
-        itemFormInstance.init(formData.value.items || []);
-      }
     } finally {
       modalApi.unlock();
     }
   },
 });
-
-/** 审核/反审核 */
-async function handleUpdateStatus(id: number, status: number) {
-  try {
-    await updateStockCheckStatus({ id, status });
-    message.success(status === 20 ? '审核成功' : '反审核成功');
-    emit('success');
-    await modalApi.close();
-  } catch (error: any) {
-    message.error(error.message || '操作失败');
-  }
-}
-
-defineExpose({ modalApi, handleUpdateStatus });
 </script>
 
 <template>
   <Modal
-    v-bind="$attrs"
     :title="getTitle"
-    class="w-4/5"
-    :closable="true"
-    :mask-closable="true"
+    class="w-3/4"
     :show-confirm-button="formType !== 'detail'"
   >
     <Form class="mx-3">
-      <template #product="slotProps">
-        <StockInItemForm
-          v-bind="slotProps"
+      <template #items>
+        <ItemForm
           ref="itemFormRef"
-          class="w-full"
           :items="formData?.items ?? []"
           :disabled="formType === 'detail'"
           @update:items="handleUpdateItems"
diff --git a/apps/web-antd/src/views/erp/stock/check/modules/item-form.vue b/apps/web-antd/src/views/erp/stock/check/modules/item-form.vue
new file mode 100644
index 000000000..f9400c3b3
--- /dev/null
+++ b/apps/web-antd/src/views/erp/stock/check/modules/item-form.vue
@@ -0,0 +1,308 @@
+<script lang="ts" setup>
+import type { ErpProductApi } from '#/api/erp/product/product';
+import type { ErpStockCheckApi } from '#/api/erp/stock/check';
+
+import { computed, nextTick, onMounted, ref, watch } from 'vue';
+
+import {
+  erpCountInputFormatter,
+  erpPriceInputFormatter,
+  erpPriceMultiply,
+} from '@vben/utils';
+
+import { Input, InputNumber, Select } from 'ant-design-vue';
+
+import { TableAction, useVbenVxeGrid } from '#/adapter/vxe-table';
+import { getProductSimpleList } from '#/api/erp/product/product';
+import { getStockCount } from '#/api/erp/stock/stock';
+import { getWarehouseSimpleList } from '#/api/erp/stock/warehouse';
+
+import { useFormItemColumns } from '../data';
+
+interface Props {
+  items?: ErpStockCheckApi.StockCheckItem[];
+  disabled?: boolean;
+}
+
+const props = withDefaults(defineProps<Props>(), {
+  items: () => [],
+  disabled: false,
+});
+
+const emit = defineEmits(['update:items']);
+
+const tableData = ref<ErpStockCheckApi.StockCheckItem[]>([]); // 表格数据
+const productOptions = ref<ErpProductApi.Product[]>([]); // 产品下拉选项
+const warehouseOptions = ref<any[]>([]); // 仓库下拉选项
+
+/** 获取表格合计数据 */
+const summaries = computed(() => {
+  return {
+    count: tableData.value.reduce((sum, item) => sum + (item.count || 0), 0),
+    totalPrice: tableData.value.reduce(
+      (sum, item) => sum + (item.totalPrice || 0),
+      0,
+    ),
+  };
+});
+
+/** 表格配置 */
+const [Grid, gridApi] = useVbenVxeGrid({
+  gridOptions: {
+    columns: useFormItemColumns(),
+    data: tableData.value,
+    minHeight: 250,
+    autoResize: true,
+    border: true,
+    rowConfig: {
+      keyField: 'row_id',
+      isHover: true,
+    },
+    pagerConfig: {
+      enabled: false,
+    },
+    toolbarConfig: {
+      enabled: false,
+    },
+  },
+});
+
+/** 监听外部传入的列数据 */
+watch(
+  () => props.items,
+  async (items) => {
+    if (!items) {
+      return;
+    }
+    items.forEach((item) => initRow(item));
+    tableData.value = [...items];
+    await nextTick(); // 特殊：保证 gridApi 已经初始化
+    await gridApi.grid.reloadData(tableData.value);
+  },
+  {
+    immediate: true,
+  },
+);
+
+/** 处理新增 */
+function handleAdd() {
+  const newRow = {
+    id: undefined,
+    warehouseId: undefined,
+    productId: undefined,
+    productUnitName: undefined, // 产品单位
+    productBarCode: undefined, // 产品条码
+    productPrice: undefined,
+    stockCount: undefined,
+    actualCount: undefined,
+    count: undefined,
+    totalPrice: undefined,
+    remark: undefined,
+  };
+  tableData.value.push(newRow);
+  // 通知父组件更新
+  emit('update:items', [...tableData.value]);
+}
+
+/** 处理删除 */
+function handleDelete(row: ErpStockCheckApi.StockCheckItem) {
+  const index = tableData.value.findIndex((item) => item.id === row.id);
+  if (index !== -1) {
+    tableData.value.splice(index, 1);
+  }
+  // 通知父组件更新
+  emit('update:items', [...tableData.value]);
+}
+
+/** 处理仓库变更 */
+async function handleWarehouseChange(warehouseId: any, row: any) {
+  const warehouse = warehouseOptions.value.find((w) => w.id === warehouseId);
+  if (!warehouse) {
+    return;
+  }
+  row.warehouseId = warehouseId;
+
+  // 如果已选择产品，重新获取库存
+  if (row.productId) {
+    row.stockCount = (await getStockCount(row.productId, warehouseId)) || 0;
+  }
+
+  handleRowChange(row);
+}
+
+/** 处理产品变更 */
+async function handleProductChange(productId: any, row: any) {
+  const product = productOptions.value.find((p) => p.id === productId);
+  if (!product) {
+    return;
+  }
+  row.productId = productId;
+  row.productUnitId = product.unitId;
+  row.productBarCode = product.barCode;
+  row.productUnitName = product.unitName;
+  row.productName = product.name;
+  row.stockCount = row.warehouseId
+    ? (await getStockCount(productId, row.warehouseId)) || 0
+    : (await getStockCount(productId)) || 0;
+  row.actualCount = row.stockCount || 0;
+  row.productPrice = product.purchasePrice || 0;
+  row.count = row.actualCount - row.stockCount || 0;
+  handleRowChange(row);
+}
+
+/** 处理实际库存变更 */
+function handleActualCountChange(actualCount: any, row: any) {
+  row.actualCount = actualCount;
+  if (row.stockCount !== undefined && row.actualCount !== undefined) {
+    row.count = row.actualCount - row.stockCount;
+    if (row.productPrice && row.count) {
+      row.totalPrice = erpPriceMultiply(row.productPrice, row.count) ?? 0;
+    }
+  }
+  handleRowChange(row);
+}
+
+/** 处理行数据变更 */
+function handleRowChange(row: any) {
+  const index = tableData.value.findIndex((item) => item.id === row.id);
+  if (index === -1) {
+    tableData.value.push(row);
+  } else {
+    tableData.value[index] = row;
+  }
+  emit('update:items', [...tableData.value]);
+}
+
+/** 初始化行数据 */
+const initRow = (row: ErpStockCheckApi.StockCheckItem): void => {
+  if (row.productPrice && row.count) {
+    row.totalPrice = erpPriceMultiply(row.productPrice, row.count) ?? 0;
+  }
+};
+
+/** 表单校验 */
+function validate() {
+  for (let i = 0; i < tableData.value.length; i++) {
+    const item = tableData.value[i];
+    if (item) {
+      if (!item.warehouseId) {
+        throw new Error(`第 ${i + 1} 行：仓库不能为空`);
+      }
+      if (!item.productId) {
+        throw new Error(`第 ${i + 1} 行：产品不能为空`);
+      }
+      if (!item.actualCount || item.actualCount <= 0) {
+        throw new Error(`第 ${i + 1} 行：实际库存不能为空`);
+      }
+    }
+  }
+}
+
+defineExpose({
+  validate,
+});
+
+/** 初始化 */
+onMounted(async () => {
+  productOptions.value = await getProductSimpleList();
+  warehouseOptions.value = await getWarehouseSimpleList();
+  // 目的：新增时，默认添加一行
+  if (tableData.value.length === 0) {
+    handleAdd();
+  }
+});
+</script>
+
+<template>
+  <Grid class="w-full">
+    <template #warehouseId="{ row }">
+      <Select
+        v-model:value="row.warehouseId"
+        :options="warehouseOptions"
+        :field-names="{ label: 'name', value: 'id' }"
+        class="w-full"
+        placeholder="请选择仓库"
+        show-search
+        :disabled="disabled"
+        @change="handleWarehouseChange($event, row)"
+      />
+    </template>
+    <template #productId="{ row }">
+      <Select
+        v-model:value="row.productId"
+        :options="productOptions"
+        :field-names="{ label: 'name', value: 'id' }"
+        class="w-full"
+        placeholder="请选择产品"
+        show-search
+        :disabled="disabled"
+        @change="handleProductChange($event, row)"
+      />
+    </template>
+    <template #actualCount="{ row }">
+      <InputNumber
+        v-if="!disabled"
+        v-model:value="row.actualCount"
+        :min="0"
+        :precision="3"
+        @change="handleActualCountChange($event, row)"
+      />
+      <span v-else>{{ row.actualCount || '-' }}</span>
+    </template>
+    <template #productPrice="{ row }">
+      <InputNumber
+        v-if="!disabled"
+        v-model:value="row.productPrice"
+        :min="0"
+        :precision="2"
+        @change="handleRowChange(row)"
+      />
+      <span v-else>{{ row.productPrice || '-' }}</span>
+    </template>
+    <template #remark="{ row }">
+      <Input v-if="!disabled" v-model:value="row.remark" class="w-full" />
+      <span v-else>{{ row.remark || '-' }}</span>
+    </template>
+    <template #actions="{ row }">
+      <TableAction
+        v-if="!disabled"
+        :actions="[
+          {
+            label: '删除',
+            type: 'link',
+            danger: true,
+            popConfirm: {
+              title: '确认删除该产品吗？',
+              confirm: handleDelete.bind(null, row),
+            },
+          },
+        ]"
+      />
+    </template>
+
+    <template #bottom>
+      <div class="border-border bg-muted mt-2 rounded border p-2">
+        <div class="text-muted-foreground flex justify-between text-sm">
+          <span class="text-foreground font-medium">合计：</span>
+          <div class="flex space-x-4">
+            <span>数量：{{ erpCountInputFormatter(summaries.count) }}</span>
+            <span>
+              金额：{{ erpPriceInputFormatter(summaries.totalPrice) }}
+            </span>
+          </div>
+        </div>
+      </div>
+      <TableAction
+        v-if="!disabled"
+        class="mt-2 flex justify-center"
+        :actions="[
+          {
+            label: '添加盘点产品',
+            type: 'default',
+            onClick: handleAdd,
+          },
+        ]"
+      />
+    </template>
+  </Grid>
+</template>
\ No newline at end of file
diff --git a/apps/web-antd/src/views/erp/stock/check/modules/stock-check-item-form.vue b/apps/web-antd/src/views/erp/stock/check/modules/stock-check-item-form.vue
deleted file mode 100644
index 90af5f7aa..000000000
--- a/apps/web-antd/src/views/erp/stock/check/modules/stock-check-item-form.vue
+++ /dev/null
@@ -1,374 +0,0 @@
-<script lang="ts" setup>
-import type { VxeTableGridOptions } from '#/adapter/vxe-table';
-import type { ErpStockCheckApi } from '#/api/erp/stock/check';
-
-import { nextTick, onMounted, ref, watch } from 'vue';
-
-import { erpPriceMultiply } from '@vben/utils';
-
-import { Input, InputNumber, Select } from 'ant-design-vue';
-
-import { TableAction, useVbenVxeGrid } from '#/adapter/vxe-table';
-import { getProductSimpleList } from '#/api/erp/product/product';
-import { getStockCount } from '#/api/erp/stock/stock';
-import { getWarehouseSimpleList } from '#/api/erp/stock/warehouse';
-
-import { useStockCheckItemTableColumns } from '../data';
-
-const props = withDefaults(defineProps<Props>(), {
-  items: () => [],
-  disabled: false,
-});
-
-const emit = defineEmits(['update:items']);
-
-interface Props {
-  items?: ErpStockCheckApi.StockCheckItem[];
-  disabled?: boolean;
-}
-
-const tableData = ref<ErpStockCheckApi.StockCheckItem[]>([]);
-const productOptions = ref<any[]>([]);
-const warehouseOptions = ref<any[]>([]);
-const isValidating = ref(false);
-
-/** 表格配置 */
-const [Grid, gridApi] = useVbenVxeGrid({
-  gridOptions: {
-    editConfig: {
-      trigger: 'click',
-      mode: 'cell',
-    },
-    columns: useStockCheckItemTableColumns(isValidating),
-    data: tableData.value,
-    border: true,
-    showOverflow: true,
-    autoResize: true,
-    minHeight: 250,
-    keepSource: true,
-    rowConfig: {
-      keyField: 'id',
-    },
-    pagerConfig: {
-      enabled: false,
-    },
-    toolbarConfig: {
-      enabled: false,
-    },
-    showFooter: true,
-    footerCellClassName: 'stock-in-footer-cell',
-    footerMethod: ({
-      columns,
-    }: {
-      columns: VxeTableGridOptions['columns'];
-    }) => {
-      const footers: any[][] = [];
-      const sums = getSummaries();
-      const footerData: any[] = [];
-      columns!.forEach((column, columnIndex: number) => {
-        if (columnIndex === 0) {
-          footerData.push('合计');
-        } else if (column.field === 'count') {
-          footerData.push(sums.count);
-        } else if (column.field === 'totalPrice') {
-          footerData.push(sums.totalPrice);
-        } else {
-          footerData.push('');
-        }
-      });
-      footers.push(footerData);
-      return footers;
-    },
-  },
-});
-
-/** 监听外部传入的列数据 */
-watch(
-  () => props.items,
-  async (items) => {
-    if (!items) {
-      return;
-    }
-    await nextTick();
-    tableData.value = [...items];
-    await nextTick();
-    await gridApi.grid.reloadData(tableData.value);
-  },
-  {
-    immediate: true,
-  },
-);
-
-/** 初始化 */
-onMounted(async () => {
-  productOptions.value = await getProductSimpleList();
-  warehouseOptions.value = await getWarehouseSimpleList();
-});
-
-function handleAdd() {
-  const newRow = {
-    warehouseId: undefined,
-    productId: undefined,
-    productName: '',
-    productUnitId: undefined,
-    productUnitName: '',
-    productBarCode: '',
-    count: 1,
-    productPrice: 0,
-    totalPrice: 0,
-    stockCount: 0,
-    remark: '',
-  };
-  tableData.value.push(newRow);
-  gridApi.grid.insertAt(newRow, -1);
-  emit('update:items', [...tableData.value]);
-  // 触发表格重新渲染以更新 cellClassName
-  // TODO @XuZhiqiang：使用 await 风格哈；
-  nextTick(() => {
-    gridApi.grid.refreshColumn();
-  });
-}
-
-function handleDelete(row: ErpStockCheckApi.StockCheckItem) {
-  gridApi.grid.remove(row);
-  const index = tableData.value.findIndex((item) => item.id === row.id);
-  if (index !== -1) {
-    tableData.value.splice(index, 1);
-  }
-  emit('update:items', [...tableData.value]);
-}
-
-async function handleWarehouseChange(warehouseId: any, row: any) {
-  const warehouse = warehouseOptions.value.find((w) => w.id === warehouseId);
-  if (!warehouse) {
-    return;
-  }
-
-  row.warehouseId = warehouseId;
-
-  // 如果已选择产品，重新获取库存
-  if (row.productId) {
-    const stockCount = await getStockCount(row.productId, warehouseId);
-    row.stockCount = stockCount || 0;
-  }
-
-  handleUpdateValue(row);
-}
-
-async function handleProductChange(productId: any, row: any) {
-  const product = productOptions.value.find((p) => p.id === productId);
-  if (!product) {
-    return;
-  }
-
-  // 获取库存数量
-  const stockCount = row.warehouseId
-    ? await getStockCount(productId, row.warehouseId)
-    : await getStockCount(productId);
-
-  row.productId = productId;
-  row.productUnitId = product.unitId;
-  row.productBarCode = product.barCode;
-  row.productUnitName = product.unitName;
-  row.productName = product.name;
-  row.stockCount = stockCount || 0;
-  row.actualCount = stockCount || 0;
-  row.productPrice = product.purchasePrice || 0;
-  row.count = 0;
-
-  handlePriceChange(row);
-}
-
-function handlePriceChange(row: any) {
-  if (row.productPrice && row.actualCount) {
-    row.count = row.actualCount - row.stockCount;
-    row.totalPrice = erpPriceMultiply(row.productPrice, row.count) ?? 0;
-  }
-  handleUpdateValue(row);
-}
-
-function handleUpdateValue(row: any) {
-  const index = tableData.value.findIndex((item) => item.id === row.id);
-  if (index === -1) {
-    tableData.value.push(row);
-  } else {
-    tableData.value[index] = row;
-  }
-  emit('update:items', [...tableData.value]);
-  // 触发表格重新渲染以更新cellClassName
-  nextTick(() => {
-    gridApi.grid.refreshColumn();
-  });
-}
-
-const getSummaries = (): {
-  count: number;
-  totalPrice: number;
-} => {
-  return {
-    count: tableData.value.reduce((sum, item) => sum + (item.count || 0), 0),
-    totalPrice: tableData.value.reduce(
-      (sum, item) => sum + (item.totalPrice || 0),
-      0,
-    ),
-  };
-};
-
-/** 验证表单 */
-function validate(): Promise<boolean> {
-  return new Promise((resolve) => {
-    isValidating.value = true;
-
-    // 触发表格重新渲染以显示验证错误
-    nextTick(() => {
-      gridApi.grid.refreshColumn();
-    });
-
-    // 验证是否有产品清单
-    if (!tableData.value || tableData.value.length === 0) {
-      resolve(false);
-      return;
-    }
-
-    // 验证每一行的必填字段
-    for (const item of tableData.value) {
-      if (!item.warehouseId || !item.productId || !item.actualCount) {
-        resolve(false);
-        return;
-      }
-    }
-
-    // 验证通过，清除验证状态
-    isValidating.value = false;
-    nextTick(() => {
-      gridApi.grid.refreshColumn();
-    });
-
-    resolve(true);
-  });
-}
-
-/** 初始化表格数据 */
-function init(items: ErpStockCheckApi.StockCheckItem[]) {
-  tableData.value = items || [];
-  gridApi.grid.reloadData(tableData.value);
-}
-
-defineExpose({
-  validate,
-  init,
-  handleAdd,
-});
-</script>
-
-<template>
-  <div class="w-full">
-    <div class="mb-4 flex justify-between">
-      <span class="text-lg font-medium"></span>
-    </div>
-
-    <Grid>
-      <template #warehouseId="{ row }">
-        <Select
-          v-model:value="row.warehouseId"
-          :options="warehouseOptions"
-          :field-names="{ label: 'name', value: 'id' }"
-          placeholder="请选择仓库"
-          :disabled="disabled"
-          show-search
-          @change="(value) => handleWarehouseChange(value, row)"
-          class="w-full"
-        />
-      </template>
-
-      <template #productId="{ row }">
-        <Select
-          v-model:value="row.productId"
-          :options="productOptions"
-          :field-names="{ label: 'name', value: 'id' }"
-          placeholder="请选择产品"
-          :disabled="disabled"
-          show-search
-          @change="(value) => handleProductChange(value, row)"
-          class="w-full"
-        />
-      </template>
-      <template #actualCount="{ row }">
-        <InputNumber
-          v-model:value="row.actualCount"
-          :disabled="disabled"
-          :min="0.001"
-          :precision="2"
-          @change="() => handlePriceChange(row)"
-          class="w-full"
-        />
-      </template>
-
-      <template #count="{ row }">
-        <InputNumber
-          v-model:value="row.count"
-          :disabled="true"
-          :min="0.001"
-          :precision="2"
-          class="w-full"
-        />
-      </template>
-
-      <template #productPrice="{ row }">
-        <InputNumber
-          v-model:value="row.productPrice"
-          :disabled="disabled"
-          :min="0.01"
-          :precision="2"
-          @change="() => handlePriceChange(row)"
-          class="w-full"
-        />
-      </template>
-
-      <template #remark="{ row }">
-        <Input
-          v-model:value="row.remark"
-          :disabled="disabled"
-          placeholder="请输入备注"
-        />
-      </template>
-
-      <template #actions="{ row }">
-        <TableAction
-          v-if="!disabled"
-          :actions="[
-            {
-              label: '删除',
-              type: 'link',
-              danger: true,
-              popConfirm: {
-                title: '确认删除该产品吗？',
-                confirm: handleDelete.bind(null, row),
-              },
-            },
-          ]"
-        />
-      </template>
-
-      <template #bottom>
-        <TableAction
-          v-if="!disabled"
-          class="mt-4 flex justify-center"
-          :actions="[
-            {
-              label: '添加产品',
-              type: 'default',
-              onClick: handleAdd,
-            },
-          ]"
-        />
-      </template>
-    </Grid>
-  </div>
-</template>
-
-<style scoped>
-:deep(.vxe-table .vxe-footer--column.stock-in-footer-cell .vxe-cell) {
-  background-color: #f5f5f5 !important;
-}
-</style>