# 直播平台功能交互逻辑报告

## 概述

本报告详细描述直播平台三大核心模块的功能交互逻辑：
1. **敏感词管理** - 内容安全过滤系统
2. **消息/粉丝团/群组** - 社交通讯系统
3. **封禁系统** - 用户与房间管理

---

## 一、敏感词管理模块

### 1.1 功能概述

敏感词管理用于过滤平台内的违规内容，保障平台内容安全。

### 1.2 数据表结构

**表名**: `eb_sensitive_word`

| 字段 | 类型 | 说明 |
|------|------|------|
| id | int | 主键ID |
| word | varchar(128) | 敏感词内容 |
| category | varchar(32) | 分类(default/spam/illegal) |
| level | tinyint | 级别(1轻度/2中度/3重度) |
| action | tinyint | 处理方式(1替换/2拦截/3警告) |
| replace_text | varchar(32) | 替换文本(默认***) |
| status | tinyint | 状态(0禁用/1启用) |
| create_time | datetime | 创建时间 |
| update_time | datetime | 更新时间 |

### 1.3 管理端功能

**API路径**: `/api/admin/sensitive/word`

| 接口 | 方法 | 功能 |
|------|------|------|
| /list | GET | 敏感词列表(支持分页、关键词搜索、时间筛选) |
| /add | POST | 添加敏感词 |
| /update | POST | 更新敏感词 |
| /delete/{id} | POST | 删除敏感词 |
| /status/{id} | POST | 切换启用/禁用状态 |

### 1.4 交互流程图

```
┌─────────────────────────────────────────────────────────────────┐
│                      敏感词管理流程                              │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  ┌──────────┐    ┌──────────┐    ┌──────────┐                  │
│  │ 管理员   │───▶│ 添加敏感词│───▶│ 存入数据库│                  │
│  └──────────┘    └──────────┘    └──────────┘                  │
│                                                                 │
│  ┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐  │
│  │ 用户发送 │───▶│ 内容检测 │───▶│ 匹配敏感词│───▶│ 执行处理 │  │
│  │ 消息/弹幕│    │          │    │          │    │ (替换/拦截)│  │
│  └──────────┘    └──────────┘    └──────────┘    └──────────┘  │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘
```

### 1.5 应用场景

敏感词过滤应用于以下场景：
- 直播间弹幕消息
- 私聊消息内容
- 粉丝团群聊消息
- 动态发布内容
- 用户昵称/签名

---

## 二、消息/粉丝团/群组模块

### 2.1 私聊消息系统

#### 2.1.1 数据表结构

**会话表**: `eb_conversation`

| 字段 | 类型 | 说明 |
|------|------|------|
| id | bigint | 会话ID |
| user1_id | int | 用户1 ID |
| user2_id | int | 用户2 ID |
| last_message | varchar(255) | 最后一条消息预览 |
| last_message_time | datetime | 最后消息时间 |
| user1_unread_count | int | 用户1未读数 |
| user2_unread_count | int | 用户2未读数 |
| user1_deleted | tinyint | 用户1是否删除 |
| user2_deleted | tinyint | 用户2是否删除 |

**私聊消息表**: `eb_private_message`

| 字段 | 类型 | 说明 |
|------|------|------|
| id | bigint | 消息ID |
| conversation_id | bigint | 会话ID |
| sender_id | int | 发送者ID |
| receiver_id | int | 接收者ID |
| content | text | 消息内容 |
| message_type | varchar(20) | 消息类型(text/image/voice) |
| media_url | varchar(500) | 媒体URL |
| status | varchar(20) | 状态(sent/read) |
| is_recalled | tinyint | 是否撤回 |

#### 2.1.2 移动端API

**路径**: `/api/front/chat`

| 接口 | 方法 | 功能 |
|------|------|------|
| /conversations | GET | 获取会话列表 |
| /conversations/{id} | GET | 获取会话详情 |
| /conversations/{id}/messages | GET | 获取消息列表 |
| /conversations/{id}/messages | POST | 发送消息 |
| /conversations/{id}/read | POST | 标记已读 |
| /messages/{id}/recall | POST | 撤回消息(2分钟内) |

