180 lines
6.3 KiB
Markdown
180 lines
6.3 KiB
Markdown
|
# 员工结束会话 PRD
|
|||
|
|
|
|||
|
|
> **版本**: v1.0
|
|||
|
|
> **日期**: 2026-07-24
|
|||
|
|
> **REQ编号**: REQ-会话-001
|
|||
|
|
> **优先级**: P1
|
|||
|
|
> **阶段**: 近期
|
|||
|
|
> **状态**: 待评审
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 一、需求概述
|
|||
|
|
|
|||
|
|
### 1.1 需求背景
|
|||
|
|
|
|||
|
|
当前系统存在以下问题：
|
|||
|
|
1. 用户无法主动结束会话，若要结束错误对话历史（如AI回答错误），只能开启新会话
|
|||
|
|
2. 人工咨询场景缺少员工主动结束的入口
|
|||
|
|
3. 满意度评价仅在AI判定问题已解决时触发，无法覆盖所有会话场景
|
|||
|
|
|
|||
|
|
### 1.2 需求目标
|
|||
|
|
|
|||
|
|
| 目标 | 说明 |
|
|||
|
|
|------|------|
|
|||
|
|
| G1 | 员工可主动结束当前会话 |
|
|||
|
|
| G2 | 结束会话时强制收集满意度评价 |
|
|||
|
|
| G3 | 复用"人工咨询"按钮实现全流程状态管理 |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 二、用户故事
|
|||
|
|
|
|||
|
|
| # | 角色 | 用户故事 |
|
|||
|
|
|---|------|----------|
|
|||
|
|
| US-1 | 员工 | 作为员工，我希望在会话结束时能主动关闭会话，以便开始新会话获取正确回答 |
|
|||
|
|
| US-2 | 员工 | 作为员工，我希望结束会话时能评价本次服务，以便反馈服务质量 |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 三、功能详情
|
|||
|
|
|
|||
|
|
### 3.1 按钮状态机设计
|
|||
|
|
|
|||
|
|
复用现有的"人工咨询"按钮，实现四状态转换：
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
┌─────────────────────────────────────────────────────────────┐
|
|||
|
|
│ 状态1 状态2 状态3 状态4 │
|
|||
|
|
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
|
|||
|
|
│ │ 人工咨询 │→ │ 排队等待中│→ │ 已接入 │→ │ 结束咨询 │ │
|
|||
|
|
│ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │
|
|||
|
|
│ ↓ ↓ ↓ ↓ │
|
|||
|
|
│ 发起呼叫 询问取消排队? 正常会话 评价+关闭 │
|
|||
|
|
└─────────────────────────────────────────────────────────────┘
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
| 状态 | 按钮文字 | 点击行为 | 触发条件 |
|
|||
|
|
|------|---------|---------|---------|
|
|||
|
|
| 状态1 | 人工咨询 | 发起呼叫请求 | 默认状态 |
|
|||
|
|
| 状态2 | 排队等待中 | 弹出确认框："是否取消排队？" | 呼叫请求发送后 |
|
|||
|
|
| 状态3 | 结束咨询 | 弹出满意度评价 → 提交后窗口自动关闭 | 坐席接听（已接入） |
|
|||
|
|
|
|||
|
|
### 3.2 结束流程
|
|||
|
|
|
|||
|
|
点击"结束咨询"后的完整流程：
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
用户点击"结束咨询"
|
|||
|
|
↓
|
|||
|
|
【技术实现】调用后端API关闭会话（POST /h5/conversations/current/close）
|
|||
|
|
↓
|
|||
|
|
会话状态变为 resolved
|
|||
|
|
↓
|
|||
|
|
弹出满意度评价组件
|
|||
|
|
↓
|
|||
|
|
用户提交评价（必填）
|
|||
|
|
↓
|
|||
|
|
评价提交成功 → 窗口自动关闭
|
|||
|
|
↓
|
|||
|
|
重新进入应用 → 全新会话
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**技术要点**：
|
|||
|
|
- 必须先调用后端API将会话状态变为resolved，否则评价会报错"只能评价已结单的会话"
|
|||
|
|
- 关闭会话API会触发会话结束事件，前端监听会话状态变化自动处理
|
|||
|
|
|
|||
|
|
**注意**：点击"结束咨询"后无"继续"选项，直接进入评价流程。
|
|||
|
|
| 状态2 | 排队等待中 | 弹出确认框："是否取消排队？" | 呼叫请求发送后 |
|
|||
|
|
| 状态3 | 已接入 | 无操作（禁用） | 坐席接听 |
|
|||
|
|
| 状态4 | 结束咨询 | 弹出评价组件 → 关闭会话 | 坐席挂断或用户主动点击 |
|
|||
|
|
|
|||
|
|
### 3.2 评价组件集成
|
|||
|
|
|
|||
|
|
复用现有的 `ResolveFeedback.vue` 组件：
|
|||
|
|
|
|||
|
|
| 字段 | 说明 |
|
|||
|
|
|------|------|
|
|||
|
|
| 评价选项 | 满意/一般/不满意（表情） |
|
|||
|
|
| 评语 | 可选，文本输入 |
|
|||
|
|
| 提交行为 | 评价提交后自动关闭会话 |
|
|||
|
|
|
|||
|
|
### 3.3 后端API（已存在）
|
|||
|
|
|
|||
|
|
| API | 说明 |
|
|||
|
|
|-----|------|
|
|||
|
|
| `POST /h5/conversations/current/close` | 员工主动关闭会话 |
|
|||
|
|
| `POST /api/conversations/{id}/evaluation` | 提交满意度评价（复用） |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 四、非目标
|
|||
|
|
|
|||
|
|
| # | 明确不做 |
|
|||
|
|
|---|----------|
|
|||
|
|
| N1 | 不修改人工呼叫的后端逻辑（仅前端状态管理） |
|
|||
|
|
| N2 | 不区分AI会话与人工会话的结束流程 |
|
|||
|
|
| N3 | 不支持跳过评价直接关闭（必须评价） |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 五、验收指标
|
|||
|
|
|
|||
|
|
| # | 指标 | 目标值 | 验收方式 |
|
|||
|
|
|---|------|--------|---------|
|
|||
|
|
| AC1 | 员工可主动结束会话 | 100% | 点击"结束咨询"按钮可触发关闭流程 |
|
|||
|
|
| AC2 | 评价提交率 | =100% | 关闭会话前必须提交评价 |
|
|||
|
|
| AC3 | 按钮状态切换正确 | 4种状态正确切换 | 人工呼叫全流程测试 |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 六、关联文档
|
|||
|
|
|
|||
|
|
| 文档 | 说明 |
|
|||
|
|
|------|------|
|
|||
|
|
| `前端组件-ResolveFeedback.vue` | 满意度评价组件 |
|
|||
|
|
| `API-h5.py` | 关闭会话API |
|
|||
|
|
| `PRD-REQ-集成-002-邀请功能` | 会话管理系列功能 |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 七、里程碑
|
|||
|
|
|
|||
|
|
| 阶段 | 任务 | 预计时间 |
|
|||
|
|
|------|------|---------|
|
|||
|
|
| M1 | PRD评审 | 0.5天 |
|
|||
|
|
| M2 | 前端实现（状态机+评价） | 1天 |
|
|||
|
|
| M3 | 联调测试 | 0.5天 |
|
|||
|
|
| M4 | 上线 | 0.5天 |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 八、风险与依赖
|
|||
|
|
|
|||
|
|
| 风险 | 影响 | 缓解措施 |
|
|||
|
|
|------|------|---------|
|
|||
|
|
| R1：现有"人工坐席"按钮逻辑复杂 | 改动可能影响原有功能 | 先梳理现有状态机逻辑 |
|
|||
|
|
| R2：评价组件复用兼容性 | 现有组件可能不完全匹配 | 评估是否需要微调 |
|
|||
|
|
|
|||
|
|
**依赖**：
|
|||
|
|
- D1：后端 `/h5/conversations/current/close` API可用
|
|||
|
|
- D2：前端 `ResolveFeedback.vue` 组件可用
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 九、变更记录
|
|||
|
|
|
|||
|
|
> 本章节记录需求发布后的 bug 修复与变更。需求主体（v1.0）保持不变，每次变更记录一行。
|
|||
|
|
|
|||
|
|
| 日期 | 变更内容 | 关联缺陷 | 变更人 |
|
|||
|
|
|------|----------|----------|--------|
|
|||
|
|
| 2026-07-30 | H5 员工端"结束会话失败,请稍后重试"修复：前端最小修复（防抖 + 同步 store + 改善 catch 文案），零后端改动。详见 BUG-用户-003。部署 hash：CSS `index-CfEzPwEP.css` / JS `index-DDJ_fm-u.js`。 | [BUG-用户-003](../../03-测试文档/05-缺陷单/BUG-用户-H5结束会话失败-003.md) | Duckula (AI) |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 十、关联缺陷
|
|||
|
|
|
|||
|
|
| 缺陷编号 | 标题 | 状态 | 优先级 |
|
|||
|
|
|----------|------|------|--------|
|
|||
|
|
| [BUG-用户-003](../../03-测试文档/05-缺陷单/BUG-用户-H5结束会话失败-003.md) | H5员工端"结束会话失败,请稍后重试" | 已修复（2026-07-30） | P2-Medium |
|