From 2f21daecc1eb5a12f7c3ed8e5e36af014cd65cc6 Mon Sep 17 00:00:00 2001
From: YunaiV <zhijiantianya@gmail.com>
Date: Tue, 7 Apr 2026 12:26:19 +0800
Subject: [PATCH] =?UTF-8?q?=E2=99=BB=EF=B8=8F=20refactor(mes):=20=E7=A7=BB?=
 =?UTF-8?q?=E9=99=A4=E6=97=A0=E7=94=A8=E7=9A=84=E5=8F=91=E8=B4=A7=E9=80=9A?=
 =?UTF-8?q?=E7=9F=A5=E5=8D=95=E7=9B=B8=E5=85=B3=E4=BB=A3=E7=A0=81?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

删除了不再使用的发货通知单精简列表接口及相关逻辑，简化了代码结构，提高了可维护性。
---
 src/api/mes/wm/salesnotice/index.ts           |   7 +-
 .../components/WmSalesNoticeSelect.vue        | 198 ++++++++---
 .../components/WmSalesNoticeSelectDialog.vue  | 318 ++++++++++++++++++
 3 files changed, 464 insertions(+), 59 deletions(-)
 create mode 100644 src/views/mes/wm/salesnotice/components/WmSalesNoticeSelectDialog.vue

