Simon
44e77dcb0e
**重构前**（旧编号 02-11）： - docs/02-产品需求/ → 00 产品规划/PRD - docs/03-技术架构/ → 01-05 子目录散落 - docs/04-原型设计/ → 01-02 产品设计（HTML 原型） - docs/05-原型设计/ → screens/ - docs/06-测试素材/ → 02-E2E / 03-功能 / 04-版本测试 - docs/07-项目管理/ → 任务说明书/日报/计划 - docs/08-安全审计/ → 审计报告 - docs/09-堡垒运维/ → toolbox / deploy - docs/10-项目管理/ → 任务说明书（重复） - docs/11-历史归档/ → deploy-nas-archived **重构后**（新编号 00-07，语义化）： - docs/00-产品开发流程与文档管理规范.md - docs/00-版本迭代总览.md - docs/01-产品文档/ （PRD/原型/认证/会话/AI 服务/坐席/集成） - docs/02-技术文档/ （技术方案/架构图/重构记录/前端改造/实现配置） - docs/03-测试文档/ （E2E/功能用例/版本报告/缺陷单） - docs/04-运维文档/ （部署运维/运维指南） - docs/05-运营文档/ （品牌推广/用户手册） - docs/06-安全审计/ （审计报告） - docs/07-项目管理/ （任务说明书/日报/计划/看板） **净收益**： - 目录编号与产品文档管理规范对齐（按文档阶段 01-07 编号） - 消除 02-产品需求 与 10-项目管理 的编号重叠 - 子目录按文档类型分组（如 01-产品文档/00-产品规划、01-产品文档/01-认证与登录） - 把运维/安全/项目管理从 0X 散落改为 04/06/07 合计 494 文件 + 78495 行 / - 14076 行
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 |
|