邀请码管理（单条、批量）10位英文数字随机

src/api/system/invitecode/index.ts

@@ -0,0 +1,49 @@
+import request from '@/config/axios'
+
+// 邀请码 VO
+export interface InviteCodeVO {
+  id: number // 主键
+  code: string // 邀请码
+  roleIds: string // 绑定角色
+  roleNames: [] // 绑定角色
+  validTime: number // 有效期（天）
+  expireTime: Date // 过期时间
+  useUserId: number // 使用用户id
+  useUserName: String // 使用用户名称
+  useUserTenantId: number // 使用用户租户id
+  useUserTenantName: String // 使用用户租户名称
+  status: string // 状态
+}
+
+// 邀请码 API
+export const InviteCodeApi = {
+  // 查询邀请码分页
+  getInviteCodePage: async (params: any) => {
+    return await request.get({ url: `/system/invite-code/page`, params })
+  },
+
+  // 查询邀请码详情
+  getInviteCode: async (id: number) => {
+    return await request.get({ url: `/system/invite-code/get?id=` + id })
+  },
+
+  // 新增邀请码
+  createInviteCode: async (data: InviteCodeVO) => {
+    return await request.post({ url: `/system/invite-code/create`, data })
+  },
+
+  // 修改邀请码
+  updateInviteCode: async (data: InviteCodeVO) => {
+    return await request.put({ url: `/system/invite-code/update`, data })
+  },
+
+  // 删除邀请码
+  deleteInviteCode: async (id: number) => {
+    return await request.delete({ url: `/system/invite-code/delete?id=` + id })
+  },
+
+  // 导出邀请码 Excel
+  exportInviteCode: async (params) => {
+    return await request.download({ url: `/system/invite-code/export-excel`, params })
+  }
+}

src/types/auto-components.d.ts

