916 lines
30 KiB
Markdown
916 lines
30 KiB
Markdown
|
# 缘池管理端设计文档
|
|||
|
|
|
|||
|
|
> 版本：V1.0
|
|||
|
|
> 更新日期：2025-12-30
|
|||
|
|
> 功能范围：板块管理 + 消息管理 + 自动审核
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 一、功能概述
|
|||
|
|
|
|||
|
|
缘池是直播平台的社交社区模块，用户可在不同板块发布消息进行交流。管理端提供板块配置、消息审核、自动审核规则设置等功能。
|
|||
|
|
|
|||
|
|
### 1.1 功能结构
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
缘池管理 (/community)
|
|||
|
|
├── 板块管理 - 配置社区板块分类
|
|||
|
|
├── 消息管理 - 查看/审核/管理用户消息
|
|||
|
|
└── 审核配置 - 自动审核规则设置
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 1.2 自动审核机制
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
用户发布消息 → 敏感词检测 → 自动判定
|
|||
|
|
↓
|
|||
|
|
┌──────────┼──────────┐
|
|||
|
|
↓ ↓ ↓
|
|||
|
|
无敏感词 轻度敏感 重度敏感
|
|||
|
|
↓ ↓ ↓
|
|||
|
|
自动通过 待人工审核 自动拒绝
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 二、前端设计
|
|||
|
|
|
|||
|
|
### 2.1 路由配置
|
|||
|
|
|
|||
|
|
文件：`Zhibo/admin/src/router/modules/communityManage.js`
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
import Layout from '@/layout';
|
|||
|
|
|
|||
|
|
const communityManageRouter = {
|
|||
|
|
path: '/community',
|
|||
|
|
component: Layout,
|
|||
|
|
redirect: '/community/category',
|
|||
|
|
name: 'Community',
|
|||
|
|
alwaysShow: true,
|
|||
|
|
meta: {
|
|||
|
|
title: '缘池管理',
|
|||
|
|
icon: 'el-icon-s-opportunity',
|
|||
|
|
},
|
|||
|
|
children: [
|
|||
|
|
{
|
|||
|
|
path: 'category',
|
|||
|
|
component: () => import('@/views/community/category/index'),
|
|||
|
|
name: 'CommunityCategory',
|
|||
|
|
meta: { title: '板块管理', icon: '' },
|
|||
|
|
},
|
|||
|
|
{
|
|||
|
|
path: 'message',
|
|||
|
|
component: () => import('@/views/community/message/index'),
|
|||
|
|
name: 'CommunityMessage',
|
|||
|
|
meta: { title: '消息管理', icon: '' },
|
|||
|
|
},
|
|||
|
|
{
|
|||
|
|
path: 'audit-config',
|
|||
|
|
component: () => import('@/views/community/auditConfig/index'),
|
|||
|
|
name: 'CommunityAuditConfig',
|
|||
|
|
meta: { title: '审核配置', icon: '' },
|
|||
|
|
},
|
|||
|
|
],
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
export default communityManageRouter;
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 2.2 API接口
|
|||
|
|
|
|||
|
|
文件：`Zhibo/admin/src/api/community.js`
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
import request from '@/utils/request';
|
|||
|
|
|
|||
|
|
// ==================== 板块管理 ====================
|
|||
|
|
|
|||
|
|
// 获取板块列表
|
|||
|
|
export function categoryList(params) {
|
|||
|
|
return request({
|
|||
|
|
url: '/admin/community/category/list',
|
|||
|
|
method: 'get',
|
|||
|
|
params,
|
|||
|
|
});
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 保存板块(新增/编辑)
|
|||
|
|
export function categorySave(data) {
|
|||
|
|
return request({
|
|||
|
|
url: '/admin/community/category/save',
|
|||
|
|
method: 'post',
|
|||
|
|
data,
|
|||
|
|
});
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 删除板块
|
|||
|
|
export function categoryDelete(id) {
|
|||
|
|
return request({
|
|||
|
|
url: `/admin/community/category/delete/${id}`,
|
|||
|
|
method: 'delete',
|
|||
|
|
});
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 更新板块状态
|
|||
|
|
export function categoryStatus(data) {
|
|||
|
|
return request({
|
|||
|
|
url: '/admin/community/category/status',
|
|||
|
|
method: 'post',
|
|||
|
|
data,
|
|||
|
|
});
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// ==================== 消息管理 ====================
|
|||
|
|
|
|||
|
|
// 获取消息列表(分页)
|
|||
|
|
export function messageList(data) {
|
|||
|
|
return request({
|
|||
|
|
url: '/admin/community/message/list',
|
|||
|
|
method: 'post',
|
|||
|
|
data,
|
|||
|
|
});
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 审核消息
|
|||
|
|
export function messageAudit(data) {
|
|||
|
|
return request({
|
|||
|
|
url: '/admin/community/message/audit',
|
|||
|
|
method: 'post',
|
|||
|
|
data,
|
|||
|
|
});
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 删除消息
|
|||
|
|
export function messageDelete(id) {
|
|||
|
|
return request({
|
|||
|
|
url: `/admin/community/message/delete/${id}`,
|
|||
|
|
method: 'delete',
|
|||
|
|
});
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// ==================== 审核配置 ====================
|
|||
|
|
|
|||
|
|
// 获取审核配置
|
|||
|
|
export function getAuditConfig() {
|
|||
|
|
return request({
|
|||
|
|
url: '/admin/community/audit/config',
|
|||
|
|
method: 'get',
|
|||
|
|
});
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 保存审核配置
|
|||
|
|
export function saveAuditConfig(data) {
|
|||
|
|
return request({
|
|||
|
|
url: '/admin/community/audit/config/save',
|
|||
|
|
method: 'post',
|
|||
|
|
data,
|
|||
|
|
});
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 2.3 页面设计
|
|||
|
|
|
|||
|
|
#### 2.3.1 板块管理页面
|
|||
|
|
|
|||
|
|
文件：`Zhibo/admin/src/views/community/category/index.vue`
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
┌─────────────────────────────────────────────────────────────┐
|
|||
|
|
│ [+ 新增板块] │
|
|||
|
|
├─────────────────────────────────────────────────────────────┤
|
|||
|
|
│ 图标 │ 名称 │ 排序 │ 状态 │ 创建时间 │ 操作 │
|
|||
|
|
├──────┼────────┼──────┼────────┼────────────┼───────────────┤
|
|||
|
|
│ 🎮 │ 游戏 │ 100 │ ●启用 │ 2025-01-01 │ [编辑][删除] │
|
|||
|
|
│ 🎵 │ 音乐 │ 90 │ ●启用 │ 2025-01-01 │ [编辑][删除] │
|
|||
|
|
│ 💬 │ 交友 │ 80 │ ○禁用 │ 2025-01-01 │ [编辑][删除] │
|
|||
|
|
└─────────────────────────────────────────────────────────────┘
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**功能说明：**
|
|||
|
|
- 新增板块：弹窗表单，填写名称、图标、排序
|
|||
|
|
- 编辑板块：弹窗表单，修改板块信息
|
|||
|
|
- 删除板块：确认弹窗后删除
|
|||
|
|
- 状态切换：开关组件，启用/禁用板块
|
|||
|
|
|
|||
|
|
#### 2.3.2 消息管理页面
|
|||
|
|
|
|||
|
|
文件：`Zhibo/admin/src/views/community/message/index.vue`
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
┌─────────────────────────────────────────────────────────────────────┐
|
|||
|
|
│ 板块[全部▼] 状态[全部▼] 审核方式[全部▼] 时间[起始-结束] [搜索] │
|
|||
|
|
├─────────────────────────────────────────────────────────────────────┤
|
|||
|
|
│ 用户 │ 板块 │ 内容 │ 图片 │ 状态 │ 审核方式│ 操作 │
|
|||
|
|
├──────────┼──────┼──────────────┼──────┼────────┼─────────┼─────────┤
|
|||
|
|
│ 👤张三 │ 游戏 │ 今天开黑吗.. │ 🖼x2 │ 已通过 │ 自动 │ [删除] │
|
|||
|
|
│ 👤李四 │ 交友 │ 有人一起.. │ 🖼x1 │ 待审核 │ - │ [✓][✗] │
|
|||
|
|
│ 👤王五 │ 音乐 │ 推荐一首.. │ - │ 已拒绝 │ 自动 │ [删除] │
|
|||
|
|
└─────────────────────────────────────────────────────────────────────┘
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**筛选条件：**
|
|||
|
|
- 板块：下拉选择板块
|
|||
|
|
- 状态：全部/待审核/已通过/已拒绝
|
|||
|
|
- 审核方式：全部/自动/人工
|
|||
|
|
- 时间范围：日期选择器
|
|||
|
|
|
|||
|
|
**操作说明：**
|
|||
|
|
- 待审核消息：显示[通过][拒绝]按钮
|
|||
|
|
- 已审核消息：显示[删除]按钮
|
|||
|
|
- 点击内容可展开查看完整内容和图片
|
|||
|
|
|
|||
|
|
#### 2.3.3 审核配置页面
|
|||
|
|
|
|||
|
|
文件：`Zhibo/admin/src/views/community/auditConfig/index.vue`
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
┌─────────────────────────────────────────────────────────────┐
|
|||
|
|
│ 自动审核配置 │
|
|||
|
|
├─────────────────────────────────────────────────────────────┤
|
|||
|
|
│ │
|
|||
|
|
│ 开启自动审核 [========●] │
|
|||
|
|
│ 说明：开启后系统自动检测敏感词并审核 │
|
|||
|
|
│ │
|
|||
|
|
│ 无敏感词自动通过 [========●] │
|
|||
|
|
│ 说明：消息不含敏感词时自动通过审核 │
|
|||
|
|
│ │
|
|||
|
|
│ 重度敏感词自动拒绝 [========●] │
|
|||
|
|
│ 说明：消息含违禁词时自动拒绝 │
|
|||
|
|
│ │
|
|||
|
|
│ [保存配置] │
|
|||
|
|
└─────────────────────────────────────────────────────────────┘
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 三、数据库设计
|
|||
|
|
|
|||
|
|
### 3.1 板块表 (eb_community_category)
|
|||
|
|
|
|||
|
|
| 字段 | 类型 | 说明 |
|
|||
|
|
|------|------|------|
|
|||
|
|
| id | int | 板块ID，主键自增 |
|
|||
|
|
| name | varchar(50) | 板块名称 |
|
|||
|
|
| icon | varchar(255) | 板块图标URL |
|
|||
|
|
| sort | int | 排序(越大越靠前) |
|
|||
|
|
| status | tinyint | 状态 0禁用 1启用 |
|
|||
|
|
| create_time | datetime | 创建时间 |
|
|||
|
|
| update_time | datetime | 更新时间 |
|
|||
|
|
|
|||
|
|
### 3.2 消息表 (eb_community_message)
|
|||
|
|
|
|||
|
|
| 字段 | 类型 | 说明 |
|
|||
|
|
|------|------|------|
|
|||
|
|
| id | bigint | 消息ID，主键自增 |
|
|||
|
|
| uid | int | 用户ID |
|
|||
|
|
| category_id | int | 板块ID |
|
|||
|
|
| content | text | 消息内容 |
|
|||
|
|
| images | varchar(1000) | 图片URL(逗号分隔) |
|
|||
|
|
| status | tinyint | 状态 0待审核 1通过 2拒绝 |
|
|||
|
|
| audit_type | tinyint | 审核方式 0自动 1人工 |
|
|||
|
|
| audit_remark | varchar(255) | 审核备注 |
|
|||
|
|
| is_delete | tinyint | 是否删除 0否 1是 |
|
|||
|
|
| create_time | datetime | 创建时间 |
|
|||
|
|
| update_time | datetime | 更新时间 |
|
|||
|
|
|
|||
|
|
### 3.3 审核配置表 (eb_community_audit_config)
|
|||
|
|
|
|||
|
|
| 字段 | 类型 | 说明 |
|
|||
|
|
|------|------|------|
|
|||
|
|
| id | int | 配置ID，固定为1 |
|
|||
|
|
| auto_audit | tinyint | 开启自动审核 0关闭 1开启 |
|
|||
|
|
| auto_pass | tinyint | 无敏感词自动通过 0否 1是 |
|
|||
|
|
| auto_reject | tinyint | 重度敏感词自动拒绝 0否 1是 |
|
|||
|
|
| update_time | datetime | 更新时间 |
|
|||
|
|
|
|||
|
|
### 3.4 建表SQL
|
|||
|
|
|
|||
|
|
```sql
|
|||
|
|
-- ============================================
|
|||
|
|
-- 缘池管理数据库表
|
|||
|
|
-- ============================================
|
|||
|
|
|
|||
|
|
-- 1. 板块表
|
|||
|
|
CREATE TABLE `eb_community_category` (
|
|||
|
|
`id` int NOT NULL AUTO_INCREMENT COMMENT '板块ID',
|
|||
|
|
`name` varchar(50) NOT NULL COMMENT '板块名称',
|
|||
|
|
`icon` varchar(255) DEFAULT '' COMMENT '板块图标URL',
|
|||
|
|
`sort` int DEFAULT 0 COMMENT '排序(越大越靠前)',
|
|||
|
|
`status` tinyint DEFAULT 1 COMMENT '状态 0禁用 1启用',
|
|||
|
|
`create_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
|
|||
|
|
`update_time` datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
|
|||
|
|
PRIMARY KEY (`id`)
|
|||
|
|
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='缘池板块表';
|
|||
|
|
|
|||
|
|
-- 2. 消息表
|
|||
|
|
CREATE TABLE `eb_community_message` (
|
|||
|
|
`id` bigint NOT NULL AUTO_INCREMENT COMMENT '消息ID',
|
|||
|
|
`uid` int NOT NULL COMMENT '用户ID',
|
|||
|
|
`category_id` int NOT NULL COMMENT '板块ID',
|
|||
|
|
`content` text COMMENT '消息内容',
|
|||
|
|
`images` varchar(1000) DEFAULT '' COMMENT '图片URL(逗号分隔)',
|
|||
|
|
`status` tinyint DEFAULT 1 COMMENT '状态 0待审核 1通过 2拒绝',
|
|||
|
|
`audit_type` tinyint DEFAULT 0 COMMENT '审核方式 0自动 1人工',
|
|||
|
|
`audit_remark` varchar(255) DEFAULT '' COMMENT '审核备注(敏感词等)',
|
|||
|
|
`is_delete` tinyint DEFAULT 0 COMMENT '是否删除 0否 1是',
|
|||
|
|
`create_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
|
|||
|
|
`update_time` datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
|
|||
|
|
PRIMARY KEY (`id`),
|
|||
|
|
KEY `idx_uid` (`uid`),
|
|||
|
|
KEY `idx_category` (`category_id`),
|
|||
|
|
KEY `idx_status` (`status`)
|
|||
|
|
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='缘池消息表';
|
|||
|
|
|
|||
|
|
-- 3. 审核配置表
|
|||
|
|
CREATE TABLE `eb_community_audit_config` (
|
|||
|
|
`id` int NOT NULL AUTO_INCREMENT,
|
|||
|
|
`auto_audit` tinyint DEFAULT 1 COMMENT '开启自动审核 0关闭 1开启',
|
|||
|
|
`auto_pass` tinyint DEFAULT 1 COMMENT '无敏感词自动通过 0否 1是',
|
|||
|
|
`auto_reject` tinyint DEFAULT 1 COMMENT '重度敏感词自动拒绝 0否 1是',
|
|||
|
|
`update_time` datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
|
|||
|
|
PRIMARY KEY (`id`)
|
|||
|
|
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='缘池审核配置表';
|
|||
|
|
|
|||
|
|
-- 初始化审核配置
|
|||
|
|
INSERT INTO `eb_community_audit_config` (`id`, `auto_audit`, `auto_pass`, `auto_reject`)
|
|||
|
|
VALUES (1, 1, 1, 1);
|
|||
|
|
|
|||
|
|
-- 初始化默认板块
|
|||
|
|
INSERT INTO `eb_community_category` (`name`, `icon`, `sort`, `status`) VALUES
|
|||
|
|
('交友', 'el-icon-user', 100, 1),
|
|||
|
|
('游戏', 'el-icon-video-play', 90, 1),
|
|||
|
|
('音乐', 'el-icon-headset', 80, 1),
|
|||
|
|
('运动', 'el-icon-football', 70, 1),
|
|||
|
|
('美食', 'el-icon-food', 60, 1);
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 四、后端设计
|
|||
|
|
|
|||
|
|
### 4.1 实体类
|
|||
|
|
|
|||
|
|
#### CommunityCategory.java
|
|||
|
|
|
|||
|
|
文件：`crmeb-common/src/main/java/com/zbkj/common/model/community/CommunityCategory.java`
|
|||
|
|
|
|||
|
|
```java
|
|||
|
|
package com.zbkj.common.model.community;
|
|||
|
|
|
|||
|
|
import com.baomidou.mybatisplus.annotation.IdType;
|
|||
|
|
import com.baomidou.mybatisplus.annotation.TableId;
|
|||
|
|
import com.baomidou.mybatisplus.annotation.TableName;
|
|||
|
|
import lombok.Data;
|
|||
|
|
import java.util.Date;
|
|||
|
|
|
|||
|
|
@Data
|
|||
|
|
@TableName("eb_community_category")
|
|||
|
|
public class CommunityCategory {
|
|||
|
|
@TableId(type = IdType.AUTO)
|
|||
|
|
private Integer id;
|
|||
|
|
private String name;
|
|||
|
|
private String icon;
|
|||
|
|
private Integer sort;
|
|||
|
|
private Integer status;
|
|||
|
|
private Date createTime;
|
|||
|
|
private Date updateTime;
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### CommunityMessage.java
|
|||
|
|
|
|||
|
|
文件：`crmeb-common/src/main/java/com/zbkj/common/model/community/CommunityMessage.java`
|
|||
|
|
|
|||
|
|
```java
|
|||
|
|
package com.zbkj.common.model.community;
|
|||
|
|
|
|||
|
|
import com.baomidou.mybatisplus.annotation.IdType;
|
|||
|
|
import com.baomidou.mybatisplus.annotation.TableId;
|
|||
|
|
import com.baomidou.mybatisplus.annotation.TableName;
|
|||
|
|
import lombok.Data;
|
|||
|
|
import java.util.Date;
|
|||
|
|
|
|||
|
|
@Data
|
|||
|
|
@TableName("eb_community_message")
|
|||
|
|
public class CommunityMessage {
|
|||
|
|
@TableId(type = IdType.AUTO)
|
|||
|
|
private Long id;
|
|||
|
|
private Integer uid;
|
|||
|
|
private Integer categoryId;
|
|||
|
|
private String content;
|
|||
|
|
private String images;
|
|||
|
|
private Integer status; // 0待审核 1通过 2拒绝
|
|||
|
|
private Integer auditType; // 0自动 1人工
|
|||
|
|
private String auditRemark;
|
|||
|
|
private Integer isDelete;
|
|||
|
|
private Date createTime;
|
|||
|
|
private Date updateTime;
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### CommunityAuditConfig.java
|
|||
|
|
|
|||
|
|
文件：`crmeb-common/src/main/java/com/zbkj/common/model/community/CommunityAuditConfig.java`
|
|||
|
|
|
|||
|
|
```java
|
|||
|
|
package com.zbkj.common.model.community;
|
|||
|
|
|
|||
|
|
import com.baomidou.mybatisplus.annotation.IdType;
|
|||
|
|
import com.baomidou.mybatisplus.annotation.TableId;
|
|||
|
|
import com.baomidou.mybatisplus.annotation.TableName;
|
|||
|
|
import lombok.Data;
|
|||
|
|
import java.util.Date;
|
|||
|
|
|
|||
|
|
@Data
|
|||
|
|
@TableName("eb_community_audit_config")
|
|||
|
|
public class CommunityAuditConfig {
|
|||
|
|
@TableId(type = IdType.AUTO)
|
|||
|
|
private Integer id;
|
|||
|
|
private Integer autoAudit; // 开启自动审核
|
|||
|
|
private Integer autoPass; // 无敏感词自动通过
|
|||
|
|
private Integer autoReject; // 重度敏感词自动拒绝
|
|||
|
|
private Date updateTime;
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 4.2 Controller
|
|||
|
|
|
|||
|
|
文件：`crmeb-admin/src/main/java/com/zbkj/admin/controller/CommunityAdminController.java`
|
|||
|
|
|
|||
|
|
```java
|
|||
|
|
package com.zbkj.admin.controller;
|
|||
|
|
|
|||
|
|
import com.github.pagehelper.PageInfo;
|
|||
|
|
import com.zbkj.common.model.community.*;
|
|||
|
|
import com.zbkj.common.request.CommunityMessageRequest;
|
|||
|
|
import com.zbkj.common.request.CommunityAuditRequest;
|
|||
|
|
import com.zbkj.common.response.CommunityMessageVO;
|
|||
|
|
import com.zbkj.common.result.CommonResult;
|
|||
|
|
import com.zbkj.service.service.CommunityService;
|
|||
|
|
import io.swagger.annotations.Api;
|
|||
|
|
import io.swagger.annotations.ApiOperation;
|
|||
|
|
import org.springframework.beans.factory.annotation.Autowired;
|
|||
|
|
import org.springframework.web.bind.annotation.*;
|
|||
|
|
import java.util.List;
|
|||
|
|
|
|||
|
|
@RestController
|
|||
|
|
@RequestMapping("/admin/community")
|
|||
|
|
@Api(tags = "缘池管理")
|
|||
|
|
public class CommunityAdminController {
|
|||
|
|
|
|||
|
|
@Autowired
|
|||
|
|
private CommunityService communityService;
|
|||
|
|
|
|||
|
|
// ==================== 板块管理 ====================
|
|||
|
|
|
|||
|
|
@ApiOperation("板块列表")
|
|||
|
|
@GetMapping("/category/list")
|
|||
|
|
public CommonResult<List<CommunityCategory>> categoryList() {
|
|||
|
|
return CommonResult.success(communityService.getCategoryList());
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
@ApiOperation("保存板块")
|
|||
|
|
@PostMapping("/category/save")
|
|||
|
|
public CommonResult<String> categorySave(@RequestBody CommunityCategory category) {
|
|||
|
|
communityService.saveCategory(category);
|
|||
|
|
return CommonResult.success("保存成功");
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
@ApiOperation("删除板块")
|
|||
|
|
@DeleteMapping("/category/delete/{id}")
|
|||
|
|
public CommonResult<String> categoryDelete(@PathVariable Integer id) {
|
|||
|
|
communityService.deleteCategory(id);
|
|||
|
|
return CommonResult.success("删除成功");
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
@ApiOperation("更新板块状态")
|
|||
|
|
@PostMapping("/category/status")
|
|||
|
|
public CommonResult<String> categoryStatus(@RequestBody CommunityCategory category) {
|
|||
|
|
communityService.updateCategoryStatus(category.getId(), category.getStatus());
|
|||
|
|
return CommonResult.success("更新成功");
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// ==================== 消息管理 ====================
|
|||
|
|
|
|||
|
|
@ApiOperation("消息列表")
|
|||
|
|
@PostMapping("/message/list")
|
|||
|
|
public CommonResult<PageInfo<CommunityMessageVO>> messageList(
|
|||
|
|
@RequestBody CommunityMessageRequest request) {
|
|||
|
|
return CommonResult.success(communityService.getMessageList(request));
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
@ApiOperation("审核消息")
|
|||
|
|
@PostMapping("/message/audit")
|
|||
|
|
public CommonResult<String> messageAudit(@RequestBody CommunityAuditRequest request) {
|
|||
|
|
communityService.auditMessage(request.getId(), request.getStatus(), request.getRemark());
|
|||
|
|
return CommonResult.success("审核成功");
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
@ApiOperation("删除消息")
|
|||
|
|
@DeleteMapping("/message/delete/{id}")
|
|||
|
|
public CommonResult<String> messageDelete(@PathVariable Long id) {
|
|||
|
|
communityService.deleteMessage(id);
|
|||
|
|
return CommonResult.success("删除成功");
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// ==================== 审核配置 ====================
|
|||
|
|
|
|||
|
|
@ApiOperation("获取审核配置")
|
|||
|
|
@GetMapping("/audit/config")
|
|||
|
|
public CommonResult<CommunityAuditConfig> getAuditConfig() {
|
|||
|
|
return CommonResult.success(communityService.getAuditConfig());
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
@ApiOperation("保存审核配置")
|
|||
|
|
@PostMapping("/audit/config/save")
|
|||
|
|
public CommonResult<String> saveAuditConfig(@RequestBody CommunityAuditConfig config) {
|
|||
|
|
communityService.saveAuditConfig(config);
|
|||
|
|
return CommonResult.success("保存成功");
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 4.3 Service
|
|||
|
|
|
|||
|
|
文件：`crmeb-service/src/main/java/com/zbkj/service/service/CommunityService.java`
|
|||
|
|
|
|||
|
|
```java
|
|||
|
|
package com.zbkj.service.service;
|
|||
|
|
|
|||
|
|
import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
|
|||
|
|
import com.github.pagehelper.PageHelper;
|
|||
|
|
import com.github.pagehelper.PageInfo;
|
|||
|
|
import com.zbkj.common.model.community.*;
|
|||
|
|
import com.zbkj.common.request.CommunityMessageRequest;
|
|||
|
|
import com.zbkj.common.response.CommunityMessageVO;
|
|||
|
|
import com.zbkj.service.dao.*;
|
|||
|
|
import org.springframework.beans.factory.annotation.Autowired;
|
|||
|
|
import org.springframework.stereotype.Service;
|
|||
|
|
import java.util.List;
|
|||
|
|
|
|||
|
|
@Service
|
|||
|
|
public class CommunityService {
|
|||
|
|
|
|||
|
|
@Autowired
|
|||
|
|
private CommunityCategoryDao categoryDao;
|
|||
|
|
@Autowired
|
|||
|
|
private CommunityMessageDao messageDao;
|
|||
|
|
@Autowired
|
|||
|
|
private CommunityAuditConfigDao auditConfigDao;
|
|||
|
|
@Autowired
|
|||
|
|
private SensitiveWordService sensitiveWordService;
|
|||
|
|
|
|||
|
|
// ==================== 板块管理 ====================
|
|||
|
|
|
|||
|
|
public List<CommunityCategory> getCategoryList() {
|
|||
|
|
return categoryDao.selectList(new QueryWrapper<CommunityCategory>()
|
|||
|
|
.orderByDesc("sort"));
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
public void saveCategory(CommunityCategory category) {
|
|||
|
|
if (category.getId() != null) {
|
|||
|
|
categoryDao.updateById(category);
|
|||
|
|
} else {
|
|||
|
|
categoryDao.insert(category);
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
public void deleteCategory(Integer id) {
|
|||
|
|
categoryDao.deleteById(id);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
public void updateCategoryStatus(Integer id, Integer status) {
|
|||
|
|
CommunityCategory category = new CommunityCategory();
|
|||
|
|
category.setId(id);
|
|||
|
|
category.setStatus(status);
|
|||
|
|
categoryDao.updateById(category);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// ==================== 消息管理 ====================
|
|||
|
|
|
|||
|
|
public PageInfo<CommunityMessageVO> getMessageList(CommunityMessageRequest request) {
|
|||
|
|
PageHelper.startPage(request.getPage(), request.getLimit());
|
|||
|
|
List<CommunityMessageVO> list = messageDao.selectMessageList(request);
|
|||
|
|
return new PageInfo<>(list);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
public void auditMessage(Long id, Integer status, String remark) {
|
|||
|
|
CommunityMessage message = new CommunityMessage();
|
|||
|
|
message.setId(id);
|
|||
|
|
message.setStatus(status);
|
|||
|
|
message.setAuditType(1); // 人工审核
|
|||
|
|
message.setAuditRemark(remark != null ? remark : (status == 1 ? "人工审核通过" : "人工审核拒绝"));
|
|||
|
|
messageDao.updateById(message);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
public void deleteMessage(Long id) {
|
|||
|
|
CommunityMessage message = new CommunityMessage();
|
|||
|
|
message.setId(id);
|
|||
|
|
message.setIsDelete(1);
|
|||
|
|
messageDao.updateById(message);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// ==================== 自动审核(移动端发布时调用) ====================
|
|||
|
|
|
|||
|
|
public void autoAuditMessage(CommunityMessage message) {
|
|||
|
|
CommunityAuditConfig config = getAuditConfig();
|
|||
|
|
|
|||
|
|
// 未开启自动审核，待人工审核
|
|||
|
|
if (config.getAutoAudit() != 1) {
|
|||
|
|
message.setStatus(0);
|
|||
|
|
return;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 敏感词检测
|
|||
|
|
String content = message.getContent();
|
|||
|
|
List<String> sensitiveWords = sensitiveWordService.findAll(content);
|
|||
|
|
|
|||
|
|
if (sensitiveWords.isEmpty()) {
|
|||
|
|
// 无敏感词
|
|||
|
|
if (config.getAutoPass() == 1) {
|
|||
|
|
message.setStatus(1);
|
|||
|
|
message.setAuditRemark("自动审核通过");
|
|||
|
|
} else {
|
|||
|
|
message.setStatus(0);
|
|||
|
|
}
|
|||
|
|
message.setAuditType(0);
|
|||
|
|
} else if (sensitiveWordService.hasSevereWord(sensitiveWords)) {
|
|||
|
|
// 重度敏感词
|
|||
|
|
if (config.getAutoReject() == 1) {
|
|||
|
|
message.setStatus(2);
|
|||
|
|
message.setAuditRemark("含违禁词自动拒绝");
|
|||
|
|
} else {
|
|||
|
|
message.setStatus(0);
|
|||
|
|
message.setAuditRemark("含敏感词:" + String.join(",", sensitiveWords));
|
|||
|
|
}
|
|||
|
|
message.setAuditType(0);
|
|||
|
|
} else {
|
|||
|
|
// 轻度敏感词，待人工审核
|
|||
|
|
message.setStatus(0);
|
|||
|
|
message.setAuditRemark("含敏感词:" + String.join(",", sensitiveWords));
|
|||
|
|
message.setAuditType(0);
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// ==================== 审核配置 ====================
|
|||
|
|
|
|||
|
|
public CommunityAuditConfig getAuditConfig() {
|
|||
|
|
return auditConfigDao.selectById(1);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
public void saveAuditConfig(CommunityAuditConfig config) {
|
|||
|
|
config.setId(1);
|
|||
|
|
auditConfigDao.updateById(config);
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 4.4 DAO层
|
|||
|
|
|
|||
|
|
#### CommunityCategoryDao.java
|
|||
|
|
|
|||
|
|
文件：`crmeb-service/src/main/java/com/zbkj/service/dao/CommunityCategoryDao.java`
|
|||
|
|
|
|||
|
|
```java
|
|||
|
|
package com.zbkj.service.dao;
|
|||
|
|
|
|||
|
|
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
|
|||
|
|
import com.zbkj.common.model.community.CommunityCategory;
|
|||
|
|
import org.apache.ibatis.annotations.Mapper;
|
|||
|
|
|
|||
|
|
@Mapper
|
|||
|
|
public interface CommunityCategoryDao extends BaseMapper<CommunityCategory> {
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### CommunityMessageDao.java
|
|||
|
|
|
|||
|
|
文件：`crmeb-service/src/main/java/com/zbkj/service/dao/CommunityMessageDao.java`
|
|||
|
|
|
|||
|
|
```java
|
|||
|
|
package com.zbkj.service.dao;
|
|||
|
|
|
|||
|
|
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
|
|||
|
|
import com.zbkj.common.model.community.CommunityMessage;
|
|||
|
|
import com.zbkj.common.request.CommunityMessageRequest;
|
|||
|
|
import com.zbkj.common.response.CommunityMessageVO;
|
|||
|
|
import org.apache.ibatis.annotations.Mapper;
|
|||
|
|
import org.apache.ibatis.annotations.Param;
|
|||
|
|
import java.util.List;
|
|||
|
|
|
|||
|
|
@Mapper
|
|||
|
|
public interface CommunityMessageDao extends BaseMapper<CommunityMessage> {
|
|||
|
|
List<CommunityMessageVO> selectMessageList(@Param("req") CommunityMessageRequest request);
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### CommunityAuditConfigDao.java
|
|||
|
|
|
|||
|
|
文件：`crmeb-service/src/main/java/com/zbkj/service/dao/CommunityAuditConfigDao.java`
|
|||
|
|
|
|||
|
|
```java
|
|||
|
|
package com.zbkj.service.dao;
|
|||
|
|
|
|||
|
|
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
|
|||
|
|
import com.zbkj.common.model.community.CommunityAuditConfig;
|
|||
|
|
import org.apache.ibatis.annotations.Mapper;
|
|||
|
|
|
|||
|
|
@Mapper
|
|||
|
|
public interface CommunityAuditConfigDao extends BaseMapper<CommunityAuditConfig> {
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 4.5 Mapper XML
|
|||
|
|
|
|||
|
|
文件：`crmeb-service/src/main/resources/mapper/community/CommunityMessageMapper.xml`
|
|||
|
|
|
|||
|
|
```xml
|
|||
|
|
<?xml version="1.0" encoding="UTF-8"?>
|
|||
|
|
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
|
|||
|
|
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
|
|||
|
|
<mapper namespace="com.zbkj.service.dao.CommunityMessageDao">
|
|||
|
|
|
|||
|
|
<select id="selectMessageList" resultType="com.zbkj.common.response.CommunityMessageVO">
|
|||
|
|
SELECT
|
|||
|
|
m.id, m.uid, m.category_id, m.content, m.images,
|
|||
|
|
m.status, m.audit_type, m.audit_remark, m.create_time,
|
|||
|
|
u.nickname, u.avatar,
|
|||
|
|
c.name as category_name
|
|||
|
|
FROM eb_community_message m
|
|||
|
|
LEFT JOIN eb_user u ON m.uid = u.uid
|
|||
|
|
LEFT JOIN eb_community_category c ON m.category_id = c.id
|
|||
|
|
WHERE m.is_delete = 0
|
|||
|
|
<if test="req.categoryId != null">
|
|||
|
|
AND m.category_id = #{req.categoryId}
|
|||
|
|
</if>
|
|||
|
|
<if test="req.status != null">
|
|||
|
|
AND m.status = #{req.status}
|
|||
|
|
</if>
|
|||
|
|
<if test="req.auditType != null">
|
|||
|
|
AND m.audit_type = #{req.auditType}
|
|||
|
|
</if>
|
|||
|
|
<if test="req.startTime != null and req.endTime != null">
|
|||
|
|
AND m.create_time BETWEEN #{req.startTime} AND #{req.endTime}
|
|||
|
|
</if>
|
|||
|
|
ORDER BY m.create_time DESC
|
|||
|
|
</select>
|
|||
|
|
|
|||
|
|
</mapper>
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 4.6 Request/Response类
|
|||
|
|
|
|||
|
|
#### CommunityMessageRequest.java
|
|||
|
|
|
|||
|
|
文件：`crmeb-common/src/main/java/com/zbkj/common/request/CommunityMessageRequest.java`
|
|||
|
|
|
|||
|
|
```java
|
|||
|
|
package com.zbkj.common.request;
|
|||
|
|
|
|||
|
|
import lombok.Data;
|
|||
|
|
|
|||
|
|
@Data
|
|||
|
|
public class CommunityMessageRequest {
|
|||
|
|
private Integer page = 1;
|
|||
|
|
private Integer limit = 20;
|
|||
|
|
private Integer categoryId; // 板块ID
|
|||
|
|
private Integer status; // 状态
|
|||
|
|
private Integer auditType; // 审核方式
|
|||
|
|
private String startTime; // 开始时间
|
|||
|
|
private String endTime; // 结束时间
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### CommunityAuditRequest.java
|
|||
|
|
|
|||
|
|
文件：`crmeb-common/src/main/java/com/zbkj/common/request/CommunityAuditRequest.java`
|
|||
|
|
|
|||
|
|
```java
|
|||
|
|
package com.zbkj.common.request;
|
|||
|
|
|
|||
|
|
import lombok.Data;
|
|||
|
|
|
|||
|
|
@Data
|
|||
|
|
public class CommunityAuditRequest {
|
|||
|
|
private Long id; // 消息ID
|
|||
|
|
private Integer status; // 审核状态 1通过 2拒绝
|
|||
|
|
private String remark; // 审核备注
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### CommunityMessageVO.java
|
|||
|
|
|
|||
|
|
文件：`crmeb-common/src/main/java/com/zbkj/common/response/CommunityMessageVO.java`
|
|||
|
|
|
|||
|
|
```java
|
|||
|
|
package com.zbkj.common.response;
|
|||
|
|
|
|||
|
|
import lombok.Data;
|
|||
|
|
import java.util.Date;
|
|||
|
|
|
|||
|
|
@Data
|
|||
|
|
public class CommunityMessageVO {
|
|||
|
|
private Long id;
|
|||
|
|
private Integer uid;
|
|||
|
|
private Integer categoryId;
|
|||
|
|
private String content;
|
|||
|
|
private String images;
|
|||
|
|
private Integer status;
|
|||
|
|
private Integer auditType;
|
|||
|
|
private String auditRemark;
|
|||
|
|
private Date createTime;
|
|||
|
|
// 关联字段
|
|||
|
|
private String nickname; // 用户昵称
|
|||
|
|
private String avatar; // 用户头像
|
|||
|
|
private String categoryName; // 板块名称
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 五、文件清单
|
|||
|
|
|
|||
|
|
### 5.1 前端文件
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
Zhibo/admin/src/
|
|||
|
|
├── api/
|
|||
|
|
│ └── community.js # API接口
|
|||
|
|
├── router/modules/
|
|||
|
|
│ └── communityManage.js # 路由配置
|
|||
|
|
└── views/community/
|
|||
|
|
├── category/
|
|||
|
|
│ └── index.vue # 板块管理页面
|
|||
|
|
├── message/
|
|||
|
|
│ └── index.vue # 消息管理页面
|
|||
|
|
└── auditConfig/
|
|||
|
|
└── index.vue # 审核配置页面
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 5.2 后端文件
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
Zhibo/zhibo-h/
|
|||
|
|
├── crmeb-admin/src/main/java/com/zbkj/admin/controller/
|
|||
|
|
│ └── CommunityAdminController.java # 控制器
|
|||
|
|
├── crmeb-service/src/main/java/com/zbkj/service/
|
|||
|
|
│ ├── service/
|
|||
|
|
│ │ └── CommunityService.java # 服务层
|
|||
|
|
│ └── dao/
|
|||
|
|
│ ├── CommunityCategoryDao.java # 板块DAO
|
|||
|
|
│ ├── CommunityMessageDao.java # 消息DAO
|
|||
|
|
│ └── CommunityAuditConfigDao.java # 配置DAO
|
|||
|
|
├── crmeb-service/src/main/resources/mapper/community/
|
|||
|
|
│ └── CommunityMessageMapper.xml # Mapper XML
|
|||
|
|
└── crmeb-common/src/main/java/com/zbkj/common/
|
|||
|
|
├── model/community/
|
|||
|
|
│ ├── CommunityCategory.java # 板块实体
|
|||
|
|
│ ├── CommunityMessage.java # 消息实体
|
|||
|
|
│ └── CommunityAuditConfig.java # 配置实体
|
|||
|
|
├── request/
|
|||
|
|
│ ├── CommunityMessageRequest.java # 消息查询请求
|
|||
|
|
│ └── CommunityAuditRequest.java # 审核请求
|
|||
|
|
└── response/
|
|||
|
|
└── CommunityMessageVO.java # 消息响应VO
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 5.3 数据库
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
eb_community_category # 板块表
|
|||
|
|
eb_community_message # 消息表
|
|||
|
|
eb_community_audit_config # 审核配置表
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 六、菜单配置SQL
|
|||
|
|
|
|||
|
|
```sql
|
|||
|
|
-- 添加缘池管理菜单
|
|||
|
|
INSERT INTO `eb_system_menu` (`pid`, `name`, `icon`, `perms`, `component`, `menu_type`, `sort`, `is_show`) VALUES
|
|||
|
|
(0, '缘池管理', 'el-icon-s-opportunity', '', '/community', 'M', 140, 1);
|
|||
|
|
|
|||
|
|
SET @community_id = LAST_INSERT_ID();
|
|||
|
|
|
|||
|
|
INSERT INTO `eb_system_menu` (`pid`, `name`, `icon`, `perms`, `component`, `menu_type`, `sort`, `is_show`) VALUES
|
|||
|
|
(@community_id, '板块管理', '', 'admin:community:category', '/community/category', 'C', 3, 1),
|
|||
|
|
(@community_id, '消息管理', '', 'admin:community:message', '/community/message', 'C', 2, 1),
|
|||
|
|
(@community_id, '审核配置', '', 'admin:community:audit', '/community/audit-config', 'C', 1, 1);
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 七、开发顺序
|
|||
|
|
|
|||
|
|
1. **数据库** - 执行建表SQL
|
|||
|
|
2. **后端实体类** - 创建Model类
|
|||
|
|
3. **后端DAO** - 创建DAO接口和Mapper
|
|||
|
|
4. **后端Service** - 实现业务逻辑
|
|||
|
|
5. **后端Controller** - 实现API接口
|
|||
|
|
6. **前端API** - 创建接口文件
|
|||
|
|
7. **前端路由** - 配置路由
|
|||
|
|
8. **前端页面** - 实现三个管理页面
|
|||
|
|
9. **菜单配置** - 执行菜单SQL
|