From 711d5abc0aba33606d92332a26b82a55022b6fb8 Mon Sep 17 00:00:00 2001
From: YunaiV <zhijiantianya@gmail.com>
Date: Sun, 10 May 2026 23:56:28 +0800
Subject: [PATCH] =?UTF-8?q?feat=EF=BC=88wms=EF=BC=89=EF=BC=9A=E5=AE=8C?=
 =?UTF-8?q?=E5=96=84=E5=BE=80=E6=9D=A5=E4=BC=81=E4=B8=9A?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/api/wms/md/merchant/index.ts           |  57 ++++++
 src/utils/dict.ts                          |   2 +-
 src/views/wms/md/merchant/MerchantForm.vue | 185 ++++++++++++++++++
 src/views/wms/md/merchant/index.vue        | 211 +++++++++++++++++++++
 4 files changed, 454 insertions(+), 1 deletion(-)
 create mode 100644 src/api/wms/md/merchant/index.ts
 create mode 100644 src/views/wms/md/merchant/MerchantForm.vue
 create mode 100644 src/views/wms/md/merchant/index.vue

diff --git a/src/api/wms/md/merchant/index.ts b/src/api/wms/md/merchant/index.ts
new file mode 100644
index 000000000..7a552a29a
--- /dev/null
+++ b/src/api/wms/md/merchant/index.ts
@@ -0,0 +1,57 @@
+import request from '@/config/axios'
+
+// WMS 往来企业 VO
+export interface MerchantVO {
+  id?: number
+  code?: string
+  name?: string
+  type?: number
+  level?: string
+  bankName?: string
+  bankAccount?: string
+  address?: string
+  mobile?: string
+  telephone?: string
+  contact?: string
+  email?: string
+  remark?: string
+  createTime?: Date
+}
+
+// WMS 往来企业 API
+export const MerchantApi = {
+  // 查询往来企业分页
+  getMerchantPage: async (params: any) => {
+    return await request.get({ url: '/wms/merchant/page', params })
+  },
+
+  // 查询往来企业精简列表
+  getMerchantSimpleList: async (params?: any) => {
+    return await request.get({ url: '/wms/merchant/simple-list', params })
+  },
+
+  // 查询往来企业详情
+  getMerchant: async (id: number) => {
+    return await request.get({ url: '/wms/merchant/get?id=' + id })
+  },
+
+  // 新增往来企业
+  createMerchant: async (data: MerchantVO) => {
+    return await request.post({ url: '/wms/merchant/create', data })
+  },
+
+  // 修改往来企业
+  updateMerchant: async (data: MerchantVO) => {
+    return await request.put({ url: '/wms/merchant/update', data })
+  },
+
+  // 删除往来企业
+  deleteMerchant: async (id: number) => {
+    return await request.delete({ url: '/wms/merchant/delete?id=' + id })
+  },
+
+  // 导出往来企业
+  exportMerchant: async (params: any) => {
+    return await request.download({ url: '/wms/merchant/export-excel', params })
+  }
+}
diff --git a/src/utils/dict.ts b/src/utils/dict.ts
index 455c3d656..130c239ab 100644
--- a/src/utils/dict.ts
+++ b/src/utils/dict.ts
@@ -217,7 +217,7 @@ export enum DICT_TYPE {
   ERP_STOCK_RECORD_BIZ_TYPE = 'erp_stock_record_biz_type', // 库存明细的业务类型
 
   // ========== WMS - 仓库管理模块 ==========
-  WMS_MERCHANT_TYPE = 'merchant_type', // WMS 供应商企业类型
+  WMS_MERCHANT_TYPE = 'merchant_type', // WMS 往来企业类型
 
   // ========== AI - 人工智能模块  ==========
   AI_PLATFORM = 'ai_platform', // AI 平台
diff --git a/src/views/wms/md/merchant/MerchantForm.vue b/src/views/wms/md/merchant/MerchantForm.vue
new file mode 100644
index 000000000..6571f0066
--- /dev/null
+++ b/src/views/wms/md/merchant/MerchantForm.vue
@@ -0,0 +1,185 @@
+<!-- WMS 往来企业表单 -->
+<template>
+  <Dialog v-model="dialogVisible" :title="dialogTitle" width="1000px">
+    <el-form
+      ref="formRef"
+      v-loading="formLoading"
+      :model="formData"
+      :rules="formRules"
+      label-width="120px"
+    >
+      <el-row :gutter="20">
+        <el-col :span="12">
+          <el-form-item label="往来企业编号" prop="code">
+            <el-input v-model="formData.code" maxlength="20" placeholder="请输入往来企业编号" />
+          </el-form-item>
+        </el-col>
+        <el-col :span="12">
+          <el-form-item label="往来企业名称" prop="name">
+            <el-input v-model="formData.name" maxlength="60" placeholder="请输入往来企业名称" />
+          </el-form-item>
+        </el-col>
+        <el-col :span="12">
+          <el-form-item label="往来企业类型" prop="type">
+            <el-select v-model="formData.type" class="w-1/1" placeholder="请选择往来企业类型">
+              <el-option
+                v-for="dict in getIntDictOptions(DICT_TYPE.WMS_MERCHANT_TYPE)"
+                :key="dict.value"
+                :label="dict.label"
+                :value="dict.value"
+              />
+            </el-select>
+          </el-form-item>
+        </el-col>
+        <el-col :span="12">
+          <el-form-item label="级别" prop="level">
+            <el-input v-model="formData.level" maxlength="10" placeholder="请输入级别" />
+          </el-form-item>
+        </el-col>
+        <el-col :span="12">
+          <el-form-item label="开户行" prop="bankName">
+            <el-input v-model="formData.bankName" maxlength="255" placeholder="请输入开户行" />
+          </el-form-item>
+        </el-col>
+        <el-col :span="12">
+          <el-form-item label="银行账户" prop="bankAccount">
+            <el-input v-model="formData.bankAccount" maxlength="40" placeholder="请输入银行账户" />
+          </el-form-item>
+        </el-col>
+        <el-col :span="12">
+          <el-form-item label="地址" prop="address">
+            <el-input v-model="formData.address" maxlength="200" placeholder="请输入地址" />
+          </el-form-item>
+        </el-col>
+        <el-col :span="12">
+          <el-form-item label="联系人" prop="contact">
+            <el-input v-model="formData.contact" maxlength="30" placeholder="请输入联系人" />
+          </el-form-item>
+        </el-col>
+        <el-col :span="12">
+          <el-form-item label="手机号" prop="mobile">
+            <el-input v-model="formData.mobile" maxlength="13" placeholder="请输入手机号" />
+          </el-form-item>
+        </el-col>
+        <el-col :span="12">
+          <el-form-item label="座机号" prop="telephone">
+            <el-input v-model="formData.telephone" maxlength="13" placeholder="请输入座机号" />
+          </el-form-item>
+        </el-col>
+        <el-col :span="12">
+          <el-form-item label="Email" prop="email">
+            <el-input v-model="formData.email" maxlength="50" placeholder="请输入 Email" />
+          </el-form-item>
+        </el-col>
+        <el-col :span="12">
+          <el-form-item label="备注" prop="remark">
+            <el-input v-model="formData.remark" maxlength="255" placeholder="请输入备注" />
+          </el-form-item>
+        </el-col>
+      </el-row>
+    </el-form>
+    <template #footer>
+      <el-button :disabled="formLoading" type="primary" @click="submitForm">确 定</el-button>
+      <el-button @click="dialogVisible = false">取 消</el-button>
+    </template>
+  </Dialog>
+</template>
+
+<script lang="ts" setup>
+import { DICT_TYPE, getIntDictOptions } from '@/utils/dict'
+import { MerchantApi, MerchantVO } from '@/api/wms/md/merchant'
+
+/** WMS 往来企业表单 */
+defineOptions({ name: 'WmsMerchantForm' })
+
+const { t } = useI18n() // 国际化
+const message = useMessage() // 消息弹窗
+
+const dialogVisible = ref(false) // 弹窗的是否展示
+const dialogTitle = ref('') // 弹窗的标题
+const formLoading = ref(false) // 表单的加载中：1）修改时的数据加载；2）提交的按钮禁用
+const formType = ref('') // 表单的类型：create - 新增；update - 修改
+const formData = ref<MerchantVO>({
+  id: undefined,
+  code: undefined,
+  name: undefined,
+  type: undefined,
+  level: undefined,
+  bankName: undefined,
+  bankAccount: undefined,
+  address: undefined,
+  mobile: undefined,
+  telephone: undefined,
+  contact: undefined,
+  email: undefined,
+  remark: undefined
+})
+const formRules = reactive({
+  code: [{ required: true, message: '往来企业编号不能为空', trigger: 'blur' }],
+  name: [{ required: true, message: '往来企业名称不能为空', trigger: 'blur' }],
+  type: [{ required: true, message: '往来企业类型不能为空', trigger: 'change' }]
+})
+const formRef = ref() // 表单 Ref
+
+/** 打开弹窗 */
+const open = async (type: string, id?: number) => {
+  dialogVisible.value = true
+  dialogTitle.value = t('action.' + type)
+  formType.value = type
+  resetForm()
+  // 修改时，设置数据
+  if (id) {
+    formLoading.value = true
+    try {
+      formData.value = await MerchantApi.getMerchant(id)
+    } finally {
+      formLoading.value = false
+    }
+  }
+}
+defineExpose({ open }) // 提供 open 方法，用于打开弹窗
+
+/** 提交表单 */
+const emit = defineEmits(['success']) // 定义 success 事件，用于操作成功后的回调
+const submitForm = async () => {
+  // 校验表单
+  await formRef.value.validate()
+  // 提交请求
+  formLoading.value = true
+  try {
+    const data = formData.value as MerchantVO
+    if (formType.value === 'create') {
+      await MerchantApi.createMerchant(data)
+      message.success(t('common.createSuccess'))
+    } else {
+      await MerchantApi.updateMerchant(data)
+      message.success(t('common.updateSuccess'))
+    }
+    dialogVisible.value = false
+    // 发送操作成功的事件
+    emit('success')
+  } finally {
+    formLoading.value = false
+  }
+}
+
+/** 重置表单 */
+const resetForm = () => {
+  formData.value = {
+    id: undefined,
+    code: undefined,
+    name: undefined,
+    type: undefined,
+    level: undefined,
+    bankName: undefined,
+    bankAccount: undefined,
+    address: undefined,
+    mobile: undefined,
+    telephone: undefined,
+    contact: undefined,
+    email: undefined,
+    remark: undefined
+  }
+  formRef.value?.resetFields()
+}
+</script>
diff --git a/src/views/wms/md/merchant/index.vue b/src/views/wms/md/merchant/index.vue
new file mode 100644
index 000000000..5aa27392f
--- /dev/null
+++ b/src/views/wms/md/merchant/index.vue
@@ -0,0 +1,211 @@
+<!-- WMS 往来企业 -->
+<template>
+  <ContentWrap>
+    <!-- 搜索工作栏 -->
+    <el-form
+      ref="queryFormRef"
+      :inline="true"
+      :model="queryParams"
+      class="-mb-15px"
+      label-width="120px"
+    >
+      <el-form-item label="往来企业编号" prop="code">
+        <el-input
+          v-model="queryParams.code"
+          class="!w-240px"
+          clearable
+          placeholder="请输入往来企业编号"
+          @keyup.enter="handleQuery"
+        />
+      </el-form-item>
+      <el-form-item label="往来企业名称" prop="name">
+        <el-input
+          v-model="queryParams.name"
+          class="!w-240px"
+          clearable
+          placeholder="请输入往来企业名称"
+          @keyup.enter="handleQuery"
+        />
+      </el-form-item>
+      <el-form-item label="往来企业类型" prop="type">
+        <el-select
+          v-model="queryParams.type"
+          class="!w-240px"
+          clearable
+          placeholder="请选择往来企业类型"
+        >
+          <el-option
+            v-for="dict in getIntDictOptions(DICT_TYPE.WMS_MERCHANT_TYPE)"
+            :key="dict.value"
+            :label="dict.label"
+            :value="dict.value"
+          />
+        </el-select>
+      </el-form-item>
+      <el-form-item>
+        <el-button @click="handleQuery">
+          <Icon class="mr-5px" icon="ep:search" />
+          搜索
+        </el-button>
+        <el-button @click="resetQuery">
+          <Icon class="mr-5px" icon="ep:refresh" />
+          重置
+        </el-button>
+        <el-button
+          v-hasPermi="['wms:merchant:create']"
+          plain
+          type="primary"
+          @click="openForm('create')"
+        >
+          <Icon class="mr-5px" icon="ep:plus" />
+          新增
+        </el-button>
+        <el-button
+          v-hasPermi="['wms:merchant:export']"
+          :loading="exportLoading"
+          plain
+          type="success"
+          @click="handleExport"
+        >
+          <Icon class="mr-5px" icon="ep:download" />
+          导出
+        </el-button>
+      </el-form-item>
+    </el-form>
+  </ContentWrap>
+
+  <!-- 往来企业列表 -->
+  <ContentWrap>
+    <el-table v-loading="loading" :data="list" :show-overflow-tooltip="true" :stripe="true">
+      <el-table-column align="center" label="往来企业编号" prop="code" width="160" />
+      <el-table-column align="center" label="往来企业名称" prop="name" min-width="160" />
+      <el-table-column align="center" label="往来企业类型" prop="type" width="120">
+        <template #default="scope">
+          <dict-tag :type="DICT_TYPE.WMS_MERCHANT_TYPE" :value="scope.row.type" />
+        </template>
+      </el-table-column>
+      <el-table-column align="center" label="级别" prop="level" width="100" />
+      <el-table-column align="center" label="联系人" prop="contact" width="120" />
+      <el-table-column align="center" label="备注" prop="remark" min-width="160" />
+      <el-table-column align="center" label="操作" width="160">
+        <template #default="scope">
+          <el-button
+            v-hasPermi="['wms:merchant:update']"
+            link
+            type="primary"
+            @click="openForm('update', scope.row.id)"
+          >
+            修改
+          </el-button>
+          <el-button
+            v-hasPermi="['wms:merchant:delete']"
+            link
+            type="danger"
+            @click="handleDelete(scope.row.id)"
+          >
+            删除
+          </el-button>
+        </template>
+      </el-table-column>
+    </el-table>
+    <!-- 分页 -->
+    <Pagination
+      v-model:limit="queryParams.pageSize"
+      v-model:page="queryParams.pageNo"
+      :total="total"
+      @pagination="getList"
+    />
+  </ContentWrap>
+
+  <!-- 表单弹窗：添加/修改 -->
+  <MerchantForm ref="formRef" @success="getList" />
+</template>
+
+<script lang="ts" setup>
+import { DICT_TYPE, getIntDictOptions } from '@/utils/dict'
+import { MerchantApi, MerchantVO } from '@/api/wms/md/merchant'
+import MerchantForm from './MerchantForm.vue'
+import download from '@/utils/download'
+
+/** WMS 往来企业 */
+defineOptions({ name: 'WmsMerchant' })
+
+const message = useMessage() // 消息弹窗
+const { t } = useI18n() // 国际化
+
+const loading = ref(true) // 列表的加载中
+const list = ref<MerchantVO[]>([]) // 列表的数据
+const total = ref(0) // 列表的总页数
+const queryParams = reactive({
+  pageNo: 1,
+  pageSize: 10,
+  code: undefined,
+  name: undefined,
+  type: undefined
+})
+const queryFormRef = ref() // 搜索的表单
+const exportLoading = ref(false) // 导出的加载中
+
+/** 查询往来企业列表 */
+const getList = async () => {
+  loading.value = true
+  try {
+    const data = await MerchantApi.getMerchantPage(queryParams)
+    list.value = data.list
+    total.value = data.total
+  } finally {
+    loading.value = false
+  }
+}
+
+/** 搜索按钮操作 */
+const handleQuery = () => {
+  queryParams.pageNo = 1
+  getList()
+}
+
+/** 重置按钮操作 */
+const resetQuery = () => {
+  queryFormRef.value.resetFields()
+  handleQuery()
+}
+
+/** 添加/修改操作 */
+const formRef = ref()
+const openForm = (type: string, id?: number) => {
+  formRef.value.open(type, id)
+}
+
+/** 删除往来企业 */
+const handleDelete = async (id: number) => {
+  try {
+    // 删除的二次确认
+    await message.delConfirm()
+    // 发起删除
+    await MerchantApi.deleteMerchant(id)
+    message.success(t('common.delSuccess'))
+    // 刷新列表
+    await getList()
+  } catch {}
+}
+
+/** 导出按钮操作 */
+const handleExport = async () => {
+  try {
+    // 导出的二次确认
+    await message.exportConfirm()
+    // 发起导出
+    exportLoading.value = true
+    const data = await MerchantApi.exportMerchant(queryParams)
+    download.excel(data, '往来企业.xls')
+  } catch {
+  } finally {
+    exportLoading.value = false
+  }
+}
+
+/** 初始化 */
+onMounted(() => {
+  getList()
+})
+</script>