From 4965934c08620dff7f2ec2f10633e700b6a49210 Mon Sep 17 00:00:00 2001
From: SjS <email@example.com>
Date: Tue, 29 Apr 2025 10:46:08 +0800
Subject: [PATCH] =?UTF-8?q?=E8=A7=86=E9=A2=91=E6=95=99=E7=A8=8B=E6=A8=A1?=
 =?UTF-8?q?=E5=9D=97?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/api/bst/help.js          |  44 ++++
 src/utils/constants.js       |   6 +
 src/views/bst/help/index.vue | 385 +++++++++++++++++++++++++++++++++++
 3 files changed, 435 insertions(+)
 create mode 100644 src/api/bst/help.js
 create mode 100644 src/views/bst/help/index.vue

diff --git a/src/api/bst/help.js b/src/api/bst/help.js
new file mode 100644
index 0000000..cabd4ca
--- /dev/null
+++ b/src/api/bst/help.js
@@ -0,0 +1,44 @@
+import request from '@/utils/request'
+
+// 查询教程列表列表
+export function listHelp(query) {
+  return request({
+    url: '/bst/help/list',
+    method: 'get',
+    params: query
+  })
+}
+
+// 查询教程列表详细
+export function getHelp(id) {
+  return request({
+    url: '/bst/help/' + id,
+    method: 'get'
+  })
+}
+
+// 新增教程列表
+export function addHelp(data) {
+  return request({
+    url: '/bst/help',
+    method: 'post',
+    data: data
+  })
+}
+
+// 修改教程列表
+export function updateHelp(data) {
+  return request({
+    url: '/bst/help',
+    method: 'put',
+    data: data
+  })
+}
+
+// 删除教程列表
+export function delHelp(id) {
+  return request({
+    url: '/bst/help/' + id,
+    method: 'delete'
+  })
+}
diff --git a/src/utils/constants.js b/src/utils/constants.js
index a1e6d59..22d2c9a 100644
--- a/src/utils/constants.js
+++ b/src/utils/constants.js
@@ -9,6 +9,12 @@ export const UserType = {
   APP: "2"      // 普通用户
 }
 
