Files

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

7.9 KiB

Raw Blame History

任务说明书 — 管理后台分配模式 Tab 收编

版本: v1.0 | 日期: 2026-07-28 状态: 待执行

📋 基本信息

项目	内容
任务名称	管理后台分配模式 Tab 收编（v1.2）
关联需求编号	REQ-集成-002-v1.2
优先级	🟡 P2
类型	UI 改造（页面结构）
状态	待执行
负责人	待指派
创建日期	2026-07-28
预计完成日期	2026-07-29
涉及端	仅前端（管理后台 frontend-admin）

📥 输入项来源

产品需求

来源文档	相关章节	说明
`docs/01-产品文档/08-集成生态/PRD-REQ-集成-002-管理后台-v1.0.md`	§5.1 页面树 / §5.2 导航分组 / §5.3 页面映射 / §9.2 占位表 / §12 变更日志（v1.2）	v1.2 已完成 PRD 改造，删除「分配模式」菜单项与独立页，合并入坐席管理 Tab
同上 §12 v1.2 关键变更说明	—	决策依据、影响范围已记录

技术方案

来源文档	相关章节	说明
`docs/02-技术文档/技术方案-REQ-集成-002-管理后台v1.2-分配模式Tab收编.md`	§3 前端改造详细设计	本任务的核心实施依据

原型设计

来源文档	相关章节	说明
`docs/01-产品文档/08-集成生态/原型-REQ-集成-000-管理后台-v1.0.html`	坐席管理页（`#page-agents`）	Tab 1 坐席列表 / Tab 2 分配策略（含 6 模式卡片）

需了解的现有代码

模块/文件	说明	需了解的内容
`src/frontend-admin/src/views/Agents.vue`	坐席管理页（改造目标）	现有 `<AgentTable>` 引用、3 个 `el-dialog`（编辑/添加/重置密码）、`agentStore` 用法、`skillTagOptions`、`statusTabs`
`src/frontend-admin/src/views/AssignmentMode.vue`	旧分配模式页（迁移来源）	`modes` 数组、`currentMode`、`selectMode` 函数、`getModeDescription`/`getLockReason`、`getAssignmentMode`/`apiUpdateMode` 调用
`src/frontend-admin/src/router/index.ts`	路由表（删路由项）	现有 `/admin/assignment-mode` 路由配置位置
`src/frontend-admin/src/api/admin.ts`	API 封装（不动）	`getAssignmentMode`/`updateAssignmentMode` 已有导出
`src/frontend-admin/src/types/index.ts`	类型定义（不动）	`AssignmentMode` 类型、`SKILL_TAGS` 常量
`src/frontend-admin/src/stores/agent.ts`	坐席 Store（提供人数）	`loadAgents` 方法、`agents` 列表

📤 输出成果要求

交付物清单

#	交付物	类型	说明
1	`src/frontend-admin/src/views/Agents.vue`	代码（修改）	顶层加 `<el-tabs v-model="activeTab">`，原内容迁入 Tab 1，新增 Tab 2「分配策略」
2	`src/frontend-admin/src/views/AssignmentMode.vue`	代码（保留+注释）	文件保留，顶部加注释「v1.2 起停用，仅供未来回滚」
3	`src/frontend-admin/src/router/index.ts`	代码（修改）	删除 `/admin/assignment-mode` 路由项
4	`docs/03-测试文档/03-功能测试用例/TC-集成-002-分配模式Tab收编.md`	测试用例（新建，可选）	Tab 切换 + 6 卡片渲染 + 锁定态 + API 兼容（按技术方案 §6 验证清单编写）

验收要点

菜单项消失：左侧导航「知识与 AI」组无「分配模式」入口，原型图与代码保持一致。
Tab 切换正常：默认进 Tab 1（坐席列表），点 Tab 2 显示 6 张模式卡片。
6 卡片完整：「手动接单」高亮 + 「当前启用」tag；其余 5 张 opacity:0.5 + 锁图标 + 解锁条件文案。
引导条准确：Tab 2 顶部显示当前坐席人数（取自 agentStore.agents.length）。
API 兼容：浏览器 Network 面板中 GET /admin/assignment-mode 返回 200。
构建通过：npm run build 无 TS 报错、无 lint 报错。
现有功能回归：坐席列表的添加/编辑/删除/OTP 解绑/密码重置全部不受影响。

🔧 验证方式

