三件事,因为改动在 plan.service / execution.service / types 里交织,合成一次提交。

## 1. fix:话术自报家门串名(线上 bug)

现象:登录人是李倩,话术却写"我是本诊所的客服主管晋芳辰"。
根因:登录客服姓名被烤进 LLM 生成的正文,而 plan_scripts 的 UNIQUE 是 plan_id
     (一个 plan 一份话术、不分人),召回池又是共享的 —— 谁先打开触发生成,
     姓名就固化给后面所有人看。线上 44 条话术 100% 中招,是必然不是偶发。

解法:姓名不进 LLM,改「生成期占位 → 渲染期回填」
  - 新增 shared/agent-identity.ts 作单一源(占位符 + resolveScriptAgent + renderAgentIdentity)
  - 稳健/标准/深度三档 prompt 与 format.md 统一输出 【回访客服】(沿用 v8 立的
    `{}`=填空 / `【】`=原样保留 的约定,归第二类)
  - 四个出口渲染回填:详情聚合、strict Zod 详情、同步重生成、SSE 流式
  - DraftPlanScriptInput 去掉 agent 字段

副作用(正向):input_hash 不再含人名 → 同一 plan 不同客服共享 AI 缓存;
工单转派后名字自动跟着换,不用重生成。

三档实跑验证模型都保留了占位符;浏览器验证同一份缓存对两个登录人显示各自姓名。

⚠️ 存量 44 条仍是旧正文,需部署后逐条重生成(dist/cli/ai-gen-script.cli.js)。

## 2. refactor:删 plan_executions 两个死字段

  - invalid_reason  从没被写过(pac-web 零引用),读回路径也没带它
  - abandon_other   写得进没人读,且信息恒冗余 —— 放弃原因是固定复选框无自由文本,
                    该列只可能取到字面量"其他",而 abandon_reasons 已含 'other'

生产 0 行受影响(执行总数 2,两列全空)。

## 3. feat:宿主回访模式的「关闭机会」闭环

瑞尔侧回访在宿主系统做,PAC 只提供关闭入口做闭环。**刻意不引入新概念**:
不加 closed outcome、不加 close_reasons 列、不加 plan 状态 —— 关闭就是
outcome='abandoned' + abandon_reasons,跟 PAC 自带表单同一条路、同一列。
分叉只在展示层(ABANDON_REASON_META.shownIn,两个面板各渲染各的子集)。

  - AbandonReason 扩成两种模式的并集;近义项不合并(两模式按 host 配置二选一、
    运行时不共存,同一 host 只出现自己那套 key,统计不会碎)
  - 关闭弹窗改多选无上限;「其他」说明写 notes,不另立列
  - 原因级抑制窗:各原因 suppressDays 取 max(每个原因独立成立,取最严的);
    未配的沿用 outcome 默认 60d,行为跟改造前一致
  - 「识别不准确」不再双写 recall_feedback(该表留给拇指控件那条路)
  - outcome-form 的中文硬编码数组 + 中译映射表删除,key/label 改为同源
    (那张表里「已转介他人→treated_elsewhere」是语义错位)

## 文档

新增「取数说明」(pac-docs)—— 给 DW 团队自助查生产 PG:召回池筛选条件、
关闭操作落表、数据范围过滤(品牌/诊所/时间)、字段字典、常用 SQL。

291 tests passed;service + web 双端 typecheck 干净。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

清缓存与 reparse/persona/plan 不是一类动作(不重算、秒级、按需重生成),
放进同一张表会误导"改 prompt 也要跑重算"。改为表下引用块说明。