diff --git a/src/api/mes/wm/salesnotice/index.ts b/src/api/mes/wm/salesnotice/index.ts
index 059d11e61..aa89a2f5e 100644
--- a/src/api/mes/wm/salesnotice/index.ts
+++ b/src/api/mes/wm/salesnotice/index.ts
@@ -7,6 +7,8 @@ export interface WmSalesNoticeVO {
   noticeName: string
   salesOrderCode: string
   clientId: number
+  clientCode: string
+  clientName: string
   salesDate: string
   recipientName: string
   recipientTelephone: string
@@ -52,9 +54,4 @@ export const WmSalesNoticeApi = {
   exportSalesNotice: async (params: any) => {
     return await request.download({ url: '/mes/wm/sales-notice/export-excel', params })
   },
-
-  // 获取发货通知单精简列表
-  getSalesNoticeSimpleList: async (status?: number) => {
-    return await request.get({ url: '/mes/wm/sales-notice/simple-list', params: { status } })
-  }
 }
diff --git a/src/views/mes/wm/salesnotice/components/WmSalesNoticeSelect.vue b/src/views/mes/wm/salesnotice/components/WmSalesNoticeSelect.vue
index 346d79ff0..057b241df 100644
--- a/src/views/mes/wm/salesnotice/components/WmSalesNoticeSelect.vue
+++ b/src/views/mes/wm/salesnotice/components/WmSalesNoticeSelect.vue
@@ -1,43 +1,72 @@
-<!-- MES 发货通知单选择器：纯下拉，前端过滤（支持 noticeCode、noticeName） -->
+<!--
+  MES 发货通知单选择器：只读输入框 + 点击弹窗选择
+
+  交互：显示为只读 el-input，点击打开弹窗（单选模式）进行选择
+  Props:
+    modelValue  — 绑定的发货通知单 ID（v-model）
+    status      — 固定状态筛选（透传给 Dialog，限制可选范围）
+    disabled    — 是否禁用
+    clearable   — 是否允许清空（鼠标悬停时显示清除图标）
+    placeholder — 占位文字
+  Events:
+    update:modelValue — v-model 更新
+    change(item)      — 选中发货通知单变化时触发，传递完整 WmSalesNoticeVO（清空时为 undefined）
+-->
 <template>
-  <el-select
-    v-model="selectValue"
-    :placeholder="placeholder"
-    :disabled="disabled"
-    :clearable="clearable"
-    filterable
-    :filter-method="handleFilter"
-    class="!w-1/1"
-    @change="handleChange"
+  <div
+    v-bind="attrs"
+    class="w-full"
+    :class="disabled ? 'cursor-not-allowed' : 'cursor-pointer'"
+    @click="handleClick"
+    @mouseenter="hovering = true"
+    @mouseleave="hovering = false"
   >
-    <el-option
-      v-for="item in filteredList"
-      :key="item.id"
-      :label="item.noticeName"
-      :value="item.id"
-    >
-      <div class="flex items-center gap-8px">
-        <span>{{ item.noticeName }}</span>
-        <el-tag v-if="item.noticeCode" size="small" type="info" class="ml-4px">
-          编号: {{ item.noticeCode }}
-        </el-tag>
-      </div>
-    </el-option>
-  </el-select>
+    <el-tooltip :disabled="!selectedItem" placement="top" :show-after="500">
+      <template #content>
+        <div v-if="selectedItem" class="leading-6">
+          <div>编号：{{ selectedItem.noticeCode }}</div>
+          <div>名称：{{ selectedItem.noticeName || '-' }}</div>
+          <div>客户：{{ selectedItem.clientName || '-' }}</div>
+          <div>销售订单：{{ selectedItem.salesOrderCode || '-' }}</div>
+        </div>
+      </template>
+      <el-input
+        :model-value="displayLabel"
+        :placeholder="placeholder"
+        :disabled="disabled"
+        readonly
+        :suffix-icon="suffixIcon"
+        :class="disabled ? 'is-select-disabled' : 'is-select-clickable'"
+      />
+    </el-tooltip>
+  </div>
+  <!-- 弹窗必须放在 div 外部，否则弹窗内的点击事件会冒泡到 div 触发 handleClick -->
+  <WmSalesNoticeSelectDialog
+    ref="dialogRef"
+    :multiple="false"
+    :status="status"
+    @selected="handleSelected"
+  />
 </template>
 
 <script setup lang="ts">
 import { WmSalesNoticeApi, WmSalesNoticeVO } from '@/api/mes/wm/salesnotice'
+import { Search, CircleClose } from '@element-plus/icons-vue'
+import WmSalesNoticeSelectDialog from './WmSalesNoticeSelectDialog.vue'
 
-defineOptions({ name: 'WmSalesNoticeSelect' })
+// 组件有两个根节点（div + Dialog），Vue 不会自动继承 attrs；
+// 手动透传到外层 div，确保父组件传入的 class / style 等生效
+const attrs = useAttrs()
+
+defineOptions({ name: 'WmSalesNoticeSelect', inheritAttrs: false })
 
 const props = withDefaults(
   defineProps<{
-    modelValue?: number
-    disabled?: boolean
-    clearable?: boolean
-    placeholder?: string
-    status?: number
+    modelValue?: number // 绑定的发货通知单 ID
+    status?: number // 固定状态筛选
+    disabled?: boolean // 是否禁用
+    clearable?: boolean // 是否允许清空
+    placeholder?: string // 占位文字
   }>(),
   {
     disabled: false,
@@ -51,37 +80,98 @@ const emit = defineEmits<{
   change: [item: WmSalesNoticeVO | undefined]
 }>()
 
-const allList = ref<WmSalesNoticeVO[]>([])
-const filteredList = ref<WmSalesNoticeVO[]>([])
+const dialogRef = ref() // 弹窗 Ref
+const hovering = ref(false) // 鼠标是否悬停
 
-const selectValue = computed({
-  get: () => props.modelValue,
-  set: (val) => emit('update:modelValue', val)
+// ==================== 名称回显 ====================
+const selectedItem = ref<WmSalesNoticeVO | undefined>() // 当前选中的发货通知单对象
+
+/** 输入框显示文本：展示通知单名称，保持简洁 */
+const displayLabel = computed(() => {
+  return selectedItem.value?.noticeName ?? ''
 })
 
-/** 前端过滤（noticeCode + noticeName） */
-const handleFilter = (query: string) => {
-  if (!query) {
-    filteredList.value = allList.value
+/** 是否显示清除图标 */
+const showClear = computed(() => {
+  return props.clearable && !props.disabled && hovering.value && props.modelValue != null
+})
+
+/** 后缀图标：悬停且有值时显示清除，否则显示搜索 */
+const suffixIcon = computed(() => {
+  return showClear.value ? CircleClose : Search
+})
+
+/** 根据 ID 单条查询发货通知单信息（用于编辑回显） */
+const resolveItemById = async (id: number | undefined) => {
+  if (id == null) {
+    selectedItem.value = undefined
     return
   }
-  const keyword = query.toLowerCase()
-  filteredList.value = allList.value.filter(
-    (item) =>
-      item.noticeName?.toLowerCase().includes(keyword) ||
-      item.noticeCode?.toLowerCase().includes(keyword)
-  )
+  if (selectedItem.value?.id === id) {
+    return
+  }
+  try {
+    selectedItem.value = await WmSalesNoticeApi.getSalesNotice(id)
+  } catch (e) {
+    console.error('[WmSalesNoticeSelect] resolveItemById failed:', e)
+  }
 }
 
-/** 选中变化 */
-const handleChange = (val: number | undefined) => {
-  const item = allList.value.find((o) => o.id === val)
+/** 监听 modelValue 变化，触发回显 */
+watch(
+  () => props.modelValue,
+  (val) => {
+    resolveItemById(val)
+  },
+  { immediate: true }
+)
+
+// ==================== 点击交互 ====================
+
+/** 点击组件：清除或打开弹窗 */
+const handleClick = (e: MouseEvent) => {
+  if (props.disabled) {
+    return
+  }
+  // 点击清除图标：清空选中
+  const target = e.target as HTMLElement
+  if (showClear.value && target.closest('.el-input__suffix')) {
+    e.stopPropagation()
+    selectedItem.value = undefined
+    emit('update:modelValue', undefined)
+    emit('change', undefined)
+    return
+  }
+  // 打开弹窗，传入当前选中 ID 用于预选高亮
+  const selectedIds = props.modelValue != null ? [props.modelValue] : []
+  dialogRef.value.open(selectedIds)
+}
+
+/** 弹窗选中回调 */
+const handleSelected = (rows: WmSalesNoticeVO[]) => {
+  if (!rows || rows.length === 0) {
+    return
+  }
+  const item = rows[0]
+  selectedItem.value = item
+  emit('update:modelValue', item.id)
   emit('change', item)
 }
-
-/** 加载发货通知单列表 */
-onMounted(async () => {
-  allList.value = await WmSalesNoticeApi.getSalesNoticeSimpleList(props.status)
-  filteredList.value = allList.value
-})
 </script>
+
+<style lang="scss" scoped>
+/* :deep 用于穿透 el-input 内部元素的 cursor 样式，UnoCSS 无法直接处理组件内部 DOM */
+.is-select-clickable {
+  :deep(.el-input__wrapper),
+  :deep(.el-input__inner) {
+    cursor: pointer;
+  }
+}
+
+.is-select-disabled {
+  :deep(.el-input__wrapper),
+  :deep(.el-input__inner) {
+    cursor: not-allowed;
+  }
+}
+</style>
diff --git a/src/views/mes/wm/salesnotice/components/WmSalesNoticeSelectDialog.vue b/src/views/mes/wm/salesnotice/components/WmSalesNoticeSelectDialog.vue
new file mode 100644
index 000000000..9736d1b5d
--- /dev/null
+++ b/src/views/mes/wm/salesnotice/components/WmSalesNoticeSelectDialog.vue
@@ -0,0 +1,318 @@
+<!--
+  MES 发货通知单弹窗选择器（支持单选/多选）
+
+  Props:
+    multiple — true 多选（checkbox），false 单选（radio）；默认 true
+    status   — 固定状态筛选（传入后不展示状态下拉），不传时展示状态搜索框
+  Events:
+    selected(rows: WmSalesNoticeVO[]) — 确认选择后触发，单选时数组长度为 1
+  Expose:
+    open(selectedIds?: number[]) — 打开弹窗，可传入已选 ID 用于预选高亮
+-->
+<template>
+  <Dialog title="发货通知单选择" v-model="dialogVisible" width="70%">
+    <ContentWrap>
+      <el-form :inline="true" :model="queryParams" label-width="100px">
+        <el-form-item label="通知单编号">
+          <el-input
+            v-model="queryParams.noticeCode"
+            placeholder="请输入通知单编号"
+            clearable
+            @keyup.enter="handleQuery"
+            class="!w-220px"
+          />
+        </el-form-item>
+        <el-form-item label="通知单名称">
+          <el-input
+            v-model="queryParams.noticeName"
+            placeholder="请输入通知单名称"
+            clearable
+            @keyup.enter="handleQuery"
+            class="!w-220px"
+          />
+        </el-form-item>
+        <el-form-item label="销售订单编号">
+          <el-input
+            v-model="queryParams.salesOrderCode"
+            placeholder="请输入销售订单编号"
+            clearable
+            @keyup.enter="handleQuery"
+            class="!w-220px"
+          />
+        </el-form-item>
+        <el-form-item label="客户">
+          <MdClientSelect v-model="queryParams.clientId" class="!w-220px" />
+        </el-form-item>
+        <el-form-item v-if="props.status == null" label="单据状态">
+          <el-select
+            v-model="queryParams.status"
+            placeholder="请选择单据状态"
+            clearable
+            class="!w-220px"
+          >
+            <el-option
+              v-for="dict in getIntDictOptions(DICT_TYPE.MES_WM_SALES_NOTICE_STATUS)"
+              :key="dict.value"
+              :label="dict.label"
+              :value="dict.value"
+            />
+          </el-select>
+        </el-form-item>
+        <el-form-item>
+          <el-button @click="handleQuery">
+            <Icon icon="ep:search" class="mr-5px" /> 搜索
+          </el-button>
+          <el-button @click="resetQuery">
+            <Icon icon="ep:refresh" class="mr-5px" /> 重置
+          </el-button>
+        </el-form-item>
+      </el-form>
+    </ContentWrap>
+    <!-- 数据表格：单选 radio / 多选 checkbox 统一在一个 table 内 -->
+    <ContentWrap>
+      <el-table
+        ref="tableRef"
+        v-loading="loading"
+        :data="list"
+        :stripe="true"
+        :show-overflow-tooltip="true"
+        row-key="id"
+        :highlight-current-row="!multiple"
+        @selection-change="handleSelectionChange"
+        @row-click="handleRowClick"
+        @row-dblclick="handleRowDblClick"
+      >
+        <!-- 多选：checkbox（reserve-selection 保证跨页勾选不丢失） -->
+        <el-table-column
+          v-if="multiple"
+          type="selection"
+          :reserve-selection="true"
+          width="50"
+          align="center"
+        />
+        <!-- 单选：radio -->
+        <el-table-column v-else width="50" align="center">
+          <template #default="{ row }">
+            <el-radio
+              v-model="selectedRadioId"
+              :value="row.id"
+              class="radio-no-label"
+              @change="handleRadioChange(row)"
+            />
+          </template>
+        </el-table-column>
+        <el-table-column label="通知单编号" align="center" prop="noticeCode" width="180" />
+        <el-table-column label="通知单名称" align="left" prop="noticeName" min-width="150" />
+        <el-table-column label="销售订单编号" align="center" prop="salesOrderCode" width="160" />
+        <el-table-column label="客户名称" align="center" prop="clientName" width="120" />
+        <el-table-column label="发货日期" align="center" prop="salesDate" width="120">
+          <template #default="scope">
+            <span>{{ formatDate(scope.row.salesDate, 'YYYY-MM-DD') }}</span>
+          </template>
+        </el-table-column>
+        <el-table-column label="收货人" align="center" prop="recipientName" width="100" />
+        <el-table-column label="联系方式" align="center" prop="recipientTelephone" width="130" />
+        <el-table-column label="收货地址" align="center" prop="recipientAddress" min-width="200" />
+        <el-table-column label="单据状态" align="center" prop="status" width="100">
+          <template #default="scope">
+            <dict-tag :type="DICT_TYPE.MES_WM_SALES_NOTICE_STATUS" :value="scope.row.status" />
+          </template>
+        </el-table-column>
+      </el-table>
+      <Pagination
+        :total="total"
+        v-model:page="queryParams.pageNo"
+        v-model:limit="queryParams.pageSize"
+        @pagination="getList"
+      />
+    </ContentWrap>
+    <template #footer>
+      <el-button type="primary" @click="confirmSelect">确 定</el-button>
+      <el-button @click="dialogVisible = false">取 消</el-button>
+    </template>
+  </Dialog>
+</template>
+
+<script setup lang="ts">
+import { DICT_TYPE, getIntDictOptions } from '@/utils/dict'
+import { formatDate } from '@/utils/formatTime'
+import { WmSalesNoticeApi, WmSalesNoticeVO } from '@/api/mes/wm/salesnotice'
+import MdClientSelect from '@/views/mes/md/client/components/MdClientSelect.vue'
+
+defineOptions({ name: 'WmSalesNoticeSelectDialog' })
+
+const props = withDefaults(
+  defineProps<{
+    multiple?: boolean // true 多选（checkbox），false 单选（radio）
+    status?: number // 固定状态筛选（传入后该字段锁定，不展示搜索框）
+  }>(),
+  {
+    multiple: true
+  }
+)
+
+const message = useMessage()
+const emit = defineEmits<{
+  selected: [rows: WmSalesNoticeVO[]]
+}>()
+
+const dialogVisible = ref(false) // 弹窗是否展示
+const loading = ref(false) // 列表加载中
+const list = ref<WmSalesNoticeVO[]>([]) // 列表
+const total = ref(0) // 总条数
+
+// ==================== 选中状态 ====================
+const tableRef = ref() // 表格 Ref
+const selectedRows = ref<WmSalesNoticeVO[]>([]) // 多选模式：选中行
+const selectedRadioId = ref<number>() // 单选模式：选中 ID
+const currentRadioRow = ref<WmSalesNoticeVO>() // 单选模式：选中行对象
+const preSelectedIds = ref<number[]>([]) // 打开弹窗时传入的已选 ID
+
+/** 多选：checkbox 变化 */
+const handleSelectionChange = (rows: WmSalesNoticeVO[]) => {
+  if (props.multiple) {
+    selectedRows.value = rows
+  }
+}
+
+/** 单选：radio 变化 */
+const handleRadioChange = (row: WmSalesNoticeVO) => {
+  currentRadioRow.value = row
+}
+
+/** 单击行：单选模式下点击整行即选中（降低操作成本），多选不处理（避免和 dblclick 冲突） */
+const handleRowClick = (row: WmSalesNoticeVO) => {
+  if (props.multiple) {
+    return
+  }
+  selectedRadioId.value = row.id
+  currentRadioRow.value = row
+}
+
+/** 双击行：多选模式切换勾选，单选模式直接确认 */
+const handleRowDblClick = (row: WmSalesNoticeVO) => {
+  if (props.multiple) {
+    tableRef.value?.toggleRowSelection(row)
+    return
+  }
+  selectedRadioId.value = row.id
+  currentRadioRow.value = row
+  confirmSelect()
+}
+
+// ==================== 查询 ====================
+const queryParams = reactive({
+  pageNo: 1,
+  pageSize: 10,
+  noticeCode: undefined as string | undefined,
+  noticeName: undefined as string | undefined,
+  salesOrderCode: undefined as string | undefined,
+  clientId: undefined as number | undefined,
+  status: undefined as number | undefined
+})
+
+/** 查询列表 */
+const getList = async () => {
+  loading.value = true
+  try {
+    const data = await WmSalesNoticeApi.getSalesNoticePage(queryParams)
+    list.value = data.list
+    total.value = data.total
+    await nextTick()
+    applyPreSelection()
+  } finally {
+    loading.value = false
+  }
+}
+
+/** 恢复预选状态（当前页可见范围内） */
+const applyPreSelection = () => {
+  if (preSelectedIds.value.length === 0) {
+    return
+  }
+  if (props.multiple) {
+    const table = tableRef.value
+    if (!table) {
+      return
+    }
+    list.value.forEach((row) => {
+      if (preSelectedIds.value.includes(row.id)) {
+        table.toggleRowSelection(row, true)
+      }
+    })
+  } else {
+    const match = list.value.find((row) => preSelectedIds.value.includes(row.id))
+    if (match) {
+      selectedRadioId.value = match.id
+      currentRadioRow.value = match
+    }
+  }
+}
+
+/** 搜索按钮操作 */
+const handleQuery = () => {
+  queryParams.pageNo = 1
+  getList()
+}
+
+/** 重置查询条件 */
+const resetQuery = () => {
+  queryParams.noticeCode = undefined
+  queryParams.noticeName = undefined
+  queryParams.salesOrderCode = undefined
+  queryParams.clientId = undefined
+  queryParams.status = props.status
+  handleQuery()
+}
+
+/** 确认选择 */
+const confirmSelect = () => {
+  if (props.multiple) {
+    if (selectedRows.value.length === 0) {
+      message.warning('请至少选择一条数据')
+      return
+    }
+    emit('selected', selectedRows.value)
+  } else {
+    if (!currentRadioRow.value) {
+      message.warning('请选择一条数据')
+      return
+    }
+    emit('selected', [currentRadioRow.value])
+  }
+  dialogVisible.value = false
+}
+
+// ==================== 打开弹窗 ====================
+
+/** 打开弹窗，可传入已选 ID 用于预选高亮 */
+const open = async (selectedIds?: number[]) => {
+  dialogVisible.value = true
+  // 重置查询条件 + 页码，避免二次打开继承上次过滤上下文
+  queryParams.noticeCode = undefined
+  queryParams.noticeName = undefined
+  queryParams.salesOrderCode = undefined
+  queryParams.clientId = undefined
+  queryParams.status = props.status != null ? props.status : undefined
+  queryParams.pageNo = 1
+  // 清空上一次的选中状态
+  selectedRows.value = []
+  selectedRadioId.value = undefined
+  currentRadioRow.value = undefined
+  preSelectedIds.value = selectedIds ?? []
+  // 多选模式清空跨页缓存的勾选
+  await nextTick()
+  tableRef.value?.clearSelection()
+  await getList()
+}
+defineExpose({ open })
+</script>
+
+<style lang="scss" scoped>
+/* 隐藏 radio 的 label 文字，只保留圆圈 */
+.radio-no-label {
+  :deep(.el-radio__label) {
+    display: none;
+  }
+}
+</style>