# 版本迭代总览

> 本文件为 IT智能服务台 的**全局版本迭代索引**，是跨类别文档（PRD / 技术方案 / 测试报告 / 部署发布）的统一时间轴。
> 原 `02-技术文档/重构记录` 已按版本拆分并入 `01-产品文档` / `02-技术文档`，本文件承接其"版本总览"职责。

## 一、用途

- 一眼看清每个版本**交付了什么、对应哪个 PRD / 技术方案、测试结果、发布说明**
- 新需求/变更落地时，在此追加一行，并同步更新对应 PRD 的「版本历史」
- 避免重构记录、发布说明、任务说明书各自维护版本号导致的不一致

## 二、字段定义

| 字段 | 说明 |
|------|------|
| 版本号 | 语义化版本（如 v0.7.1） |
| 日期 | 发布/合并日期 |
| 需求来源 | 关联 PRD（指向 `01-产品文档/01-01产品需求/`） |
| 技术方案 | 关联技术文档（指向 `02-技术文档/`） |
| 测试 | 关联测试报告（指向 `03-测试文档/`） |
| 发布说明 | 关联部署发布记录（指向 `04-运维文档/部署运维/`） |
| 关键变更 | 一句话摘要 |

## 三、版本时间轴

> 以下版本号从现有发布说明/任务说明书文件名中提取，**内容已回填**。

| 版本号 | 日期 | 需求来源 | 技术方案 | 测试 | 发布说明 | 关键变更 |
|--------|------|----------|----------|------|----------|----------|
| v0.5.0 | 2026-05-? | - | - | - | - | 初始 Beta 版本 |
| v0.5.2 | 2026-06-16 | - | - | - | 部署包-2026-06-16-v0.5.2 | 部署包发布 |
| v0.5.3 | 2026-06-16 | - | - | - | 部署包-2026-06-16-v0.5.3 | 部署包发布 |
| v0.7.0 | 2026-06-21 | - | 扫码登录+OTP部署指南 | - | 07-扫码登录OTP部署指南 / 10-一键部署操作包 | 扫码登录+OTP二次认证 |
| v0.7.1 | 2026-06-23 | - | - | - | RELEASE_NOTES_v0.7.1 | 扫码iOS修复、MFA+RBAC、H5企微OAuth |
| v1.1.0 | 2026-06-14 | - | - | - | 05-版本更新说明-v1.1.0 | 消息撤回/删除、状态追踪、OTP认证 |
| v1.2.0（重构） | 2026-07-? | 复杂场景与统一路由PRD | 02-技术文档/技术架构 | - | - | 复杂场景重构（暂停恢复，信息更正、版本链、排查步骤联动） |
| v1.2.1（Bugfix） | 2026-07-24 | REQ-AI-005 | - | - | 04-运维文档/部署运维/00-标准故障排查手册.md (CASE-20260724-01) | H5选项选择消息重复修复 |
| v1.2.2（Patch） | 2026-07-25 | REQ-AI-001（复杂场景与统一路由） | 02-技术文档/实现配置/AI对话链路全栈改造实施计划-v1.0.md | E2E打字机验证报告（2026-07-08） | - | AI回复打字机逐字显示效果（前端 H5 + Agent 双端） |
| v1.2.3（Bugfix） | 2026-07-26 | - | - | - | 04-运维文档/部署运维/00-标准故障排查手册.md (CASE-20260726-01~08) | AI选项交互全链路修复：结构化回复渲染、白屏三连、消息排序、轮询去重、选中状态、Dify超时 |
| **v1.2（管理后台 IA 调整）** | 2026-07-28 | PRD-REQ-集成-002-管理后台-v1.0.md (v1.2) | 技术方案-REQ-集成-002-管理后台v1.2-分配模式Tab收编.md | TC-集成-002-分配模式Tab收编.md | 任务说明书-REQ-集成-002-分配模式Tab收编.md | **分配模式收编到坐席管理 Tab**：原 `/admin/assignment-mode` 独立菜单/独立页 → 收编为 `/admin/agents` 第 2 Tab「分配策略」；菜单导航「知识与 AI」8 → 7 项，总菜单数 27 → 26；后端 API 零改动；6 张模式卡片（手动接单 P0 + 轮询/最少活跃 P2 + 加权/技能匹配/优先队列 P3）全部迁移嵌入 Tab 2 |

## 四，回填来源

- 发布说明：`04-运维文档/部署运维/` 下 `RELEASE-NOTES-*`、`*-部署指南*`、`*-版本更新说明*`
- 任务说明书：`07-项目管理/任务说明书/` 下 `任务说明书-*` 含版本/批次信息
- 重构方案：`02-技术文档/重构记录/00-v4.0重构总方案.md`
- 测试报告：`03-测试文档/04-版本测试报告/`

## 五、文档整理记录（2026-07-19）

> 本次整理为 IT智能服务台 项目的首次系统性文档规范化，基于 `00-产品开发流程与文档管理规范.md` 执行。

### 5.1 整理范围

