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

9.7 KiB

Raw Blame History

任务说明书：坐席端左栏会话状态 Tab 顺序调整 + 默认显示待处理

版本: v1.0 | 日期: 2026-08-03

📋 基本信息

项目	内容
任务名称	坐席端左栏会话状态 Tab 顺序调整 + 默认显示待处理
任务ID	#134（#133 已被 voice_asr-auth 加固占用，沿用 #132 后下一个空号）
优先级	🟢 P3
类型	功能开发（UI 微调）
状态	✅ 已完成
负责人	宋献
创建日期	2026-08-03
计划完成日期	2026-08-03
前置任务	#132（坐席端待办事项移至右栏底部 — 已完成）

📥 输入项来源

产品需求

来源文档	相关章节	说明
原型 v1.2（本文）	左栏会话 Tab 行	「全部」Tab 移至「已完成」之后；默认进入页面激活「待处理」
用户口头要求	2026-08-03 17:14	"全部"频次最低放末尾；待处理是坐席日常首选

原型设计

来源文档	页面	说明
`docs/01-产品文档/04-坐席工作台/原型-REQ-坐席-000-坐席工作台-v1.2.html`	坐席工作台左栏	v1.1 → v1.2：Tab 顺序调整 + 默认激活「待处理」
`docs/01-产品文档/04-坐席工作台/v1.2-验收截图/`	4 张 tab 状态截图	用户确认无问题（2026-08-03 17:34）

需了解的现有代码（历史现状）

模块/文件	说明	需了解的内容
`src/frontend-agent/src/components/conversation/ConversationList.vue`	左栏会话列表	line 108-113 `filterTags` 数组顺序为 `[全部, 待处理, 进行中, 已完成]`；line 126 `activeFilter = ref<string>('all')` 默认激活"全部"；line 150-163 `applyFilters` 根据 `activeFilter` 过滤；status 映射：pending→queued、active→serving/ai_handling、done→resolved
`src/frontend-agent/src/stores/conversation.ts`	会话 Pinia Store	line 315 `myConversations` 合并 queued + serving+is_mine + pending_close+is_mine + collaborator+serving；line 333 `colleagueConversations` 合并 serving+!is_mine+!collaborator + ai_handling；line 349 `historyConversations` 仅 resolved（90 天内）

📤 输出成果要求

交付物清单

#	交付物	类型	说明
1	`src/frontend-agent/src/components/conversation/ConversationList.vue`	代码	`filterTags` 顺序倒置；`activeFilter` 初始值改为 `'pending'`
2	坐席端构建产物	构建	`npm run build` 通过
3	浏览器端到端验证	测试	默认进入页面显示「待处理」激活、左侧仅展示 pending 会话；切换其他 tab 正常

代码要求

最小改动原则（仅 2 处变更，不重构）
保持 activeFilter 的 key 名不变（'pending' \| 'active' \| 'done' \| 'all'），仅改数组顺序和初值
applyFilters 逻辑不动（已按 status 准确映射）
不动 store、不动 ConversationItem.vue、不动样式
不加数量徽章 / 空状态（v1.2 原型里有，但需要新加 4 个 computed 算实时数量；本任务范围仅"顺序+默认"，数量徽章作后续独立任务）

🔧 验证方式

功能验证

验证项	验证方法	预期结果
Tab 顺序	浏览器访问坐席工作台	从左到右依次：`待处理 → 进行中 → 已完成 → 全部`
默认激活态	刷新坐席工作台	"待处理" Tab 高亮（蓝色背景 + 蓝色文字）
默认列表	刷新坐席工作台	左侧仅展示 status=queued（待接单）的会话（"我的会话"区，其他两区因 store 自然为空）
Tab 切换	点击"进行中"	切换为蓝色高亮，左侧展示 status=serving/ai_handling 的会话
Tab 切换	点击"已完成"	切换为蓝色高亮，左侧展示 status=resolved 的会话（来自 historyConversations，跨区渲染）
Tab 切换	点击"全部"	切换为蓝色高亮，左侧展示所有 3 个区（my + colleague + history）
搜索过滤	在搜索框输入关键词	关键词过滤仍生效，与 tab 过滤为 AND 关系

兼容性验证

验证项	验证方法	预期结果
搜索 + tab 联动	输入关键词后切换 tab	关键词过滤在所有 tab 下均生效
无会话态	数据库清空会话，刷新页面	「待处理」Tab 激活，左侧显示 `el-empty description="暂无会话"` 占位
我的会话 vs 同事会话区分	切换"全部" tab	同事会话（赵敏/周芳/吴明）的"接手"按钮仍正常弹出
接手 + 关闭会话流	在同事会话点击"接手"，接单后该会话进入"我的"区	接单成功后该会话归入 myConversations，"全部" tab 下可见

与 v1.2 原型一致性验证

