Commit 5b01bfec by luoqi

docs(cli): 撤回「重算 plan 会释放客服」—— 那是错的,因果说反了

上一条(2b0c5406)在 CLI 头注里写「 别为了填派生列去重算 plan,会 auto_release
释放客服手上的单」。查代码后确认**这个判断是错的**:

`auto_release` 只有两个触发条件,都在 plan-engine 里写得很清楚:
  · 本轮该患者 **0 命中**(信号真没了,比如治疗做完了)
  · 患者**最后到诊诊所变了**,原客服将出 scope
两者都是**真实的业务状态变化**,不是"重算"这个动作造成的。
而且 `plansSkippedAssigned = 0`(assigned 不再 skip),这套逻辑本来就跟着
增量同步每天在跑 —— 该释放的早已释放,再跑一次不会多释放任何人。

⇒ 日常维护**本来就靠原机制**:plan 生成收尾会调 `backfillMissing()`, 并没有绕开它。
  这个 CLI 只解决一件事:**上线那一刻的空窗** —— 迁移后全表 NULL,矩阵遇到 NULL
  什么都不出 ⇒ 矩阵全是 0,要等下一次增量同步(最长两小时)或夜间刷新(03:30)
  才自愈;CLI 把窗口压到约一分钟。

️ 留着那句错话的代价不是"说错一次",是下一个人会据此**避开一个本来安全的操作**。
parent 2b0c5406
......@@ -7,9 +7,14 @@
* `unnest(potential_labels)` 遇到 NULL 什么都不出 ⇒ **这段时间矩阵会全是 0**。
* ⛔ 别指望夜间任务兜 —— 那要等到次日 03:30。
*
* ⚠️ ⛔ 不要为了填这一列去「重算 plan」:重算会升版本、关闭无信号的 plan、
* `auto_release` 释放客服手上的单 —— 为一个派生列去动召回池,代价完全不对等。
* (重算收尾确实也会补齐,但那是顺带,不是手段。)
* ⚠️ **重算 plan 也能补齐,而且是安全的** —— ⛔ 别被"会释放客服"吓住(那是错的):
* `auto_release` 只在「本轮该患者 0 命中(信号真没了)」或「最后到诊诊所变了」时触发,
* 两者都是真实业务变化,不是重算这个动作造成的;这套逻辑本来就跟着增量同步每天在跑,
* 该释放的早已释放,再跑一次不会多释放任何人。
* ⇒ 日常维护**本来就靠原机制**:plan 生成收尾会调 `backfillMissing()`。
* 这个 CLI 只解决一件事:**上线那一刻的空窗** —— 迁移后全表 NULL,
* 等下一次增量同步(最长两小时)或夜间刷新(03:30)才自愈,
* 而 CLI 把这个窗口压到约一分钟。⛔ 别拿它当日常手段。
*
* Usage:
* pnpm backfill-plan-labels # 只补没算过的(上线后跑这个)
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment