docs(会话-001/用户-005): 版本合并与文档规范化整改 #9
REQ-会话-001 员工结束会话: - PRD/原型 v1.0/v1.1/v1.2 归档为 .archive，现行收敛至单一 v1.3 - 技术方案 v1.2 归档，v1.3 为现行版本(位于 docs/02-技术文档/) - PRD v1.3 §六 关联文档表指向 v1.3 原型与技术方案实际路径 - 三份任务说明书 + BUG-003 + TC-用户-008 引用同步至 .archive/v1.3 REQ-用户-005 头像菜单退出: - PRD/原型/技术方案文件名 v1.0 -> v1.1，追平内容版本(铁律2) - 三件套 + 任务说明书 + TC 互引版本对齐，相关 PRD 指向会话-001 v1.3 其他: - 修复 4 处 UTF-8 乱码(U+FFFD) - 新增 TR-会话-001-结束会话-v1.3.2 端到端测试报告(单测 75/75 + 生产构建通过) - 整改记录 #9 写入 00-文档规范化整改记录.md 遗留: PRD v1.3「状态条永久显示」与代码 v1.3.5「状态条已删除」存在分歧，待产品拍板
This commit is contained in:
Simon
@@ -247,3 +247,24 @@
|
||||
| 2026-07-28 | v1.3 | 新增整改 #4：移除快速回复规则页面顶部 3 张重复统计卡片，并登记代码事实与回归方式 | Simon / 宋献 | 页面信息冗余 | REQ-通用-002 文档链及管理后台 `/quick-rules` 页面 |
|
||||
| 2026-07-30 | v1.4 | 新增整改 #7：REQ-会话-001 v1.2 三件套位置/任务说明书补齐/历史归档 | Duckula (AI) | 大需求重构跨阶段实施，PRD v1.2 阶段必须三件套对齐 + 任务说明书 + 历史归档 | REQ-会话-001 文档链（PRD v1.2 + 原型 v1.2 + 技术方案 v1.2） |
|
||||
| 2026-07-31 | v1.6 | 新增整改 #8：REQ-会话-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 §⑨） |
|
||||
|
||||
---
|
||||
|
||||
### 整改 #9 · REQ-会话-001 版本合并 + REQ-用户-005 规范化（7 文档合并）
|
||||
|
||||
| 项目 | 值 |
|
||||
|------|------|
|
||||
| 日期 | 2026-07-27 |
|
||||
| 触发人 | 宋献 / Duckula |
|
||||
| 源需求 / 源文档 | REQ-会话-001（员工结束会话，PRD/原型 v1.0-v1.3 合并）；REQ-用户-005（头像菜单退出，v1.0→v1.1 规范化）|
|
||||
| 整改维度 | A 命名/位置 + B 关联引用 + D 完整度 |
|
||||
| 问题数 | 11 项（7 文档版本合并 + 4 类引用/编码缺陷）|
|
||||
| 关键修复 | **【会话-001 版本合并】** 1) 归档 PRD v1.0/v1.1/v1.2 → `.v1.x.archive.md`（canonical 为 v1.3，其 §九 变更记录已覆盖 v1.1→v1.2→v1.3）；2) 归档 原型 v1.0/v1.1/v1.2 → `.v1.x.archive.html`（保留 v1.3 + 整合区方案A v1.3 为现行）；3) 归档 技术方案 v1.2 → `.v1.2.archive.md`（v1.3 已存在为现行）。<br>**【用户-005 规范化】** 4) PRD + 原型 文件名 `v1.0`→`v1.1`（铁律2：文件名=内容版本，内容头部本就是 v1.1）；5) 技术方案 文件名 `v1.0`→`v1.1`（内容本就是 v1.1）。<br>**【引用对齐】** 6) PRD-会话-001 v1.3 §六：原型/技术方案引用 v1.2→v1.3 且技术方案补全 `../../02-技术文档/` 路径；7) 技术方案-会话-001 v1.3 头部：PRD/原型裸引用补全相对路径；8) 用户-005 三件套（PRD/技术方案/任务说明书/TC）互引 v1.0→v1.1，相关 PRD 指向会话-001 v1.3，参考原型指向自身 v1.1；9) 任务说明书 #128 关联 PRD/技术方案/原型 v1.0→v1.3（技术方案路径改 `02-技术文档/`）；10) 会话-001 三份任务说明书（v1.2/v1.3/通用）中被本次归档波及的 v1.2/v1.0 引用改为 `.archive` 有效历史链接；v1.3 原型 HTML 的"对应 PRD/技术方案"由 v1.2 改为 v1.3。<br>**【编码缺陷】** 11) 修复 4 处 UTF-8 乱码（U+FFFD）：用户-005 PRD「退出风险」、用户-005 任务说明书「菜单退出」「结束咨询按钮」、会话-001 技术方案 v1.3「标题栏坐席徽章」；历史缺陷/TC 文档（BUG-003、TC-用户-008）的 v1.0 裸引用改为 `.archive`。 |
|
||||
| 归档动作 | PRD-会话-001-v1.0/v1.1/v1.2.md → `.v1.x.archive.md`；原型-会话-001-v1.0/v1.1/v1.2.html → `.v1.x.archive.html`；技术方案-会话-001-v1.2.md → `.v1.2.archive.md`；用户-005 PRD/原型/技术方案 `v1.0`→`v1.1`（现行文件改名，非归档）|
|
||||
| 引用同步 | 会话-001 v1.3 现行三件套（PRD/技术方案/原型/任务说明书）互相指向 v1.3；用户-005 现行三件套（PRD v1.1/技术方案 v1.1/任务说明书/TC）互相指向 v1.1；被归档版本以 `.archive` 形式在任务说明书中保留历史链接 |
|
||||
| ASCII 副本同步 | 无需（仅中文路径文档，无 ASCII 副本机制参与）|
|
||||
| 收益 | 1) 会话-001 现行文档单一真源收敛到 v1.3，历史版本可溯；2) 用户-005 三件套版本对齐（均 v1.1），消除"文件名 v1.0 / 内容 v1.1"错位；3) 跨文档引用全部有效，无悬空链接；4) 消除 4 处编码乱码 |
|
||||
| 教训 | **① 文件名版本号必须随内容同步 bump**：用户-005 PRD/技术方案内容已升 v1.1 但文件名仍 v1.0，埋雷数月；**② 技术方案应落在 `02-技术文档/`**，裸引用（无路径）会从 PRD 所在目录错误解析；**③ 中文文档的 UTF-8 乱码需专项扫描**：本次 4 处乱码均因早期 Edit 写入异常，合并时须用 U+FFFD 扫描兜底 |
|
||||
| 遗留待办 | 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 |
|
||||
|
||||
|
||||
Reference in New Issue
Block a user