feat(adBanner): 新增广告位管理功能

- 实现广告位的增删改查接口
- 开发广告位列表页面，支持搜索和分页
- 添加广告位表单，支持图片上传和预览
- 实现广告位数据的导出功能
- 集成权限控制，确保操作安全
- 添加图片预览弹窗和上传状态管理

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

@@ -0,0 +1,63 @@
+import request from '@/utils/request';
+import { AxiosPromise } from 'axios';
+import { AdBannerVO, AdBannerForm, AdBannerQuery } from '@/api/system/physical/adBanner/types';
+
+/**
+ * 查询广告位列表
+ * @param query
+ * @returns {*}
+ */
+
+export const listAdBanner = (query?: AdBannerQuery): AxiosPromise<AdBannerVO[]> => {
+  return request({
+    url: '/physical/adBanner/list',
+    method: 'get',
+    params: query
+  });
+};
+
+/**
+ * 查询广告位详细
+ * @param id
+ */
+export const getAdBanner = (id: string | number): AxiosPromise<AdBannerVO> => {
+  return request({
+    url: '/physical/adBanner/' + id,
+    method: 'get'
+  });
+};
+
+/**
+ * 新增广告位
+ * @param data
+ */
+export const addAdBanner = (data: AdBannerForm) => {
+  return request({
+    url: '/physical/adBanner',
+    method: 'post',
+    data: data
+  });
+};
+
+/**
+ * 修改广告位
+ * @param data
+ */
+export const updateAdBanner = (data: AdBannerForm) => {
+  return request({
+    url: '/physical/adBanner',
+    method: 'put',
+    data: data
+  });
+};
+
+/**
+ * 删除广告位
+ * @param id
+ */
+export const delAdBanner = (id: string | number | Array<string | number>) => {
+  return request({
+    url: '/physical/adBanner/' + id,
+    method: 'delete'
+  });
+};

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

@@ -0,0 +1,140 @@
+export interface AdBannerVO {
+  /**
+   *
+   */
+  id: string | number;
+
+  /**
+   * 广告位位置，如 HOME_MAIN
+   */
+  position: string;
+
+  /**
+   * 图片地址（HTTPS）
+   */
+  imageUrl: string;
+
+  /**
+   * 点击跳转链接
+   */
+  linkUrl: string;
+
+  /**
+   * 排序序号，越小越靠前
+   */
+  sortOrder: number;
+
+  /**
+   * 状态：ENABLE / DISABLE
+   */
+  status: string;
+
+  /**
+   *
+   */
+  createdAt: string;
+
+  /**
+   *
+   */
+  updatedAt: string;
+
+  /**
+   * 软删除时间
+   */
+  deletedAt: string;
+}
+
+export interface AdBannerForm extends BaseEntity {
+  /**
+   *
+   */
+  id?: string | number;
+
+  /**
+   * 广告位位置，如 HOME_MAIN
+   */
+  position?: string;
+
+  /**
+   * 图片地址（HTTPS）
+   */
+  imageUrl?: string;
+
+  /**
+   * 点击跳转链接
+   */
+  linkUrl?: string;
+
+  /**
+   * 排序序号，越小越靠前
+   */
+  sortOrder?: number;
+
+  /**
+   * 状态：ENABLE / DISABLE
+   */
+  status?: string;
+
+  /**
+   *
+   */
+  createdAt?: string;
+
+  /**
+   *
+   */
+  updatedAt?: string;
+
+  /**
+   * 软删除时间
+   */
+  deletedAt?: string;
+}
+
+export interface AdBannerQuery extends PageQuery {
+  /**
+   * 广告位位置，如 HOME_MAIN
+   */
+  position?: string;
+
+  /**
+   * 图片地址（HTTPS）
+   */
+  imageUrl?: string;
+
+  /**
+   * 点击跳转链接
+   */
+  linkUrl?: string;
+
+  /**
+   * 排序序号，越小越靠前
+   */
+  sortOrder?: number;
+
+  /**
+   * 状态：ENABLE / DISABLE
+   */
+  status?: string;
+
+  /**
+   *
+   */
+  createdAt?: string;
+
+  /**
+   *
+   */
+  updatedAt?: string;
+
+  /**
+   * 软删除时间
+   */
+  deletedAt?: string;
+
+  /**
+   * 日期范围参数
+   */
+  params?: any;
+}

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

