feat(system): 添加使用条款管理功能

- 新增使用条款管理相关的 API 接口和类型定义- 实现使用条款管理的列表查询、详情查看、添加、修改和删除功能
- 添加使用条款的 H5 页面展示功能
- 集成富文本编辑器和 HTML 内容净化库

package.json

@@ -22,12 +22,14 @@
   "dependencies": {
     "@element-plus/icons-vue": "2.3.1",
     "@highlightjs/vue-plugin": "2.1.0",
+    "@tinymce/tinymce-vue": "^6.2.0",
     "@vueup/vue-quill": "1.2.0",
     "@vueuse/core": "13.1.0",
     "animate.css": "4.1.1",
     "await-to-js": "3.0.0",
     "axios": "1.8.4",
     "crypto-js": "4.2.0",
+    "dompurify": "^3.2.6",
     "echarts": "5.6.0",
     "element-plus": "2.9.8",
     "file-saver": "2.0.5",
@@ -38,9 +40,10 @@
     "nprogress": "0.2.0",
     "pinia": "3.0.2",
     "screenfull": "6.0.2",
+    "tinymce": "^7.9.1",
     "vue": "3.5.13",
     "vue-cropper": "1.1.1",
-    "vue-i18n": "11.1.3",
+    "vue-i18n": "^11.1.10",
     "vue-json-pretty": "2.4.0",
     "vue-router": "4.5.0",
     "vue-types": "6.0.0",
@@ -62,7 +65,7 @@
     "@vue/eslint-config-prettier": "10.2.0",
     "@vue/eslint-config-typescript": "14.4.0",
     "autoprefixer": "10.4.20",
-    "eslint": "9.21.0",
+    "eslint": "^9.31.0",
     "eslint-plugin-prettier": "5.2.3",
     "eslint-plugin-vue": "9.32.0",
     "globals": "16.0.0",
@@ -74,7 +77,7 @@
     "unplugin-icons": "22.1.0",
     "unplugin-vue-components": "28.5.0",
     "unplugin-vue-setup-extend-plus": "1.0.1",
-    "vite": "6.3.2",
+    "vite": "^6.3.5",
     "vite-plugin-compression": "0.5.1",
     "vite-plugin-svg-icons-ng": "^1.4.0",
     "vite-plugin-vue-devtools": "7.7.5",

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

@@ -0,0 +1,74 @@
+import request from '@/utils/request';
+import { AxiosPromise } from 'axios';
+import { OfServiceVO, OfServiceForm, OfServiceQuery } from '@/api/system/business/ofService/types';
+
+/**
+ * 查询使用条款管理列表
+ * @param query
+ * @returns {*}
+ */
+
+export const listOfService = (query?: OfServiceQuery): AxiosPromise<OfServiceVO[]> => {
+  return request({
+    url: '/business/ofService/list',
+    method: 'get',
+    params: query
+  });
+};
+
+/**
+ * 查询使用条款管理详细
+ * @param id
+ */
+export const getOfService = (id: string | number): AxiosPromise<OfServiceVO> => {
+  return request({
+    url: '/business/ofService/' + id,
+    method: 'get'
+  });
+};
+
+/**
+ * 新增使用条款管理
+ * @param data
+ */
+export const addOfService = (data: OfServiceForm) => {
+  return request({
+    url: '/business/ofService',
+    method: 'post',
+    data: data
+  });
+};
+
+/**
+ * 修改使用条款管理
+ * @param data
+ */
+export const updateOfService = (data: OfServiceForm) => {
+  return request({
+    url: '/business/ofService',
+    method: 'put',
+    data: data
+  });
+};
+
+/**
+ * 删除使用条款管理
+ * @param id
+ */
+export const delOfService = (id: string | number | Array<string | number>) => {
+  return request({
+    url: '/business/ofService/' + id,
+    method: 'delete'
+  });
+};
+
+/**
+ * 查询默认数据展示H5页面 接口
+ * @param id
+ */
+export const getTermsServiceListMax = (): AxiosPromise<OfServiceVO> => {
+  return request({
+    url: '/business/ofService/selectTermsServiceListMax',
+    method: 'get'
+  });
+};

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

@@ -0,0 +1,83 @@
+export interface OfServiceVO {
+  /**
+   * 主键
+   */
+  id: string | number;
+
+  /**
+   * 条款标题（如：使用条款、隐私协议等）
+   */
+  title: string;
+
+  /**
+   * 条款内容（HTML格式）
+   */
+  content: string;
+
+  /**
+   * 语言代码，如 zh-CN, en-US
+   */
+  language: string;
+
+  /**
+   * 是否为默认版本
+   */
+  isDefault: number;
+
+}
+
+export interface OfServiceForm extends BaseEntity {
+  /**
+   * 主键
+   */
+  id?: string | number;
+
+  /**
+   * 条款标题（如：使用条款、隐私协议等）
+   */
+  title?: string;
+
+  /**
+   * 条款内容（HTML格式）
+   */
+  content?: string;
+
+  /**
+   * 语言代码，如 zh-CN, en-US
+   */
+  language?: string;
+
+  /**
+   * 是否为默认版本
+   */
+  isDefault?: number;
+
+}
+
+export interface OfServiceQuery extends PageQuery {
+
+  /**
+   * 条款标题（如：使用条款、隐私协议等）
+   */
+  title?: string;
+
+  /**
+   * 条款内容（HTML格式）
+   */
+  content?: string;
+
+  /**
+   * 语言代码，如 zh-CN, en-US
+   */
+  language?: string;
+
+  /**
+   * 是否为默认版本
+   */
+  isDefault?: number;
+
+  /**
+   * 日期范围参数
+   */
+  params?: any;
+}

src/permission.ts

@@ -11,7 +11,7 @@ import { usePermissionStore } from '@/store/modules/permission';
 import { ElMessage } from 'element-plus/es';
 
 NProgress.configure({ showSpinner: false });
-const whiteList = ['/login', '/register', '/social-callback', '/register*', '/register/*'];
+const whiteList = ['/login', '/register', '/social-callback', '/register*', '/register/*', '/ofService'];
 
 const isWhiteList = (path: string) => {
   return whiteList.some((pattern) => isPathMatch(pattern, path));

src/router/index.ts

@@ -88,6 +88,11 @@ export const constantRoutes: RouteRecordRaw[] = [
         meta: { title: '个人中心', icon: 'user' }
       }
     ]
+  },
+  {
+    path: '/ofService',
+    component: () => import('@/views/system/business/ofService/indexPreview.vue'),
+    hidden: true
   }
 ];
 

