docs(management): 批次B真机冒烟——六端点耗时/回测员工抽查/记录
Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
浅念
@@ -241,3 +241,57 @@
|
|||||||
| 9 | 全量测试套件绿 | ✅ | **653 passed in 62s**（Task 8 本机实跑，2026-09-09） |
|
| 9 | 全量测试套件绿 | ✅ | **653 passed in 62s**（Task 8 本机实跑，2026-09-09） |
|
||||||
| 10 | 核实文档完整 | ✅ | 本文补齐 |
|
| 10 | 核实文档完整 | ✅ | 本文补齐 |
|
||||||
| 11 | 写钩子零改动 | ✅ | 批次A全部 17 个 commits（27f91e5→0fce21a）逐一核查，无一触碰 storage/summary.py、storage/repos.py（repos.py 最近一次改动 d428953 属 customer_account_link 工作线，先于批次A） |
|
| 11 | 写钩子零改动 | ✅ | 批次A全部 17 个 commits（27f91e5→0fce21a）逐一核查，无一触碰 storage/summary.py、storage/repos.py（repos.py 最近一次改动 d428953 属 customer_account_link 工作线，先于批次A） |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
# 批次B冒烟（Task B5，2026-09-09）
|
||||||
|
|
||||||
|
经营管理后台六端点真机冒烟 + 性能初测。回测员工王云青 `369D257EEC9A4357935FDE19DDD99CAA`（#1 高负载+群运营），窗口 30 天 `20260810~20260908`。
|
||||||
|
|
||||||
|
## 0. 环境与启动方式
|
||||||
|
|
||||||
|
- **基线**：`pytest tests/ -q` → **721 passed in 60.9s**（批次B收尾后全绿）。
|
||||||
|
- **后端启动**：docker 无 `yunke-backend/frontend-1` 容器；冒烟前 8000 端口空闲（连接拒绝，无常驻进程）。本任务自起：`yunke-server/.venv/Scripts/python.exe -m uvicorn app.api.main:app --port 8000`（无 `--reload`），`GET /api/health` → `{"status":"ok"}`；`openapi.json` 含 management 路由（grep 命中）确认新代码已加载。
|
||||||
|
- **鉴权模式**：`.env` 中 `API_TOKEN=`（空值）→ 鉴权中间件 no-op，**免鉴权直接 curl**（无 Authorization 头）。
|
||||||
|
- **进程处置**：uvicorn 留跑供用户查看，Git Bash PID **2423**（`kill 2423` 关闭；或任务管理器结束对应 python.exe）。
|
||||||
|
|
||||||
|
## 1. 六端点结果（HTTP 码 × 耗时 × 大小）
|
||||||
|
|
||||||
|
首次访问含冷启动（连接池/查询编译/InnoDB 冷缓存），dashboard 另测暖态三次：
|
||||||
|
|
||||||
|
| 端点 | HTTP | 首次耗时 | 暖态耗时 | 大小 | 判定 |
|
||||||
|
|---|---|---|---|---|---|
|
||||||
|
| `/api/management/dashboard` | 200 | 12.03s | **2.92 / 2.39 / 2.18s** | 22,309B | ⚠️ 超 1.5s 目标（慢段定位见 §2） |
|
||||||
|
| `/api/management/employees?page_size=50` | 200 | 0.34s | 0.30 / 0.31s | 58,865B | ✅ ≤1.5s |
|
||||||
|
| `/api/management/employees/{王云青}` | 200 | 0.40s | — | 4,739B | ✅ |
|
||||||
|
| `…/metrics?section=service` | 200 | 0.40s | — | 4,655B | ✅ |
|
||||||
|
| `…/drilldown?metric_code=first_reply_p90` | 200 | 0.016s | — | 5,268B | ✅ |
|
||||||
|
| `/api/management/metric-definitions` | 200 | 0.005s | — | 4,081B | ✅ |
|
||||||
|
|
||||||
|
## 2. dashboard 慢段定位（分段实测，不做优化——决策归批次F）
|
||||||
|
|
||||||
|
用 app 同一 session 复放 dashboard 组装流水线逐段计时（合计 2.685s ≈ 暖态端点耗时）：
|
||||||
|
|
||||||
|
| 段 | 耗时 |
|
||||||
|
|---|---|
|
||||||
|
| load_score_config | 0.044s |
|
||||||
|
| assemble_employees（评分+异常，2 窗聚合） | 0.262s |
|
||||||
|
| wide_daily_rows / call_daily_rows | 0.007s / 0.002s |
|
||||||
|
| service_daily_trend | 0.032s |
|
||||||
|
| data_as_of | 0.009s |
|
||||||
|
| **action_counts（unreplied+churn+sensitive）** | **2.328s** |
|
||||||
|
|
||||||
|
action_counts 内部：`unreplied(hours=2)` **2.38s**；`churn(real,30d)` 0.12s；sensitive count 0.005s。unreplied 再拆：候选窗口函数查询（row_number over 67,116 行 friend 分区 → 3,123 候选）仅 **0.10~0.16s**；>500 候选走「仅本页决赛圈」分支无 N+1，但**单条尾部消息点查耗时 1.7~1.9s**。EXPLAIN 实证：`channel=None`（全平台）时无法使用 channel 打头的全部索引（`ix_message_channel_owner_talker_time(channel,owner,talker,timestamp)` 等），优化器退化到 `ix_message_room`（`room_id IS NULL/''`）→ **扫 378,202 行 + filesort**（message 表 96.4 万行）。
|
||||||
|
|
||||||
|
优化方向（供批次F选择）：① 查询改写按渠道 UNION/`channel IN (…)` 绑定前缀走现有索引；② 补 `(owner_account_id, talker_id, timestamp)` 无 channel 前缀索引；③ dashboard 对 action_counts 做短 TTL 缓存。除 unreplied 外全链路 <0.5s，达标无压力。
|
||||||
|
|
||||||
|
## 3. 合理性抽查
|
||||||
|
|
||||||
|
- **employees 列表**：`total=41`/rows=41（=本文① staff 总数 ✓）。**王云青行与宽表 SQL 聚合逐字段全等**：msg_sent=111 / msg_recv=1003 / cust_threads=89 / threads_answered=57 / fr_sum_ms=698,140,844、days_with_data=29。数量级说明：「千级」预期对应全期全口径（全期 162,740 条消息/12,055 串，群聊为主）；本窗 friend 口径 recv=1003 千级 ✓，sent=111 为真实分布——同窗全口径 recv≈2.0 万（stat_daily_staff 实测） vs friend 1,003，差额几乎全是群消息；cust_threads=89 是串模型多日串折叠（本文 §3 已验证折叠比 57.4%）+本窗 friend 活动偏低。
|
||||||
|
- **dashboard kpis**：active_employees=**40**（~40 ✓，=本文① stat 有数员工数）、active_customers=2,195、msg_total=42,422、cust_threads=9,330、answered=8,460、call 263/接通 113；lifecycle new/cooling/dormant/reactivated=231/1,432/3,353/145。**anomalies=28（critical 3 / warning 25）**，首条 `reply_p90_worsened` critical：P90 324.98min vs 基线期 18.06min（+1700%，样本 62、涉及 51 客户）。dimension_summary：risk/action 全 41 pending（批次C接线，符合预期），service scored 27/insufficient 4/pending 10、均分 56.0。趋势 30 点，末日 20260908 全零——数据止于 20260907（本文快照范围），边界正确。
|
||||||
|
- **detail（王云青）**：`score.trial=true` ✓、grade=**E**（total=39，scored 非 insufficient）、dimensions：risk/action **pending** ✓（批次C）、service 47.8 / customer 0.0 / workload 100；含 accounts/prev/baseline/anomalies。
|
||||||
|
- **metrics section=service**：数值与宽表窗聚合一致 + trend 30 点 ✓。
|
||||||
|
- **drilldown first_reply_p90**：total=**57**=该员工账号窗内 fact 行数（=threads_answered ✓）。首行 fr_ms=**498,242,238ms≈5.8 天**——超「分钟~小时」预期，但与源表全等（fact MAX 同值）；窗内全库更极端值达 1,617,406,247ms≈18.7 天（thread_end 08-14 → reply 09-02，沉睡客户复活串），属真实数据形态非计算缺陷。该员工 p50=97,153ms（1.6min）/p90=1,651,758ms（27.5min）分钟级 ✓。极值是否 winsorize/封顶归批次F口径决策。
|
||||||
|
- **metric-definitions**：19 项定义（msg_sent…call_followup_rate）+ score_config + caliber_notes，`config_source="db"`（评分配置 v1.0 种子生效 ✓）。
|
||||||
|
|
||||||
|
**结论：六端点全 200、数据与库逐字段可对；唯一性能缺口=dashboard 的 unreplied 行动计数（channel 无前缀索引可用），暖态 2.2~2.9s，其余端点全部达标。**
|
||||||
|
|||||||
Reference in New Issue
Block a user