simon/wecom_it_smart_desk
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

docs(REQ-会话-001): v1.4 状态条删除闭环 + 三件套升 v1.4

Browse Source 
- 以 v1.3.5 代码为准，删除整合区状态条（不向员工暴露坐席在线/离线）
- PRD/技术方案/原型三件套升 v1.4：整合区 4→3 元素（操作按钮+进度胶囊+引导语）
- 任务说明书 v1.3→v1.4：M8 shiftHours 取消、M9 降为三元素、M11 依赖调整
- TR-会话-001-v1.3.2 分歧1 由待拍板升级为已闭环，附录A 补 v1.4 闭环记录
- 整改记录 #9→#10：闭环状态条分歧遗留项（v1.7 登记）
- 代码落地：IntegrationZone.vue 移除状态条渲染；新增 integrationZoneStatusBar.test.ts 源码级回归守卫
This commit is contained in:
Simon
2026-08-04 00:34:41 +08:00
parent 502551ad9c
commit 1c5169531a
14 changed files with 2799 additions and 85 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/07-项目管理/任务说明书/任务说明书-REQ-会话-001-员工结束会话v1.3.md → docs/07-项目管理/任务说明书/任务说明书-REQ-会话-001-员工结束会话v1.4.md
+30 -29
View File
@@ -1,10 +1,10 @@
# 任务说明书 - 员工结束会话 v1.3（整合区方案 A：状态条 + 操作按钮 + 进度胶囊三件套）
# 任务说明书 - 员工结束会话 v1.4（整合区方案 A：操作按钮 + 进度胶囊 + 引导语三元素，状态条已删除）
> **版本**: v1.0 | **日期**: 2026-07-31
> **关联需求**: REQ-会话-001 v1.3
> **关联 PRD**: PRD-REQ-会话-001-员工结束会话-v1.3 §十一
> **关联技术方案**: 技术方案-REQ-会话-001-员工结束会话-v1.3 §十
> **状态**: 待开始（M8-M14）
> **版本**: v1.4 | **日期**: 2026-08-03
> **关联需求**: REQ-会话-001 v1.4
> **关联 PRD**: PRD-REQ-会话-001-员工结束会话-v1.4 §十一
> **关联技术方案**: 技术方案-REQ-会话-001-员工结束会话-v1.4 §十
> **状态**: 待开始（M8-M14，其中 M8 shiftHours 已随 v1.4 状态条删除取消）
---
@@ -12,11 +12,11 @@
| 项目 | 内容 |
|------|------|
| **任务名称** | 员工结束会话 v1.3 改造（整合区方案 A：状态条 + 操作按钮 + 进度胶囊三件套） |
| **任务ID** | REQ-会话-001-v1.3 |
| **任务名称** | 员工结束会话 v1.4 改造（整合区方案 A：操作按钮 + 进度胶囊 + 引导语三元素，状态条 v1.4 删除） |
| **任务ID** | REQ-会话-001-v1.4 |
| **优先级** | 🟠P1 |
| **类型** | 功能开发 |
| **状态** | 待开始（M8-M14 未开始；M1-M7 已完成，见 v1.2 任务说明书） |
| **状态** | 待开始（M8-M14 未开始；M1-M7 已完成，见 v1.2 任务说明书；M8 shiftHours 因 v1.4 删除状态条已取消） |
| **负责人** | 宋献 |
| **创建日期** | 2026-07-31 |
| **计划完成日期** | 2026-08-06（M8-M14 共 2.5 天开发+测试工时） |
@@ -31,21 +31,21 @@
| 来源文档 | 相关章节 | 说明 |
|----------|----------|------|
| `docs/01-产品文档/02-会话管理/PRD-REQ-会话-001-员工结束会话-v1.3.md` | **§十一 v1.3 整合区增量**（方案 A 已拍板） | 4 维度分散 → 2 段式（整合区+顶部退出）+ 5 决策落地清单 |
| `docs/01-产品文档/02-会话管理/PRD-REQ-会话-001-员工结束会话-v1.4.md` | **§十一 v1.3/v1.4 整合区增量**（方案 A 已拍板；v1.4 反转删除状态条） | 4 维度分散 → 2 段式（整合区+顶部退出）+ 5 决策落地清单；v1.4 整合区降为三元素 |
| `docs/01-产品文档/02-会话管理/PRD-REQ-会话-001-员工结束会话-v1.2.archive.md` | §3.2 §3.5 §3.7 §3.8 | v1.2 设计哲学 + 6 态按钮 + 4 种引导语 + 顶部按钮 AI 场景互斥规则（v1.3 沿用） |
### 技术方案
| 来源文档 | 相关章节 | 说明 |
|----------|----------|------|
| `docs/02-技术文档/技术方案-REQ-会话-001-员工结束会话-v1.3.md` | **§十 v1.3 整合区实施要点**（A-F 6 子节） | 组件拆分 + 文件清单 + 共享知识 + 数据结构 + 任务列表 + 待明确事项 |
| `docs/02-技术文档/技术方案-REQ-会话-001-员工结束会话-v1.4.md` | **§十 v1.3/v1.4 整合区实施要点**（A-F 6 子节；v1.4 反转删除状态条） | 组件拆分 + 文件清单（v1.4 移除 shiftHours.ts）+ 共享知识 + 数据结构 + 任务列表 + 待明确事项 |
| `docs/02-技术文档/技术方案-REQ-会话-001-员工结束会话-v1.2.archive.md` | §3.3 §3.4 §3.7 §3.8 | store 新字段 + InputBar/ChatPanel 改动 + 24h 边界 + 双入口防抖（v1.3 沿用） |
### 原型设计
| 来源文档 | 页面 | 说明 |
|----------|------|------|
| `docs/01-产品文档/02-会话管理/原型-REQ-会话-001-结束会话流程-v1.3.html` | **§⑨ 方案 A 整合区设计（v1.3 已拍板）** | 9 场景 mockup + 5 决策落地 + R1-R5 关键交互细节 |
| `docs/01-产品文档/02-会话管理/原型-REQ-会话-001-结束会话流程-v1.4.html` | **§⑨ 方案 A 整合区设计（v1.3 已拍板 · v1.4 删除状态条）** | 9 场景 mockup + 6 决策落地（含 v1.4 状态条反转）+ R1-R5 关键交互细节 |
| `docs/01-产品文档/02-会话管理/原型-REQ-会话-001-结束会话流程-v1.2.archive.html` | §② §③ §④ | 6 态按钮 + 4 种引导语 + 顶部按钮可见性 mockup（v1.3 沿用） |
### 需了解的现有代码（v1.2 实施时必读）
@@ -139,10 +139,10 @@
- [x] M6：联调测试 + 视觉回归通过
- [x] M7：上线后监控无异常（按钮点击转化率与历史持平，无 1001 错误）
#### v1.3 待开始（2026-07-31 拍板）
#### v1.3/v1.4 待开始（2026-07-31 拍板 · 2026-08-03 v1.4 反转删除状态条）
- [ ] M8：新建 `shiftHours.ts` 工具常量（`SHIFT_HOURS = '9:00-18:00'`）
- [ ] M9：新建 `IntegrationZone.vue` 容器组件（5 元素纵向堆叠）
- [ ] M8：~~新建 `shiftHours.ts` 工具常量~~ **（v1.4 取消：状态条已删除，不再需要班次硬编码常量；`store.shiftHours` 预留后端班次字段，当前无渲染）**
- [ ] M9：新建 `IntegrationZone.vue` 容器组件（v1.3 规划 5 元素 → **v1.4 降为三元素**：操作按钮 + 进度胶囊 + 引导语，状态条移除）
- [ ] M10：新建 `integrationZone.ts` 状态 store
- [ ] M11：改造 `InputBar.vue` 移除操作按钮 + 移除引导语容器
- [ ] M12：改造 `ChatPanel.vue` 移除坐席徽章 + 集成 IntegrationZone
@@ -159,13 +159,13 @@
- [x] 部署验证通过
- [x] 文档更新已完成（任务说明书 v1.2 + 整改记录 #7）
#### v1.3 待产出
#### v1.3/v1.4 待产出
- [ ] 代码已提交并通过 Code Review（M8-M13）
- [ ] 单元测试新增/修复完成（覆盖整合区 9 场景 + store.shiftHours 单测）
- [ ] 代码已提交并通过 Code Review（M9-M13；M8 因 v1.4 状态条删除取消）
- [ ] 单元测试新增/修复完成（覆盖整合区 9 场景；v1.4 移除 store.shiftHours 单测）
- [ ] 集成测试通过
- [ ] 部署验证通过
- [ ] 文档更新已完成（本任务说明书 v1.3 + 整改记录 #8）
- [ ] 文档更新已完成（本任务说明书 v1.4 + 整改记录 #10）
---
@@ -186,19 +186,19 @@
| **M7** | 上线 | 0.5 天 | ✅ 已完成 |
| | **小计** | **4.5 天** | |
### v1.3 待开始阶段（2026-07-31 拍板，整合区方案 A 实施）
### v1.3/v1.4 待开始阶段（2026-07-31 拍板 · 2026-08-03 v1.4 反转删除状态条）
| 阶段 | 任务 | 预估工时 | 依赖 | 状态 |
|------|------|----------|------|------|
| **M8** | 新建 `shiftHours.ts` 工具常量（`SHIFT_HOURS = '9:00-18:00'`，v1.4 接 store.shiftHours） | 0.1d | — | ⏳ 待开始 |
| **M9** | 新建 `IntegrationZone.vue` 容器组件（5 元素纵向堆叠 + 浅灰背景 + 状态条三态文案） | 0.5d | — | ⏳ 待开始 |
| **M8** | ~~新建 `shiftHours.ts` 工具常量~~ **（v1.4 取消：状态条删除，不再需要班次硬编码常量）** | 0d | — | ❌ 已取消 |
| **M9** | 新建 `IntegrationZone.vue` 容器组件（v1.4 三元素纵向堆叠 + 浅灰背景：**移除状态条三态文案**） | 0.5d | — | ⏳ 待开始 |
| **M10** | 新建 `integrationZone.ts` 状态 store | 0.3d | — | ⏳ 待开始 |
| **M11** | 改造 `InputBar.vue` 移除操作按钮 + 移除引导语容器（工具栏更简洁：😊📎[输入框][发送]） | 0.3d | M8 | ⏳ 待开始 |
| **M11** | 改造 `InputBar.vue` 移除操作按钮 + 移除引导语容器（工具栏更简洁：😊📎[输入框][发送]） | 0.3d | — | ⏳ 待开始 |
| **M12** | 改造 `ChatPanel.vue` 移除坐席徽章 + 集成 IntegrationZone | 0.5d | M9, M10 | ⏳ 待开始 |
| **M13** | 改造 `QueueCapsule.vue` 集成到 IntegrationZone 内部 | 0.3d | M9 | ⏳ 待开始 |
| **M14** | 联调测试 + 视觉回归 + 部署 prod（按钮态回归 9 场景 + 整合区 mockup 视觉对比） | 0.5d | M11, M12, M13 | ⏳ 待开始 |
| | **小计** | **2.5d** | | |
| | **v1.2 + v1.3 合计** | **7.0 天** | | |
| | **小计** | **2.4d** | | |
| | **v1.2 + v1.4 合计** | **6.9 天** | | |
---
@@ -227,16 +227,17 @@
|------|----------|--------|------|
| 2026-07-30 | 创建任务说明书 v1.0 | Duckula (AI) | 覆盖 PRD v1.2 + 技术方案 v1.2 的 7 阶段实施计划；按 product-doc-standard 规范要求补建任务说明书 |
| 2026-07-31 | 创建任务说明书 v1.0（v1.3 整合区方案 A） | Duckula (AI) | 基于 v1.2 任务说明书扩展：保留 M1-M7 已完成阶段，新增 M8-M14 待开始阶段（整合区实施）；基线版本 v1.2 → v1.3；新增引用 PRD v1.3 §十一 + 技术方案 v1.3 §十 + 原型 v1.3 §⑨；预计完成日期 2026-08-06 |
| 2026-08-03 | 升级任务说明书 v1.3 → v1.4 | Duckula (AI) | 闭环整改 #9 遗留分歧：以 v1.3.5 代码为准删除整合区状态条；引用 PRD/技术方案/原型升级为 v1.4；M8 shiftHours 标记取消、M9 降为三元素、M11 依赖改为无；小计 2.5d→2.4d；关联整改记录 #10 |
---
## 📎 附件
### v1.3 主线文档
### v1.4 主线文档
- **产品需求（v1.3）**：[PRD-REQ-会话-001-员工结束会话-v1.3.md](../../01-产品文档/02-会话管理/PRD-REQ-会话-001-员工结束会话-v1.3.md) **§十一 v1.3 整合区增量**
- **技术方案（v1.3）**：[技术方案-REQ-会话-001-员工结束会话-v1.3.md](../../02-技术文档/技术方案-REQ-会话-001-员工结束会话-v1.3.md) **§十 v1.3 整合区实施要点**
- **原型图（v1.3）**：[原型-REQ-会话-001-结束会话流程-v1.3.html](../../01-产品文档/02-会话管理/原型-REQ-会话-001-结束会话流程-v1.3.html) **§⑨ 方案 A 整合区设计**
- **产品需求（v1.4）**：[PRD-REQ-会话-001-员工结束会话-v1.4.md](../../01-产品文档/02-会话管理/PRD-REQ-会话-001-员工结束会话-v1.4.md) **§十一 v1.3/v1.4 整合区增量（v1.4 反转删除状态条）**
- **技术方案（v1.4）**：[技术方案-REQ-会话-001-员工结束会话-v1.4.md](../../02-技术文档/技术方案-REQ-会话-001-员工结束会话-v1.4.md) **§十 v1.3/v1.4 整合区实施要点**
- **原型图（v1.4）**：[原型-REQ-会话-001-结束会话流程-v1.4.html](../../01-产品文档/02-会话管理/原型-REQ-会话-001-结束会话流程-v1.4.html) **§⑨ 方案 A 整合区设计（v1.4 删除状态条）**
### v1.2 基线文档（已上线，M1-M7 已完成）