#### 2.1.3 管理端API

**路径**: `/api/admin/chat`

| 接口 | 方法 | 功能 |
|------|------|------|
| /conversations | GET | 会话列表(支持搜索) |
| /conversations/{id}/messages | GET | 查看会话消息 |
| /conversations/{id} | DELETE | 删除会话 |
| /messages/{id} | DELETE | 删除单条消息 |
| /statistics | GET | 私聊统计数据 |

#### 2.1.4 私聊交互流程

```
┌─────────────────────────────────────────────────────────────────────────┐
│                         私聊消息发送流程                                  │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                         │
│  ┌────────┐   ┌────────────┐   ┌────────────┐   ┌────────────┐         │
│  │ 用户A  │──▶│ 检查黑名单 │──▶│ 敏感词过滤 │──▶│ 保存消息   │         │
│  │ 发消息 │   │            │   │            │   │            │         │
│  └────────┘   └────────────┘   └────────────┘   └────────────┘         │
│                    │                                   │                │
│                    ▼                                   ▼                │
│              ┌────────────┐                     ┌────────────┐         │
│              │ 黑名单拦截 │                     │ 更新会话   │         │
│              │ 返回错误   │                     │ 推送通知   │         │
│              └────────────┘                     └────────────┘         │
│                                                        │                │
│                                                        ▼                │
│                                                 ┌────────────┐         │
│                                                 │ 用户B收到  │         │
│                                                 │ 消息通知   │         │
│                                                 └────────────┘         │
└─────────────────────────────────────────────────────────────────────────┘
```

### 2.2 粉丝团系统

#### 2.2.1 数据表结构

**粉丝团表**: `eb_fan_group`

| 字段 | 类型 | 说明 |
|------|------|------|
| id | int | 粉丝团ID |
| anchor_id | int | 主播ID |
| anchor_name | varchar(64) | 主播昵称 |
| name | varchar(64) | 粉丝团名称 |
| badge | varchar(32) | 粉丝团徽章 |
| badge_color | varchar(16) | 徽章颜色 |
| member_count | int | 成员数量 |
| level | int | 粉丝团等级 |
| status | tinyint | 状态(0解散/1正常) |

**粉丝团成员表**: `eb_fan_group_member`

| 字段 | 类型 | 说明 |
|------|------|------|
| id | int | 成员记录ID |
| group_id | int | 粉丝团ID |
| uid | int | 用户ID |
| nickname | varchar(64) | 成员昵称 |
| level | int | 成员等级(1-10) |
| intimacy | int | 亲密度 |
| status | tinyint | 状态 |
| join_time | datetime | 加入时间 |

**群聊消息表**: `eb_group_message`

| 字段 | 类型 | 说明 |
|------|------|------|
| id | bigint | 消息ID |
| group_id | int | 粉丝团ID |
| sender_id | int | 发送者ID |
| content | text | 消息内容 |
| message_type | varchar(20) | 消息类型 |
| is_deleted | tinyint | 是否删除 |

#### 2.2.2 管理端API

**路径**: `/api/admin/fan/group`

| 接口 | 方法 | 功能 |
|------|------|------|
| /list | GET | 粉丝团列表 |
| /detail/{id} | GET | 粉丝团详情 |
| /delete/{id} | POST | 删除粉丝团 |
| /batch-delete | POST | 批量删除 |
| /status/{id} | POST | 修改状态(解散/恢复) |
| /update/{id} | POST | 修改粉丝团信息 |
| /member/list | GET | 成员列表 |
| /member/delete/{id} | POST | 删除成员 |
| /member/update-level/{id} | POST | 修改成员等级 |
| /message/list | GET | 聊天记录列表 |
| /message/delete/{id} | POST | 删除聊天记录 |
| /statistics | GET | 统计数据 |

#### 2.2.3 粉丝团交互流程

