simon/wecom_it_smart_desk
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
5f439e8384da87cc8faee42740230e94962f8cf5
wecom_it_smart_desk/docs/00-版本迭代总览.md
T
Simon facc04aa65 chore: docs 结构整改 + compose 双目录对齐（合并重建提交） 
本提交为 .git 对象库损坏后的重建提交，内容等价于原先三个本地提交
（5e2fd4c2 / 57a53c98 / 5d7e1873）的累积结果，未做任何额外改动。

一、docs 结构整改（整改 #14）
根因：重构时新结构为 untracked 文件，执行 git stash（未带 -u）未纳入，
随后 git reset 拉回 HEAD 旧 tracked 树，导致旧树复活、新旧两棵目录
树并存于 docs/，共 791 文件、双分类体系冲突。

修复动作：
- b2 同名异主题文件改名迁移保全 9 个
- C 类 39 个孤立文件按主题正确归类
- A/B1 类 222 个重复文件删除（新结构已有内容副本）
- 9 个旧独有空目录删除
- 270 处内部引用按 verified 映射改写
- 整改记录 #14 登记于 04-运维文档/部署运维

结果：docs 791 → 569 文件，顶层仅规范 8 类 + 治理文件，单树恢复。
残留：约 20 处指向从未存在文件的陈旧死链，归入独立文档卫生任务。

二、compose 双目录对齐（消除踩坑 A）
- docker-compose.yml：nginx 前端挂载全部由根目录 frontend-*/dist
  改为 src/frontend-*/dist（h5 / agent / admin / terminal）
- docker-compose.dev.yml：dev 服务 build context 与卷同步改 src/
- 效果：本地 docker compose up 不再把根目录 stale dist 挂回，
  与线上一致，分叉隐患消除（已 docker compose config 校验通过）

防复发铁律：
- 重构须提交；仓库修复须 git stash -u 或先 commit
- 新结构须 git add 并提交，避免再次 untracked 复活
- H5 改动只动 src/frontend-h5/，禁改根目录遗留 frontend-*/
2026-08-07 22:31:32 +08:00

8.4 KiB
Raw Blame History

版本迭代总览

本文件为 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 内嵌决策矩阵"
  • "可逆撤销步骤记录要求"
Reference in New Issue View Git Blame Copy Permalink