From 8e8c1941b34e39349a331b629207723e41cc2482 Mon Sep 17 00:00:00 2001
From: YunaiV <zhijiantianya@gmail.com>
Date: Mon, 6 Apr 2026 00:53:32 +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=AE=A2=E6=88=B7=E5=88=97?=
 =?UTF-8?q?=E8=A1=A8=E6=8E=A5=E5=8F=A3=E5=92=8C=E7=9B=B8=E5=85=B3=E4=BB=A3?=
 =?UTF-8?q?=E7=A0=81?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

清理不再使用的客户精简列表接口及其相关实现，优化代码结构，提升可维护性。
---
 src/api/mes/md/client/index.ts                |   6 +-
 .../md/client/components/MdClientSelect.vue   | 184 +++++++++---
 .../components/MdClientSelectDialog.vue       | 284 ++++++++++++++++++
 3 files changed, 423 insertions(+), 51 deletions(-)
 create mode 100644 src/views/mes/md/client/components/MdClientSelectDialog.vue

diff --git a/src/api/mes/md/client/index.ts b/src/api/mes/md/client/index.ts
index 80f232c62..135beabcd 100644
--- a/src/api/mes/md/client/index.ts
+++ b/src/api/mes/md/client/index.ts
@@ -32,10 +32,8 @@ export const MdClientApi = {
     return await request.get({ url: `/mes/md-client/page`, params })
   },
 
-  // 查询客户精简列表
-  getClientSimpleList: async () => {
-    return await request.get({ url: `/mes/md-client/simple-list` })
-  },
+
+
 
   // 查询客户详情
   getClient: async (id: number) => {
diff --git a/src/views/mes/md/client/components/MdClientSelect.vue b/src/views/mes/md/client/components/MdClientSelect.vue
index 5a3335c90..8546ee96e 100644
--- a/src/views/mes/md/client/components/MdClientSelect.vue
+++ b/src/views/mes/md/client/components/MdClientSelect.vue
@@ -1,37 +1,65 @@
-<!-- MES 客户选择器：纯下拉，前端过滤（支持 name、code） -->
+<!--
+  MES 客户选择器：只读输入框 + 点击弹窗选择
+
+  交互：显示为只读 el-input，点击打开弹窗（单选模式）进行选择
+  Props:
+    modelValue  — 绑定的客户 ID（v-model）
+    disabled    — 是否禁用
+    clearable   — 是否允许清空（鼠标悬停时显示清除图标）
+    placeholder — 占位文字
+  Events:
+    update:modelValue — v-model 更新
+    change(item)      — 选中客户变化时触发，传递完整 MdClientVO（清空时为 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.name" :value="item.id">
-      <div class="flex items-center gap-8px">
-        <span>{{ item.name }}</span>
-        <el-tag v-if="item.code" size="small" type="info" class="ml-4px">
-          编号: {{ item.code }}
-        </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.code }}</div>
+          <div>名称：{{ selectedItem.name }}</div>
+          <div>简称：{{ selectedItem.nickname || '-' }}</div>
+          <div>电话：{{ selectedItem.telephone || '-' }}</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 -->
+  <MdClientSelectDialog ref="dialogRef" :multiple="false" @selected="handleSelected" />
 </template>
 
 <script setup lang="ts">
 import { MdClientApi, MdClientVO } from '@/api/mes/md/client'
+import { Search, CircleClose } from '@element-plus/icons-vue'
+import MdClientSelectDialog from './MdClientSelectDialog.vue'
 
