docs(management): 批次A回填实测+对账记录+DEPLOY部署注记

- 核实文档追加Task8小节:回填实测汇总(fact 68,476行/72s,宽表12,371+
  通话1,163/71s,幂等,同源68,476≡68,476,孤儿0,通话314天)
- 对账抽查:王云青+田瑞志×3日期×三组,①②组12/12逐日全一致,③组宽表
  ≤日切(差值=跨夜串归属效应,全期12,055 vs 20,981折叠57.4%验证串未丢)
- 批次A验收清单11项全过(653测试本机复跑绿,写钩子零改动逐commit核查)
- DEPLOY.md §7 新增批次A附加步骤:b7c8d9e0f1a2手动alembic+两条回填
  命令及顺序依赖(employee-metrics必须在first-reply-facts之后)

Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
浅念
2026-09-09 16:20:33 +08:00
parent 0fce21aaf7
commit 639edf56a6
2 changed files with 96 additions and 0 deletions
+25
View File
@@ -228,6 +228,31 @@ alembic 链自当前线上版本起新增 3 支迁移:`a7d3e9f1c2b4` msg_daily_s
幂等自动补种,无需手插;后续加新词默认只扫增量,要扫历史消息需重跑
`--full`。
### 管理后台批次A附加步骤(一次性,2026-09-09)
迁移链新增 `b7c8d9e0f1a2`(经营管理域六表:first_reply_fact /
employee_metric_daily / employee_call_daily / employee_score_config /
employee_score_snapshot / management_followup)。**服务器 backend 容器
不会自动跑 alembic**,须手动:
```bash
sudo docker compose -f docker-compose.server.yml exec backend alembic upgrade head
```
部署带该迁移后在**夜间低峰**跑两条一次性回填(幂等;本地实测耗时:
fact 72s / 宽表+通话 71s,均分钟级):
```bash
sudo docker compose -f docker-compose.server.yml exec backend python -m app.sync.cli first-reply-facts
sudo docker compose -f docker-compose.server.yml exec backend python -m app.sync.cli employee-metrics
```
- `first-reply-facts`:跨日精确首响事实表(本地实测 11,020 会话 → 6.8 万行)。
- `employee-metrics`:员工指标宽表 + 通话日小表(本地实测 12,371 宽表行 +
1,163 通话行);**必须在 first-reply-facts 之后跑**——宽表串类列
(threads_answered/首响分位)与 fact 表同源,先跑宽表会整体为 0。
- 两命令均为按日 delete+insert 幂等重建,复跑结果一致,中断重跑无副作用。
## 8. 本地收尾(部署验证通过后)
```bash