```
┌─────────────────────────────────────────────────────────────────────────┐
│                         粉丝团系统流程                                    │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                         │
│  【创建粉丝团】                                                          │
│  ┌────────┐   ┌────────────┐   ┌────────────┐                          │
│  │ 主播   │──▶│ 设置名称   │──▶│ 创建粉丝团 │                          │
│  │ 开播   │   │ 徽章/颜色  │   │            │                          │
│  └────────┘   └────────────┘   └────────────┘                          │
│                                                                         │
│  【加入粉丝团】                                                          │
│  ┌────────┐   ┌────────────┐   ┌────────────┐   ┌────────────┐         │
│  │ 用户   │──▶│ 查看粉丝团 │──▶│ 支付加入费 │──▶│ 成为成员   │         │
│  │        │   │ 信息       │   │ (可选)     │   │ 等级=1     │         │
│  └────────┘   └────────────┘   └────────────┘   └────────────┘         │
│                                                                         │
│  【等级提升】                                                            │
│  ┌────────┐   ┌────────────┐   ┌────────────┐   ┌────────────┐         │
│  │ 成员   │──▶│ 送礼/互动  │──▶│ 增加亲密度 │──▶│ 等级提升   │         │
│  │        │   │            │   │            │   │ (1-10级)   │         │
│  └────────┘   └────────────┘   └────────────┘   └────────────┘         │
│                                                                         │
│  【群聊功能】                                                            │
│  ┌────────┐   ┌────────────┐   ┌────────────┐   ┌────────────┐         │
│  │ 成员   │──▶│ 发送消息   │──▶│ 敏感词过滤 │──▶│ 群内广播   │         │
│  │        │   │            │   │            │   │            │         │
│  └────────┘   └────────────┘   └────────────┘   └────────────┘         │
│                                                                         │
└─────────────────────────────────────────────────────────────────────────┘
```

---

## 三、封禁系统模块

### 3.1 系统概述

封禁系统分为两大类：
1. **平台封禁** - 管理员对用户/房间的封禁（eb_user_ban / eb_room_ban）
2. **用户黑名单** - 用户间的互相拉黑（eb_user_blacklist / eb_room_blacklist）

### 3.2 数据表结构

#### 3.2.1 用户封禁表 `eb_user_ban`

| 字段 | 类型 | 说明 |
|------|------|------|
| id | bigint | 记录ID |
| user_id | int | 被封禁用户ID |
| ban_type | varchar(20) | 封禁类型(permanent永久/temporary临时) |
| reason | varchar(500) | 封禁原因 |
| duration_days | int | 封禁天数(临时封禁) |
| expire_time | datetime | 解封时间 |
| operator_id | int | 操作员ID |
| status | tinyint | 状态(0已解封/1封禁中) |

#### 3.2.2 房间封禁表 `eb_room_ban`

| 字段 | 类型 | 说明 |
|------|------|------|
| id | bigint | 记录ID |
| room_id | int | 被封禁房间ID |
| ban_type | varchar(20) | 封禁类型 |
| reason | varchar(500) | 封禁原因 |
| duration_days | int | 封禁天数 |
| expire_time | datetime | 解封时间 |
| operator_id | int | 操作员ID |
| status | tinyint | 状态 |

#### 3.2.3 用户黑名单表 `eb_user_blacklist`

| 字段 | 类型 | 说明 |
|------|------|------|
| id | int | 记录ID |
| user_id | int | 拉黑发起者ID |
| blocked_user_id | int | 被拉黑用户ID |
| blocker_nickname | varchar(64) | 发起者昵称 |
| blocked_nickname | varchar(64) | 被拉黑者昵称 |
| create_time | datetime | 创建时间 |

#### 3.2.4 房间黑名单表 `eb_room_blacklist`

| 字段 | 类型 | 说明 |
|------|------|------|
| id | int | 记录ID |
| room_id | int | 房间ID |
| room_name | varchar(128) | 房间名称 |
| blocked_user_id | int | 被拉黑用户ID |
| blocked_user_nickname | varchar(64) | 被拉黑用户昵称 |
| operator_id | int | 操作者ID(主播) |
| create_time | datetime | 创建时间 |

### 3.3 管理端API

#### 3.3.1 封禁管理 `/api/admin/ban`