类型	方式
路由层	浏览器地址栏访问 `/admin/assignment-mode` → 404 或重定向到 `/admin/agents`；访问 `/admin/agents` 正常显示
UI 层	浏览器（Chrome DevTools 深色主题）打开 `/admin/agents`，目视确认 Tab 切换 + 6 卡片渲染 + 锁定态
API 层	浏览器 Network 面板 / `curl -H 'X-Forwarded-For: 10.240.1.100' http://10.90.5.110:8000/admin/assignment-mode` 返回 200 + 期望 JSON
回归	坐席管理原有功能（添加/编辑/删除/OTP/密码重置）逐一手动验证一次
构建	`npm run build` 成功 + `dist/assets/*.css` 的 hash 变化（确认源码改了，不是缓存）
部署	`Compress-Archive` + `v2_ops.py upload` + 服务器解压 + `docker restart wecom_it_nginx`（按 SOP）

✅ 完成标准

路由表删除 /admin/assignment-mode
Agents.vue 加 <el-tabs> + Tab 2「分配策略」可切换
6 张模式卡片全部渲染，「手动接单」高亮
Tab 2 顶部引导条显示当前坐席人数
坐席管理原有 CRUD/OTP/密码重置功能 100% 不受影响
AssignmentMode.vue 文件保留，顶部加"v1.2 起停用"注释
npm run build 通过
后端 API（GET/PUT /api/admin/assignment-mode）200 OK，无回归
（可选）TC-集成-002 测试用例已编写
（可选）部署到生产并通过 agent-browser 端到端验证

📝 实施步骤建议

步骤	操作	预计耗时
1	本地读取 `Agents.vue` 与 `AssignmentMode.vue`，画好迁移映射	5 min
2	`Agents.vue` 顶层套 `<el-tabs>`，原内容迁入 Tab 1	15 min
3	Tab 2 复制 `AssignmentMode.vue` 模板与脚本（含 `modes`、`currentMode`、`selectMode`、`getModeDescription`、`getLockReason`）	15 min
4	Tab 2 顶部加引导条，绑 `agentStore.agents.length`	5 min
5	`router/index.ts` 删除 `/admin/assignment-mode` 路由项	2 min
6	`AssignmentMode.vue` 顶部加"v1.2 起停用"注释	2 min
7	`npm run build` 验证编译	5 min
8	多路径同步铁律：ASCII 路径 `D:\dev\wecom\src\frontend-admin\` 也需同步修改（防止构建用的是旧代码）	—
9	本地浏览器手动验证（地址栏 + Tab 切换 + 6 卡片）	10 min
10	按部署 SOP 上线（`v2_ops.py upload` + 服务器解压 + nginx restart）	15 min
11	（可选）curl 验证 API 200 + agent-browser 端到端截图	5 min
合计		约 80 min

⚠️ 风险与回滚

风险	应对
中文路径下 `pnpm install` 卡死	用 ASCII 路径 `D:\dev\wecom` 构建（项目铁律）
多路径代码不同步导致部署无效	build 后查 `dist/assets/*.css` 的 hash 变化确认
Tab 2 数据二次请求浪费	用 `watch(activeTab)` 懒加载，或一次性 `onMounted` 加载
旧菜单链接残留 404	PRD §12 已标注 v1.2 起不再独立；通知相关文档/聊天链接失效
阶段二/三分配模式膨胀需拆回	技术方案 §3.3 已记录回滚步骤（约 30 min）

📚 关联文档

文档	路径
PRD	`docs/01-产品文档/08-集成生态/PRD-REQ-集成-002-管理后台-v1.0.md`
原型图	`docs/01-产品文档/08-集成生态/原型-REQ-集成-000-管理后台-v1.0.html`
技术方案	`docs/02-技术文档/技术方案-REQ-集成-002-管理后台v1.2-分配模式Tab收编.md`
部署 SOP	`docs/04-运维文档/部署运维/DEPLOY-GUIDE.md`
项目铁律	`~/.workbuddy/MEMORY.md`（多路径代码同步铁律）

📝 变更日志

版本	日期	变更	变更人
v1.0	2026-07-28	初版（配套 PRD v1.2 + 技术方案）	宋献

7.9 KiB Raw Blame History Unescape Escape

任务说明书 — 管理后台分配模式 Tab 收编

📋 基本信息

📥 输入项来源

产品需求

技术方案

原型设计

需了解的现有代码

📤 输出成果要求

交付物清单

验收要点

🔧 验证方式

✅ 完成标准

📝 实施步骤建议

⚠️ 风险与回滚

📚 关联文档

📝 变更日志

7.9 KiB

Raw Blame History