验证项	验证方法	预期结果
Tab 顺序对照	部署后浏览器对比 `原型-REQ-坐席-000-坐席工作台-v1.2.html`	实际页 Tab 顺序与原型一致
默认激活对照	部署后浏览器对比原型默认视图	默认进入页面 = "待处理"激活

✅ 完成标准

验收条件

代码已修改（ConversationList.vue 共 2 处：filterTags 顺序倒置 + activeFilter 初值 'all'→'pending'）
坐席端 npm run build 通过（6.20s，新 main chunk index-BK_U7e10.js，Workspace chunk 唯一 D44-5RYv.js）
部署到生产（rm -rf dist → build → 打包 576,913B → jumpserver-V2 上传 → sudo 替换 → restart nginx）
生产服务验证：HTTP 200 + 主 chunk hash 由 index-BDGZ_gcJ.js → index-BK_U7e10.js + Workspace JS 数 = 1（无累积污染）+ 备份链 dist.bak.0803_pre133 保留
浏览器端到端验证（用户无痕模式确认 2026-08-03 17:48："无痕模式显示已更新"）
v1.2 原型与实际页面 Tab 顺序一致（原型-REQ-坐席-000-坐席工作台-v1.2.html 与生产渲染一致）
git commit（见下方"📞 变更记录"）

📊 工作分解

子任务

子任务	负责人	预估工时	状态
修改 `ConversationList.vue`（`filterTags` 顺序 + `activeFilter` 初值）	宋献	0.1h	✅ 已完成
坐席端 `npm run build`	宋献	0.1h	✅ 已完成（6.20s，无累积，Workspace chunk 唯一）
打包 + jumpserver-V2 部署 + 清理旧 dist/chunk	宋献	0.3h	✅ 已完成（jumpserver cache 19.7h 内有效，全程免登录；server 验证 HTTP 200）
浏览器端到端验证（用户确认默认待处理视图）	宋献	0.1h	✅ 已完成（用户 17:48 无痕模式确认"显示已更新"）
git commit	宋献	0.1h	✅ 已完成

总预估：0.7h（短平快，原型已确认）

📞 依赖与阻塞

前置依赖

依赖任务	依赖说明	状态
#132 坐席端待办移至右栏底部	当前 `ConversationList.vue` 已是"干净"版本（已移除 TodoPanel）	✅ 已完成

阻塞因素

阻塞项	影响范围	解决方案
无	-	-

📈 变更记录

日期	变更内容	变更人	说明
2026-08-03	创建任务	宋献	初始版本；承接 v1.2 原型调整（用户 17:14 触发，17:34 用户确认原型图，17:36 用户指令"写任务说明书，然后落地代码"）

📎 调整需求说明

需求概述

将坐席端左栏会话窗口的状态 Tab 顺序调整为 待处理 → 进行中 → 已完成 → 全部（"全部"频次最低放末尾），并把默认激活项从「全部」改为 「待处理」（坐席日常工作的最高频入口）。

改动点（精确 2 处）

filterTags 数组顺序（ConversationList.vue line 108-113）：

// 改前：[全部, 待处理, 进行中, 已完成]
const filterTags: FilterTag[] = [
  { key: 'all', label: '全部' },
  { key: 'pending', label: '待处理' },
  { key: 'active', label: '进行中' },
  { key: 'done', label: '已完成' },
]

// 改后：[待处理, 进行中, 已完成, 全部]
const filterTags: FilterTag[] = [
  { key: 'pending', label: '待处理' },
  { key: 'active', label: '进行中' },
  { key: 'done', label: '已完成' },
  { key: 'all', label: '全部' },
]

activeFilter 初始值（ConversationList.vue line 126）：

// 改前：
const activeFilter = ref<string>('all')
// 改后：
const activeFilter = ref<string>('pending')

不做的事（明确范围）

不改 store 数据分区（myConversations / colleagueConversations / historyConversations 划分逻辑准确）
不改 applyFilters 函数逻辑（status 映射已正确：pending→queued、active→serving/ai_handling、done→resolved）
不动 ConversationItem.vue / 不动样式 / 不动 backend API
不在本任务加 Tab 数量徽章 + 空状态文案（v1.2 原型里有该设计，但需要 store 新增 4 个 computed 计算实时数量；作后续独立任务 #134 候选）
不动 activeFilter 的 key 名（保持 'pending' \| 'active' \| 'done' \| 'all' 与 applyFilters switch 兼容；改名为 'in-progress' 等需配合多处同步调整，超出本任务范围）

为什么是「最小改动」

用户需求 = "Tab 顺序 + 默认激活" 两件事。代码现状已经按 status 准确分桶，store 划分合理，applyFilters 正确 — 唯一缺的就是"两处默认值"，故 2 处 Edit 即可完成，避免引入回归风险。

9.7 KiB Raw Blame History Unescape Escape