| 接口 | 方法 | 功能 |
|------|------|------|
| /user/list | GET | 用户封禁列表 |
| /user/add | POST | 封禁用户 |
| /user/unban/{id} | POST | 解除用户封禁 |
| /user/delete/{id} | POST | 删除封禁记录 |
| /user/batch-delete | POST | 批量删除 |
| /user/check/{userId} | GET | 检查用户封禁状态 |
| /room/list | GET | 房间封禁列表 |
| /room/add | POST | 封禁房间 |
| /room/unban/{id} | POST | 解除房间封禁 |
| /room/delete/{id} | POST | 删除封禁记录 |
| /room/batch-delete | POST | 批量删除 |
| /room/check/{roomId} | GET | 检查房间封禁状态 |

#### 3.3.2 黑名单管理 `/api/admin/blacklist`

| 接口 | 方法 | 功能 |
|------|------|------|
| /user/list | GET | 用户黑名单列表 |
| /user/delete/{id} | POST | 删除用户黑名单记录 |
| /user/batch-delete | POST | 批量删除 |
| /room/list | GET | 房间黑名单列表 |
| /room/delete/{id} | POST | 删除房间黑名单记录 |
| /room/batch-delete | POST | 批量删除 |

### 3.4 移动端API

**路径**: `/api/front/ban`

| 接口 | 方法 | 功能 |
|------|------|------|
| /check/me | GET | 检查当前用户封禁状态 |
| /check/user/{userId} | GET | 检查指定用户封禁状态 |
| /check/room/{roomId} | GET | 检查房间封禁状态 |
| /blacklist/list | GET | 获取我的黑名单列表 |
| /blacklist/add | POST | 添加用户到黑名单 |
| /blacklist/remove | POST | 从黑名单移除用户 |
| /blacklist/check/{targetUserId} | GET | 检查黑名单状态 |

### 3.5 封禁检查触发点

封禁状态检查在以下场景自动触发：

| 场景 | 检查内容 | 实现位置 |
|------|----------|----------|
| 用户登录 | 检查用户是否被封禁 | LoginServiceImpl.checkUserBanStatus() |
| 发送私聊消息 | 检查双方黑名单状态 | ConversationServiceImpl.checkBlacklistStatus() |
| 发送直播间弹幕 | 检查用户封禁状态 | LiveRoomController.checkUserBanStatus() |
| 赠送礼物 | 检查用户封禁状态 | LiveRoomController.sendGift() |
| 进入直播间 | 检查房间封禁状态 | Android RoomDetailActivity |

### 3.6 封禁系统交互流程

```
┌─────────────────────────────────────────────────────────────────────────────┐
│                           封禁系统完整流程                                    │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                             │
│  【管理员封禁用户】                                                          │
│  ┌────────┐   ┌────────────┐   ┌────────────┐   ┌────────────┐             │
│  │ 管理员 │──▶│ 选择用户   │──▶│ 设置封禁   │──▶│ 更新用户   │             │
│  │        │   │ 填写原因   │   │ 类型/时长  │   │ status=0   │             │
│  └────────┘   └────────────┘   └────────────┘   └────────────┘             │
│                                                                             │
│  【用户登录检查】                                                            │
│  ┌────────┐   ┌────────────┐   ┌────────────┐   ┌────────────┐             │
│  │ 用户   │──▶│ 提交登录   │──▶│ 检查封禁表 │──▶│ 封禁中?    │             │
│  │ 登录   │   │            │   │            │   │            │             │
│  └────────┘   └────────────┘   └────────────┘   └─────┬──────┘             │
│                                                       │                     │
│                                    ┌──────────────────┼──────────────────┐  │
│                                    ▼                  ▼                  │  │
│                              ┌──────────┐       ┌──────────┐             │  │
│                              │ 是:拒绝  │       │ 否:允许  │             │  │
│                              │ 返回原因 │       │ 登录成功 │             │  │
│                              └──────────┘       └──────────┘             │  │
│                                                                             │
│  【用户拉黑用户】                                                            │
│  ┌────────┐   ┌────────────┐   ┌────────────┐   ┌────────────┐             │
│  │ 用户A  │──▶│ 点击拉黑   │──▶│ 添加黑名单 │──▶│ 删除好友   │             │
│  │        │   │ 用户B      │   │ 记录       │   │ 关系       │             │
│  └────────┘   └────────────┘   └────────────┘   └────────────┘             │
│                                                                             │
│  【私聊黑名单检查】                                                          │
│  ┌────────┐   ┌────────────┐   ┌────────────┐                              │
│  │ 用户A  │──▶│ 发送消息   │──▶│ 检查黑名单 │                              │
│  │ 发消息 │   │ 给用户B    │   │            │                              │
│  └────────┘   └────────────┘   └─────┬──────┘                              │
│                                      │                                      │
│                   ┌──────────────────┼──────────────────┐                   │
│                   ▼                  ▼                  ▼                   │
│             ┌──────────┐       ┌──────────┐       ┌──────────┐             │
│             │ A拉黑了B │       │ B拉黑了A │       │ 无黑名单 │             │
│             │ 提示:您已│       │ 提示:对方│       │ 正常发送 │             │
│             │ 拉黑对方 │       │ 已拉黑您 │       │          │             │
│             └──────────┘       └──────────┘       └──────────┘             │
│                                                                             │
│  【房间封禁检查】                                                            │
│  ┌────────┐   ┌────────────┐   ┌────────────┐   ┌────────────┐             │
│  │ 用户   │──▶│ 进入直播间 │──▶│ 检查房间   │──▶│ 封禁中?    │             │
│  │        │   │            │   │ 封禁状态   │   │            │             │
│  └────────┘   └────────────┘   └────────────┘   └─────┬──────┘             │
│                                                       │                     │
│                                    ┌──────────────────┼──────────────────┐  │
│                                    ▼                  ▼                  │  │
│                              ┌──────────┐       ┌──────────┐             │  │
│                              │ 是:禁止  │       │ 否:允许  │             │  │
│                              │ 进入房间 │       │ 进入观看 │             │  │
│                              └──────────┘       └──────────┘             │  │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘
```