@@ -130,6 +130,8 @@ declare module 'vue' {
     Infotip: typeof import('./../components/Infotip/src/Infotip.vue')['default']
     InputPassword: typeof import('./../components/InputPassword/src/InputPassword.vue')['default']
     InputWithColor: typeof import('./../components/InputWithColor/index.vue')['default']
+    Invitecode: typeof import('./../views/system/invitecode/index.vue')['default']
+    InviteCodeForm: typeof import('./../views/system/invitecode/InviteCodeForm.vue')['default']
     LazyJsonViewer: typeof import('./../components/Json/LazyJsonViewer.vue')['default']
     MagicCubeEditor: typeof import('./../components/MagicCubeEditor/index.vue')['default']
     MarkdownView: typeof import('./../components/MarkdownView/index.vue')['default']

src/types/auto-imports.d.ts

@@ -7,8 +7,6 @@ export {}
 declare global {
   const DICT_TYPE: typeof import('@/utils/dict')['DICT_TYPE']
   const EffectScope: typeof import('vue')['EffectScope']
-  const ElMessage: typeof import('element-plus/es')['ElMessage']
-  const ElMessageBox: typeof import('element-plus/es')['ElMessageBox']
   const computed: typeof import('vue')['computed']
   const createApp: typeof import('vue')['createApp']
   const customRef: typeof import('vue')['customRef']

src/views/system/invitecode/InviteCodeForm.vue

@@ -0,0 +1,218 @@
+<template>
+  <Dialog :title="dialogTitle" v-model="dialogVisible">
+    <el-form
+      ref="formRef"
+      :model="formData"
+      :rules="formRules"
+      label-width="120px"
+      v-loading="formLoading"
+    >
+      <el-form-item label="类型" prop="type" v-if="formType === 'create'">
+        <div class="flex items-center">
+          <el-radio v-model="formData.type" label="single" border>单次</el-radio>
+          <el-radio v-model="formData.type" label="batch" border class="ml-20px">批量</el-radio>
+        </div>
+      </el-form-item>
+      
+      <el-form-item v-if="formType === 'update' || formData.type === 'single'" label="邀请码" prop="code">
+        <el-input v-model="formData.code" placeholder="请输入邀请码" :disabled="formType === 'update'">
+          <template #append>
+            <el-button @click="generateRandomCode" :disabled="formType === 'update'">
+              随机
+            </el-button>
+          </template>
+        </el-input>
+      </el-form-item>
+
+      <el-form-item v-else-if="formData.type === 'batch'" label="批量前缀" prop="code">
+        <div class="flex items-center gap-10px">
+          <el-input v-model="formData.code" placeholder="请输入批量前缀" class="flex-1" />
+          <el-input-number v-model="formData.batchCount" :min="1" :max="50" placeholder="数量" style="width: 120px;">
+            <template #suffix>
+              <span>个</span>
+            </template>
+          </el-input-number>
+        </div>
+      </el-form-item>
+      
+      <el-form-item label="绑定角色" prop="roleIds">
+        <el-select v-model="formData.roleIds" multiple placeholder="请选择绑定角色" >
+          <el-option
+            v-for="role in roleList"
+            :key="role.id"
+            :label="role.name"
+            :value="role.id"
+          />
+        </el-select>
+      </el-form-item>
+      
+      <el-form-item label="有效期（天）" prop="validTime">
+        <el-input-number v-model="formData.validTime" :min="1" :max="365">
+          <template #suffix>
+            <span>天</span>
+          </template>
+        </el-input-number>
+      </el-form-item>
+      
+      <el-form-item label="状态" prop="status">
+        <el-switch v-model="formData.status" active-value="1" inactive-value="0" disabled />
+      </el-form-item>
+    </el-form>
+    <template #footer>
+      <el-button @click="submitForm" type="primary" :disabled="formLoading || formType === 'update'">确 定</el-button>
+      <el-button @click="dialogVisible = false">取 消</el-button>
+    </template>
+  </Dialog>
+</template>
+<script setup lang="ts">
+import { InviteCodeApi, InviteCodeVO } from '@/api/system/invitecode'
+import { getSimpleRoleList, RoleVO } from '@/api/system/role/index'
+
+/** 邀请码 表单 */
+defineOptions({ name: 'InviteCodeForm' })
+
+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({
+  id: undefined,
+  code: undefined,
+  type: 'single',
+  batchCount: 1,
+  roleIds: [],
+  validTime: undefined,
+  expireTime: undefined,
+  useUserId: undefined,
+  useUserTenantId: undefined,
+  status: '1'
+})
+const formRules = reactive({
+  type: [
+    // 类型不再是必选，默认选中单次
+  ],
+  code: [
+    { required: formData.value.type === 'single', message: '请输入邀请码', trigger: 'blur' },
+    { min: 1, max: 10, message: '邀请码长度不能超过10位', trigger: 'blur' },
+    { pattern: /^[A-Za-z0-9]+$/, message: '邀请码只能包含英文和数字', trigger: 'blur' }
+  ],
+  roleIds: [
+    { required: true, message: '请选择绑定角色', trigger: 'change' },
+    { type: 'array', min: 1, message: '至少选择一个角色', trigger: 'change' }
+  ],
+  validTime: [
+    { required: true, message: '请输入有效期', trigger: 'blur' },
+    { type: 'number', min: 1, max: 365, message: '有效期必须在1-365天之间', trigger: 'blur' }
+  ],
+  batchCount: [
+    { required: formData.value.type === 'batch', message: '请输入批量数量', trigger: 'blur' },
+    { type: 'number', min: 1, max: 50, message: '批量数量必须在1-50之间', trigger: 'blur' },
+    { type: 'number', integer: true, message: '批量数量必须是整数', trigger: 'blur' }
+  ],
+  status: [
+    { required: true, message: '请选择状态', trigger: 'change' }
+  ]
+})
+const formRef = ref() // 表单 Ref
+const roleList = ref<RoleVO[]>([])
+
+/** 打开弹窗 */
+const open = async (type: string, id?: number) => {
+  dialogVisible.value = true
+  dialogTitle.value = t('action.' + type)
+  formType.value = type
+  resetForm()
+  
+  // 获取角色列表
+  await getRoleList()
+  
+  // 修改时，设置数据
+  if (id) {
+    formLoading.value = true
+    try {
+      const data = await InviteCodeApi.getInviteCode(id)
+      // 将字符串格式的roleIds转换为数组
+      if (data.roleIds && typeof data.roleIds === 'string') {
+        data.roleIds = data.roleIds.split(',').map(Number)
+      }
+      formData.value = data
+    } finally {
+      formLoading.value = false
+    }
+  }
+}
+
+/** 获取角色列表 */
+const getRoleList = async () => {
+  try {
+    roleList.value = await getSimpleRoleList()
+  } catch (error) {
+    console.error('获取角色列表失败:', error)
+    message.error('获取角色列表失败')
+  }
+}
+
+/** 生成随机邀请码 */
+const generateRandomCode = () => {
+  const characters = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789'
+  let result = ''
+  for (let i = 0; i < 10; i++) {
+    result += characters.charAt(Math.floor(Math.random() * characters.length))
+  }
+  formData.value.code = result
+}
+defineExpose({ open }) // 提供 open 方法，用于打开弹窗
+
+/** 提交表单 */
+const emit = defineEmits(['success']) // 定义 success 事件，用于操作成功后的回调
+const submitForm = async () => {
+  // 校验表单
+  await formRef.value.validate()
+  
+  // 准备提交数据
+  const submitData = { ...formData.value }
+  
+  // 将角色ID数组转换为逗号分隔的字符串
+  if (Array.isArray(submitData.roleIds)) {
+    submitData.roleIds = submitData.roleIds.join(',')
+  }
+  
+  // 提交请求
+  formLoading.value = true
+  try {
+    const data = submitData as unknown as InviteCodeVO
+    if (formType.value === 'create') {
+      await InviteCodeApi.createInviteCode(data)
+      message.success(t('common.createSuccess'))
+    } else {
+      await InviteCodeApi.updateInviteCode(data)
+      message.success(t('common.updateSuccess'))
+    }
+    dialogVisible.value = false
+    // 发送操作成功的事件
+    emit('success')
+  } finally {
+    formLoading.value = false
+  }
+}
+
+/** 重置表单 */
+const resetForm = () => {
+  formData.value = {
+    id: undefined,
+    code: undefined,
+    type: 'single',
+    batchCount: 1,
+    roleIds: [],
+    validTime: undefined,
+    expireTime: undefined,
+    useUserId: undefined,
+    useUserTenantId: undefined,
+    status: '1'
+  }
+  formRef.value?.resetFields()
+}
+</script>

src/views/system/invitecode/index.vue

@@ -0,0 +1,256 @@
+<template>
+  <ContentWrap>
+    <!-- 搜索工作栏 -->
+    <el-form
+      class="-mb-15px"
+      :model="queryParams"
+      ref="queryFormRef"
+      :inline="true"
+      label-width="80px"
+    >
+      <el-form-item label="邀请码" prop="code">
+        <el-input
+          v-model="queryParams.code"
+          placeholder="请输入邀请码"
+          clearable
+          @keyup.enter="handleQuery"
+          class="!w-240px"
+        />
+      </el-form-item>
+      <el-form-item label="绑定角色" prop="roleIds">
+        <el-input
+          v-model="queryParams.roleIds"
+          placeholder="请输入绑定角色"
+          clearable
+          @keyup.enter="handleQuery"
+          class="!w-240px"
+        />
+      </el-form-item>
+      <el-form-item label="过期时间" prop="expireTime">
+        <el-date-picker
+          v-model="queryParams.expireTime"
+          value-format="YYYY-MM-DD HH:mm:ss"
+          type="daterange"
+          start-placeholder="开始日期"
+          end-placeholder="结束日期"
+          :default-time="[new Date('1 00:00:00'), new Date('1 23:59:59')]"
+          class="!w-220px"
+        />
+      </el-form-item>
+      <el-form-item label="使用用户" prop="useUserId">
+        <el-input
+          v-model="queryParams.useUserId"
+          placeholder="请输入使用用户"
+          clearable
+          @keyup.enter="handleQuery"
+          class="!w-240px"
+        />
+      </el-form-item>
+      <el-form-item label="状态" prop="status">
+        <el-select
+          v-model="queryParams.status"
+          placeholder="请选择状态"
+          clearable
+          class="!w-240px"
+        >
+          <el-option label="请选择字典生成" 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-button
+          type="primary"
+          plain
+          @click="openForm('create')"
+          v-hasPermi="['system:invite-code:create']"
+        >
+          <Icon icon="ep:plus" class="mr-5px" /> 新增
+        </el-button>
+        <el-button
+          type="success"
+          plain
+          @click="handleExport"
+          :loading="exportLoading"
+          v-hasPermi="['system:invite-code:export']"
+        >
+          <Icon icon="ep:download" class="mr-5px" /> 导出
+        </el-button>
+      </el-form-item>
+    </el-form>
+  </ContentWrap>
+
+  <!-- 列表 -->
+  <ContentWrap>
+    <el-table v-loading="loading" :data="list" :stripe="true" :show-overflow-tooltip="true">
+      <el-table-column label="主键" align="center" prop="id" fixed="left"/>
+      <el-table-column label="邀请码" align="center" prop="code" fixed="left" width="140px" />
+      <el-table-column label="绑定角色" align="center" prop="roleNames" fixed="left" >
+        <template #default="scope">
+          <div style="display: flex; flex-direction: column; gap: 5px;">
+            <el-tag type="primary"
+                    v-for="roleName in scope.row.roleNames"
+                    :key="roleName"
+            >{{ roleName }}</el-tag>
+          </div>
+        </template>
+      </el-table-column>
+      <el-table-column label="有效期（天）" align="center" prop="validTime" fixed="left" />
+      <el-table-column label="状态" align="center" prop="status">
+        <template #default="scope">
+          <dict-tag :type="DICT_TYPE.COMMON_STATUS" :value="scope.row.useUserTenantId" />
+        </template>
+      </el-table-column>
+      <el-table-column label="使用用户" align="center" prop="useUserName" width="100px"/>
+      <el-table-column label="用户租户" align="center" prop="useUserTenantName" width="180px" />
+      <el-table-column
+        label="使用时间"
+        align="center"
+        prop="useTime"
+        :formatter="dateFormatter"
+        width="180px"
+      />
+      <el-table-column
+        label="过期时间"
+        align="center"
+        prop="expireTime"
+        :formatter="dateFormatter"
+        width="180px"
+      />
+      <el-table-column
+        label="创建时间"
+        align="center"
+        prop="createTime"
+        :formatter="dateFormatter"
+        width="180px"
+      />
+      <el-table-column label="操作" align="center" min-width="120px" fixed="right">
+        <template #default="scope">
+          <el-button
+            link
+            type="primary"
+            @click="openForm('update', scope.row.id)"
+            v-hasPermi="['system:invite-code:update']"
+          >
+            编辑
+          </el-button>
+          <el-button
+            link
+            type="danger"
+            :disabled="true"
+            @click="handleDelete(scope.row.id)"
+            v-hasPermi="['system:invite-code:delete']"
+          >
+            删除
+          </el-button>
+        </template>
+      </el-table-column>
+    </el-table>
+    <!-- 分页 -->
+    <Pagination
+      :total="total"
+      v-model:page="queryParams.pageNo"
+      v-model:limit="queryParams.pageSize"
+      @pagination="getList"
+    />
+  </ContentWrap>
+
+  <!-- 表单弹窗：添加/修改 -->
+  <InviteCodeForm ref="formRef" @success="getList" />
+</template>
+
+<script setup lang="ts">
+import { DICT_TYPE } from '@/utils/dict'
+import { dateFormatter } from '@/utils/formatTime'
+import download from '@/utils/download'
+import { InviteCodeApi, InviteCodeVO } from '@/api/system/invitecode'
+import InviteCodeForm from './InviteCodeForm.vue'
+
+/** 邀请码 列表 */
+defineOptions({ name: 'InviteCode' })
+
+const message = useMessage() // 消息弹窗
+const { t } = useI18n() // 国际化
+
+const loading = ref(true) // 列表的加载中
+const list = ref<InviteCodeVO[]>([]) // 列表的数据
+const total = ref(0) // 列表的总页数
+const queryParams = reactive({
+  pageNo: 1,
+  pageSize: 10,
+  code: undefined,
+  roleIds: undefined,
+  validTime: undefined,
+  expireTime: [],
+  useUserId: undefined,
+  useUserTenantId: undefined,
+  status: undefined,
+  createTime: [],
+  tenantId: undefined
+})
+const queryFormRef = ref() // 搜索的表单
+const exportLoading = ref(false) // 导出的加载中
+
+/** 查询列表 */
+const getList = async () => {
+  loading.value = true
+  try {
+    const data = await InviteCodeApi.getInviteCodePage(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 InviteCodeApi.deleteInviteCode(id)
+    message.success(t('common.delSuccess'))
+    // 刷新列表
+    await getList()
+  } catch {}
+}
+
+/** 导出按钮操作 */
+const handleExport = async () => {
+  try {
+    // 导出的二次确认
+    await message.exportConfirm()
+    // 发起导出
+    exportLoading.value = true
+    const data = await InviteCodeApi.exportInviteCode(queryParams)
+    download.excel(data, '邀请码.xls')
+  } catch {
+  } finally {
+    exportLoading.value = false
+  }
+}
+
+/** 初始化 **/
+onMounted(() => {
+  getList()
+})
+</script>