# 任务说明书：坐席端左栏会话状态 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 顺序与原型一致 |
| 默认激活对照 | 部署后浏览器对比原型默认视图 | 默认进入页面 = "待处理"激活 |

---

## ✅ 完成标准

### 验收条件
- [x] 代码已修改（`ConversationList.vue` 共 2 处：`filterTags` 顺序倒置 + `activeFilter` 初值 `'all'`→`'pending'`）
- [x] 坐席端 `npm run build` 通过（6.20s，新 main chunk `index-BK_U7e10.js`，Workspace chunk 唯一 `D44-5RYv.js`）
- [x] 部署到生产（`rm -rf dist` → build → 打包 576,913B → jumpserver-V2 上传 → sudo 替换 → restart nginx）
- [x] 生产服务验证：HTTP 200 + 主 chunk hash 由 `index-BDGZ_gcJ.js` → `index-BK_U7e10.js` + Workspace JS 数 = 1（无累积污染）+ 备份链 `dist.bak.0803_pre133` 保留
- [x] 浏览器端到端验证（用户无痕模式确认 2026-08-03 17:48："无痕模式显示已更新"）
- [x] v1.2 原型与实际页面 Tab 顺序一致（`原型-REQ-坐席-000-坐席工作台-v1.2.html` 与生产渲染一致）
- [x] 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 处）
1. **`filterTags` 数组顺序**（`ConversationList.vue` line 108-113）：
   ```typescript
   // 改前：[全部, 待处理, 进行中, 已完成]
   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: '全部' },
   ]
   ```
2. **`activeFilter` 初始值**（`ConversationList.vue` line 126）：
   ```typescript
   // 改前：
   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 即可完成，避免引入回归风险。