[Decision] Per-user notification locale —— 2026-08-13 裁决所等的「实测拉力」已到(hotcrm:4 个已发布语言 × 16 个 notify 节点 × 0 可本地化)

[huangyiirene]

按维护者指示上行立卡(2026-08-31,hotcrm#1185 决裁,逐字:「1185 如果是平台的问题就去平台立卡片」)。

背景:两条既有裁决的交汇

• 2026-08-17(hotcrm#1185):「立项，走 emailTemplates 路线」—— 模板通道已由 Flow notify nodes cannot be localized: title/message are raw strings with no template or locale channel, so a four-locale app sends English-only notifications #9205 / PR feat(automation): notify nodes reference email templates for localized delivery — resolve (name, recipient locale) at delivery time #9224 落地,spec@17.1.0 钉内可用,四探针实测全通过;
• 2026-08-13:收件人语言固定为部署默认(II18nService.getDefaultLocale()),per-user locale 推迟至「有实测拉力为止」。

第二条使第一条的目标不可达:投递路径每次通知只解析一个语言(payload.locale 在 fan-out 前插值一次,或部署默认),从不按收件人解析。service-messaging/src/email-channel.ts L86-99 自述此状并写明「a per-user locale, when it lands, plugs in here」。

实测拉力(hotcrm#1185 的 dev 停手报告 + PM 复核,两个独立车道同判)

• hotcrm 发布 4 个语言(en / zh-CN / ja-JP / es-ES),16 个 notify 节点,0 个可本地化:zh-CN / ja-JP / es-ES 用户从每一条自动化(成单、SLA 违约、升级、任务提醒、合同到期…)收到英文通知;
• 应用侧无路可走(实测):sys_user 无 locale 列且 protection.lock: 'full',应用加不了;sys_notification_preference 亦无;逐 flow 查偏好的绕行被测量排除(无偏好行用户会以字面量 "undefined" 作 locale 静默死信,严格差于现状)—— 且按 2026-08-31 应用仓三原则([ruled] 应用仓基本原则落编:阻塞是平台缺陷时,应用侧等待平台修复 —— ⛔ 不绕行、不半边落地(维护者 2026-08-31,判例 hotcrm#549) #13848)应用侧绕行本就 ⛔;
• 独立佐证:objectstack#7684(QA 清单车道,2026-08-11 关闭)同测同判;spec 文档面漂移(docblock 承诺 per-recipient 而实现刻意不做)已另行立卡 objectstack#12178。

要裁的形状(两个候选,均插在 email-channel 预留的 seam 上)

• A · sys_user.locale 列:一等公民;动 packages/spec/src/system 的用户面(better-auth 相邻面需核),条款②;
• B · sys_user_preference 支撑的覆盖位:不动 sys_user;投递 fan-out 时按收件人解析(今天 payload.locale 是 fan-out 前单值 —— 两个形状都要求把解析点移到 per-recipient)。

公共要求:解析链 = 收件人 locale → 部署默认(缺失恒回退,⛔ 不得死信);与 TEMPLATE_* permanent 失败分类的交互写进设计;首个消费者 = hotcrm#1185(已改挂本卡,能力落地日退化为纯元数据转换)。

Refs: hotcrm#1185(拉力测量全records)· #9205 / PR #9224(模板通道)· #12178(文档漂移)· 2026-08-13 裁决(email-channel.ts 注记引用)。

---

Blocked-by: (resolved 2026-09-03T09:54Z — PR #14775 MERGED as 1401ae7; the #14832 hang was quarantined on main by PR #14871)
Unlock-action: (fired — PR #14775 merged 09:53Z)
(Added by the domain:spec seat 2026-09-03T05:00Z: work complete — PR #14775 review PASS 5519054527, kicked from the merge queue twice by the packages/cli run-dev-unbuilt-workspace.e2e.test.ts defect that survived its first fix (#14648 closed, successor #14832); re-check the PR when #14832 closes, do not re-dispatch.)

---

Generated by Claude Code

[huangyiirene]

裁决:A —— sys_user.locale 一等列;解析点移到 per-recipient(维护者 2026-09-01,总监批 #23)

项目总监席 · session session_01KGtaLpkW1mycWgkbSb3H6t · 维护者对本批逐字:「同意」。2026-08-13「推迟至有实测拉力」的前提已被 hotcrm#1185 的测量满足(4 语言 × 16 notify 节点 × 0 可本地化,两个独立车道同判),该裁决按其自身条款解除。

1. A:sys_user 加 locale 一等列(用户语言是主流平台的一等用户属性;B 的 preference 袋会把一等概念藏进键值对并孕育第二种拼法,排除);
2. 解析点移到 fan-out 后按收件人:payload.locale 不再是 fan-out 前单值,插进 email-channel.ts L86-99 自留的 seam;
3. 解析链 = 收件人 locale → 部署默认(II18nService.getDefaultLocale()),缺失恒回退,⛔ 任何路径不得死信(hotcrm 实测的 "undefined" 字面量死信形状是反例钉);
4. better-auth 相邻面核验写进实施第一步:sys_user 面与 better-auth 的用户表映射关系先测后动,若发现耦合冲突 ⇒ 停手报回,⛔ 不硬凑;
5. 与 TEMPLATE_* permanent 失败分类的交互写进 PR 正文供复审;
6. 条款②:YES(packages/spec/src/system 用户面扩宽)⇒ draft + needs:contract-review 同笔,本席复审;changeset minor;
7. 首个消费者 = hotcrm#1185(能力落地日退化为纯元数据转换);文档漂移卡 spec: NotifyConfigSchema template doc/description promises per-recipient locale resolution that the delivery path deliberately does not do (deployment default, ruled 2026-08-13) #12178 在本卡落地时一并核销或更新。

再锚定:A 触 spec 声明面 ⇒ domain:services → domain:spec,同笔改挂(#13816 同规则)。

状态转移(同笔)

needs-user-decision → pm:queue;改挂 domain:spec。

---

Generated by Claude Code

[huangyiirene]

分诊 · 反向索引维护(不动裁决,不动值级)

已补 pm:blocking(get_labels 回读确认,现 3 个标签)。本卡现在有一个已登记的下游:

被阻塞卡	等的是什么
#14641 (domain:services, p3)	邀请邮件按被邀请人语言选模板 —— 需要本卡裁的 sys_user.locale 一等列;在此之前保持部署默认是正确行为而非欠账

#14641 的正文已挂 Blocked-by: #13881,本卡落地时应一并解锁。它的实施面按裁决第 2 项应当只剩一处取值点;若届时发现不止一处,那说明解析点没有真正移到 fan-out 之后,应回报而不是在下游卡里补齐。

一条给认领人的提醒(转述裁决,不新增要求)

2026-09-01 裁决第 6 项:条款②:YES(packages/spec/src/system 用户面扩宽)⇒ draft + needs:contract-review 同笔,项目总监席复审;changeset minor。

⚠️ 该标签按裁决的措辞是在起草 PR 的那一笔上,所以本席没有提前打在卡上 —— 但它容易在认领与起草之间掉队,故在此点名。同样容易掉队的是第 4 项:better-auth 相邻面核验写进实施第一步,先测后动,发现耦合冲突 ⇒ 停手报回,⛔ 不硬凑。

---

Generated by Claude Code