+// 教程状态
+export const HelpStatus = {
+  ENABLED: "1", // 启用
+  DISABLED: "2", // 禁用
+}
+
 // 日期选择器快捷选项
 export const DatePickerOptions = {
   // 默认
diff --git a/src/views/bst/help/index.vue b/src/views/bst/help/index.vue
new file mode 100644
index 0000000..4afdcd5
--- /dev/null
+++ b/src/views/bst/help/index.vue
@@ -0,0 +1,385 @@
+<template>
+  <div class="app-container">
+    <el-form :model="queryParams" ref="queryForm" size="small" :inline="true" v-show="showSearch" label-width="68px">
+      <el-form-item label="标题" prop="title">
+        <el-input
+          v-model="queryParams.title"
+          placeholder="请输入标题"
+          clearable
+          @keyup.enter.native="handleQuery"
+        />
+      </el-form-item>
+      <el-form-item label="状态" prop="status">
+        <el-select v-model="queryParams.status" placeholder="请选择状态" clearable @change="handleQuery">
+          <el-option
+            v-for="dict in dict.type.help_status"
+            :key="dict.value"
+            :label="dict.label"
+            :value="dict.value"
+          />
+        </el-select>
+      </el-form-item>
+      <el-form-item label="视频url" prop="videoUrl">
+        <el-input
+          v-model="queryParams.videoUrl"
+          placeholder="请输入视频url"
+          clearable
+          @keyup.enter.native="handleQuery"
+        />
+      </el-form-item>
+      <el-form-item label="备注" prop="remark">
+        <el-input
+          v-model="queryParams.remark"
+          placeholder="请输入备注"
+          clearable
+          @keyup.enter.native="handleQuery"
+        />
+      </el-form-item>
+      <el-form-item label="编码" prop="code">
+        <el-input
+          v-model="queryParams.code"
+          placeholder="请输入编码"
+          clearable
+          @keyup.enter.native="handleQuery"
+        />
+      </el-form-item>
+      <el-form-item>
+        <el-button type="primary" icon="el-icon-search" size="mini" @click="handleQuery">搜索</el-button>
+        <el-button icon="el-icon-refresh" size="mini" @click="resetQuery">重置</el-button>
+      </el-form-item>
+    </el-form>
+
+    <el-row :gutter="10" class="mb8">
+      <el-col :span="1.5">
+        <el-button
+          type="primary"
+          plain
+          icon="el-icon-plus"
+          size="mini"
+          @click="handleAdd"
+          v-hasPermi="['ss:help:add']"
+        >新增</el-button>
+      </el-col>
+      <el-col :span="1.5">
+        <el-button
+          type="danger"
+          plain
+          icon="el-icon-delete"
+          size="mini"
+          :disabled="multiple"
+          @click="handleDelete"
+          v-hasPermi="['ss:help:remove']"
+        >删除</el-button>
+      </el-col>
+      <el-col :span="1.5">
+        <el-button
+          type="warning"
+          plain
+          icon="el-icon-download"
+          size="mini"
+          @click="handleExport"
+          v-hasPermi="['ss:help:export']"
+        >导出</el-button>
+      </el-col>
+      <right-toolbar :showSearch.sync="showSearch" @queryTable="getList" :columns="columns"></right-toolbar>
+    </el-row>
+
+    <el-table v-loading="loading" :data="helpList" @selection-change="handleSelectionChange" :default-sort="defaultSort"  @sort-change="onSortChange">
+      <el-table-column type="selection" width="55" align="center" />
+      <template v-for="column of showColumns">
+        <el-table-column
+            :key="column.key"
+            :label="column.label"
+            :prop="column.key"
+            :align="column.align"
+            :min-width="column.minWidth"
+            :sort-orders="orderSorts"
+            :sortable="column.sortable"
+            :show-overflow-tooltip="column.overflow"
+            :width="column.width"
+        >
+          <template slot-scope="d">
+            <template v-if="column.key === 'id'">
+              {{d.row[column.key]}}
+            </template>
+            <template v-else-if="column.key === 'status'">
+              <dict-tag :options="dict.type.help_status" :value="d.row[column.key]"/>
+            </template>
+            <template v-else-if="column.key === 'videoUrl'">
+              <video :src="d.row[column.key]" style="width: 90px; height: 60px;"></video>
+            </template>
+            <template v-else-if="column.key === 'coverUrl'">
+              <image-preview :src="d.row[column.key]" :width="90" :height="60"/>
+            </template>
+            <template v-else>
+              {{d.row[column.key]}}
+            </template>
+          </template>
+        </el-table-column>
+      </template>
+      <el-table-column label="操作" align="center" class-name="small-padding fixed-width">
+        <template slot-scope="scope">
+          <el-button
+            size="mini"
+            type="text"
+            icon="el-icon-edit"
+            @click="handleUpdate(scope.row)"
+            v-hasPermi="['ss:help:edit']"
+          >修改</el-button>
+          <el-button
+            size="mini"
+            type="text"
+            icon="el-icon-delete"
+            @click="handleDelete(scope.row)"
+            v-hasPermi="['ss:help:remove']"
+          >删除</el-button>
+        </template>
+      </el-table-column>
+    </el-table>
+
+    <pagination
+      v-show="total>0"
+      :total="total"
+      :page.sync="queryParams.pageNum"
+      :limit.sync="queryParams.pageSize"
+      @pagination="getList"
+    />
+
+    <!-- 添加或修改教程对话框 -->
+    <el-dialog :title="title" :visible.sync="open" width="800px" append-to-body>
+      <el-form ref="form" :model="form" :rules="rules" label-width="80px">
+        <el-row>
+          <form-col :span="span" label="标题" prop="title">
+            <el-input v-model="form.title" placeholder="请输入标题" />
+          </form-col>
+          <form-col :span="span" label="状态" prop="status">
+            <el-radio-group v-model="form.status">
+              <el-radio
+                v-for="dict in dict.type.help_status"
+                :key="dict.value"
+                :label="dict.value"
+              >{{dict.label}}</el-radio>
+            </el-radio-group>
+          </form-col>
+          <form-col :span="span" label="视频" prop="videoUrl">
+            <image-upload v-model="form.videoUrl" :limit="1" :file-size="200" :file-type="FileType.VIDEO"/>
+          </form-col>
+          <form-col :span="span" label="封面" prop="coverUrl">
+            <image-upload v-model="form.coverUrl" :limit="1" :file-type="FileType.IMAGE"/>
+          </form-col>
+          <form-col :span="span" label="备注" prop="remark">
+            <el-input v-model="form.remark" placeholder="请输入备注" />
+          </form-col>
+          <form-col :span="span" label="编码" prop="code">
+            <el-input v-model="form.code" placeholder="请输入编码" />
+          </form-col>
+        </el-row>
+      </el-form>
+      <div slot="footer" class="dialog-footer">
+        <el-button type="primary" @click="submitForm">确 定</el-button>
+        <el-button @click="cancel">取 消</el-button>
+      </div>
+    </el-dialog>
+  </div>
+</template>
+
+<script>
+import { listHelp, getHelp, delHelp, addHelp, updateHelp } from "@/api/bst/help";
+import { $showColumns } from '@/utils/mixins';
+import { FileType, HelpStatus } from '@/utils/constants';
+
+// 默认排序字段
+const defaultSort = {
+  prop: "createTime",
+  order: "descending"
+}
+
+export default {
+  name: "Help",
+  mixins: [$showColumns],
+  dicts: ['help_status'],
+  data() {
+    return {
+      span: 12,
+      HelpStatus,
+      FileType,
+      // 字段列表
+      columns: [
+        {key: 'id', visible: true, label: 'ID', minWidth: null, sortable: true, overflow: false, align: 'center', width: "80"},
+        {key: 'title', visible: true, label: '标题', minWidth: null, sortable: true, overflow: false, align: 'center', width: null},
+        {key: 'status', visible: true, label: '状态', minWidth: null, sortable: true, overflow: false, align: 'center', width: null},
+        {key: 'coverUrl', visible: true, label: '封面', minWidth: null, sortable: true, overflow: false, align: 'center', width: null},
+        {key: 'videoUrl', visible: true, label: '视频', minWidth: null, sortable: true, overflow: false, align: 'center', width: null},
+        {key: 'remark', visible: true, label: '备注', minWidth: null, sortable: true, overflow: false, align: 'center', width: null},
+        {key: 'code', visible: true, label: '编码', minWidth: null, sortable: true, overflow: false, align: 'center', width: null},
+        {key: 'createTime', visible: true, label: '创建时间', minWidth: null, sortable: true, overflow: false, align: 'center', width: null},
+        {key: 'updateTime', visible: true, label: '更新时间', minWidth: null, sortable: true, overflow: false, align: 'center', width: null},
+      ],
+      // 排序方式
+      orderSorts: ['ascending', 'descending', null],
+      // 遮罩层
+      loading: true,
+      // 选中数组
+      ids: [],
+      // 非单个禁用
+      single: true,
+      // 非多个禁用
+      multiple: true,
+      // 显示搜索条件
+      showSearch: true,
+      // 总条数
+      total: 0,
+      // 教程表格数据
+      helpList: [],
+      // 弹出层标题
+      title: "",
+      // 是否显示弹出层
+      open: false,
+      defaultSort,
+      // 查询参数
+      queryParams: {
+        pageNum: 1,
+        pageSize: 20,
+        orderByColumn: defaultSort.prop,
+        isAsc: defaultSort.order,
+        id: null,
+        title: null,
+        status: null,
+        videoUrl: null,
+        remark: null,
+        code: null
+      },
+      // 表单参数
+      form: {},
+      // 表单校验
+      rules: {
+        title: [
+          { required: true, message: "标题不能为空", trigger: "blur" }
+        ],
+        status: [
+          { required: true, message: "状态不能为空", trigger: "change" }
+        ],
+        videoUrl: [
+          { required: true, message: "视频url不能为空", trigger: "blur" }
+        ],
+        createTime: [
+          { required: true, message: "创建时间不能为空", trigger: "blur" }
+        ],
+      }
+    };
+  },
+  created() {
+    this.getList();
+  },
+  methods: {
+    /** 当排序按钮被点击时触发 **/
+    onSortChange(column) {
+      if (column.order == null) {
+        this.queryParams.orderByColumn = defaultSort.prop;
+        this.queryParams.isAsc = defaultSort.order;
+      } else {
+        this.queryParams.orderByColumn = column.prop;
+        this.queryParams.isAsc = column.order;
+      }
+      this.getList();
+    },
+    /** 查询教程列表 */
+    getList() {
+      this.loading = true;
+      listHelp(this.queryParams).then(response => {
+        this.helpList = response.rows;
+        this.total = response.total;
+        this.loading = false;
+      });
+    },
+    // 取消按钮
+    cancel() {
+      this.open = false;
+      this.reset();
+    },
+    // 表单重置
+    reset() {
+      this.form = {
+        id: null,
+        title: null,
+        status: HelpStatus.ENABLED,
+        videoUrl: null,
+        coverUrl: null,
+        createTime: null,
+        updateTime: null,
+        remark: null,
+        code: null
+      };
+      this.resetForm("form");
+    },
+    /** 搜索按钮操作 */
+    handleQuery() {
+      this.queryParams.pageNum = 1;
+      this.getList();
+    },
+    /** 重置按钮操作 */
+    resetQuery() {
+      this.resetForm("queryForm");
+      this.handleQuery();
+    },
+    // 多选框选中数据
+    handleSelectionChange(selection) {
+      this.ids = selection.map(item => item.id)
+      this.single = selection.length!==1
+      this.multiple = !selection.length
+    },
+    /** 新增按钮操作 */
+    handleAdd() {
+      this.reset();
+      this.open = true;
+      this.title = "添加教程";
+    },
+    /** 修改按钮操作 */
+    handleUpdate(row) {
+      this.reset();
+      const id = row.id || this.ids
+      getHelp(id).then(response => {
+        this.form = response.data;
+        this.open = true;
+        this.title = "修改教程";
+      });
+    },
+    /** 提交按钮 */
+    submitForm() {
+      this.$refs["form"].validate(valid => {
+        if (valid) {
+          if (this.form.id != null) {
+            updateHelp(this.form).then(response => {
+              this.$modal.msgSuccess("修改成功");
+              this.open = false;
+              this.getList();
+            });
+          } else {
+            addHelp(this.form).then(response => {
+              this.$modal.msgSuccess("新增成功");
+              this.open = false;
+              this.getList();
+            });
+          }
+        }
+      });
+    },
+    /** 删除按钮操作 */
+    handleDelete(row) {
+      const ids = row.id || this.ids;
+      this.$modal.confirm('是否确认删除教程编号为"' + ids + '"的数据项？').then(function() {
+        return delHelp(ids);
+      }).then(() => {
+        this.getList();
+        this.$modal.msgSuccess("删除成功");
+      }).catch(() => {});
+    },
+    /** 导出按钮操作 */
+    handleExport() {
+      this.download('ss/help/export', {
+        ...this.queryParams
+      }, `help_${new Date().getTime()}.xlsx`)
+    }
+  }
+};
+</script>