507 lines
14 KiB
Markdown
507 lines
14 KiB
Markdown
# 管理端优化设计报告
|
||
|
||
> 生成时间：2025-12-29
|
||
> 基于移动端功能分析管理端现状，提出优化方案
|
||
|
||
---
|
||
|
||
## 一、现状分析
|
||
|
||
### 1.1 管理端现有模块
|
||
|
||
| 模块分类 | 已有功能 | 完成度 |
|
||
|----------|----------|--------|
|
||
| 用户管理 | 用户列表、用户等级、用户标签、用户分组、私聊管理 | ✅ 90% |
|
||
| 房间管理 | 房间类型、房间背景、房间列表、直播房间 | ✅ 85% |
|
||
| 礼物管理 | 礼物列表、坐骑管理 | ✅ 80% |
|
||
| 财务管理 | 充值管理、提现管理、账单明细 | ✅ 85% |
|
||
| 内容管理 | 动态管理、评论管理、文章管理 | ✅ 80% |
|
||
| 系统设置 | 系统配置、敏感词、黑名单 | ✅ 90% |
|
||
| 会话管理 | 会话列表、消息查看 | ✅ 70% |
|
||
|
||
### 1.2 移动端核心功能模块
|
||
|
||
| 功能模块 | 移动端实现 | 管理端支持 | 差距 |
|
||
|----------|------------|------------|------|
|
||
| 用户认证 | ✅ 登录/注册/验证码 | ✅ 用户管理 | 无 |
|
||
| 直播间 | ✅ 观看/创建/弹幕 | ✅ 房间管理 | 无 |
|
||
| 礼物打赏 | ✅ 送礼/充值 | ✅ 礼物管理 | 无 |
|
||
| 私聊会话 | ✅ 完整私聊功能 | ⚠️ 基础管理 | 缺少消息审核 |
|
||
| 好友管理 | ✅ 添加/删除/请求 | ❌ 无 | **需新增** |
|
||
| 语音/视频通话 | ✅ 完整通话功能 | ❌ 无 | **需新增** |
|
||
| 在线状态 | ✅ 实时在线检测 | ❌ 无 | **需新增** |
|
||
| 作品发布 | ✅ 发布/查看作品 | ❌ 无 | **需新增** |
|
||
| 粉丝/关注 | ✅ 关注/粉丝列表 | ⚠️ 基础管理 | 需完善 |
|
||
| 通知推送 | ✅ 本地通知 | ❌ 无 | **需新增** |
|
||
|
||
---
|
||
|
||
## 二、缺失功能详细分析
|
||
|
||
### 2.1 好友关系管理 ❌ 缺失
|
||
|
||
**移动端功能：**
|
||
- 搜索用户添加好友
|
||
- 发送/接收好友请求
|
||
- 好友列表管理
|
||
- 删除好友
|
||
|
||
**管理端需求：**
|
||
- 查看所有好友关系
|
||
- 查看好友请求记录
|
||
- 强制解除好友关系
|
||
- 好友关系统计
|
||
|
||
### 2.2 通话记录管理 ❌ 缺失
|
||
|
||
**移动端功能：**
|
||
- 语音通话
|
||
- 视频通话
|
||
- 通话记录
|
||
- 未接来电
|
||
|
||
**管理端需求：**
|
||
- 通话记录列表
|
||
- 通话时长统计
|
||
- 通话类型分析
|
||
- 异常通话监控
|
||
|
||
### 2.3 在线状态监控 ❌ 缺失
|
||
|
||
**移动端功能：**
|
||
- 用户在线状态
|
||
- 房间在线人数
|
||
- WebSocket连接
|
||
|
||
**管理端需求：**
|
||
- 实时在线用户数
|
||
- 在线用户列表
|
||
- WebSocket连接监控
|
||
- 在线时长统计
|
||
|
||
### 2.4 作品内容管理 ❌ 缺失
|
||
|
||
**移动端功能：**
|
||
- 发布作品（图片/视频）
|
||
- 作品详情
|
||
- 点赞/评论
|
||
|
||
**管理端需求：**
|
||
- 作品审核
|
||
- 作品列表管理
|
||
- 违规作品处理
|
||
- 作品数据统计
|
||
|
||
### 2.5 消息推送管理 ❌ 缺失
|
||
|
||
**移动端功能：**
|
||
- 系统通知
|
||
- 消息提醒
|
||
- 推送设置
|
||
|
||
**管理端需求：**
|
||
- 推送消息管理
|
||
- 推送模板配置
|
||
- 推送记录查询
|
||
- 推送效果统计
|
||
|
||
---
|
||
|
||
## 三、优化设计方案
|
||
|
||
### 3.1 新增模块设计
|
||
|
||
#### 3.1.1 好友关系管理模块
|
||
|
||
**路由配置：** `/friend`
|
||
|
||
```
|
||
好友管理
|
||
├── 好友关系列表 (/friend/list)
|
||
│ ├── 用户1信息（头像、昵称、ID）
|
||
│ ├── 用户2信息（头像、昵称、ID）
|
||
│ ├── 建立时间
|
||
│ ├── 操作：解除好友
|
||
│ └── 搜索：用户ID/昵称
|
||
│
|
||
├── 好友请求记录 (/friend/requests)
|
||
│ ├── 发起人信息
|
||
│ ├── 接收人信息
|
||
│ ├── 请求消息
|
||
│ ├── 状态（待处理/已接受/已拒绝）
|
||
│ ├── 请求时间
|
||
│ └── 处理时间
|
||
│
|
||
└── 好友统计 (/friend/statistics)
|
||
├── 总好友对数
|
||
├── 今日新增好友
|
||
├── 待处理请求数
|
||
└── 好友关系趋势图
|
||
```
|
||
|
||
**后端API设计：**
|
||
```
|
||
GET /api/admin/friend/list - 好友关系列表
|
||
GET /api/admin/friend/requests - 好友请求列表
|
||
DELETE /api/admin/friend/{id} - 解除好友关系
|
||
GET /api/admin/friend/statistics - 好友统计数据
|
||
```
|
||
|
||
#### 3.1.2 通话记录管理模块
|
||
|
||
**路由配置：** `/call`
|
||
|
||
```
|
||
通话管理
|
||
├── 通话记录列表 (/call/list)
|
||
│ ├── 通话ID
|
||
│ ├── 主叫用户（头像、昵称）
|
||
│ ├── 被叫用户（头像、昵称）
|
||
│ ├── 通话类型（语音/视频）
|
||
│ ├── 通话状态（已接通/未接/已拒绝/已取消）
|
||
│ ├── 通话时长
|
||
│ ├── 发起时间
|
||
│ ├── 结束时间
|
||
│ └── 搜索：用户ID/通话ID
|
||
│
|
||
└── 通话统计 (/call/statistics)
|
||
├── 总通话次数
|
||
├── 今日通话次数
|
||
├── 平均通话时长
|
||
├── 语音/视频占比
|
||
├── 接通率
|
||
└── 通话趋势图
|
||
```
|
||
|
||
**后端API设计：**
|
||
```
|
||
GET /api/admin/call/list - 通话记录列表
|
||
GET /api/admin/call/detail/{id} - 通话详情
|
||
DELETE /api/admin/call/{id} - 删除通话记录
|
||
GET /api/admin/call/statistics - 通话统计数据
|
||
```
|
||
|
||
#### 3.1.3 在线状态监控模块
|
||
|
||
**路由配置：** `/monitor`
|
||
|
||
```
|
||
实时监控
|
||
├── 在线概览 (/monitor/overview)
|
||
│ ├── 当前在线用户数（实时）
|
||
│ ├── 当前活跃房间数
|
||
│ ├── WebSocket连接数
|
||
│ ├── 今日峰值在线
|
||
│ └── 在线趋势图（实时刷新）
|
||
│
|
||
├── 在线用户列表 (/monitor/users)
|
||
│ ├── 用户信息
|
||
│ ├── 在线时长
|
||
│ ├── 当前位置（房间/私聊）
|
||
│ ├── 最后活跃时间
|
||
│ └── 操作：强制下线
|
||
│
|
||
└── 房间在线 (/monitor/rooms)
|
||
├── 房间信息
|
||
├── 在线人数
|
||
├── 主播状态
|
||
└── 实时弹幕数
|
||
```
|
||
|
||
**后端API设计：**
|
||
```
|
||
GET /api/admin/monitor/overview - 在线概览数据
|
||
GET /api/admin/monitor/users - 在线用户列表
|
||
GET /api/admin/monitor/rooms - 房间在线情况
|
||
POST /api/admin/monitor/kick/{userId} - 强制下线
|
||
GET /api/admin/monitor/websocket - WebSocket状态
|
||
```
|
||
|
||
#### 3.1.4 作品内容管理模块
|
||
|
||
**路由配置：** `/work`
|
||
|
||
```
|
||
作品管理
|
||
├── 作品列表 (/work/list)
|
||
│ ├── 作品ID
|
||
│ ├── 发布者信息
|
||
│ ├── 作品类型（图片/视频）
|
||
│ ├── 作品内容预览
|
||
│ ├── 点赞数/评论数
|
||
│ ├── 审核状态
|
||
│ ├── 发布时间
|
||
│ └── 操作：审核/删除/查看详情
|
||
│
|
||
├── 待审核作品 (/work/pending)
|
||
│ ├── 作品预览
|
||
│ ├── 发布者信息
|
||
│ └── 操作：通过/拒绝
|
||
│
|
||
└── 作品统计 (/work/statistics)
|
||
├── 总作品数
|
||
├── 今日发布数
|
||
├── 待审核数
|
||
└── 作品类型分布
|
||
```
|
||
|
||
**后端API设计：**
|
||
```
|
||
GET /api/admin/work/list - 作品列表
|
||
GET /api/admin/work/pending - 待审核作品
|
||
GET /api/admin/work/detail/{id} - 作品详情
|
||
POST /api/admin/work/audit/{id} - 审核作品
|
||
DELETE /api/admin/work/{id} - 删除作品
|
||
GET /api/admin/work/statistics - 作品统计
|
||
```
|
||
|
||
#### 3.1.5 消息推送管理模块
|
||
|
||
**路由配置：** `/push`
|
||
|
||
```
|
||
推送管理
|
||
├── 推送消息 (/push/send)
|
||
│ ├── 推送类型（全员/指定用户/用户组）
|
||
│ ├── 消息标题
|
||
│ ├── 消息内容
|
||
│ ├── 跳转链接
|
||
│ └── 定时发送
|
||
│
|
||
├── 推送记录 (/push/history)
|
||
│ ├── 推送ID
|
||
│ ├── 推送内容
|
||
│ ├── 推送范围
|
||
│ ├── 发送时间
|
||
│ ├── 送达数/阅读数
|
||
│ └── 状态
|
||
│
|
||
└── 推送模板 (/push/templates)
|
||
├── 模板名称
|
||
├── 模板内容
|
||
└── 操作：编辑/删除
|
||
```
|
||
|
||
**后端API设计：**
|
||
```
|
||
POST /api/admin/push/send - 发送推送
|
||
GET /api/admin/push/history - 推送记录
|
||
GET /api/admin/push/templates - 推送模板列表
|
||
POST /api/admin/push/templates - 创建模板
|
||
PUT /api/admin/push/templates/{id} - 更新模板
|
||
DELETE /api/admin/push/templates/{id} - 删除模板
|
||
```
|
||
|
||
---
|
||
|
||
### 3.2 现有模块优化
|
||
|
||
#### 3.2.1 私聊管理优化
|
||
|
||
**当前问题：**
|
||
- 只能查看会话列表
|
||
- 缺少消息内容审核
|
||
- 缺少敏感词过滤记录
|
||
|
||
**优化方案：**
|
||
```
|
||
私聊管理（优化后）
|
||
├── 会话列表（现有）
|
||
├── 消息审核（新增）
|
||
│ ├── 疑似违规消息列表
|
||
│ ├── 敏感词触发记录
|
||
│ └── 操作：删除消息/警告用户
|
||
│
|
||
└── 私聊统计（增强）
|
||
├── 消息量趋势
|
||
├── 活跃用户排行
|
||
└── 敏感词触发统计
|
||
```
|
||
|
||
#### 3.2.2 直播房间管理优化
|
||
|
||
**当前问题：**
|
||
- 缺少实时监控
|
||
- 弹幕管理功能弱
|
||
|
||
**优化方案：**
|
||
```
|
||
直播房间管理（优化后）
|
||
├── 房间列表（现有）
|
||
├── 实时监控（新增）
|
||
│ ├── 正在直播房间
|
||
│ ├── 实时观看人数
|
||
│ └── 实时弹幕流
|
||
│
|
||
├── 弹幕管理（增强）
|
||
│ ├── 弹幕记录查询
|
||
│ ├── 违规弹幕过滤
|
||
│ └── 弹幕关键词屏蔽
|
||
│
|
||
└── 直播统计（新增）
|
||
├── 直播时长统计
|
||
├── 观看人次统计
|
||
└── 礼物收入统计
|
||
```
|
||
|
||
---
|
||
|
||
## 四、技术实现建议
|
||
|
||
### 4.1 后端新增Controller
|
||
|
||
| Controller | 路径 | 功能 |
|
||
|------------|------|------|
|
||
| FriendAdminController | /api/admin/friend | 好友关系管理 |
|
||
| CallAdminController | /api/admin/call | 通话记录管理 |
|
||
| MonitorController | /api/admin/monitor | 在线状态监控 |
|
||
| WorkAdminController | /api/admin/work | 作品内容管理 |
|
||
| PushController | /api/admin/push | 消息推送管理 |
|
||
|
||
### 4.2 前端新增路由模块
|
||
|
||
| 模块文件 | 路径 | 说明 |
|
||
|----------|------|------|
|
||
| friend.js | /src/router/modules/ | 好友管理路由 |
|
||
| call.js | /src/router/modules/ | 通话管理路由 |
|
||
| monitor.js | /src/router/modules/ | 实时监控路由 |
|
||
| work.js | /src/router/modules/ | 作品管理路由 |
|
||
| push.js | /src/router/modules/ | 推送管理路由 |
|
||
|
||
### 4.3 前端新增API文件
|
||
|
||
| API文件 | 路径 | 说明 |
|
||
|---------|------|------|
|
||
| friend.js | /src/api/ | 好友管理API |
|
||
| call.js | /src/api/ | 通话管理API |
|
||
| monitor.js | /src/api/ | 监控API |
|
||
| work.js | /src/api/ | 作品管理API |
|
||
| push.js | /src/api/ | 推送管理API |
|
||
|
||
### 4.4 数据库表设计
|
||
|
||
**已有表（需确认）：**
|
||
- `eb_friend` - 好友关系表
|
||
- `eb_friend_request` - 好友请求表
|
||
- `eb_call_record` - 通话记录表
|
||
- `eb_conversation` - 会话表
|
||
- `eb_private_message` - 私信消息表
|
||
|
||
**需新增表：**
|
||
```sql
|
||
-- 作品表
|
||
CREATE TABLE eb_work (
|
||
id BIGINT PRIMARY KEY AUTO_INCREMENT,
|
||
user_id INT NOT NULL COMMENT '发布者ID',
|
||
type VARCHAR(20) COMMENT '类型: image/video',
|
||
content TEXT COMMENT '作品描述',
|
||
media_urls TEXT COMMENT '媒体文件URL(JSON)',
|
||
like_count INT DEFAULT 0 COMMENT '点赞数',
|
||
comment_count INT DEFAULT 0 COMMENT '评论数',
|
||
status TINYINT DEFAULT 0 COMMENT '状态: 0待审核 1已通过 2已拒绝',
|
||
create_time DATETIME,
|
||
update_time DATETIME,
|
||
INDEX idx_user_id (user_id),
|
||
INDEX idx_status (status)
|
||
);
|
||
|
||
-- 推送记录表
|
||
CREATE TABLE eb_push_record (
|
||
id BIGINT PRIMARY KEY AUTO_INCREMENT,
|
||
title VARCHAR(100) COMMENT '推送标题',
|
||
content TEXT COMMENT '推送内容',
|
||
target_type VARCHAR(20) COMMENT '目标类型: all/user/group',
|
||
target_ids TEXT COMMENT '目标ID列表(JSON)',
|
||
send_count INT DEFAULT 0 COMMENT '发送数',
|
||
read_count INT DEFAULT 0 COMMENT '阅读数',
|
||
status TINYINT DEFAULT 0 COMMENT '状态: 0待发送 1已发送',
|
||
send_time DATETIME COMMENT '发送时间',
|
||
create_time DATETIME
|
||
);
|
||
|
||
-- 推送模板表
|
||
CREATE TABLE eb_push_template (
|
||
id BIGINT PRIMARY KEY AUTO_INCREMENT,
|
||
name VARCHAR(50) COMMENT '模板名称',
|
||
title VARCHAR(100) COMMENT '标题模板',
|
||
content TEXT COMMENT '内容模板',
|
||
create_time DATETIME,
|
||
update_time DATETIME
|
||
);
|
||
```
|
||
|
||
---
|
||
|
||
## 五、优先级排序
|
||
|
||
### 5.1 高优先级 🔴 （建议立即实现）
|
||
|
||
| 功能 | 原因 | 工作量 |
|
||
|------|------|--------|
|
||
| 通话记录管理 | 移动端已完整实现，管理端无法查看 | 2天 |
|
||
| 好友关系管理 | 移动端已完整实现，管理端无法管理 | 2天 |
|
||
| 在线状态监控 | 运营必需，了解平台活跃度 | 3天 |
|
||
|
||
### 5.2 中优先级 🟡 （建议近期实现）
|
||
|
||
| 功能 | 原因 | 工作量 |
|
||
|------|------|--------|
|
||
| 作品内容管理 | 内容审核需求 | 3天 |
|
||
| 私聊管理优化 | 消息审核需求 | 2天 |
|
||
| 直播监控优化 | 运营监控需求 | 2天 |
|
||
|
||
### 5.3 低优先级 🟢 （可后续实现）
|
||
|
||
| 功能 | 原因 | 工作量 |
|
||
|------|------|--------|
|
||
| 消息推送管理 | 需集成推送服务 | 5天 |
|
||
| 数据统计增强 | 锦上添花 | 3天 |
|
||
|
||
---
|
||
|
||
## 六、实施计划
|
||
|
||
### 第一阶段（1周）
|
||
- [ ] 实现通话记录管理模块
|
||
- [ ] 实现好友关系管理模块
|
||
- [ ] 后端API开发 + 前端页面
|
||
|
||
### 第二阶段（1周）
|
||
- [ ] 实现在线状态监控模块
|
||
- [ ] 优化私聊管理功能
|
||
- [ ] WebSocket监控集成
|
||
|
||
### 第三阶段（1周）
|
||
- [ ] 实现作品内容管理模块
|
||
- [ ] 优化直播房间管理
|
||
- [ ] 数据统计功能增强
|
||
|
||
### 第四阶段（2周）
|
||
- [ ] 实现消息推送管理
|
||
- [ ] 集成推送服务（极光/个推）
|
||
- [ ] 整体测试和优化
|
||
|
||
---
|
||
|
||
## 七、总结
|
||
|
||
### 管理端与移动端功能对比
|
||
|
||
| 维度 | 移动端 | 管理端现状 | 优化后 |
|
||
|------|--------|------------|--------|
|
||
| 核心功能覆盖 | 100% | 70% | 95% |
|
||
| 数据管理能力 | - | 75% | 90% |
|
||
| 实时监控能力 | - | 30% | 85% |
|
||
| 内容审核能力 | - | 50% | 85% |
|
||
|
||
### 预期效果
|
||
|
||
1. **运营效率提升**：新增监控模块，实时掌握平台状态
|
||
2. **内容安全保障**：完善审核功能，及时处理违规内容
|
||
3. **数据分析能力**：增强统计功能，支持运营决策
|
||
4. **功能完整性**：管理端覆盖移动端所有核心功能
|
||
|
||
---
|
||
|
||
*报告生成完毕*
|