-defineOptions({ name: 'MdClientSelect' })
+// 组件有两个根节点（div + Dialog），Vue 不会自动继承 attrs；
+// 手动透传到外层 div，确保父组件传入的 class / style 等生效
+const attrs = useAttrs()
+
+defineOptions({ name: 'MdClientSelect', inheritAttrs: false })
 
 const props = withDefaults(
   defineProps<{
-    modelValue?: number
-    disabled?: boolean
-    clearable?: boolean
-    placeholder?: string
+    modelValue?: number // 绑定的客户 ID
+    disabled?: boolean // 是否禁用
+    clearable?: boolean // 是否允许清空
+    placeholder?: string // 占位文字
   }>(),
   {
     disabled: false,
@@ -45,36 +73,98 @@ const emit = defineEmits<{
   change: [item: MdClientVO | undefined]
 }>()
 
-const allList = ref<MdClientVO[]>([])
-const filteredList = ref<MdClientVO[]>([])
+const dialogRef = ref() // 弹窗 Ref
+const hovering = ref(false) // 鼠标是否悬停
 
-const selectValue = computed({
-  get: () => props.modelValue,
-  set: (val) => emit('update:modelValue', val)
+// ==================== 名称回显 ====================
+const selectedItem = ref<MdClientVO | undefined>() // 当前选中的客户对象
+
+/** 输入框显示文本：只展示客户名称，保持简洁 */
+const displayLabel = computed(() => {
+  return selectedItem.value?.name ?? ''
 })
 
-/** 前端过滤（name + code） */
-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.name?.toLowerCase().includes(keyword) || item.code?.toLowerCase().includes(keyword)
-  )
+  if (selectedItem.value?.id === id) {
+    return
+  }
+  try {
+    selectedItem.value = await MdClientApi.getClient(id)
+  } catch (e) {
+    console.error('[MdClientSelect] 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: MdClientVO[]) => {
+  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 MdClientApi.getClientSimpleList()
-  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/md/client/components/MdClientSelectDialog.vue b/src/views/mes/md/client/components/MdClientSelectDialog.vue
new file mode 100644
index 000000000..a38c66dfb
--- /dev/null
+++ b/src/views/mes/md/client/components/MdClientSelectDialog.vue
@@ -0,0 +1,284 @@
+<!--
+  MES 客户弹窗选择器（支持单选/多选）
+
+  Props:
+    multiple — true 多选（checkbox），false 单选（radio）；默认 true
+  Events:
+    selected(rows: MdClientVO[]) — 确认选择后触发，单选时数组长度为 1
+  Expose:
+    open(selectedIds?: number[]) — 打开弹窗，可传入已选 ID 用于预选高亮
+-->
+<template>
+  <Dialog title="客户选择" v-model="dialogVisible" width="70%">
+    <!-- 搜索表单 -->
+    <el-form :inline="true" :model="queryParams" class="mb-10px" label-width="80px">
+      <el-form-item label="客户编码">
+        <el-input
+          v-model="queryParams.code"
+          placeholder="请输入客户编码"
+          clearable
+          @keyup.enter="handleQuery"
+        />
+      </el-form-item>
+      <el-form-item label="客户名称">
+        <el-input
+          v-model="queryParams.name"
+          placeholder="请输入客户名称"
+          clearable
+          @keyup.enter="handleQuery"
+        />
+      </el-form-item>
+      <el-form-item label="客户简称">
+        <el-input
+          v-model="queryParams.nickname"
+          placeholder="请输入客户简称"
+          clearable
+          @keyup.enter="handleQuery"
+        />
+      </el-form-item>
+      <el-form-item>
+        <el-button type="primary" @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>
+    <!-- 数据表格：单选 radio / 多选 checkbox 统一在一个 table 内 -->
+    <el-table
+      ref="tableRef"
+      v-loading="loading"
+      :data="list"
+      :stripe="true"
+      :show-overflow-tooltip="true"
+      border
+      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="code" width="200" />
+      <el-table-column label="客户名称" align="left" prop="name" min-width="150" />
+      <el-table-column label="客户简称" align="center" prop="nickname" width="120" />
+      <el-table-column label="客户类型" align="center" prop="type" width="100">
+        <template #default="scope">
+          <dict-tag :type="DICT_TYPE.MES_CLIENT_TYPE" :value="scope.row.type" />
+        </template>
+      </el-table-column>
+      <el-table-column label="联系人" align="center" prop="contact1Name" width="100" />
+      <el-table-column label="联系电话" align="center" prop="telephone" width="130" />
+      <el-table-column label="状态" align="center" prop="status" width="80">
+        <template #default="scope">
+          <dict-tag :type="DICT_TYPE.COMMON_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"
+    />
+    <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 } from '@/utils/dict'
+import { MdClientApi, MdClientVO } from '@/api/mes/md/client'
+
+defineOptions({ name: 'MdClientSelectDialog' })
+
+const props = withDefaults(
+  defineProps<{
+    multiple?: boolean // true 多选（checkbox），false 单选（radio）
+  }>(),
+  {
+    multiple: true
+  }
+)
+
+const message = useMessage()
+const emit = defineEmits<{
+  selected: [rows: MdClientVO[]]
+}>()
+
+const dialogVisible = ref(false) // 弹窗是否展示
+const loading = ref(false) // 列表加载中
+const list = ref<MdClientVO[]>([]) // 客户列表
+const total = ref(0) // 总条数
+
+// ==================== 选中状态 ====================
+const tableRef = ref() // 表格 Ref
+const selectedRows = ref<MdClientVO[]>([]) // 多选模式：选中行
+const selectedRadioId = ref<number>() // 单选模式：选中 ID
+const currentRadioRow = ref<MdClientVO>() // 单选模式：选中行对象
+const preSelectedIds = ref<number[]>([]) // 打开弹窗时传入的已选 ID
+
+/** 多选：checkbox 变化 */
+const handleSelectionChange = (rows: MdClientVO[]) => {
+  if (props.multiple) {
+    selectedRows.value = rows
+  }
+}
+
+/** 单选：radio 变化 */
+const handleRadioChange = (row: MdClientVO) => {
+  currentRadioRow.value = row
+}
+
+/** 单击行：单选模式下点击整行即选中（降低操作成本），多选不处理（避免和 dblclick 冲突） */
+const handleRowClick = (row: MdClientVO) => {
+  if (props.multiple) {
+    return
+  }
+  selectedRadioId.value = row.id
+  currentRadioRow.value = row
+}
+
+/** 双击行：多选模式切换勾选，单选模式直接确认 */
+const handleRowDblClick = (row: MdClientVO) => {
+  if (props.multiple) {
+    tableRef.value?.toggleRowSelection(row)
+    return
+  }
+  selectedRadioId.value = row.id
+  currentRadioRow.value = row
+  confirmSelect()
+}
+
+// ==================== 客户查询 ====================
+const queryParams = reactive({
+  pageNo: 1, // 页码
+  pageSize: 10, // 每页条数
+  code: undefined as string | undefined, // 客户编码
+  name: undefined as string | undefined, // 客户名称
+  nickname: undefined as string | undefined // 客户简称
+})
+
+/** 查询客户列表 */
+const getList = async () => {
+  loading.value = true
+  try {
+    const data = await MdClientApi.getClientPage(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.code = undefined
+  queryParams.name = undefined
+  queryParams.nickname = undefined
+  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.code = undefined
+  queryParams.name = undefined
+  queryParams.nickname = 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>