[Decision] `severity: 'warning'` 的校验规则没有受众概念 —— UI 级劝导在 seed/bootstrap 等机器写入路径上照样求值并打爆启动日志,且按写入次数而非按行计数

[huangyiirene]

按维护者指示上行立卡(2026-08-31,hotcrm#1203 决裁,逐字:「#1203 种子数据触发 related_to_required 警告，这种也是平台的问题啊」)。

实测事实(hotcrm#1203 + PR #1291 全记录,dev 全枚举 + PM 独立复核 + 消融验证)

• hotcrm 的 related_to_required(severity: 'warning',文案 "At least one related record should be selected")是写给表单中的人的劝导。种子里恰好一行合法的内部任务(刻意不挂父记录、注释在场)触发它;
• 平台对 warning 级规则没有受众/通道概念:同一条规则在 seed 加载、demo_bootstrap 认领回写等机器写入路径上照样求值,以 WARN 打进服务器启动日志 —— 一条给人看的表单提示变成了「启动诊断」,读起来像 boot 失败;
• 按写入计数,不按行(hotcrm#1203 dev 发现 3):bootstrap 认领扫描回写 owner_id 会对业务字段未变的行重新求值全部规则 ⇒ 同一行清库首启响两次;任何数启动日志 warning 的人都会按「被认领对象数」高估;
• 应用侧无路可走而不弯东西:达成「零警告」只能强行挂父(弯数据)或删规则(削门禁)—— hotcrm#1203 的四选项分析已排除两者,而「容忍日志行」把成本留给每一个全新部署的第一印象。

要裁的形状(平台统一,⛔ 应用不逐行辩护)

• A · 声明受众:ValidationRuleSchema 给 advisory 级规则一个受众/通道位(如 audience: 'interactive' 或按 severity 约定)—— warning 级只在用户交互写入时求值/呈现,机器路径(seed/bootstrap/system)跳过或聚合。条款②面(spec 契约扩宽或语义收窄),需设计混用与默认值;
• B · 引导路径聚合:seed/bootstrap 加载器把 advisory 命中聚合为一行摘要(「N 行触发 advisory 规则 X,详见…」),不改规则语义,只改日志形状;同笔修「按写入计数」(业务字段未变的系统回写不重复求值 advisory);
• C · 维持并文档化(warning 即全路径日志,应用自行容忍)—— hotcrm#1203 的经验说明这会把每个样板/应用逼进「弯数据 vs 忍噪音」的假选择。

相关但不并卡

• 种子日期是未解析 CEL 信封,离线对种子求值日期谓词会得到自信的错答案(hotcrm#1203 dev 发现 1)—— 工具面单独关切;
• 双 autonumber 计数器启动警告已有上游 Seed loader writes untenanted rows while the REST path stamps an organization — one single-tenant install runs two autonumber scopes and mints duplicate business identifiers, silently (17.0.0 GA) #8686。

Refs: hotcrm#1203(测量全记录,现象卡已收口)· hotcrm PR #1291(防回归钉)· 2026-08-31 应用仓三原则 objectstack#13848。

[huangyiirene]

裁决:B —— 引导路径聚合 + 修「按写入计数」;A 挂绊线停放,C 排除(维护者 2026-09-01,总监批 #23)

项目总监席 · session session_01KGtaLpkW1mycWgkbSb3H6t · 维护者对本批逐字:「同意」。

1. B:seed / bootstrap 加载路径把 advisory(warning 级)命中聚合为一行摘要(「N 行触发 advisory 规则 X,详见…」),⛔ 不改规则语义,只改日志形状;
2. 同笔修计数缺陷:业务字段未变的系统回写(如 bootstrap 认领扫描写 owner_id)不重复求值 advisory 规则 —— 同一行清库首启只响一次,按行不按写入;
3. A(ValidationRuleSchema 加受众/通道位)挂绊线停放:实测伤害全在引导路径的日志形状与重复求值,不在「缺一个可编写键」;⛔ 不为尚无第二例的需求铸造可编写面。绊线:若出现「某 warning 规则就该在机器路径响」的实例 ⇒ 受众键成真需求,census 随卡回决策箱;
4. C 排除(把「弯数据 vs 忍噪音」的假选择留给每个应用,hotcrm#1203 已证)。

再锚定:B 的落点在加载器侧(seed loader + bootstrap 认领回写的求值门),不触 spec 声明面 ⇒ domain:spec → domain:engine,同笔改挂。相关不并卡维持:种子日期 CEL 信封(工具面)、双 autonumber(#8686)。

状态转移(同笔)

needs-user-decision → pm:queue;改挂 domain:engine。验收锚 = hotcrm#1203 的实测记录(同一行首启只响一次、启动日志一行摘要)。

---

Generated by Claude Code