顺带修补编辑残留:表格首行多一列、③ 代码块缺收尾 ```。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

面向"自己动手部署"的 runbook,不重复 deployment.mdx 的架构介绍,直接给命令:
- 三环境速查表(位置/目录/分支/DB/部署方式)+ 分支规约
- 本地开发(docker 基础设施 + 原生跑应用)+ 4 个常见问题
- 测试/生产部署命令(生产强调 COMPOSE_MANAGED=1 与 source .env)
- 部署后要不要重算的对照表 + 固定顺序(reparse→persona→plan→清缓存)+ 耗时参考
- 定向补数据(PAC_COHORT_ONLY_PATIENT @file)参数与分批阈值
- 失败处理/回滚、7 个踩过的坑(含 pkill 自杀、ClickHouse 256KB 上限)、日常巡检

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

# Conflicts:
#	apps/pac-service/tests/recall-suppression.spec.ts

背景:DW 病历表 patient_id 错位污染(高逸铭案例),需按名单重摄 3 万患者。
沿用现有 PAC_COHORT_ONLY_PATIENT(cohort 收窄)时发现两个阻塞问题:

1) ⭐ 静默丢数据:只要 manifest 配了 incremental.per_query(jvs-dw 配了),
   cold-import 任何模式都写 cursor_after=run_start。定向轮只覆盖名单内患者,
   却推进全局水位 → 名单外患者在本轮期间的 DW 新写入被永久埋在游标下方。
   (与本次排查发现的"12,595 个患者符合 cohort 却从未摄入"是同类机制)
   修:定向模式下 cursor 保持上次水位不推进,daily 增量照常从原点接力。

2) 大名单 E2BIG:3 万个 id 的逗号串约 275KB > 环境变量单值 128KB(MAX_ARG_STRLEN)。
   修:支持 PAC_COHORT_ONLY_PATIENT=@/path/to/file(每行一个 id);逗号列表照旧兼容。

顺带:定向生效时打印命中患者数,便于核对名单规模。
测试 7 例:空/空白不误判定向、逗号列表、@file(含 3 万行)、文件缺失须抛错不静默退化。

生产验证(高逸铭组 7 人小批):删除→重摄后
  高逸铭 62 事实/6 诊所 → 21/1(上海时代),别人的数据清光
  刘晓旭 13 → 25、徐嘉悦 126 → 130,被吞的数据补回,诊所归属全部正确

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

跟进诊所重归属(7b4f0d93)的补丁:诊所隔离是硬边界(list/detail 都强制
targetClinicId ∈ scope.clinicIds),已认领单漂出原认领人 scope 后会变成
谁都看不见的孤儿单(assigned 不进池、新店客服非 assignee、原客服出 scope)。

- unchanged 就地改归属:若 status=assigned 且诊所变了 → 返池(assignee/assignedAt/recycleAt 清空)
- 升版本路径:clinicMoved 时 assigned 不继承,新版本直接回池(与上同规则)
- 两路径都记 log(哪单从哪店改到哪店),上线后可巡检
- 测试 +3:两路径返池 + 归属未变时继承不误伤(12/12);顺带修 mock seed 缺 targetClinicId

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

业务口径(2026-07):运营按客户最后一次到诊的诊所做跟进分类,谁家最后来过就归谁家客服
——原口径 target_clinic_id = 触发诊断 fact 所在诊所,会把主诊所患者顺路在别处拍片/被诊断
的人错分到那家只去过一次的诊所(反馈案例 BJ0D046171:150+次天使大厦、1次印象城影像AI诊断
→ 却进了印象城列表)。适用全部召回场景,不止影像 AI。

- target_clinic_id = 患者最近一条 encounter/emr(到诊)所在诊所;无到诊记录兜底回退诊断诊所(不置空)
- unchanged 分支(reason 未变)也就地改归属,不升版本 → 普通重算即可修复存量错分
- 批量 prefetch 修 uuid bug:patient_id IN (text 参数) 对 uuid 列在 PG 报类型错,
  批量整体静默退回诊断诊所(修不动);改 = ANY(::uuid[])。本地 2470 患者全量重算后残留错分 0
- 单刷路径 resolveLastVisitClinic 直查

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

方案 A 落地(jvs-dw):
- incremental_cron: '15 0,8-22/2 * * *'(08:15~22:15 每 2h + 过天 00:15;
  cron 小时域无 24,'0' 即用户说的"24点"次日凌晨轮)
- 空轮短路:transactionsWritten=0 且 patientsUpserted=0 → 跳过 persona/org-tree/plan,
  空轮成本收敛到每表一条 cursor 探查(秒级)。条件保守:患者主档变化不产事务但进画像,不跳。

背景:DW 当前每日 08:00 一批(实测 13:56 时三表 updated_date 仍停昨日 23 点),
日内轮询换来的是 ① DW 迟到/失败当天自愈(原等 24h)② 手动补摄自动收口
③ 瑞尔 DW 计划提频 2h,PAC 先就绪。防重前提已具备:并发锁 + cursor 幂等 + 同行去重。
计划重算链路不动(空轮短路后不会被空跑)。

验证:cron 库实测 next 14 次触发序列正确;manifest 解析 auto_sync/cron 正常;tsc 干净。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

业务定调(张雪反馈):一线关注真金白银,应收对免费套餐/团购客严重虚高
(胡新丽:应收¥1,270 实付¥0;张弦:应收¥77,795 实付¥57,887)。

- jvs-dw payment.yaml:amount settlement_money(实付);friday:net_receipts_this
- 新增 receivableAmount(应收)辅助字段:canonical schema 显式声明 + moneyFields
  登记同口径归一 + payment_record.content.receivable_cents
- discount-anchor 折扣率分母换 receivable_cents(旧事实 fallback amount_cents)
- 顺带修掉两个隐藏口径 bug:
  ① refund 一直是实收冲减 → 原 LTV 实为"应收收入−实收退款"混口径,现自洽
  ② 储值客户双计:充值(实付)计一次 + 扣卡消费应收又计一次,现扣卡单实付0不再重复

下游自动切换:profile.ltv(UI 累计消费)/ rfm.M 值 / lifecycle 消费档 → 实付口径。
金额守恒已对账(张弦 mode 表 17 行:实付57,887/应收77,795,无多通道重复计)。

上线步骤:部署后跑 reparse(rawPayload 完整保留源列,无需重拉 DW)→ persona 重算。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

第④问「以什么切入」:打电话的低门槛开口台阶,依据按优先级取第一个可用档:
① 医生计划/建议/医嘱(最优先,统一 verbatim 原话属性):
   - 治疗计划 subtype 原话(如「待22萌出后择期早期矫治」)
   - 医生建议 recommendation_record.name 原文
   - 医嘱 emr_record.doctor_advice(2.2万条真实医嘱;≥6字过滤"常嘱"水词,取最近2条)
   规则:必须优先引用「」原话要点(过长精简保留医嘱词),别只报大类;
   通用套话(定期复查不适随诊)视同无原话降档;多条挑与召回原因最相关的一条
② 洁牙/检查锚点(①为空才用):最近一次 preventive/periodontic 距今,
   超6个月才可引用时间,不足视同没有
③ 通用复查邀约(不带时间数字);严禁编"该洁牙了/上次洁牙已X个月"

防重复:同一天数整句只出现一次;锚点与召回原因"拖了X"同源时切入不再报数。
字数放宽 ≤65 最佳/90 上限;兜底模板同优先级;prompt 版本 2026-07-21-d。

注:已缓存旧简报不自动重生成,上线时按 type=recall_brief 清一遍缓存即可。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

merge: refactor/assembler-shared-dict → main(FRIDAY 摄入:共享字典分层 + 推送契约 + 关系边/咨询/退费三轨 + export cohort 过滤)

# Conflicts:
#	apps/pac-service/tests/canonical-fact-layer.spec.ts

形态 A 的 15 个 source 字段定义,放接入板块、紧随 Push 通道(它是推送通道的宿主侧具体化)。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

patient_relation / patient_return_visit 与 patient 同为 upsert 资源(不进
transaction,刻意无 emits,yaml 头注释已写明),但闸 3 豁免名单只有 patient
→ 两条误报失败(main 同样存在)。豁免集对齐 cold-import.service.ts subjectCfgs
排除集(patient/patient_relation/patient_return_visit)。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

recall-suppression.spec 引用 7eb8dbed 三源标定重构中删除的 computeLikelihoodBonus,
套件加载失败(main 同样存在)。原 GAP2"considering 不加权"在 v3 由设计保证
(scorer 不再消费 execution outcome);该块改测 v3 确定性因子:置信度夹逼 [0.5,1]、
新鲜度过窗线性衰减至 0.4 地板、三维加权(急迫0.4/价值0.3/意愿0.3)、
K08/K03 牙数分档、信任封顶 10、总分 ≤100。snoozedUntil 部分 API 未变,原测保留。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

f60f4cca/4fe0d973 重构删除旧 script-facts 8 函数,旧 spec 成孤儿(套件加载失败)。
按现架构重写:shared/script-facts(智能日期/FDI俗称)、shared/pii(去名留称呼)、
shared/disease-knowledge(病种 canonical 名)、tiers/stable/phrasing(稳健档文案,
含 jaw_cyst 双字典 key 回归点)、shared/fact-block(厚输入事实块:全名不进 prompt/
未成年拍片禁令/单一聚焦)。62 测锁行为。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

文件源宿主的诊所/时间过滤放导出侧(架构约定:host 端 dump 时过滤,PAC 不动):
- cohort 源 = med_emr_info 正式病历(对齐 jvs-dw clinic_scope 挂 EMR 事实表);
  只收窄患者名单,入选患者全部主体/跨诊所/全历史照常导出,谓词按患者求交非行级 AND
- settlement_modes 无患者列经结算头单 IN 子查询挂靠(纪律放行形态)
- SQL 走 stdin(cohort IN 列表会撞 ARG_MAX);空 cohort 拒跑防退化全量;
  cohort 内 0 行表合成表头(mysql --batch 空结果连表头都不出)
- cold-import 文件源传 --clinics/--since 时显式警告(此前静默忽略)
- refresh-clinic-names 改合并语义:子集导出不再刷掉子集外诊所名

实测(刘医生演示诊所 36 患者):EMR 53 份含 4 家其他诊所历史,零越界;
dry-run 15 资源 746 txns 0 failed;空 cohort exit=1;0 行表合成表头可导入。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

品牌中文名当前只有模拟登录对话框一处会用,显示 GUID 足够;为它引入一个数据源
(tenant_apply.tenant_info)+ 一个 Host 字段 + 契约档 + CLI 分支 + session 合并,
收益不抵复杂度 → 整条链路撤回,只留诊所名(工作台真实展示位)。

- friday export.sh / manifest:删 tenant_info 导出与 brand_directory 声明
- manifest.schema:删 brand_directory;Host.sourceUnitNames 与其迁移一并删除
  (分支未合未部署,本地 DROP COLUMN 即可,无需 down 迁移)
- TokenDictionary 删 brands 档;auth.service 恢复 getClinicNames;controller 恢复原合并
- refresh-clinic-names CLI 恢复单字典派生
- listMockOrgs:品牌名直接用 source_unit id(诊所名仍派生自病历表 organization_name)
- 契约文档:15 source 复原,「留意事项」加一条说明——品牌名未冗余进业务表,
  将来若需展示再约定推主档

验证:tsc 0(svc+web);mock-orgs 19 品牌显示 id、诊所仍中文名;session 无 brands 键、
clinics 11 家照旧;jvs-dw 全程未受影响。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

对接方必然会问"诊所名随业务表白送,品牌名为何要单独推一张表"。实证:宿主把
organization_name 冗余进了 21 张业务表,而 tenant_name 只在两张投诉表(不在契约范围),
品牌名只存于 tenant_apply.tenant_info 主档 —— 故必须单独推,好在低频且仅 45 行级。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

对齐 2026-07-20 的新落地内容:
- 新增 §2 `tenant_info` 品牌主档 source(品牌 GUID→中文名;PAC 靠它避免前端显示 GUID),
  source 总数 15→16
- `med_emr_info` / `med_check` 补 `organization_name` 列(诊所展示名来源;此前导出漏列,
  导致工作台诊所显示 GUID)
- 补回丢失的 §7:改为「语义澄清记录」——时间口径/金额/两套关系枚举/treat vs dispose/
  结算 status 全 9 值 + 为何不收 7/8,逐条附源码或数据依据;另列三条推送方留意事项
  (organization_name 仅覆盖有病历的诊所、字典表全量重推、测试环境沙盒数据待生产校准)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

两宿主此前挤在一个面板(FRIDAY 只有一条集团级横条),数据概念互相干扰。改为宿主 tab:
- 瑞尔集团(jvs-dw):原客服花名册路径,一字未动
- FRIDAY 市场:身份是造的(该宿主本就无客服花名册),但**数据范围必须真实** ——
  品牌/诊所来自新端点 GET /auth/mock-orgs:结构取 org 树(派生自 patient_transactions),
  名字取 host.sourceUnitNames / clinicNames(派生自摄入源),零硬编码

- 契约:MockLoginRequest 加 orgId(任意 org 节点 = 品牌 GUID / 诊所 id);新增 MockOrgs 响应
- service:listMockOrgs(org 树 + 名字典,有名品牌与多诊所品牌排前);friday 分支支持
  orgScope=[orgId],不传则市场级
- web:FridayPanel(角色 + 市场级 + 真实品牌/诊所两级选择 + 搜索)

验证:FRIDAY tab 显示 19 品牌 / 35 诊所(瑞诚齿科 12 诊所、希尔德 3…);点"瑞诚齿科"
品牌级登录 → 右上角 12 个诊所、召回池由 11,723 收窄到 5 人、患者诊所均属该品牌 ✓;
瑞尔 tab 花名册与登录行为不变。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

FRIDAY 的 source_unit / clinic_id 都是 GUID(jvs-dw 是"瑞尔/瑞泰"中文名),工作台此前
只能显示 GUID。诊所名机制(host.clinicNames + clinic_directory + CLI 派生)本就存在且
支持文件源 —— 缺的是①导出漏了 organization_name 列 ②friday manifest 没配 directory
③品牌名没有对应机制。

- 契约:TokenDictionary 加 brands 档;Host 加 sourceUnitNames(对称 clinicNames,
  迁移 20260720104938)
- manifest:新增 brand_directory 声明(与 clinic_directory 同形)
- CLI refresh-clinic-names 泛化:一次派生两类字典,单侧声明不误清另一侧;空结果不覆盖
- session:getDisplayNames 一次取两类,dictionary.brands 与 clinics 同款合并
  (服务端派生打底、宿主换票传的覆盖优先)
- friday export.sh:med_check/Mongo 补 organization_name,新增 tenant_info 品牌主档
  (apply 服务 tenant_apply.tenant_info,列名实测 name/name_ab 非 short_name)
- ⚠️ export.sh 加固:所有导出改 tmp→校验非空→mv,裸重定向在库抖动时会清空好文件
  (2026-07-20 踩,62MB med_emr_info.json 被清零)

验证:派生诊所名 11 家 / 品牌名 45 个;friday session 下发 brands 45(成都安玉牙种植
医院/欣美/森德口腔)+ clinics 11;jvs-dw 对照 brands 键不下发、clinics 5 家照旧。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

工作台此前只能登 jvs-dw 租户,FRIDAY 摄入的 10.7 万患者 / 1.17 万召回计划无入口查看。
- MockLoginRequestSchema.tenant 加 'friday'
- auth.service 独立 early 分支:host=friday / tenantId=friday-market /
  orgScope=['friday-market'](集团根 → 展开后 sourceUnits/clinicIds 均不限)。
  多品牌 SaaS 无在岗花名册,mock 只做集团级;诊所名未摄入 → dictionary.clinics 空,
  UI 回退显示 id。jvs-dw 路径(MOCK_PRESETS)完全不变
- 弹窗集团级横条下加青色 FRIDAY 入口,角色沿用①所选

验证:mock-login 签发 token(hostId=friday/tenantId=friday-market)、瑞尔对照未受影响;
浏览器登入实测召回池 11,723 人,详情页画像 9 项 / 治疗历史 1,621 项 / 累计消费 ¥3,320
/ AI 话术均正常。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

一、时间/金额实证(2026-07-20,契约文档同步):
- 金额=元(洁治单价均值 ¥310/客单 ¥1,730 双证);MySQL datetime=北京墙钟(_gmt_ 命名惯例误导)
- ⚠️ Mongo Date=北京墙钟伪装 UTC(clinicTime/createdGmtAt 小时分布双峰直读=营业时段;按真 UTC
  解释一半病历落深夜)→ export.sh Date 改直读墙钟输出 naive 字符串;EMR 链 35.6 万 fact
  清层重灌校正(-8h),修后小时分布恢复营业双峰。契约文档明令宿主 push 勿 toISOString 带 Z

二、官方字典(friday-saas 源码考古,待确认清单清零):
- contacts.relationship = PhoneRelationshipEnum(1本人…9其他)→ patient.yaml 解码,
  preferences.contactPhone 带 relationship 标签(mother/father…)
- referee_relationship = RecommendRelationshipEnum 17 码;reverseValue+年龄差数据双证
  语义方向=customer 是 referee 的 X → patient_relation.yaml 按逆关系重写(码8 其他亲属
  纠正 friend→other;新增 5/6/11/12/13/15/16 映射;码3 按对方性别拆 father/mother)。
  关系表清层重灌:friend 3,511→541(纯码7),官方映射干净落地
- settlement status 全 9 值:实体注释 7=流程结束/8=欠款补缴克隆单(savePatientSettlementQk
  证实 receivable 原样复制→入消费必双计)→ 现行不收 0/2/5/6/7/8 全部获官方背书
- treat=本次治疗/dispose=处置(EmrInfoResDto 注释);预约 status 7=到诊患者变更

三、患者主档 push(此前 form A 仅支持 fact 资源):
- patient-upsert.util:upsert 数据构造抽纯函数,full(cold-import 历史语义,分毫不变)/
  partial(push 单表:未提供字段不进 update 集合、phone 永不合成假号)双语义 —— 解决
  push 单表时 contacts lookup 缺席导致存量真号被假号覆盖的根因
- ingestRawTables 路由 upsert 资源(patient partial/patient_relation/patient_return_visit);
  纯主档推送不产 txn 不触发重算(注释明示)
- 测试 8/8(partial 不覆盖/无清空语义/preferences 透传);E2E 冒烟:push 单行改名,
  存量 phone 15725591111 原样保留 ✓。契约文档待确认清单清零

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

原测试只豁免 patient,后来新增的 upsert 资源 patient_relation/patient_return_visit
(设计上无 emits)一直误报;friday/patient_relation.yaml 落地后同一缺陷第三次命中。
豁免集合改为与 importDirectory 排除 subjectCfgs 的三元组一致。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

原 occurredAt ?? new Date() 在 occurredAtField 缺失/不可解析时每次摄入产生新墙钟值 —
时间锚纳入 fact 变更检测后会被放大成伪 supersede 版本抖动。改为确定性回退链
(occurredAtField → updatedAt → createdAt),三者皆缺才落墙钟并 warn。含回退顺序测试。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

FactWriter 此前只比 content hash + status:occurredAt/plannedFor/validFrom/validUntil
不参与 → 宿主纠正事件时间(如 FRIDAY 伪 UTC 整体 -8h)重摄永远 evidence_appended,
时间锚永不更新。时间锚是时间轴/召回窗口 COALESCE(occurred_at,planned_for)/过期 cron
的直接输入,属事实实质 → 纳入等值判定(毫秒精度,双 null 视为等),单写与 bulk 两路同步。
不纳入 title/summary(展示层)。含 supersede 传导测试。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

宿主动作派发(host-message 重写):
- actionUrls.OPEN_RETURN_VISIT / OPEN_POTENTIAL_TREATMENT 值形态定模式:
  未配置=按钮不渲染 / URL 模板=跳转(推荐) / 哨兵 postMessage=喊宿主父页(需 HOST_ORIGIN)
- 哨兵比较大小写不敏感(裸词不可能是合法 URL,宽容拼写零误伤)
- 管理页:配哨兵缺 HOST_ORIGIN 时黄条提示

宿主回访模式布局(有回访按钮时):
- 通话结果整列隐藏(xl 收 2 列,窄屏去「操作」tab);召回反馈拇指隐藏,宠物引导同停
- 顶栏「关闭」危险按钮 → 关闭机会弹窗(7 原因,PAC UI 标准)

关闭机会闭环(CLOSE_REASON_META 单一真理源,前后端同表):
- 原因→outcome 映射:无意愿/价格=refused(90d)、竞品=external_treatment(永久)、
  无法联系=abandoned(30d 熔断口径)、已治/其他=abandoned(14d 默认档)、
  识别不准=marked_invalid(覆写永久→14d)+ 双写召回反馈 down
- resolveSnoozedUntil 优先级链插入 closeReason 覆写档(熔断 > 覆写 > outcome 自带)
- 复用 execution 通道(channel=other),状态机/触达账本/跨栏同步全继承
- 关闭后自动跳下一位(我的进行中 → 召回池,与 /plans 入口解析器同规则)

列表口径对齐:
- 终态单(completed/abandoned)在 pool/mine 视图原地剔除(与服务端过滤一致)
- 「我的」显式 status=assigned(服务端 view=mine 返全状态是旧列表页设计)

其他:全局细滚动条(Windows 默认过粗);删 spec 中引用已重构掉的
computeLikelihoodBonus 的过时测试块(main 上即已编译失败);新增 7 个
closeReason 抑制覆写测试(19/19 过)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

- .design-sync/:config(锚定 PAC Design System 项目)+ 18 个富预览 + 用法约定 + NOTES
- src/ds/index.ts:设计系统导出桶(ui 全集 + plan-detail 原语 + toast)
- ui/*.tsx、shared.tsx:补 JSDoc(@category 分组,转换器生成 prompt.md 用)
- .gitignore:忽略同步暂存/构建产物

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

问题:信号级抑制集只按 (scenario|subKey) 一刀切,外院/无效的永久 snooze(36500d)会把
结案后新发的同类诊断也永久压死 —— 同牙位复发(外院种植失败回院再诊断)和 @whole 病种
(外院牙周,多年后新发)整类终身沉默。且 cluster lead 锚最早诊断,老 fact 永远 active
(外院治疗不进本院数据)→ 新旧必聚同 cluster,单看 lead 时间无法区分新发。

修法:
- scenario:cluster 注入 cluster_latest_occurred_at(成员 max),hit 透传
  latestSignalOccurredAt(lead/daysSince 仍锚最早,紧迫度口径不变)
- engine:抑制集 Set<key> → Map<key, 结案锚点>;锚=结案 execution.createdAt(不可变,
  不用 updatedAt——会被召回反馈等后续写顶后);同 key 多次结案取最新锚
- 过滤:key 命中且 latest > anchor → 放行复活;latest 缺省(旧 scenario)/锚不可解析
  (远未来哨兵)→ 维持旧行为全压,宁可多压不误放

测试:tests/plan-engine-snooze-anchor.spec.ts(锚点构建 5 例 + 逃逸判定端到端);
存量 plan-engine-batch 通过(mock 无 executions/updatedAt 走哨兵路径)。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

原则修正(用户指出):要求宿主把 tenant_id 别名成 brand_id 是把 PAC 的概念洁癖转嫁给
宿主;字段名差异的消化本就是适配层职责。宿主(导出与将来 push)一列不改名。

- export.sh:撤销全部 AS brand_id;Mongo 平铺同步 tenant_id
- manifest:identity_namespace_field: tenant_id(指向宿主原生列)。无功能冲突:PAC 租户
  由 manifest 静态 tenant_id: friday-market 决定,StaticTenantResolver 不读行,行级
  tenant_id(品牌 GUID)仅作 source_unit 命名空间源
- push 契约文档:brand_id → tenant_id(宿主原生列),通用约定写明概念区分责任在 PAC

零数据翻腾证明:幂等键/患者唯一键用 source_unit 的值(品牌 GUID),列名不参与 ——
原生列名重导+重摄实测:0 新 txn/357,931 全量幂等命中/0 新 fact/failed=0,
source_unit 分布逐品牌不变。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Push 通道形态 A 在 FRIDAY 宿主的具体化:每个 source 的 JSON 字段清单(类型/必填/语义),
形状与已验证的存量摄入(10.7 万患者/36 万事实)完全一致 → 宿主按此推送与存量无缝衔接
(幂等去重/版本演进/重叠无害)。

- 通用约定:id 一律字符串(存量实测坑)/updated_gmt_at 必须 bump(幂等键一半)/
  brand_id=源 tenant_id 改名/at-least-once
- 患者关系 3 source(含 upsert 主体待 PAC 排期的如实标注)/预约/病历链 3(含 diag/treat
  数组元素结构与 status∈{3,4} 推送范围)/结算链 4(status 拆分规则钉死)/计划咨询 3
- 待 FRIDAY 确认清单:两套关系码枚举/treat 语义/结算剩余 status

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

统一动机:jvs-dw(拉)存量跑写 cursor_after=run_start 供首次增量接力;FRIDAY(file)
此前不写 —— 差异根源不是流程分叉(finally 记账本就单点共用),而是 incremental.per_query
声明寄生在 sql_source 之下,file 源无处声明水位列。

- manifest.schema:IncrementalDeclSchema 抽名;sql_source.incremental 引用之(形状不动),
  manifest 顶层新增可选 incremental(file 源用;两处都写时 sql_source 内优先)
- cold-import:入口一行 ?? 兜底(sql_source 优先短路)——之后读写 cursor 走完全同一段
  finally,零新逻辑。file 装载路径不消费水位(loadAllTables 文件分支忽略 incremental
  参数,全量装载幂等去重),水位纯记账,供 delta 导出 WHERE 模板 / push 回放起点
- friday manifest:顶层声明 12 张事件表 updated_gmt_at(字典表/contacts 无更新列不列)

验证:tsc 0 err;jvs-dw 零影响(manifest 未动 + ?? 短路 + dry-run Cursor 解析行为不变);
friday 实跑 sync_logs 首次产出 cursor_after={12 表 × run_start ISO}。
心智模型统一:所有宿主存量跑即水位创世写入,差别只剩水位消费方。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

- patient_relation ← customer_referee_circle(10,169 行,双向成对存):患者-患者边进
  patient_relations 独立表(同 jvs-dw 契约,电话簿语义不冒充关系边)。
  ⚠️ 关系码字典 DB 无表(疑代码硬编码)→ 统计推断解码(互逆对+年龄差+性别三重证据,
  依据全在 yaml 注释):1=spouse(92%异性同龄)/8,7=friend/3=父母按对方性别拆
  father,mother(transforms lookup 对方 sex 拼"码|性别"键)/2,10=child(儿×女)/
  17,16=grandparent,grandchild/4,9=sibling/其余 other。待 FRIDAY 官方枚举校正,
  改 enum_mapping 重摄即覆盖。
- consultation ← customer_consult(64 行):意向 potential_treatment + FRIDAY 独有
  未成交原因 unsettled_reason(强召回信号)passthrough 进 content。
- 落库:关系边 7,996 条(friend 3511/other 2322/spouse 639/child 630/mother 349/
  father 266/sibling 229/祖孙 50),100% linked(对方均在册患者)→ guardian 链路
  (儿童触达取家长真名真号)对 FRIDAY 直接激活;consultation 64;failed=0。
- 退费第三轨(status=3 负额 200 单)测试库恢复后补摄完成:refund_record 齐 880
  (99 整单反向+581 行级+200 负额冲减),全程幂等。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

customer_contacts.relationship(13.3 万行,57.6% 填充,host sys_dict 编码 1-9)随 phone
lookup 同源带出 → patient canonical passthrough → preferences.contactPhone
{relationshipCode, isSelf: 码=='1'}。零 schema 迁移(preferences Json 收纳,同 dedicatedCs)。

编码语义用本地数据统计自证(年龄分桶):1=本人(成人 78.7%/儿童仅 51.4%——儿童过半
代接号,触达该打家长);3/2 儿童特异=父母类;8 老人特异=子女类;9 全人群恒定≈其他。
完整标签待测试库恢复读 sys_dict 后在 patient.yaml enum_mapping 补解码,管道零改动。
jvs-dw 不映射 phoneRelationshipCode → 行为分毫不变。

落库验证:107,227 患者 upsert,contactPhone 44,293(本人 40,059/代接 6,234... 按码分布
与统计一致);儿童样例(2015/2018 生)代接码 2/3 符合预期。
消费端(guardian/话术标注)待字典解码后一并接,避免半吊子 UX。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

结算源 arrail-settlement-server(全品牌覆盖,实测钉死语义):
- payment ← patient_settlement status∈{1,3} 且金额≥0(67,355 单):amount=receivable_this
  (应收=业务价值,jvs-dw 同款 LTV 决策);主导支付通道 lookup settlement_modes(金额最大者);
  encounterExternalId=registration_id。
- 退费三轨(比 jvs-dw 双轨多一轨,宿主表达差异):
  ① status=4 整单反向(99 单,全负额)⭐ paymentExternalId=ref_settlement_id 精确挂回原单
    (兑现 jvs-dw refund.yaml 预留的升级);
  ② spec is_refund=1 行级部分退费(581 行,全归属 status=3 头单,头单仍作 payment,LTV 自然对账);
  ③ status=3 负金额整单冲减(200 单,2ac96f6d 品牌不用 status=4 的表达)——被 amount_cents>=0
    校验正确拦截后归轨,导出侧 WHERE 按金额正负切分(transforms filter 不支持数值比较)。
- 其余 status(0/2/5/6/7/8)语义未明先不收。不从 settlement 反推治疗(财务≠临床)。

已验证:payment 67,155 + refund 99+581 facts 落库 failed=0。
待收尾:轨③ 200 单补摄等 FRIDAY 测试库恢复(宕机中,已挂探针;导出为空防护拦住了脏摄入)。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

补 Phase 1 缺口(与 jvs-dw C.3 同语义):treat[] normalize 后 route_by_pattern
① 建议/推荐 → recommendation(共享 recommendation-code 字典;实测 153 行全部翻出召回码:
   拔除 69 / RCT 49 / 冠 15 / 充填 9 / 种植 3 / SRP 1,仅 7 行长尾落空)
② 流程/复查/行政词 → treatment_review(category=review 哨兵;chain S4"已复查"信号)
③ 其余 → actual。拆线(50 行)按 jvs-dw 2026-06-11 一线判例排除出 review 词表 →
   actual→本地 enum 拆线→surgical(判例与 route 语境耦合,留宿主本地不入共享)。

external_id 沿用原始 value(与已摄入数据幂等键连续):重摄 failed=0,老 fact 全量
unchanged;之前被 keyword 误收进 actual 的"牙周复查"类 6 行经版本流 supersede 自动
纠正为 review,无残留。终态新增 recommendation_record 153 + review 56。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>