src/views/system/business/ofService/index.vue

@@ -0,0 +1,244 @@
+<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="title">
+              <el-input v-model="queryParams.title" 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="['system:ofService:add']">新增</el-button>
+          </el-col>
+          <el-col :span="1.5">
+            <el-button type="success" plain icon="Edit" :disabled="single" @click="handleUpdate()" v-hasPermi="['system:ofService:edit']"
+              >修改</el-button
+            >
+          </el-col>
+          <el-col :span="1.5">
+            <el-button type="danger" plain icon="Delete" :disabled="multiple" @click="handleDelete()" v-hasPermi="['system:ofService:remove']"
+              >删除</el-button
+            >
+          </el-col>
+<!--          <el-col :span="1.5">
+            <el-button type="warning" plain icon="Download" @click="handleExport" v-hasPermi="['system:ofService: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="ofServiceList" @selection-change="handleSelectionChange">
+        <el-table-column type="selection" width="55" align="center" />
+        <el-table-column label="主键" align="center" prop="id" v-if="false" />
+        <el-table-column label="条款标题" align="center" prop="title" />
+        <el-table-column label="条款内容" align="center" prop="contentText" :show-overflow-tooltip="true" />
+        <el-table-column label="语言代码" align="center" prop="language" />
+        <el-table-column label="是否为默认版本" align="center" prop="isDefault">
+          <template #default="scope">
+            <el-tag v-if="scope.row.isDefault === 1" type="success">是</el-tag>
+            <el-tag v-else type="info">否</el-tag>
+          </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="['system:ofService:edit']"></el-button>
+            </el-tooltip>
+            <el-tooltip content="删除" placement="top">
+              <el-button link type="primary" icon="Delete" @click="handleDelete(scope.row)" v-hasPermi="['system:ofService: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="ofServiceFormRef" :model="form" :rules="rules" label-width="80px">
+        <el-form-item label="条款标题" prop="title">
+          <el-input v-model="form.title" placeholder="请输入条款标题" />
+        </el-form-item>
+        <el-form-item label="条款内容" prop="content">
+          <editor v-model="form.content" :min-height="192" />
+        </el-form-item>
+<!--        <el-form-item label="语言代码，如 zh-CN, en-US" prop="language">
+          <el-input v-model="form.language" placeholder="请输入语言代码，如 zh-CN, en-US" />
+        </el-form-item>-->
+        <el-form-item label="默认版本" prop="isDefault">
+          <el-radio-group v-model="form.isDefault">
+            <el-radio :label="1">是</el-radio>
+            <el-radio :label="0">否</el-radio>
+          </el-radio-group>
+        </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="OfService" lang="ts">
+import { listOfService, getOfService, delOfService, addOfService, updateOfService } from '@/api/system/business/ofService';
+import { OfServiceVO, OfServiceQuery, OfServiceForm } from '@/api/system/business/ofService/types';
+
+const { proxy } = getCurrentInstance() as ComponentInternalInstance;
+
+const ofServiceList = ref<OfServiceVO[]>([]);
+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 ofServiceFormRef = ref<ElFormInstance>();
+
+const dialog = reactive<DialogOption>({
+  visible: false,
+  title: ''
+});
+
+const initFormData: OfServiceForm = {
+  id: undefined,
+  title: undefined,
+  content: undefined,
+  language: undefined,
+  isDefault: undefined
+};
+const data = reactive<PageData<OfServiceForm, OfServiceQuery>>({
+  form: { ...initFormData },
+  queryParams: {
+    pageNum: 1,
+    pageSize: 10,
+    title: undefined,
+    content: undefined,
+    language: undefined,
+    isDefault: undefined,
+    params: {}
+  },
+  rules: {
+    id: [{ required: true, message: '主键不能为空', trigger: 'blur' }],
+    title: [{ required: true, message: '条款标题不能为空', trigger: 'blur' }],
+    content: [{ required: true, message: '条款内容不能为空', trigger: 'blur' }]
+  }
+});
+
+const { queryParams, form, rules } = toRefs(data);
+
+/** 查询使用条款管理列表 */
+const getList = async () => {
+  loading.value = true;
+  const res = await listOfService(queryParams.value);
+  ofServiceList.value = res.rows;
+  total.value = res.total;
+  loading.value = false;
+};
+
+/** 取消按钮 */
+const cancel = () => {
+  reset();
+  dialog.visible = false;
+};
+
+/** 表单重置 */
+const reset = () => {
+  form.value = { ...initFormData };
+  ofServiceFormRef.value?.resetFields();
+};
+
+/** 搜索按钮操作 */
+const handleQuery = () => {
+  queryParams.value.pageNum = 1;
+  getList();
+};
+
+/** 重置按钮操作 */
+const resetQuery = () => {
+  queryFormRef.value?.resetFields();
+  handleQuery();
+};
+
+/** 多选框选中数据 */
+const handleSelectionChange = (selection: OfServiceVO[]) => {
+  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?: OfServiceVO) => {
+  reset();
+  const _id = row?.id || ids.value[0];
+  const res = await getOfService(_id);
+  Object.assign(form.value, res.data);
+  dialog.visible = true;
+  dialog.title = '修改';
+};
+
+/** 提交按钮 */
+const submitForm = () => {
+  ofServiceFormRef.value?.validate(async (valid: boolean) => {
+    if (valid) {
+      buttonLoading.value = true;
+      if (form.value.id) {
+        await updateOfService(form.value).finally(() => (buttonLoading.value = false));
+      } else {
+        await addOfService(form.value).finally(() => (buttonLoading.value = false));
+      }
+      proxy?.$modal.msgSuccess('操作成功');
+      dialog.visible = false;
+      await getList();
+    }
+  });
+};
+
+/** 删除按钮操作 */
+const handleDelete = async (row?: OfServiceVO) => {
+  const _ids = row?.id || ids.value;
+  await proxy?.$modal.confirm('是否确认删除使用条款管理编号为"' + _ids + '"的数据项？').finally(() => (loading.value = false));
+  await delOfService(_ids);
+  proxy?.$modal.msgSuccess('删除成功');
+  await getList();
+};
+
+/** 导出按钮操作 */
+const handleExport = () => {
+  proxy?.download(
+    'system/ofService/export',
+    {
+      ...queryParams.value
+    },
+    `ofService_${new Date().getTime()}.xlsx`
+  );
+};
+
+onMounted(() => {
+  getList();
+});
+</script>

src/views/system/business/ofService/indexPreview.vue

@@ -0,0 +1,36 @@
+<template>
+  <div class="tos-container">
+    <el-card>
+      <div v-html="tosContent"></div>
+    </el-card>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { ref, onMounted } from 'vue';
+import DOMPurify from 'dompurify';
+import { getTermsServiceListMax } from '@/api/system/business/ofService';
+
+const tosContent = ref('');
+const language = ref('zh-CN');
+
+onMounted(() => {
+  fetchTos();
+});
+
+const fetchTos = async () => {
+  try {
+    const res = await getTermsServiceListMax();
+    debugger;
+    tosContent.value = DOMPurify.sanitize(res.data.content);
+  } catch (error) {
+    console.error('获取服务条款失败', error);
+  }
+};
+</script>
+
+<style scoped>
+.tos-container {
+  padding: 20px;
+}
+</style>