@@ -0,0 +1,364 @@
+<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="linkUrl">
+              <el-input v-model="queryParams.linkUrl" placeholder="请输入点击跳转链接" clearable @keyup.enter="handleQuery" />
+            </el-form-item>
+            <el-form-item label="排序序号" prop="sortOrder">
+              <el-input v-model="queryParams.sortOrder" 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:adBanner:add']">新增</el-button>
+          </el-col>
+          <el-col :span="1.5">
+            <el-button type="success" plain icon="Edit" :disabled="single" @click="handleUpdate()" v-hasPermi="['physical:adBanner:edit']"
+              >修改</el-button
+            >
+          </el-col>
+          <el-col :span="1.5">
+            <el-button type="danger" plain icon="Delete" :disabled="multiple" @click="handleDelete()" v-hasPermi="['physical:adBanner:remove']"
+              >删除</el-button
+            >
+          </el-col>
+          <el-col :span="1.5">
+            <el-button type="warning" plain icon="Download" @click="handleExport" v-hasPermi="['physical:adBanner: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="adBannerList" @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="图片地址" align="center" width="90">
+          <template #default="scope">
+            <el-image
+              v-if="scope.row.imageUrl"
+              :src="scope.row.imageUrl"
+              style="width: 40px; height: 40px; border-radius: 4px; cursor: zoom-in"
+              :preview-src-list="[scope.row.imageUrl]"
+              :preview-teleported="true"
+              fit="cover"
+            />
+            <span v-else></span>
+          </template>
+        </el-table-column>
+        <el-table-column label="跳转链接" align="center" prop="linkUrl" />
+        <el-table-column label="排序序号" align="center" prop="sortOrder" />
+        <el-table-column label="创建时间" align="center" prop="createdAt" width="180"></el-table-column>
+        <el-table-column label="更新时间" align="center" prop="updatedAt" width="180"></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:adBanner:edit']"></el-button>
+            </el-tooltip>
+            <el-tooltip content="删除" placement="top">
+              <el-button link type="primary" icon="Delete" @click="handleDelete(scope.row)" v-hasPermi="['physical:adBanner: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="500px" append-to-body>
+      <el-form ref="adBannerFormRef" :model="form" :rules="rules" label-width="80px">
+        <el-form-item label="图片地址" prop="icon">
+          <div class="upload-container">
+            <el-upload
+              class="upload-icon"
+              action="#"
+              :on-change="handleIconChange"
+              :on-remove="handleIconRemove"
+              :file-list="fileList"
+              :auto-upload="false"
+              :limit="1"
+              accept="image/*"
+            >
+              <template #trigger>
+                <el-button type="primary">点击选择图标</el-button>
+              </template>
+
+              <!-- 预览图区域 -->
+              <template #default>
+                <div class="preview-area" @click="handlePreviewClick">
+                  <!-- 只有当 iconPreviewUrl 或 competitionIcon 存在时才显示 img -->
+                  <img
+                    v-if="iconPreviewUrl || competitionIcon"
+                    :src="iconPreviewUrl || competitionIcon"
+                    alt="预览图"
+                    style="max-width: 100px; max-height: 100px; margin-top: 10px; cursor: pointer"
+                  />
+                  <!-- 可选：无图时显示提示文字 -->
+                  <div v-else style="margin-top: 10px; color: #999"></div>
+                </div>
+              </template>
+
+              <template #tip>
+                <div class="el-upload__tip">
+                  <span v-if="fileList.length > 0">当前已选文件：{{ fileList[0].name }}</span>
+                </div>
+              </template>
+            </el-upload>
+          </div>
+        </el-form-item>
+        <el-form-item label="跳转链接" prop="linkUrl">
+          <el-input v-model="form.linkUrl" type="textarea" placeholder="请输入内容" />
+        </el-form-item>
+        <el-form-item label="排序序号" prop="sortOrder">
+          <el-input v-model="form.sortOrder" 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>
+
+    <!-- 预览弹窗 -->
+    <el-dialog v-model="dialogVisible" title="图片预览" width="50%">
+      <img :src="previewSrc || iconPreviewUrl || competitionIcon" alt="预览图片" style="max-width: 100%; max-height: 80vh" />
+    </el-dialog>
+  </div>
+</template>
+
+<script setup name="AdBanner" lang="ts">
+import { listAdBanner, getAdBanner, delAdBanner, addAdBanner, updateAdBanner } from '@/api/system/physical/adBanner';
+import { AdBannerVO, AdBannerQuery, AdBannerForm } from '@/api/system/physical/adBanner/types';
+import { uploadTournament } from '@/api/system/business/tournaments';
+const { proxy } = getCurrentInstance() as ComponentInternalInstance;
+
+const adBannerList = ref<AdBannerVO[]>([]);
+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 adBannerFormRef = ref<ElFormInstance>();
+
+const dialog = reactive<DialogOption>({
+  visible: false,
+  title: ''
+});
+
+const initFormData: AdBannerForm = {
+  id: undefined,
+  position: undefined,
+  imageUrl: undefined,
+  linkUrl: undefined,
+  sortOrder: undefined,
+  status: undefined,
+  createdAt: undefined,
+  updatedAt: undefined,
+  deletedAt: undefined
+};
+const data = reactive<PageData<AdBannerForm, AdBannerQuery>>({
+  form: { ...initFormData },
+  queryParams: {
+    pageNum: 1,
+    pageSize: 10,
+    position: undefined,
+    imageUrl: undefined,
+    linkUrl: undefined,
+    sortOrder: undefined,
+    status: undefined,
+    createdAt: undefined,
+    updatedAt: undefined,
+    deletedAt: undefined,
+    params: {}
+  },
+  rules: {
+    id: [{ required: true, message: '不能为空', trigger: 'blur' }],
+    position: [{ required: true, message: '广告位位置，如 HOME_MAIN不能为空', trigger: 'blur' }],
+    imageUrl: [{ required: true, message: '图片地址不能为空', trigger: 'blur' }]
+  }
+});
+
+const { queryParams, form, rules } = toRefs(data);
+
+/** 查询广告位列表 */
+const getList = async () => {
+  loading.value = true;
+  const res = await listAdBanner(queryParams.value);
+  adBannerList.value = res.rows;
+  total.value = res.total;
+  loading.value = false;
+};
+
+/** 取消按钮 */
+const cancel = () => {
+  reset();
+  dialog.visible = false;
+};
+
+/** 表单重置 */
+const reset = () => {
+  form.value = { ...initFormData };
+  adBannerFormRef.value?.resetFields();
+};
+
+/** 搜索按钮操作 */
+const handleQuery = () => {
+  queryParams.value.pageNum = 1;
+  getList();
+};
+
+/** 重置按钮操作 */
+const resetQuery = () => {
+  queryFormRef.value?.resetFields();
+  handleQuery();
+};
+
+/** 多选框选中数据 */
+const handleSelectionChange = (selection: AdBannerVO[]) => {
+  ids.value = selection.map((item) => item.id);
+  single.value = selection.length != 1;
+  multiple.value = !selection.length;
+};
+
+/** 新增按钮操作 */
+const handleAdd = () => {
+  reset();
+  fileList.value = [];
+  // 清除预览图和临时链接
+  iconPreviewUrl.value = '';
+  competitionIcon.value = ''; // 如
+  dialog.visible = true;
+  dialog.title = '添加';
+};
+
+/** 修改按钮操作 */
+const handleUpdate = async (row?: AdBannerVO) => {
+  reset();
+  const _id = row?.id || ids.value[0];
+  const res = await getAdBanner(_id);
+  Object.assign(form.value, res.data);
+  iconPreviewUrl.value = res.data.imageUrl;
+  competitionIcon.value = res.data.imageUrl;
+  dialog.visible = true;
+  dialog.title = '修改';
+};
+
+/** 提交按钮 */
+const submitForm = () => {
+  adBannerFormRef.value?.validate(async (valid: boolean) => {
+    if (valid) {
+      buttonLoading.value = true;
+      if (form.value.id) {
+        await updateAdBanner(form.value).finally(() => (buttonLoading.value = false));
+      } else {
+        await addAdBanner(form.value).finally(() => (buttonLoading.value = false));
+      }
+      proxy?.$modal.msgSuccess('操作成功');
+      dialog.visible = false;
+      await getList();
+    }
+  });
+};
+
+/** 删除按钮操作 */
+const handleDelete = async (row?: AdBannerVO) => {
+  const _ids = row?.id || ids.value;
+  await proxy?.$modal.confirm('是否确认删除编号为"' + _ids + '"的数据项？').finally(() => (loading.value = false));
+  await delAdBanner(_ids);
+  proxy?.$modal.msgSuccess('删除成功');
+  await getList();
+};
+
+/** 导出按钮操作 */
+const handleExport = () => {
+  proxy?.download(
+    'physical/adBanner/export',
+    {
+      ...queryParams.value
+    },
+    `adBanner_${new Date().getTime()}.xlsx`
+  );
+};
+
+onMounted(() => {
+  getList();
+});
+
+//预览图标需要
+const iconPreviewUrl = ref('');
+const competitionIcon = ref('');
+const fileList = ref([]);
+const dialogVisible = ref(false);
+const previewSrc = ref('');
+const handleIconChange = async (file) => {
+  const index = fileList.value.findIndex((f) => f.uid === file.uid);
+  fileList.value = [];
+
+  if (file.raw) {
+    iconPreviewUrl.value = URL.createObjectURL(file.raw);
+  }
+
+  if (index === -1) {
+    // 如果文件不在列表中，则添加进去
+    fileList.value.push(file);
+  }
+
+  try {
+    const rawFile = file.raw;
+    const res = await uploadTournament(rawFile);
+    if (res.code === 200) {
+      // 更新文件状态为成功
+      fileList.value[index] = {
+        ...file,
+        status: 'success',
+        response: res.data.url
+      };
+      data.form.imageUrl = fileList.value[index].response;
+      iconPreviewUrl.value = fileList.value[index].response;
+      ElMessage.success('上传成功');
+    } else {
+      throw new Error(res.msg);
+    }
+  } catch (error) {
+    // 更新文件状态为失败
+    fileList.value[index] = {
+      ...file,
+      status: 'fail',
+      error: '上传失败'
+    };
+    ElMessage.error('上传失败，请重试');
+  }
+};
+// 删除文件处理函数
+const handleIconRemove = (file, updatedFileList) => {
+  fileList.value = updatedFileList;
+  // 清除预览图和临时链接
+  iconPreviewUrl.value = '';
+  competitionIcon.value = ''; // 如果需要清除后台加载的图标，可以在这里设置为空字符串
+};
+// 点击预览图触发放大
+const handlePreviewClick = () => {
+  const currentSrc = iconPreviewUrl.value || competitionIcon.value;
+  if (currentSrc) {
+    dialogVisible.value = true;
+  }
+};
+</script>