---

## 四、三大模块联动关系

### 4.1 模块交互图

```
┌─────────────────────────────────────────────────────────────────────────────┐
│                          三大模块联动关系                                     │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                             │
│                        ┌─────────────────┐                                  │
│                        │   敏感词管理    │                                  │
│                        │                 │                                  │
│                        │ • 内容过滤规则  │                                  │
│                        │ • 违规词库维护  │                                  │
│                        └────────┬────────┘                                  │
│                                 │                                           │
│                    ┌────────────┼────────────┐                              │
│                    │            │            │                              │
│                    ▼            ▼            ▼                              │
│  ┌─────────────────────┐  ┌─────────────────────┐  ┌─────────────────────┐  │
│  │     私聊消息        │  │    粉丝团群聊       │  │    直播间弹幕       │  │
│  │                     │  │                     │  │                     │  │
│  │ • 发送前过滤敏感词  │  │ • 发送前过滤敏感词  │  │ • 发送前过滤敏感词  │  │
│  │ • 检查黑名单状态    │  │ • 检查成员状态      │  │ • 检查用户封禁      │  │
│  │ • 检查用户封禁      │  │ • 检查用户封禁      │  │ • 检查房间封禁      │  │
│  └──────────┬──────────┘  └──────────┬──────────┘  └──────────┬──────────┘  │
│             │                        │                        │             │
│             └────────────────────────┼────────────────────────┘             │
│                                      │                                      │
│                                      ▼                                      │
│                        ┌─────────────────────┐                              │
│                        │     封禁系统        │                              │
│                        │                     │                              │
│                        │ • 用户封禁管理      │                              │
│                        │ • 房间封禁管理      │                              │
│                        │ • 用户黑名单        │                              │
│                        │ • 房间黑名单        │                              │
│                        └─────────────────────┘                              │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘
```

### 4.2 完整消息发送流程

```
用户发送消息
     │
     ▼
┌────────────────┐
│ 1. 用户登录检查 │ ──── 检查 eb_user_ban 表
└───────┬────────┘
        │ 通过
        ▼
┌────────────────┐
│ 2. 封禁状态检查 │ ──── 检查用户是否被平台封禁
└───────┬────────┘
        │ 通过
        ▼
┌────────────────┐
│ 3. 黑名单检查   │ ──── 检查 eb_user_blacklist 表
└───────┬────────┘      (私聊场景)
        │ 通过
        ▼
┌────────────────┐
│ 4. 敏感词过滤   │ ──── 检查 eb_sensitive_word 表
└───────┬────────┘
        │ 通过/替换
        ▼
┌────────────────┐
│ 5. 消息入库     │ ──── 保存到对应消息表
└───────┬────────┘
        │
        ▼
┌────────────────┐
│ 6. 推送通知     │ ──── WebSocket/推送服务
└────────────────┘
```

