feat(physical): 添加客服基础信息管理功能

- 在 apiUsers 中新增根据手机号查询用户信息接口
- 新增客服基础信息的完整 CRUD 接口实现
- 创建客服基础信息管理页面，包含列表展示、搜索、新增、修改、删除功能
- 添加客服信息表单验证和手机号用户状态校验逻辑
- 集成用户注销状态检查，确保客服关联的有效性
- 完善权限控制和数据表格交互功能

src/api/system/business/apiUsers/index.ts

@@ -105,3 +105,13 @@ export const removeUserCacheSystemData = () => {
     method: 'post'
   });
 };
+/**
+ * 根据手机号查询用户信息
+ * @param phone
+ */
+export const queryUserInfoByPhone = (phone: string | number): AxiosPromise<UserVO> => {
+  return request({
+    url: '/business/user/queryUserInfoByPhone/' + phone,
+    method: 'get'
+  });
+};

src/api/system/business/apiUsers/types.ts

@@ -117,6 +117,11 @@ export interface UserVO {
    * 真实姓名
    */
   realName: string;
+
+  /**
+   * 注销状态 0 正常  1 注销中  2 已注销
+   */
+  deactivateStatus: number;
 }
 
 export interface UserForm extends BaseEntity {

src/api/system/physical/customerServiceInfo/index.ts

@@ -0,0 +1,63 @@
+import request from '@/utils/request';
+import { AxiosPromise } from 'axios';
+import { CustomerServiceInfoVO, CustomerServiceInfoForm, CustomerServiceInfoQuery } from '@/api/system/physical/customerServiceInfo/types';
+
+/**
+ * 查询客服基础信息列表
+ * @param query
+ * @returns {*}
+ */
+
+export const listCustomerServiceInfo = (query?: CustomerServiceInfoQuery): AxiosPromise<CustomerServiceInfoVO[]> => {
+  return request({
+    url: '/physical/customerServiceInfo/list',
+    method: 'get',
+    params: query
+  });
+};
+
+/**
+ * 查询客服基础信息详细
+ * @param id
+ */
+export const getCustomerServiceInfo = (id: string | number): AxiosPromise<CustomerServiceInfoVO> => {
+  return request({
+    url: '/physical/customerServiceInfo/' + id,
+    method: 'get'
+  });
+};
+
+/**
+ * 新增客服基础信息
+ * @param data
+ */
+export const addCustomerServiceInfo = (data: CustomerServiceInfoForm) => {
+  return request({
+    url: '/physical/customerServiceInfo',
+    method: 'post',
+    data: data
+  });
+};
+
+/**
+ * 修改客服基础信息
+ * @param data
+ */
+export const updateCustomerServiceInfo = (data: CustomerServiceInfoForm) => {
+  return request({
+    url: '/physical/customerServiceInfo',
+    method: 'put',
+    data: data
+  });
+};
+
+/**
+ * 删除客服基础信息
+ * @param id
+ */
+export const delCustomerServiceInfo = (id: string | number | Array<string | number>) => {
+  return request({
+    url: '/physical/customerServiceInfo/' + id,
+    method: 'delete'
+  });
+};

src/api/system/physical/customerServiceInfo/types.ts

@@ -0,0 +1,150 @@
+export interface CustomerServiceInfoVO {
+  /**
+   * 主键ID
+   */
+  id: string | number;
+
+  /**
+   * 用户ID（对应截图中的用户ID）
+   */
+  userId: string | number;
+
+  /**
+   * 客服昵称
+   */
+  nickname: string;
+
+  /**
+   * 客服手机号，唯一标识
+   */
+  phone: string;
+
+  /**
+   * 备注
+   */
+  remark: string;
+
+  /**
+   * 状态：0=正常, 1=冻结
+   */
+  status: number;
+
+  /**
+   * 操作人ID（最后修改者ID）
+   */
+  operatorId: string | number;
+
+  /**
+   * 操作人名字（最后修改者姓名）
+   */
+  operatorName: string;
+
+  /**
+   * 创建时间
+   */
+  createdAt: string;
+
+  /**
+   * 更新时间
+   */
+  updatedAt: string;
+}
+
+export interface CustomerServiceInfoForm extends BaseEntity {
+  /**
+   * 主键ID
+   */
+  id?: string | number;
+
+  /**
+   * 用户ID（对应截图中的用户ID）
+   */
+  userId?: string | number;
+
+  /**
+   * 客服昵称
+   */
+  nickname?: string;
+
+  /**
+   * 客服手机号，唯一标识
+   */
+  phone?: string;
+
+  /**
+   * 备注
+   */
+  remark?: string;
+
+  /**
+   * 状态：0=正常, 1=冻结
+   */
+  status?: number;
+
+  /**
+   * 操作人ID（最后修改者ID）
+   */
+  operatorId?: string | number;
+
+  /**
+   * 操作人名字（最后修改者姓名）
+   */
+  operatorName?: string;
+
+  /**
+   * 创建时间
+   */
+  createdAt?: string;
+
+  /**
+   * 更新时间
+   */
+  updatedAt?: string;
+}
+
+export interface CustomerServiceInfoQuery extends PageQuery {
+  /**
+   * 用户ID（对应截图中的用户ID）
+   */
+  userId?: string | number;
+
+  /**
+   * 客服昵称
+   */
+  nickname?: string;
+
+  /**
+   * 客服手机号，唯一标识
+   */
+  phone?: string;
+
+  /**
+   * 状态：0=正常, 1=冻结
+   */
+  status?: number;
+
+  /**
+   * 操作人ID（最后修改者ID）
+   */
+  operatorId?: string | number;
+
+  /**
+   * 操作人名字（最后修改者姓名）
+   */
+  operatorName?: string;
+
+  /**
+   * 创建时间
+   */
+  createdAt?: string;
+
+  /**
+   * 更新时间
+   */
+  updatedAt?: string;
+
+  /**
+   * 日期范围参数
+   */
+  params?: any;
+}

src/views/system/physical/customerServiceInfo/index.vue

@@ -0,0 +1,330 @@
+<template>
+  <div class="p-2">
+    <transition :enter-active-class="proxy?.animate.searchAnimate.enter" :leave-active-class="proxy?.animate.searchAnimate.leave">
+      <div v-show="showSearch" class="mb-[10px]">
+        <el-card shadow="hover">
+          <el-form ref="queryFormRef" :model="queryParams" :inline="true">
+            <el-form-item label="客服昵称" prop="nickname">
+              <el-input v-model="queryParams.nickname" placeholder="请输入客服昵称" clearable @keyup.enter="handleQuery" />
+            </el-form-item>
+            <el-form-item label="手机号" prop="phone">
+              <el-input v-model="queryParams.phone" placeholder="请输入客服手机号" clearable @keyup.enter="handleQuery" />
+            </el-form-item>
+            <el-form-item>
+              <el-button type="primary" icon="Search" @click="handleQuery">搜索</el-button>
+              <el-button icon="Refresh" @click="resetQuery">重置</el-button>
+            </el-form-item>
+          </el-form>
+        </el-card>
+      </div>
+    </transition>
+
+    <el-card shadow="never">
+      <template #header>
+        <el-row :gutter="10" class="mb8">
+          <el-col :span="1.5">
+            <el-button type="primary" plain icon="Plus" @click="handleAdd" v-hasPermi="['physical:customerServiceInfo:add']">新增</el-button>
+          </el-col>
+          <el-col :span="1.5">
+            <el-button type="success" plain icon="Edit" :disabled="single" @click="handleUpdate()" v-hasPermi="['physical:customerServiceInfo:edit']"
+              >修改</el-button
+            >
+          </el-col>
+          <el-col :span="1.5">
+            <el-button
+              type="danger"
+              plain
+              icon="Delete"
+              :disabled="multiple"
+              @click="handleDelete()"
+              v-hasPermi="['physical:customerServiceInfo:remove']"
+              >删除</el-button
+            >
+          </el-col>
+          <!--          <el-col :span="1.5">
+            <el-button type="warning" plain icon="Download" @click="handleExport" v-hasPermi="['system:customerServiceInfo:export']">导出</el-button>
+          </el-col>-->
+          <right-toolbar v-model:showSearch="showSearch" @queryTable="getList"></right-toolbar>
+        </el-row>
+      </template>
+
+      <el-table v-loading="loading" border :data="customerServiceInfoList" @selection-change="handleSelectionChange">
+        <el-table-column type="selection" width="55" align="center" />
+        <el-table-column label="编号" align="center" prop="id" v-if="true" />
+        <el-table-column label="用户ID" align="center" prop="userId" />
+        <el-table-column label="客服昵称" align="center" prop="nickname" />
+        <el-table-column label="客服手机号" align="center" prop="phone" />
+        <el-table-column label="备注" align="center" prop="remark" />
+        <el-table-column label="状态" align="center" prop="status">
+          <template #default="scope">
+            <el-tag :type="scope.row.status === 0 ? 'success' : 'danger'">
+              {{ scope.row.status === 0 ? '正常' : '冻结' }}
+            </el-tag>
+          </template>
+        </el-table-column>
+        <el-table-column label="操作人" align="center" prop="operatorName" />
+        <el-table-column label="创建时间" align="center" prop="createdAt" width="180">
+          <template #default="scope">
+            <span>{{ parseTime(scope.row.createdAt, '{y}-{m}-{d} {h}:{i}:{s}') }}</span>
+          </template>
+        </el-table-column>
+        <el-table-column label="更新时间" align="center" prop="updatedAt" width="180">
+          <template #default="scope">
+            <span>{{ parseTime(scope.row.updatedAt, '{y}-{m}-{d} {h}:{i}:{s}') }}</span>
+          </template>
+        </el-table-column>
+        <el-table-column label="操作" align="center" class-name="small-padding fixed-width">
+          <template #default="scope">
+            <el-tooltip content="修改" placement="top">
+              <el-button
+                link
+                type="primary"
+                icon="Edit"
+                @click="handleUpdate(scope.row)"
+                v-hasPermi="['physical:customerServiceInfo:edit']"
+              ></el-button>
+            </el-tooltip>
+            <el-tooltip content="删除" placement="top">
+              <el-button
+                link
+                type="primary"
+                icon="Delete"
+                @click="handleDelete(scope.row)"
+                v-hasPermi="['physical:customerServiceInfo:remove']"
+              ></el-button>
+            </el-tooltip>
+          </template>
+        </el-table-column>
+      </el-table>
+
+      <pagination v-show="total > 0" :total="total" v-model:page="queryParams.pageNum" v-model:limit="queryParams.pageSize" @pagination="getList" />
+    </el-card>
+    <!-- 添加或修改客服基础信息对话框 -->
+    <el-dialog :title="dialog.title" v-model="dialog.visible" width="600px" append-to-body>
+      <el-form ref="customerServiceInfoFormRef" :model="form" :rules="rules" label-width="120px">
+        <el-form-item label="客服昵称" prop="nickname">
+          <el-input v-model="form.nickname" placeholder="请输入客服昵称" />
+        </el-form-item>
+        <el-form-item label="客服手机号" prop="phone">
+          <el-input v-model="form.phone" placeholder="请输入客服手机号" @blur="handlePhoneBlur" />
+        </el-form-item>
+        <el-form-item label="用户ID" prop="userId">
+          <el-input v-model="form.userId" placeholder="请输入用户ID" disabled />
+        </el-form-item>
+        <el-form-item label="状态" prop="status">
+          <el-select v-model="form.status" placeholder="请选择状态">
+            <el-option label="正常" :value="0"></el-option>
+            <el-option label="冻结" :value="1"></el-option>
+          </el-select>
+        </el-form-item>
+        <el-form-item label="备注" prop="remark">
+          <el-input v-model="form.remark" placeholder="请输入备注" />
+        </el-form-item>
+      </el-form>
+      <template #footer>
+        <div class="dialog-footer">
+          <el-button :loading="buttonLoading" type="primary" @click="submitForm">确 定</el-button>
+          <el-button @click="cancel">取 消</el-button>
+        </div>
+      </template>
+    </el-dialog>
+  </div>
+</template>
+
+<script setup name="CustomerServiceInfo" lang="ts">
+import {
+  listCustomerServiceInfo,
+  getCustomerServiceInfo,
+  delCustomerServiceInfo,
+  addCustomerServiceInfo,
+  updateCustomerServiceInfo
+} from '@/api/system/physical/customerServiceInfo';
+import { queryUserInfoByPhone } from '@/api/system/business/apiUsers';
+import { CustomerServiceInfoVO, CustomerServiceInfoQuery, CustomerServiceInfoForm } from '@/api/system/physical/customerServiceInfo/types';
+
+const { proxy } = getCurrentInstance() as ComponentInternalInstance;
+
+const customerServiceInfoList = ref<CustomerServiceInfoVO[]>([]);
+const buttonLoading = ref(false);
+const loading = ref(true);
+const showSearch = ref(true);
+const ids = ref<Array<string | number>>([]);
+const single = ref(true);
+const multiple = ref(true);
+const total = ref(0);
+
+const queryFormRef = ref<ElFormInstance>();
+const customerServiceInfoFormRef = ref<ElFormInstance>();
+
+const dialog = reactive<DialogOption>({
+  visible: false,
+  title: ''
+});
+
+const initFormData: CustomerServiceInfoForm = {
+  id: undefined,
+  userId: undefined,
+  nickname: undefined,
+  phone: undefined,
+  remark: undefined,
+  status: 0,
+  operatorId: undefined,
+  operatorName: undefined,
+  createdAt: undefined,
+  updatedAt: undefined
+};
+const data = reactive<PageData<CustomerServiceInfoForm, CustomerServiceInfoQuery>>({
+  form: { ...initFormData },
+  queryParams: {
+    pageNum: 1,
+    pageSize: 10,
+    userId: undefined,
+    nickname: undefined,
+    phone: undefined,
+    status: undefined,
+    operatorId: undefined,
+    operatorName: undefined,
+    createdAt: undefined,
+    updatedAt: undefined,
+    params: {}
+  },
+  rules: {
+    id: [{ required: true, message: '主键ID不能为空', trigger: 'blur' }],
+    nickname: [{ required: true, message: '客服昵称不能为空', trigger: 'blur' }],
+    phone: [{ required: true, message: '客服手机号不能为空', trigger: 'blur' }]
+  }
+});
+
+const { queryParams, form, rules } = toRefs(data);
+
+/** 查询客服基础信息列表 */
+const getList = async () => {
+  loading.value = true;
+  const res = await listCustomerServiceInfo(queryParams.value);
+  customerServiceInfoList.value = res.rows;
+  total.value = res.total;
+  loading.value = false;
+};
+
+/** 取消按钮 */
+const cancel = () => {
+  reset();
+  dialog.visible = false;
+};
+
+/** 表单重置 */
+const reset = () => {
+  form.value = { ...initFormData };
+  customerServiceInfoFormRef.value?.resetFields();
+};
+
+/** 搜索按钮操作 */
+const handleQuery = () => {
+  queryParams.value.pageNum = 1;
+  getList();
+};
+
+/** 重置按钮操作 */
+const resetQuery = () => {
+  queryFormRef.value?.resetFields();
+  handleQuery();
+};
+
+/** 多选框选中数据 */
+const handleSelectionChange = (selection: CustomerServiceInfoVO[]) => {
+  ids.value = selection.map((item) => item.id);
+  single.value = selection.length != 1;
+  multiple.value = !selection.length;
+};
+
+/** 新增按钮操作 */
+const handleAdd = () => {
+  reset();
+  dialog.visible = true;
+  dialog.title = '添加';
+};
+
+/** 修改按钮操作 */
+const handleUpdate = async (row?: CustomerServiceInfoVO) => {
+  reset();
+  const _id = row?.id || ids.value[0];
+  const res = await getCustomerServiceInfo(_id);
+  Object.assign(form.value, res.data);
+  dialog.visible = true;
+  dialog.title = '修改';
+};
+
+/** 提交按钮 */
+const submitForm = () => {
+  customerServiceInfoFormRef.value?.validate(async (valid: boolean) => {
+    if (valid) {
+      buttonLoading.value = true;
+      if (form.value.id) {
+        await updateCustomerServiceInfo(form.value).finally(() => (buttonLoading.value = false));
+      } else {
+        await addCustomerServiceInfo(form.value).finally(() => (buttonLoading.value = false));
+      }
+      proxy?.$modal.msgSuccess('操作成功');
+      dialog.visible = false;
+      await getList();
+    }
+  });
+};
+
+/** 删除按钮操作 */
+const handleDelete = async (row?: CustomerServiceInfoVO) => {
+  const _ids = row?.id || ids.value;
+  await proxy?.$modal.confirm('是否确认删除编号为"' + _ids + '"的数据项？').finally(() => (loading.value = false));
+  await delCustomerServiceInfo(_ids);
+  proxy?.$modal.msgSuccess('删除成功');
+  await getList();
+};
+
+/** 导出按钮操作 */
+const handleExport = () => {
+  proxy?.download(
+    'system/customerServiceInfo/export',
+    {
+      ...queryParams.value
+    },
+    `customerServiceInfo_${new Date().getTime()}.xlsx`
+  );
+};
+
+onMounted(() => {
+  getList();
+});
+/** 手机号失焦检测 */
+const handlePhoneBlur = async () => {
+  const phone = form.value.phone;
+  if (!phone || !/^1[3-9]\d{9}$/.test(phone)) {
+    return;
+  }
+
+  try {
+    const res = await queryUserInfoByPhone(phone);
+    if (res.data) {
+      // 检查注销状态：0 正常，1 注销中，2 已注销
+      if (res.data.deactivateStatus === 0) {
+        form.value.userId = res.data.id;
+        proxy?.$modal.msgSuccess('用户验证成功');
+      } else if (res.data.deactivateStatus === 1) {
+        proxy?.$modal.msgError('该用户正在注销中，无法使用');
+        form.value.userId = undefined;
+      } else if (res.data.deactivateStatus === 2) {
+        proxy?.$modal.msgError('该用户已注销，无法使用');
+        form.value.userId = undefined;
+      } else {
+        proxy?.$modal.msgError('该用户状态异常');
+        form.value.userId = undefined;
+      }
+    } else {
+      proxy?.$modal.msgError('该手机号未注册，请输入有效的手机号');
+      form.value.userId = undefined;
+    }
+  } catch (error) {
+    proxy?.$modal.msgError('查询失败，请稍后重试');
+    form.value.userId = undefined;
+  }
+};
+</script>