From 2c7625c3e4a72320c22ce2f65c9b7a1b7e1f6ee8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=B5=85=E5=BF=B5?= Date: Thu, 10 Sep 2026 12:44:38 +0800 Subject: [PATCH] =?UTF-8?q?docs(management):=20=E6=89=B9=E6=AC=A1D?= =?UTF-8?q?=E5=85=A8=E9=93=BE=E8=B7=AF=E8=B5=B0=E6=9F=A5+=E9=AA=8C?= =?UTF-8?q?=E6=94=B6=E8=AE=B0=E5=BD=95=E2=80=94=E2=80=94=E7=AE=A1=E7=90=86?= =?UTF-8?q?=E8=80=85=E5=8A=A8=E7=BA=BF=E4=B8=83=E6=AD=A5/=E6=B8=85?= =?UTF-8?q?=E5=8D=95=E9=80=90=E9=A1=B9/=E9=97=A8=E7=A6=81=E5=85=A8?= =?UTF-8?q?=E7=BB=BF?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Code --- ...6-09-08-management-batch-a-verification.md | 69 +++++++++++++++++++ .../src/components/management/AnomalyList.vue | 2 +- 2 files changed, 70 insertions(+), 1 deletion(-) diff --git a/docs/superpowers/plans/2026-09-08-management-batch-a-verification.md b/docs/superpowers/plans/2026-09-08-management-batch-a-verification.md index 3d76f5a..b79bc1f 100644 --- a/docs/superpowers/plans/2026-09-08-management-batch-a-verification.md +++ b/docs/superpowers/plans/2026-09-08-management-batch-a-verification.md @@ -303,3 +303,72 @@ action_counts 内部：`unreplied(hours=2)` **2.38s**；`churn(real,30d)` 0.12s | 1 | call_band 样本基数：band 类指标样本量取 active_friends（规格字面），WA 通话量上来后"通话多客户少"员工会被误标 insufficient——当前数据零影响（实测 calls≥1 且 af<10 仅 5 人且 calls≤5，怎么选都不足）；归批次F回测前一行修正（sample_basis 字段或按源指标取样本） | | 2 | 配置源名唯一性：两个 code 指向同一源指标会使 employees comparisons 键静默覆盖——已在 validate_config 加源名唯一校验+测试（批次B终评闭环），默认配置六个源名互异不受影响 | | 3 | dashboard 性能（2.2~2.9s，unreplied channel=None 无前缀索引）与 fr_ms 天级极值 winsorize：见上文 §2/§3，决策归批次F | + +--- + +# 批次D走查与验收（Task D4，2026-09-10） + +批次D收尾：员工总览（b72e957）+ 员工详情（5776175）+ 驾驶舱环比/异常跳员工闭环（422a726，前置接口/时间预设 ddeda3f）。Playwright 真机七步全链路走查 + v1 §19.1 员工子集与批次D验收清单逐项核对。环境：后端 uvicorn 8000（免鉴权）+ 前端 vite dev 5173，视口 **1366px**。 + +## 0. 四门禁（全绿） + +| 门禁 | 结果 | +|---|---| +| 后端 `pytest tests/ -q` | **723 passed** in 65.29s | +| 前端 `npm run build` | ✓ built in 1.03s（exit 0） | +| 前端 `npm run test`（vitest） | Test Files 2 passed / **Tests 23 passed** | + +## 1. 七步动线走查记录（数字为真机实测，关键值已对 API 复核） + +**① 驾驶舱默认近30天（20260812~20260910）**：三 KPI 卡环比箭头 ✓（客户端自 prev_kpis 按 (cur-prev)/prev 计算，API 复核数值吻合）——全渠道：活跃客户 **1,992人 ↓12.6%**（prev 2,278）/ 活跃员工 **40人 →0.0%**（40/40）/ 消息量 **37,742条 ↓21.0%**（prev 47,749）；切微信：**979人 ↓25.3% / 40人 ↑2.6% / 27,949条 ↓29.6%**。方向与量级合理（等长紧邻前窗）。 + +**② 异常卡员工名 → 员工详情**：点微信异常榜员工名链接（落点须为 a.el-link；整行点击触发行下钻抽屉，属预期交互）→ 落地 `/management/employees/18B5EE6B1AD94B15A5CD1CDABCECAB96?channel=wechat&start=…&end=…`（驾驶舱当前筛选 query 随行 ✓）。 + +**③ 员工详情（朱晨曦，综合 21/E）**：五维条 **3 实 + 2 待数据**——合规风险/行动执行 pending 灰条占位，服务质量 0 分/客户经营 0 分/有效负载 100 分（API dimensions 逐项一致；行序随接口返回序，见遗留①）。四对比表（当前/上期/基线/中位）✓（cust_threads 62/114/107+中位）。服务质量页签双折线渲染（canvas 1074×300）→「查看超时明细」→ 首响P90 抽屉 **Total 11** → 点行进聊天：**17 条消息**，时间线与所点明细行吻合（客户 08-31 11:59:12 → 回复 17:24:11 ≈ 5小时24分）。 + +**④ 客户经营页签**：返回列表再进 → section=customer →「沉睡客户名单」抽屉 **Total 89** ✓。 + +**⑤ 员工总览对比**：勾选 2 人 → 对比抽屉并列两列指标 ✓（2-5 人为按钮启用门槛），关闭复原。 + +**⑥ 排序+翻页+CSV（微信渠道）**：综合分降序（服务端 sort）——第 1 页 **55→21**（林峰 55 领头），第 2 页 **11 / 1 / 其余「--」**（18 人 insufficient_sample **空值排尾** ✓）。导出 CSV：**3 行口径前言**（口径/窗口+渠道/试算版本）**+ 表头 + 41 行数据**，toast「已导出 41 条」。 + +**⑦ 控制台与持久化**：走查全程 console **0 errors**；修复遗留告警后（见 §3）全新加载 **0 warnings**。刷新保持 ✓——列表 view=service 刷新还原（Total 41）、详情返回后 section=service 还原。 + +**附**：9 档时间预设逐一真机核验：今日 0910~0910 / 昨日 0909 / 近7 0904~0910 / 近30 0812~0910 / 本周 0907~0910（周一周首 ✓）/ 上周 0831~0906 / 本月 0901~0910 / 上月 0801~0831 / 自定义 0901~0907。1366px 驾驶舱与员工总览双页截图目检：KPI 3×2 网阵、双趋势图、表格列均无塌陷/无横向溢出。 + +## 2. 验收清单核对 + +**v1 §19.1 员工子集（6 项）** + +| # | 项 | 状态 | 依据 | +|---|---|---|---| +| 1 | 能查看所有员工多维状态 | ✅ | total=41（API=列表=CSV 行数三方一致）；四视图（管理概览/工作负载/服务质量/客户经营）切换正常 | +| 2 | 任一分数可展开为指标/公式/样本/事实 | ✅ | 表头「?」→ 指标口径抽屉（19 项定义+公式+样本）；行/详情下钻按钮 → 事实明细 → 聊天原文（§1 ③） | +| 3 | 四对比 | ✅ | 详情四对比表逐列可见（§1 ③：62/114/107/中位） | +| 4 | 样本不足不评分 | ✅ | 18 人 insufficient_sample 综合分显「--」（§1 ⑥），CSV 同口径 | +| 5 | 异常两次点击进事实 | ✅ | 异常卡员工名（第1击）→ 详情下钻按钮（第2击）→ 事实明细/聊天 | +| 6 | 默认排序非总分/消息量榜 | ✅ | 默认 sort_by=anomaly_severity（异常严重度优先） | + +**批次D验收清单（5 项）** + +| # | 项 | 状态 | 依据 | +|---|---|---|---| +| 1 | 员工总览：41 人四视图/服务端排序分页/keyword/对比 2-5 人/CSV 含口径注释 | ✅ | §1 ⑤⑥；CSV 前言 3 行 | +| 2 | 员工详情：五维条 3+2 占位/五页签懒加载/四对比/评分明细可展开/下钻进抽屉/账号跳聊天 | ✅ | §1 ③④；页签懒加载+loaded 缓存+section URL 还原 | +| 3 | 驾驶舱：三 KPI 环比箭头/异常卡可跳员工详情 | ✅ | §1 ①②（闭环打通） | +| 4 | 时间预设全套 9 档 | ✅ | §1 附 | +| 5 | URL 全参数保持；四门禁绿；后端仅 dashboard 一处小改且测试补齐 | ✅ | §1 ⑦ + §0；后端改动=dashboard prev_kpis（D3，随测试提交） | + +## 3. 走查发现并修复（随本任务提交） + +| 问题 | 修复 | +|---|---| +| `AnomalyList.vue` 员工链接 `:underline="false"` 触发 Element Plus 废弃 API 告警——驾驶舱每次加载刷 **31 条** `[el-link] underline boolean deprecated`（异常榜每行一条） | 改 `underline="never"`（string API）；修复后全新加载 0 errors 0 warnings | + +## 4. 遗留观察项（不阻塞） + +| # | 项 | 归档 | +|---|---|---| +| 1 | 五维条行序随接口返回序 | 合规风险/行动执行（待数据）排在三实维之前——非固定语义序；批次E 接线 risk/action 后自然消解，如需固定序前端按 dim 顺序数组排即可 | +| 2 | 走查任务字面 Step6 措辞偏差 | 「切视图服务质量→点综合分列排序」按字面不可执行（综合分列仅管理概览视图有）；实际动线=管理概览排序→切服务质量视图导出，已按实际动线完成走查 | +| 3 | 空值显示 `-` 与 `--` 混用 | format.ts 的 formatMsDuration/formatRatio 按各自注释约定 null 显 `-`，员工总览本地数值/比率格式化显 `--`——同表跨列观感不一；纯观感项，批次E 顺手统一即可 | diff --git a/yunkes/src/components/management/AnomalyList.vue b/yunkes/src/components/management/AnomalyList.vue index bdb01d7..dbfcdfa 100644 --- a/yunkes/src/components/management/AnomalyList.vue +++ b/yunkes/src/components/management/AnomalyList.vue @@ -17,7 +17,7 @@
{{ row.employee_name || row.employee_user_id.slice(0, 8) }}