---

## 五、代码实现位置汇总

### 5.1 后端代码

| 模块 | 文件路径 | 说明 |
|------|----------|------|
| 敏感词管理 | `crmeb-admin/.../SensitiveWordController.java` | 管理端敏感词CRUD |
| 私聊管理 | `crmeb-admin/.../ChatManagementController.java` | 管理端私聊管理 |
| 私聊服务 | `crmeb-service/.../ConversationServiceImpl.java` | 私聊业务逻辑+黑名单检查 |
| 粉丝团管理 | `crmeb-admin/.../FanGroupController.java` | 管理端粉丝团管理 |
| 封禁管理 | `crmeb-admin/.../BanController.java` | 管理端封禁管理 |
| 黑名单管理 | `crmeb-admin/.../BlacklistController.java` | 管理端黑名单管理 |
| 移动端封禁 | `crmeb-front/.../BanFrontController.java` | 移动端封禁API |
| 登录服务 | `crmeb-front/.../LoginServiceImpl.java` | 登录时封禁检查 |
| 直播间控制 | `crmeb-front/.../LiveRoomController.java` | 弹幕/礼物封禁检查 |

### 5.2 前端代码

| 模块 | 文件路径 | 说明 |
|------|----------|------|
| 敏感词页面 | `admin/src/views/sensitiveWord/list/index.vue` | 敏感词管理页面 |
| 敏感词API | `admin/src/api/sensitiveWord.js` | 敏感词API接口 |
| 粉丝团页面 | `admin/src/views/fanGroup/list/index.vue` | 粉丝团管理页面 |
| 粉丝团API | `admin/src/api/fanGroup.js` | 粉丝团API接口 |
| 封禁页面 | `admin/src/views/ban/` | 封禁管理页面 |
| 黑名单页面 | `admin/src/views/blacklist/` | 黑名单管理页面 |

### 5.3 Android代码

| 模块 | 文件路径 | 说明 |
|------|----------|------|
| API接口 | `ApiService.java` | 封禁/黑名单API定义 |
| 直播间 | `RoomDetailActivity.java` | 进入房间封禁检查 |
| 粉丝团聊天 | `GroupChatActivity.java` | 粉丝团群聊功能 |
| 消息列表 | `MessagesActivity.java` | 消息列表页面 |

---

## 六、待完善功能建议

### 6.1 敏感词模块

1. **实时过滤服务** - 目前敏感词表已建立，建议实现统一的敏感词过滤服务类
2. **分类管理** - 支持按分类(spam/illegal/abuse)管理敏感词
3. **批量导入** - 支持Excel/TXT批量导入敏感词
4. **过滤日志** - 记录敏感词触发日志，便于分析

### 6.2 消息模块

1. **消息撤回通知** - 撤回消息时通知对方
2. **消息已读回执** - 显示消息已读状态
3. **群聊@功能** - 粉丝团群聊支持@成员
4. **消息搜索** - 支持历史消息搜索

### 6.3 封禁模块

1. **封禁申诉** - 用户可提交封禁申诉
2. **自动解封** - 临时封禁到期自动解封定时任务
3. **封禁通知** - 封禁/解封时推送通知给用户
4. **封禁统计** - 封禁数据统计报表

---

## 七、总结

本报告详细描述了直播平台三大核心模块的功能设计和交互逻辑：

1. **敏感词管理** - 提供内容安全过滤能力，保障平台内容合规
2. **消息/粉丝团/群组** - 构建完整的社交通讯体系，增强用户粘性
3. **封禁系统** - 提供多层次的用户管理能力，维护平台秩序

三大模块相互配合，形成完整的平台安全和社交体系。

---

*报告生成时间: 2026-01-05*