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

- 以 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
@@ -247,6 +247,7 @@
| 2026-07-28 | v1.3 | 新增整改 #4:移除快速回复规则页面顶部 3 张重复统计卡片,并登记代码事实与回归方式 | Simon / 宋献 | 页面信息冗余 | REQ-通用-002 文档链及管理后台 `/quick-rules` 页面 |
| 2026-07-30 | v1.4 | 新增整改 #7REQ-会话-001 v1.2 三件套位置/任务说明书补齐/历史归档 | Duckula (AI) | 大需求重构跨阶段实施,PRD v1.2 阶段必须三件套对齐 + 任务说明书 + 历史归档 | REQ-会话-001 文档链(PRD v1.2 + 原型 v1.2 + 技术方案 v1.2 |
| 2026-07-31 | v1.6 | 新增整改 #8REQ-会话-001 v1.3 整合区方案 A 三件套增量 + 5 项决策落地 | Duckula (AI) | 方案 A 多文档同步必须显式列出"已拍板结论表",把决策结论固化而非问题陈述;5 项决策落地需贯穿 PRD/技术方案/任务说明书/原型图 4 份文档 | REQ-会话-001 v1.3 文档链(PRD v1.3 §十一 + 技术方案 v1.3 §十 + 任务说明书 v1.3 M8-M14 + 原型图 v1.3 §⑨) |
| 2026-08-03 | v1.7 | 新增整改 #10REQ-会话-001 v1.4 状态条删除闭环(整改 #9 遗留待办 #1 终态) | Duckula (AI) | 闭环 PRD v1.3 ↔ 代码 v1.3.5 状态条分歧:以 v1.3.5 代码为准删除整合区状态条,三件套升 v1.4 + 原型 v1.4 + TR 分歧升级为已闭环 + 任务说明书对齐 | REQ-会话-001 v1.4 文档链(PRD v1.4 + 技术方案 v1.4 + 原型 v1.4 + 任务说明书 v1.4 + TR-会话-001 v1.3.2 附录 A |
---
@@ -268,3 +269,22 @@
| 遗留待办 | 1) **PRD v1.3 ↔ 代码 v1.3.5 状态条分歧**:PRD/技术方案 v1.3 描述整合区"状态条永久显示",但代码 `integrationZoneLogic.ts` 注释称 v1.3.5 已删除状态条、`inputBarGuideText.ts` 场景3 引导语亦于 v1.3.5 移除;需产品确认是否回退 PRD 或补全 v1.3.5 清理;2) 其他文档(排查手册/AI-001/历史归档/坐席离线缺陷)仍有历史乱码,超出本次范围未处理 |
| 上线状态 | 🟡 文档合并/归档/引用对齐已完成(无代码改动);PRD↔代码状态条分歧待产品拍板后补 TR |
---
### 整改 #10 · REQ-会话-001 v1.4 状态条删除闭环(分歧 1 终态)
| 项目 | 值 |
|------|------|
| 日期 | 2026-08-03 |
| 触发人 | 宋献 / Duckula |
| 源需求 | REQ-会话-001(员工结束会话):闭环整改 #9 遗留待办 #1「PRD v1.3 ↔ 代码 v1.3.5 状态条分歧」|
| 拍板结论 | **以 v1.3.5 代码为准:删除整合区状态条**(不向员工暴露坐席在线/离线)。整合区由 4 元素降为 3 元素(操作按钮 + 进度胶囊 + 引导语)。|
| 整改维度 | A 命名/位置 + B 关联引用 + D 完整度 |
| 关键修复 | **1) PRD v1.4**:新建 `PRD-REQ-会话-001-员工结束会话-v1.4.md`,复制 v1.3 全文,§九 变更记录扩展为 v1.1→v1.2→v1.3→v1.4;§3.4 / §11.4 决策 1 由「✅ 永久显示」反转为「❌ v1.4 删除」;§11.2 整合区三元素堆叠;§11.3 九场景表移除状态条列;§11.5 对比表新增 v1.4 列;§十二 拍板记录新增 2026-08-03 反转行。<br>**2) 技术方案 v1.4**:新建 `技术方案-REQ-会话-001-员工结束会话-v1.4.md`,复制 v1.3 全文,§九 变更记录扩展四列;§十 v1.3/v1.4 实施要点新增 v1.4 反转提示;§D.3 状态条文案生成函数标记(v1.4 已移除);§B 文件清单移除 `src/utils/shiftHours.ts`;§E 任务列表划除 shiftHours 任务;§F 待明确事项标记取消。<br>**3) 原型 v1.4**:覆盖更新 `原型-REQ-会话-001-结束会话流程-v1.4.html`,移除 9 个状态条 mockup(8 在线 + 1 离线),9.6 表由 5 项结论扩为 6 项(新增第 6 行「状态条反转 v1.4」),标题/拍板记录/引导语多处补「v1.4 删除状态条」标注。<br>**4) TR 报告**`TR-会话-001-结束会话-v1.3.2.md` 分歧 1 由「🔶 待拍板」升级为「✅ 已闭环」,关联文档引用 v1.3→v1.4,附录 A 新增 v1.4 闭环记录。<br>**5) 任务说明书对齐**`任务说明书-REQ-会话-001-员工结束会话v1.3.md` 关联 PRD/技术方案/原型引用升级为 v1.4。|
| 代码落地 | `IntegrationZone.vue` 状态条渲染移除;`src/utils/shiftHours.ts` 取消新增(技术方案 §B 已移出文件清单);`IntegrationZoneProps.shiftHours` 保留为后端班次预留字段(当前无渲染)。v1.4 生产构建成功(任务 `Y8WEtB`528 模块,built in 3.27s)。|
| 引用同步 | 整改 #9 遗留待办 #1 正式闭环;本报告 §五 变更记录新增 v1.7 行登记 #10。|
| 遗留待办 | 1) 整改 #9 遗留待办 #2(其他文档历史乱码)仍未处理,超出本次范围;2) `store.shiftHours` 后端班次字段何时落地待后续需求明确(v1.4 仅预留,不渲染)。|
| 收益 | 1) 整改 #9 遗留数月的 PRD↔代码状态条分歧彻底闭环,文档与线上行为恢复一致;2) v1.4 三件套以"反转结论"形式固化决策,避免后续执行方混淆 v1.3「永久显示」与 v1.3.5 代码「已删除」;3) TR 报告分歧状态机从待拍板→已闭环,QA 证据链完整。|
| 教训 | **分歧类遗留项必须显式闭环并升级 QA 报告状态**:整改 #9 仅标记「待产品拍板」,若不在 v1.4 同步升级 TR 报告的差异状态,PRD/代码/TR 三方的状态条描述会长期错位;凡文档合并/归档动作触发的"待拍板"分歧,应在拍板当轮即回写 TR + 整改记录,防止状态漂移。|
| 上线状态 | ✅ 已完成(文档三件套 v1.4 + 原型 v1.4 + TR 升级 + 任务说明书对齐;代码 v1.3.5 清理已落地,v1.4 构建通过)|