| 目录 | 操作 | 说明 |
|------|------|------|
| 01-产品文档 | ✅ 已优化 | PRD/原型命名规范化，REQ编号关联 |
| 02-技术文档 | ✅ 已优化 | 技术方案头部规范化，引用路径更新 |
| 03-测试文档 | ⚠️ 部分优化 | 子目录编号统一 |
| 04-运维文档 | ✅ 已优化 | 归档清理（toolbox/archive→08-历史归档） |
| 05-运营文档 | ✅ 已优化 | 子目录编号统一（02-用户手册、03-运营报告） |
| 06-安全审计 | ✅ 已优化 | 文档归类（健康检查→04-运维文档） |
| 07-项目管理 | ✅ 已优化 | 散存文件整理（日报/计划/看板子目录） |
| 08-历史归档 | ✅ 符合规范 | 归档文件正确标记 |

### 5.2 核心修复

1. **REQ编号格式修复**：1个 PRD 文档的 REQ 编号从 `REQ-02-001` 修正为 `REQ-会话-001`
2. **技术方案头部规范化**：8 个技术方案文档增加 REQ 编号和 PRD 关联字段
3. **引用路径更新**：20+ 处旧路径引用（`docs/02-产品需求/` → `01-产品文档/子系统/`）
4. **子目录编号统一**：05-运营文档、07-项目管理目录编号规范化

### 5.3 经验总结

- **引用路径一致性**：文档重组后必须同步更新所有引用，避免"死链接"
- **REQ编号全局唯一**：需求编号在项目范围内必须唯一，禁止重复使用
- **技术方案头部模板**：建议包含 `REQ编号`、`关联PRD`、`状态`、`架构师` 字段
- **归档文件命名**：使用 `-archived-日期` 后缀标记已归档文档

### 5.4 2026-07-28 v1.2 收编经验总结（基于分配模式 Tab 收编）

#### 任务性质

| 维度 | 取值 |
|------|------|
| 类型 | UI 改造（页面结构） |
| 优先级 | P2（导航重构已 v1.1 完成，v1.2 是清理性收编） |
| 工作量 | 0.5–1 人日（约 80 min 实施 + 30 min 文档） |
| 影响范围 | 前端 4 文件 + 1 路由 + 0 后端改动 |
| 决策依据 | 阶段一分配模式 6 个里 5 个灰化占位，独立菜单过重；解锁条件强依赖坐席人数，Tab 合并后上下文最连贯；未来膨胀可拆回独立页（可逆撤销） |

#### 完整产物清单（按规范 §4.3"功能调整"）

| # | 文档 | 路径 | 规范要求 |
|---|------|------|----------|
| 1 | PRD v1.1 → v1.2 | `docs/01-产品文档/08-集成生态/PRD-REQ-集成-002-管理后台-v1.0.md` | §4.3"功能调整" + 版本号 + 变更记录 |
| 2 | 原型图同步 | `docs/01-产品文档/08-集成生态/原型-REQ-集成-000-管理后台-v1.0.html` | §4.3"原型图（视情况）" |
| 3 | 技术方案 v1.0 | `docs/02-技术文档/技术方案-REQ-集成-002-管理后台v1.2-分配模式Tab收编.md` | §3.1.3 + §4.3 |
| 4 | 测试用例 v1.0 | `docs/03-测试文档/03-功能测试用例/TC-集成-002-分配模式Tab收编.md` | §4.3"功能调整"+回归 |
| 5 | 任务说明书 v1.0 | `docs/07-项目管理/任务说明书/任务说明书-REQ-集成-002-分配模式Tab收编.md` | §3.1.3 |
| 6 | 本总览文件 | `docs/00-版本迭代总览.md`（本文件）| §5.1 引用关系 |
| 7 | 规范升级 v1.11 → v1.12 | `docs/00-产品开发流程与文档管理规范.md` + `~/.workbuddy/skills/product-doc-standard/references/spec.md` | §十一 文档整理实践 |

#### 关键决策与教训

1. **Tab 合并 vs 轻合并 vs 保持现状**：本次选 Tab 合并。理由：阶段一收编 + 未来膨胀可拆回 + 不欠技术债
2. **多路径代码同步铁律**：ASCII 路径 `D:\dev\wecom\` 与中文路径 `D:\资料\03-项目开发\wecom_it_smart_desk\` 必须双改，否则 build 用旧代码
3. **6 张模式卡片迁移完整性**：用 grep 字符串字面量（`agents-assignment` / `agents-list` / `手动接单` / `轮询分配` / `技能匹配分配`）验证产物，不依赖变量名（minify 后变量名消失）
4. **回滚预案**：在技术方案 §3.3 + 任务说明书 §风险与回滚 + 规范（下次）中记录 30 分钟内可逆撤销步骤（恢复路由 + 菜单项 + 搬回内容）
5. **测试基础设施限制**：admin 后台需企业微信扫码登录，无法用 agent-browser 自动 E2E；通过"编译产物验证 + chunk 内容 grep"双证据链证明改造正确性

#### 规范升级（沉淀到 §14）

本次经验沉淀进规范文档新增章节：
- "前端模块收编/拆分流程"（规范 §14，pre-v1.12 新增）
- "页面级独立 ↔ Tab 内嵌决策矩阵"
- "可逆撤销步骤记录要求"