@pisell/private-materials 6.12.168 → 6.12.170

package/lib/components/HDLKiosk/docs/01-/346/240/270/345/277/203/350/277/220/350/241/214/346/234/272/345/210/266.md

@@ -32,7 +32,7 @@ Screen Renderer 根据当前节点与最新 Projection 渲染
 
 | 状态类型 | 例子                                               | 所有者           | 为什么不能混用                               |
 | -------- | -------------------------------------------------- | ---------------- | -------------------------------------------- |
-| 业务事实 | Cart、Customer、Summary、Payment                    | Host/OS          | 前端推测会产生重复支付、假优惠或脏订单       |
+| 业务事实 | Cart、Customer、Summary、Payment                   | Host/OS          | 前端推测会产生重复支付、假优惠或脏订单       |
 | 流程状态 | entry、nodeId、fulfillment 本地选择、session epoch | Workflow Runtime | 只回答“顾客处于哪一步”，不能证明订单已写成功 |
 | 展示输入 | options 选中项、搜索词、Modal 内选择               | Screen           | 可以随页面销毁，不得成为结账依据             |
 
@@ -40,31 +40,31 @@ Screen Renderer 根据当前节点与最新 Projection 渲染
 
 ## 2. 目录与运行时角色
 
-| 目录/文件                                                                     | 运行时角色                  | 输入                                         | 输出                                           | 解决的问题                                              |
-| ----------------------------------------------------------------------------- | --------------------------- | -------------------------------------------- | ---------------------------------------------- | ------------------------------------------------------- |
-| [`contracts/`](../contracts)                                                  | Core 与任意 Host 的最小协议 | 无宿主实现                                   | DTO、Port、Capability、Result、Workflow schema | 防止 BigSale/SalesSDK 类型渗入整个物料                  |
-| [`kernel/`](../kernel)                                                       | 无 UI 运行内核              | 注入的 Registry、Policy、Runner、Lifecycle    | Application API、Compiler、Actor、通用 Coordinator | 复用执行机制，同时阻断商家业务和 Host 反向依赖       |
-| [`slices/`](../slices)                                                      | HDLKiosk 业务切片           | Slice 定义、View、Screen/Dialog              | 可复用业务能力与其本地界面                       | 一个业务能力的规则、私有写入和界面同置                     |
-| [`app/manifest.ts`](../app/manifest.ts)                                     | 应用唯一装配点              | Slices、Workflows、应用级 Operations         | Activity/Operation/Workflow Manifest            | 自动收集依赖并在启动前验证引用完整性                      |
-| [`app/workflow/`](../app/workflow)                                          | 三入口业务编排与本地策略    | Activity 数组与特殊分支                         | Quick/Barcode/Scale Definition                  | 流程顺序集中在应用目录，不和 Slice 实现混杂               |
-| [`runtime/createWorkflowSession.ts`](../runtime/createWorkflowSession.ts)     | 一次点餐会话的组合根        | entry、Host、locale、可选 Lifecycle 扩展      | Kernel 与 HDLKiosk 业务实现的稳定组合           | 避免页面各自创建状态机或副作用执行器                    |
-| [`app/workflow/registry.ts`](../app/workflow/registry.ts)                    | Activity Registry 类型视图  | Application Manifest                         | 带 HDLKiosk 字面量类型的 Registry                | Runtime 不再维护第二份 Activity 清单                    |
-| [`kernel/workflow/compiler.ts`](../kernel/workflow/compiler.ts)              | Definition 结构校验         | Workflow Definition + 注入的 Registry        | 冻结后的可执行 Definition 或 issues            | 防止未知 Intent、非法跳转和无界循环进入 Actor           |
-| [`app/workflow/policy.ts`](../app/workflow/policy.ts)                        | HDLKiosk 业务策略校验       | 编译后的 Definition                          | 支付门禁等业务 issues                          | 结构规则不与具体交易策略混在一起                        |
-| [`kernel/workflow/actor.ts`](../kernel/workflow/actor.ts)                     | 单会话流程执行器            | Activity Intent、Navigation、Definition、Runner | WorkflowSnapshot、Transition                 | 解决双击、乱序导航和 Exit Command 完成前跳页            |
-| [`runtime/domainTransitionRunner.ts`](../runtime/domainTransitionRunner.ts)   | Activity 离开策略执行器     | Exit Policy、Host Projection、Coordinator    | advance/stay/blocked、支付回执                 | Actor 不理解 Predicate、购物车和支付 Operation          |
-| [`runtime/workflowLifecycle.ts`](../runtime/workflowLifecycle.ts)             | 已提交状态的业务生命周期出口 | Actor 提交后的 Snapshot                     | telemetry                                      | 诊断不进入状态机内核                                    |
-| [`kernel/operations/coordinator.ts`](../kernel/operations/coordinator.ts)     | 通用副作用调度器            | Operation request + 应用 Policy              | 规范化 OperationResult                         | 解决重复 intent、排队、超时和旧 Promise；不认识支付     |
-| [`app/operations.ts`](../app/operations.ts)                                  | 共享 Operation 公共入口     | 跨 Slice Operation 与执行策略                | 稳定的统一导出面                               | 避免消费者穿透私有实现目录                              |
-| [`app/operations/coordinator.ts`](../app/operations/coordinator.ts)          | HDLKiosk Operation Policy   | Host、支付门禁、冲突域、遥测                  | 绑定业务语义的 Coordinator                      | 把交易规则留在应用层而不是通用 Kernel                   |
-| [`app/operations/checkoutRequirements.ts`](../app/operations/checkoutRequirements.ts) | 支付前业务要求注册 | Requirement ID、Workflow Context、Projection | 当前适用 ID 与校验结果                         | 新增采集事实时不改 Checkout 主流程                      |
-| [`runtime/controllers/`](../runtime/controllers)                             | React 生命周期协调          | Host、Config、Projection、Actor              | session/device/customer 状态                   | 将根组件中的生命周期职责拆开                            |
-| [`runtime/HDLKioskWorkflowView.tsx`](../runtime/HDLKioskWorkflowView.tsx)     | 活跃会话 UI 编排            | Controllers、Projection、Actor snapshot      | Renderer、Shell、全局 Dialog props             | 防止根组件和具体 Screen 混入运行时协调逻辑              |
-| [`devices/`](../devices)                                                      | 设备入口治理                | 标准化扫码/称重事件                          | accept/reject、entry claim                     | 解决首页多入口竞争、重复事件和错误页面消费              |
-| [`devices/scale/`](../devices/scale)                                         | 顶层称重快照                | Adapter 发布的秤状态                         | 全生命周期统一 Scale Snapshot                  | 让 Entry 和详情页共享同一秤连接，不反复挂卸原生 Hook    |
-| [`app/ScreenRenderer.tsx`](../app/ScreenRenderer.tsx)                        | Workflow 到 Slice View 装配 | Definition、Snapshot、View Context           | 当前 View 与 modal base                        | 页面不参与中央流程判断                                  |
-| [`components/`](../components)                                               | 共享 Shell、Overlay 与控件  | 只读 ViewModel、语义 callback                 | 跨 Slice React UI                               | 共享视觉能力不反向拥有商家流程                          |
-| [`testing/`](../testing)                                                      | 可替换 Host                 | fixture、可控异步结果                        | Fake Host、调用记录                            | 不启动 BigSale 也能确定性验证 Core                      |
+| 目录/文件                                                                                     | 运行时角色                         | 输入                                            | 输出                                               | 解决的问题                                           |
+| --------------------------------------------------------------------------------------------- | ---------------------------------- | ----------------------------------------------- | -------------------------------------------------- | ---------------------------------------------------- |
+| [`app/contracts/`](../app/contracts)                                                          | Application 与任意 Host 的最小协议 | 无宿主实现                                      | DTO、Port、Capability、Result、Workflow schema     | 防止 BigSale/SalesSDK 类型渗入应用层                 |
+| [`kernel/`](../kernel)                                                                        | 无 UI 运行内核                     | 注入的 Registry、Policy、Runner、Lifecycle      | Application API、Compiler、Actor、通用 Coordinator | 复用执行机制，同时阻断商家业务和 Host 反向依赖       |
+| [`slices/`](../slices)                                                                        | HDLKiosk 业务切片                  | Slice 定义、View、Screen/Dialog                 | 可复用业务能力与其本地界面                         | 一个业务能力的规则、私有写入和界面同置               |
+| [`app/manifest.ts`](../app/manifest.ts)                                                       | 应用唯一装配点                     | Slices、Workflows、应用级 Operations            | Activity/Operation/Workflow Manifest               | 自动收集依赖并在启动前验证引用完整性                 |
+| [`app/workflow/`](../app/workflow)                                                            | 三入口业务编排与本地策略           | Activity 数组与特殊分支                         | Quick/Barcode/Scale Definition                     | 流程顺序集中在应用目录，不和 Slice 实现混杂          |
+| [`runtime/session/createSession.ts`](../runtime/session/createSession.ts)                     | 一次点餐会话的组合根               | entry、Host、locale、可选 Lifecycle 扩展        | Kernel 组合与 Payment Projection 桥接              | 避免页面创建状态机或驱动业务流程                     |
+| [`app/workflow/registry.ts`](../app/workflow/registry.ts)                                     | Activity Registry 类型视图         | Application Manifest                            | 带 HDLKiosk 字面量类型的 Registry                  | Runtime 不再维护第二份 Activity 清单                 |
+| [`kernel/workflow/compiler.ts`](../kernel/workflow/compiler.ts)                               | Definition 结构校验                | Workflow Definition + 注入的 Registry           | 冻结后的可执行 Definition 或 issues                | 防止未知 Intent、非法跳转和无界循环进入 Actor        |
+| [`app/workflow/policy.ts`](../app/workflow/policy.ts)                                         | HDLKiosk 业务策略校验              | 编译后的 Definition                             | 支付门禁等业务 issues                              | 结构规则不与具体交易策略混在一起                     |
+| [`kernel/workflow/actor.ts`](../kernel/workflow/actor.ts)                                     | 单会话流程执行器                   | Activity Intent、Navigation、Definition、Runner | WorkflowSnapshot、Transition                       | 解决双击、乱序导航和 Exit Command 完成前跳页         |
+| [`runtime/session/transitionRunner.ts`](../runtime/session/transitionRunner.ts)               | Activity 离开策略执行器            | Exit Policy、Host Projection、Coordinator       | advance/stay/blocked、支付回执                     | Actor 不理解 Predicate、购物车和支付 Operation       |
+| [`runtime/session/workflowLifecycle.ts`](../runtime/session/workflowLifecycle.ts)             | 已提交状态的业务生命周期出口       | Actor 提交后的 Snapshot                         | telemetry                                          | 诊断不进入状态机内核                                 |
+| [`kernel/operations/coordinator.ts`](../kernel/operations/coordinator.ts)                     | 通用副作用调度器                   | Operation request + 应用 Policy                 | 规范化 OperationResult                             | 解决重复 intent、排队、超时和旧 Promise；不认识支付  |
+| [`runtime/index.ts`](../runtime/index.ts)                                                     | 共享 Runtime 公共入口              | Operation Handler 与 Session Factory            | 稳定的统一导出面                                   | 避免消费者穿透私有实现目录                           |
+| [`runtime/operations/coordinator.ts`](../runtime/operations/coordinator.ts)                   | HDLKiosk Operation Policy          | Host、支付门禁、冲突域、遥测                    | 绑定业务语义的 Coordinator                         | 把交易规则留在应用层而不是通用 Kernel                |
+| [`runtime/operations/checkoutRequirements.ts`](../runtime/operations/checkoutRequirements.ts) | 支付前业务要求注册                 | Requirement ID、Workflow Context、Projection    | 当前适用 ID 与校验结果                             | 新增采集事实时不改 Checkout 主流程                   |
+| [`ui/controllers/`](../ui/controllers)                                                        | React 生命周期协调                 | Host、Config、Projection、Actor                 | session/device/customer 状态                       | 将根组件中的生命周期职责拆开                         |
+| [`ui/HDLKioskWorkflowView.tsx`](../ui/HDLKioskWorkflowView.tsx)                               | 活跃会话 UI 编排                   | Controllers、Projection、Actor snapshot         | Renderer、Shell、全局 Dialog props                 | 防止根组件和具体 Screen 混入运行时协调逻辑           |
+| [`devices/`](../devices)                                                                      | 设备入口治理                       | 标准化扫码/称重事件                             | accept/reject、entry claim                         | 解决首页多入口竞争、重复事件和错误页面消费           |
+| [`devices/scale/`](../devices/scale)                                                          | 顶层称重快照                       | Adapter 发布的秤状态                            | 全生命周期统一 Scale Snapshot                      | 让 Entry 和详情页共享同一秤连接，不反复挂卸原生 Hook |
+| [`ui/ScreenRenderer.tsx`](../ui/ScreenRenderer.tsx)                                           | Workflow 到 Slice View 装配        | Definition、Snapshot、View Context              | 当前 View 与 modal base                            | 页面不参与中央流程判断                               |
+| [`components/`](../components)                                                                | 共享 Shell、Overlay 与控件         | 只读 ViewModel、语义 callback                   | 跨 Slice React UI                                  | 共享视觉能力不反向拥有商家流程                       |
+| [`testing/`](../testing)                                                                      | 可替换 Host                        | fixture、可控异步结果                           | Fake Host、调用记录                                | 不启动 BigSale 也能确定性验证 Core                   |
 
 ## 3. Root 与 Session 如何装配
 
@@ -83,26 +83,28 @@ Screen Renderer 根据当前节点与最新 Projection 渲染
 
 ```text
 SessionController.start(request)
-→ 校验 enabledEntries / capability / production readiness
-→ EntryArbiter.claim(request.entry)
-→ createHDLKioskWorkflowSession(entry, host, options)
+→ HDLKiosk Runtime 校验 enabledEntries / capability / production readiness
+→ Application Runtime manual/automatic Trigger
+→ Runtime Admission（HDLKiosk 最多一个活跃 Session）
+→ HDLKiosk Session Factory
+   → createHDLKioskWorkflowSession(entry, host, options)
    → hdlKioskApplication Manifest
-   → createHDLKioskOperationRegistry()（从 Slice/Manifest 自动收集）
+   → createHDLKioskOperationRegistry()（从 Runtime Binding 收集 Handler）
    → compileWorkflowStructure(builtInDefinition)
    → validateHDLKioskWorkflowPolicy(definition)
    → createOperationCoordinator(host, registry)
    → createHDLKioskTransitionRunner(host, coordinator)
    → createWorkflowActor(definition, runner, lifecycle)
-→ session.ensure
-→ Barcode：在尚未发布会话时执行 barcode.consume
-→ 入口准备成功后发布 active session；失败则释放入口 claim
+   → session.ensure
+→ Runtime Registry 发布 active Session；失败则不注册
 ```
 
 重要细节：
 
-- 同一个入口的并发 `start` 共享 `startPromiseRef`，不同入口不会抢占；
+- 同一个入口的并发 `start` 由 HDLKiosk Runtime 共享一个 Promise，跨入口竞争由 Runtime Admission 拒绝；
+- Runtime snapshot 是 Session / starting / start error 的唯一状态源，React Controller 只做生命周期适配，不再镜像 Registry 状态；
 - Barcode/Scale 是会话的外部入口，不是 Workflow Activity。Barcode Workflow 天然从 Catalog 开始，Scale Workflow 天然从 Fulfillment 开始；首个业务页 Back 因此落入会话级清单并回 Entry，无需“入口节点不可回访”或 history skip 特例；
-- Host 引用变化会销毁旧 Actor，并重置 arbiter/ingress；
+- Host 引用变化会 dispose 旧 Runtime/Actor，并重置 ingress；
 - capability 变化不会要求 Host 引用变化，因此不应销毁订单；
 - session reset 只有在 Host 写入器确认空订单且 consistency barrier 完成后，才 dispose Actor、释放入口并回到 Entry；React Projection 只负责随后收敛展示，不反向否定 Host receipt。
 
@@ -160,7 +162,7 @@ Projection 的职责是“读取和标准化”，不是新 Store：
 - 不把 callback 成功直接变成支付成功；
 - 不把本地 fingerprint 当成服务端 revision。
 
-[`useHostSnapshot.ts`](../runtime/useHostSnapshot.ts) 用 `useSyncExternalStore` 消费 Projection。BigSale 接入主要依赖父级 Context rerender，其他外部事实可通过 Adapter 的显式订阅触发。
+[`ui/snapshots.ts`](../ui/snapshots.ts) 用 `useSyncExternalStore` 消费 Projection。BigSale 接入主要依赖父级 Context rerender，其他外部事实可通过 Adapter 的显式订阅触发。
 
 ## 6. Slice、Workflow 与 Actor
 
@@ -182,7 +184,7 @@ Workflow 用有序 Slice 数组描述静态编排。数组顺序是默认主路
     customizationSlice,
     fulfillmentSlice,
     paymentMethodSlice,
-    { slice: paymentCompletedSlice, end: 'success' },
+    { slice: paymentCompletedSlice, isTerminal: true },
   ],
 }
 ```
@@ -198,7 +200,7 @@ Workflow 作者不会填写 Screen、Predicate、Operation 或 failureTarget；
 
 Slice 在一条流程只出现一次时，Step ID 默认就是 Slice ID；同一 Slice 多次出现时，每次必须显式使用 `slice:用途`，例如 `catalog:initial`、`catalog:final`。这样既保持常规流程易读，也不会把复用能力误认为同一个运行位置。
 
-Slice Intent 使用 `next()`，或在 `intentPrecondition/effect` 上声明 `navigate: 'next'`，决定相邻 Step 的默认移动。不会自动前进的 Intent 只在 Workflow `on` 中指定目标。Back 是独立 Navigation，由 Actor 的实际页面历史解析。没有下一项的 Step 不会被推测为成功，必须声明 `end: 'success' | 'blocked'`。
+Slice Intent 使用 `next()`，或在 `intentPrecondition/effect` 上声明 `navigate: 'next'`，决定相邻 Step 的默认移动。不会自动前进的 Intent 只在 Workflow `on` 中指定目标。Back 是独立 Navigation，由 Actor 的实际页面历史解析。没有下一项的 Step 不会被自动推测为合法终点，必须声明 `isTerminal: true`。`isTerminal` 只表达 Workflow 图结构，不表达具体业务的成功或失败结果。
 
 Predicate 是本地可信的纯真假判断，例如 `cart.notEmpty`；Intent Precondition 表示某个 Intent 提交前必须满足的 Predicate。作者 API 使用 `intentPrecondition(predicateId)`，底层行为记录 `{ kind: 'precondition', predicate }`，编译后存入 `exitPolicy.precondition`。Predicate 只返回 boolean；它与能返回 `allow | bypass | cancel | redirect | defer | block` 的 Navigation Guard 是两套独立能力。
 
@@ -214,7 +216,7 @@ Step ID 只标识“一次出现”。Runtime 判断加载哪类数据、是否
 
 [`slices/<name>/slice.ts`](../slices) 是本地可信 Slice 定义，每个 Slice 声明：
 
-- 业务 Activity 使用哪个 `screen.id`，以及该 Screen 的 `view`；
+- 业务 Activity 使用哪个 `surface.id`，以及该 Screen 的 `view`；
 - 可以接受哪些 Intent；
 - 支持 page 还是 modal；
 - 某个 Intent 是否需要纯 Predicate 作为 Precondition；
@@ -222,28 +224,30 @@ Step ID 只标识“一次出现”。Runtime 判断加载哪类数据、是否
 - Screen 内有哪些不会离开节点的 Command；
 - 使用该 Slice 的流程在支付前需要哪些业务事实。
 
-例如 `identity.complete` / `identity.omit` 可在携带输入时执行 `identity.sync`，`customization.complete` 执行主商品同步，`paymentMethod.complete` 检查 Host 已确认支付成功。EFTPOS 派发和店员支付授权是 Payment 页面 Command，不作为流程 Intent。`defineKioskApplication` 从 Slice 自动生成 Activity Contract 与 Operation 注册信息；远端定义只看到 `Slice ID + 标准 Intent → target`，不能替换这些安全规则。
+例如 `identity.complete` / `identity.omit` 可在携带输入时执行 `identity.sync`，`customization.complete` 执行主商品同步，`paymentMethod.complete` 检查 Host 已确认支付成功。EFTPOS 派发和店员支付授权是 Payment 页面 Command，不作为流程 Intent。`defineApplication` 从 Slice 自动生成 Activity Contract 与 Operation 注册信息；远端定义只看到 `Slice ID + 标准 Intent → target`，不能替换这些安全规则。
 
-Slice 的业务定义与 React View 分离：Slice `id` 是 Workflow 和 Actor 使用的业务 Activity；`screen.id` 会被 Compiler 复制为 Workflow Node 的 `screenId`，供 Shell、Controller 和数据加载策略使用；`app/views.ts` 按 Activity 注册本地可信 View。各 Slice 的 `view.tsx` 仍负责 ViewModel 派生与组件装配，但不会进入 `defineSlice` 或 Workflow Definition。
+Slice 的业务定义与 React View 文件分离但按 feature 并置：Slice `id` 是 Workflow 和 Actor 使用的业务 Activity；`surface.id` 会被 Compiler 复制为 Workflow Node 的 `surfaceId`，供 Shell、Controller 和数据加载策略使用；`ui/views.ts` 按 Activity 注册本地可信 View。各 Slice 的 `view.tsx` 仍负责 ViewModel 派生与组件装配，但不会进入 `defineSlice` 或 Workflow Definition。
 
-| Slice 定义 | 编译/运行期形态 | 唯一用途 |
-| --- | --- | --- |
-| `id` | Node `activity` | 业务状态、Intent 和流程编排 |
-| `screen.id` | Node `screenId` | Shell 变体、数据加载和页面类别判断 |
-| `app/views.ts` 中的 Activity 映射 | 仅应用展示层使用 | React UI 渲染 |
+| Slice 定义                       | 编译/运行期形态  | 唯一用途                           |
+| -------------------------------- | ---------------- | ---------------------------------- |
+| `id`                             | Node `activity`  | 业务状态、Intent 和流程编排        |
+| `surface.id`                     | Node `surfaceId` | Shell 变体、数据加载和页面类别判断 |
+| `ui/views.ts` 中的 Activity 映射 | 仅应用展示层使用 | React UI 渲染                      |
 
-因此 `id`、`screen` 和 `view` 不互相替代：`catalog` 是商品浏览页面，`primaryProductPrompt` 是覆盖在 Catalog 上的独立 Modal Slice。店员支付授权不改变当前页面，因此是 `paymentMethod` 的 Screen Command，而不是独立 Activity。Application Manifest 是业务运行 Contract 的唯一索引，`app/views.ts` 是展示实现的唯一索引。View 使用同步本地组件引用，不产生运行期 UI chunk；纯 Compiler/Actor 依赖链也不会加载该注册表。Renderer 若发现 View 缺失，仍使用 `BlockingNotice` fail closed，且不会改变 Workflow。
+因此 `id`、`screen` 和 `view` 不互相替代：`catalog` 是商品浏览页面，`primaryProductPrompt` 是覆盖在 Catalog 上的独立 Modal Slice。店员支付授权不改变当前页面，因此是 `paymentMethod` 的 Screen Command，而不是独立 Activity。Application Manifest 是业务运行 Contract 的唯一索引，`ui/views.ts` 是展示实现的唯一索引。View 使用同步本地组件引用，不产生运行期 UI chunk；纯 Compiler/Actor 依赖链也不会加载该注册表。Renderer 若发现 View 缺失，仍使用 `BlockingNotice` fail closed，且不会改变 Workflow。
 
-`slices/index.ts` 对整套 Slice 清单执行一次类型约束：`screen.id` 只能取 HDLKiosk 的非 Entry `ScreenId`。`app/views.ts` 使用完整的 `Record<ActivityId, HDLKioskSliceView>`，因此新增 Activity 若没有注册 View 会产生类型错误。Kernel 的 `defineSlice` 同时拒绝空 `screen.id`。
+`slices/index.ts` 对整套 Slice 清单执行一次类型约束：`surface.id` 只能取 HDLKiosk 的非 Entry `ScreenId`。`ui/views.ts` 使用完整的 `Record<ActivityId, HDLKioskSliceView>`，因此新增 Activity 若没有注册 View 会产生类型错误。Kernel 的 `defineSlice` 同时拒绝空 `surface.id`。
 
-Compiler 从实际使用的 Slice 汇总 Checkout Requirement ID，但不把判断函数或 Host 字段写入 Workflow。当前 HDLKiosk 默认注册表为空；未来增加其他业务要求时仍由 [`checkoutRequirements.ts`](../app/operations/checkoutRequirements.ts) 集中判断。
+Compiler 从实际使用的 Slice 汇总 Checkout Requirement ID，但不把判断函数或 Host 字段写入 Workflow。当前 HDLKiosk 默认注册表为空；未来增加其他业务要求时仍由 [`checkoutRequirements.ts`](../runtime/operations/checkoutRequirements.ts) 集中判断。
 
 `WorkflowEvent` 同时约束 Activity、Intent 和必要输入：例如 `identity.omit` 必须携带身份输入，`fulfillment.complete` 必须携带 fulfillment context patch。Back 使用不携带业务输入的 `NAVIGATE_BACK`。Barcode 入口的条码输入不是 Workflow Event，而是 Session Controller 在发布会话前交给 `barcode.consume` 的 Command 输入。Screen Command 由 `OperationInputMap` 约束 Command ID 与输入类型。
 
 Step 可选声明 Modal 展示关系：
 
 ```ts
-presentation: { mode: 'modal' }
+presentation: {
+  mode: 'modal';
+}
 ```
 
 这只控制渲染层级。Actor Surface 保留进入 Modal 前实际展示的 Page，Workflow 不指定背景 Step。Compiler 会拒绝以 Modal 作为首节点或 Modal 直接进入另一个 Modal。
@@ -261,7 +265,7 @@ presentation: { mode: 'modal' }
 - 指向自身或更早 Step 的非 Back 跳转是否声明有限 `repeat`；
 - Modal presentation 引用是否合法。
 
-结构校验通过后，Compiler 还会将所有 Step 对应 Activity 的 `checkoutRequirements` 去重汇总到编译结果。该字段是本地 Activity Contract 的派生值，不是 Workflow Definition 的作者输入。
+结构校验通过后，Compiler 还会将所有 Step 对应 Activity 的通用 `requirements` 去重汇总到编译结果。Kernel 不解释这些 ID；HDLKiosk Domain 再把其中的 Checkout Requirement 交给本地注册表校验。该字段是 Activity Contract 的派生值，不是 Workflow Definition 的作者输入。
 
 随后 `policy.ts` 校验 HDLKiosk 交易规则，例如 `checkout.open` 必须来自
 `paymentMethod`，并且该支付步骤必须具有本地 Checkout Prepare 门禁。两类校验都在
@@ -273,7 +277,7 @@ session 创建前完成，但结构错误与业务安全错误保持独立。
 
 Actor 使用单 mailbox：
 
-1. 忽略 success end、blocked 或 disposed 后的新事件；
+1. 忽略 terminal、blocked 或 disposed 后的新事件；
 2. 同时校验事件的 `stepId` 和 `activityId`，拒绝旧 Screen 或同类 Activity 旧实例的迟到回调；
 3. 校验 Intent 是否由当前 Activity 暴露，并查找 Transition；Back 则读取页面历史；
 4. 通过注入的 Context Reducer 合并受限 contextPatch；
@@ -285,15 +289,15 @@ Actor 使用单 mailbox：
 
 结果到节点的映射：
 
-| OperationResult  | Actor 行为                                                    |
-| ---------------- | ------------------------------------------------------------- |
-| `succeeded`      | 进入 target                                                   |
-| `cancelled`      | 留在当前 Step                                                 |
-| `failed`         | 留在当前 Step，并展示可恢复错误                               |
-| `partialFailure` | 保留当前 Step，Actor 进入 blocked；命令可能只完成一部分       |
-| `unknown`        | 保留当前 Step，Actor 进入 blocked；不能确认副作用是否已经发生 |
+| OperationResult  | Actor 行为                                                                        |
+| ---------------- | --------------------------------------------------------------------------------- |
+| `succeeded`      | 进入 target                                                                       |
+| `cancelled`      | 留在当前 Step                                                                     |
+| `failed`         | 留在当前 Step，并展示可恢复错误                                                   |
+| `partialFailure` | 保留当前 Step 并展示错误；仅支付派发或 reset 等 P0 副作用进入 blocked             |
+| `unknown`        | 保留当前 Step 并展示错误；仅可能重复扣款、跨订单污染或 reset 不完整时进入 blocked |
 
-`blocked` 是运行时安全状态，不是可编排的 Activity。UI 在 Actor 阻塞时统一覆盖安全提示，因此 Workflow 中不存在为了显示错误而设置的伪业务节点。
+`blocked` 是运行时 P0 安全状态，不是可编排的 Activity。UI 在 Actor 阻塞时统一覆盖安全提示，因此 Workflow 中不存在为了显示错误而设置的伪业务节点。普通 Cart、Customer、Fulfillment 和支付前置校验的模糊结果停留原页并允许显式重试，不锁死整个 Actor。
 
 ## 7. Operation Registry 与 Coordinator
 
@@ -310,17 +314,17 @@ partialFailure/unknown 的 Screen Command 会通过 Actor 的 system block 入
 
 当前 Operation 组：
 
-| Operation                            | scope    | timeout | 核心职责                                                                               |
-| ------------------------------------ | -------- | ------- | -------------------------------------------------------------------------------------- |
-| `session.ensure/reset`               | session  | 15s     | 建立/清理订单并验证 reset                                                              |
-| `identity.sync`                      | customer | 15s     | 按 `customerId` 有无应用认证客户或清除订单客户，并执行 consistency、重报价和写后观察  |
-| `barcode.consume`                    | cart     | —       | 调宿主扫码 Flow；规格选择完成前不启动写后一致性检查                                    |
-| `cart.addProduct`                    | cart     | —       | 调宿主商品 Flow，等待规格或其它业务选择后验证写入                                      |
-| `cart.update/remove`                 | cart     | 15s     | 数量修改/删除、summary 重算和目标行验证                                                |
-| `product.syncPrimaryWeightedProduct` | cart     | —       | 首次写入可能等待 OS 额外业务弹窗；更新或写入后验证重量/options 和写后证据              |
-| `product.removePrimaryProduct`       | cart     | 15s     | 将主商品置为不存在；本来不存在时直接成功，存在时验证删除结果                |
-| `checkout.prepare*`                  | checkout | 20s     | fulfillment、cart、summary 稳定性与 token                                      |
-| `checkout.open`                      | checkout | 120s    | 消费 token、冻结危险写并打开 Host 支付                                                 |
+| Operation                            | scope    | timeout | 核心职责                                                                             |
+| ------------------------------------ | -------- | ------- | ------------------------------------------------------------------------------------ |
+| `session.ensure/reset`               | session  | 15s     | 建立/清理订单并验证 reset                                                            |
+| `identity.sync`                      | customer | 15s     | 按 `customerId` 有无应用认证客户或清除订单客户，并执行 consistency、重报价和写后观察 |
+| `barcode.consume`                    | cart     | —       | 调宿主扫码 Flow；规格选择完成前不启动写后一致性检查                                  |
+| `cart.addProduct`                    | cart     | —       | 调宿主商品 Flow，等待规格或其它业务选择后验证写入                                    |
+| `cart.update/remove`                 | cart     | 15s     | 数量修改/删除、summary 重算和目标行验证                                              |
+| `product.syncPrimaryWeightedProduct` | cart     | —       | 首次写入可能等待 OS 额外业务弹窗；更新或写入后验证重量/options 和写后证据            |
+| `product.removePrimaryProduct`       | cart     | 15s     | 将主商品置为不存在；本来不存在时直接成功，存在时验证删除结果                         |
+| `checkout.prepare*`                  | checkout | 20s     | fulfillment、cart、summary 稳定性与 token                                            |
+| `checkout.open`                      | checkout | 120s    | 消费 token、冻结危险写并打开 Host 支付                                               |
 
 ### 7.2 冲突矩阵
 
@@ -344,7 +348,7 @@ none     ↔ 不参与互斥
 - session epoch 变化后丢弃旧结果；
 - 调用应用注入的冲突、错误、Context 和生命周期 Policy。
 
-[`app/operations/coordinator.ts`](../app/operations/coordinator.ts) 只负责 HDLKiosk 交易语义：
+[`runtime/operations/coordinator.ts`](../runtime/operations/coordinator.ts) 只负责 HDLKiosk 交易语义：
 
 - 注入 `HDLKioskHost` 和最新 Workflow Context；
 - 定义 session/cart/customer/checkout 的冲突矩阵；
@@ -431,7 +435,7 @@ Shell Login
 
 ### 8.5 返回 Entry 能力接口
 
-当前物料不维护 idle 计时器或警告弹窗。Payment 成功展示在 Checkout Screen 内，10 秒倒计时或手动返回都调用 `returnToEntry(reason?)`：它对并发请求去重，执行 `session.reset`，验证 Host 空订单和一致性，再释放 Actor、Ingress 与 session epoch。
+当前物料不维护 idle 计时器或警告弹窗。Payment 成功展示在 Checkout Screen 内，10 秒倒计时或手动返回都调用 `returnToEntry(reason?)`：它对并发请求去重，执行 `session.reset`，并通过 Runtime snapshot 统一发布 `returning/returnError`；验证 Host 空订单和一致性后，再释放 Actor、Ingress 与 session epoch。
 
 未来应用级生命周期策略可以决定何时调用该接口，但不能直接清 React 状态或只切换页面。支付 pending/unknown、reset 失败等情况仍由既有安全策略 fail closed。
 
@@ -476,7 +480,7 @@ Core：Entry Ingress 负责去重、仲裁和启动会话；活跃 Screen 只消
 ```text
 HDLKiosk root
 → HDLKioskWorkflowView（运行时状态转 props）
-→ app/ScreenRenderer（按 Activity 查询 app/views.ts 中的本地 View）
+→ ui/ScreenRenderer（按 Activity 查询 ui/views.ts 中的本地 View）
 → slices/<name>/view + Screen/Dialog
 → components/shell + components/overlays + components/common
 → Activity Action callback
@@ -548,7 +552,7 @@ Entry click
 
 ```text
 CatalogScreen command(cart.addProduct)
-→ HDLKioskWorkflowView command router
+→ useHDLKioskActionDispatcher
 → session.executeCommand
 → Coordinator: cart.addProduct
 → Operation: Host addProduct
@@ -583,24 +587,26 @@ Scale 与 Quick 复用同一套称重商品原子操作和页面，差异只保
 → checkout.open consumes token
 → Checkout Safety freezes dangerous writes
 → Host result + Payment Projection
-→ result / failed / blocked
+→ Session Payment Projection bridge
+→ paymentMethod.complete 本地门禁
+→ paymentCompleted / failed / blocked
 ```
 
 ## 12. 修改需求应该落在哪里
 
-| 需求                  | 首选位置                                                   | 同步检查                                  |
-| --------------------- | ---------------------------------------------------------- | ----------------------------------------- |
-| 调整节点顺序          | `app/workflow/*.ts`                                        | 03 文档、definition/actor 测试            |
-| 新增跨 Slice 副作用   | `contracts` + `app/operations` + Host Port                 | conflict scope、timeout、unknown、adapter |
-| 新增 BigSale 字段映射 | BigSale Adapter                                            | Core DTO 是否真的需要扩展                 |
-| 新增设备来源          | Adapter Device Port                                        | Core Ingress 是否已有相同语义             |
-| 修改入口消费条件      | Device/Session Controller                                  | capability、payment freeze、dedupe        |
-| 修改页面局部交互      | `slices/<name>/Screen` + `view.tsx`                        | 不得直接调用 Host；样式留在组件目录       |
-| 新增业务 Dialog       | Slice `presentation` + `slices/<name>/Dialog`            | 不新增第二套导航状态                      |
-| 修改会话级 UI 协调    | `runtime/HDLKioskWorkflowView.tsx`                         | 不把 Controller/Actor 传入具体组件        |
-| 新增审计或持久化观察  | 外层 `WorkflowLifecycle` 扩展                              | 不得让 Kernel 依赖存储或恢复策略           |
-| 新增跨刷新恢复        | Kernel 外初始化决策模块 + Actor 初始状态                   | OS 事实、隐私、支付优先级、人工处置        |
-| 调整支付安全          | Kernel `checkoutSafety` + 业务 `checkout`                  | 必须更新 05 文档与集成测试                 |
+| 需求                  | 首选位置                                           | 同步检查                                  |
+| --------------------- | -------------------------------------------------- | ----------------------------------------- |
+| 调整节点顺序          | `app/workflow/*.ts`                                | 03 文档、definition/actor 测试            |
+| 新增跨 Slice 副作用   | `app/contracts` + `runtime/operations` + Host Port | conflict scope、timeout、unknown、adapter |
+| 新增 BigSale 字段映射 | BigSale Adapter                                    | Core DTO 是否真的需要扩展                 |
+| 新增设备来源          | Adapter Device Port                                | Core Ingress 是否已有相同语义             |
+| 修改入口消费条件      | Device/Session Controller                          | capability、payment freeze、dedupe        |
+| 修改页面局部交互      | `slices/<name>/Screen` + `view.tsx`                | 不得直接调用 Host；样式留在组件目录       |
+| 新增业务 Dialog       | Slice `presentation` + `slices/<name>/Dialog`      | 不新增第二套导航状态                      |
+| 修改会话级 UI 协调    | `ui/HDLKioskWorkflowView.tsx`                      | 不把 Controller/Actor 传入具体组件        |
+| 新增审计或持久化观察  | 外层 `WorkflowLifecycle` 扩展                      | 不得让 Kernel 依赖存储或恢复策略          |
+| 新增跨刷新恢复        | Kernel 外初始化决策模块 + Actor 初始状态           | OS 事实、隐私、支付优先级、人工处置       |
+| 调整支付安全          | Kernel `checkoutSafety` + 业务 `checkout`          | 必须更新 05 文档与集成测试                |
 
 ## 13. 当前刻意不做的抽象
 

package/lib/components/HDLKiosk/docs/02-Host/351/200/202/351/205/215/344/270/216/344/270/232/345/212/241/346/225/260/346/215/256.md

@@ -55,20 +55,21 @@ Core 不能反向 import BigSale；Adapter 不能决定下一个 Workflow 节点
 
 | 文件                                                                                                      | 具体职责                                                                   | 不应放入的逻辑                         |
 | --------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- | -------------------------------------- |
-| [`index.tsx`](../../bigSale/templates/HDLKiosk/index.tsx)                                                 | 合并 config、读取 Engine plugin、创建 Scale Hub/Runtime、装配 Host 和 Core | Workflow 节点、购物车操作              |
+| [`index.tsx`](../../bigSale/templates/HDLKiosk/index.tsx)                                                 | 合并 config、读取 Engine plugin、挂载 Scale Owner、装配 Host 和 Core       | Workflow 节点、购物车操作              |
 | [`primaryWeightedProduct.ts`](../../bigSale/templates/HDLKiosk/primaryWeightedProduct.ts)                 | 从 catalog list 的首条 data variant 解析称重主商品                         | 商品查询、隐式 fallback                |
 | [`types.ts`](../../bigSale/templates/HDLKiosk/types.ts)                                                   | 声明模板内部 `HDLKioskBigSaleHostBridge`，隔离尚未标准化的宿主窄能力       | BigSale 公共 Props、通用 SalesSDK 类型 |
 | [`adapter/useBigSaleHDLKioskHost.ts`](../../bigSale/templates/HDLKiosk/adapter/useBigSaleHDLKioskHost.ts) | 用 ref 持有最新 Context/bridge/scan handle，稳定 Host 引用                 | DTO 字段转换                           |
 | [`adapter/createHost.ts`](../../bigSale/templates/HDLKiosk/adapter/createHost.ts)                         | 组合 Sales/Device/Telemetry Port 和动态 capabilities                       | React 页面逻辑                         |
-| [`adapter/capabilities.ts`](../../bigSale/templates/HDLKiosk/adapter/capabilities.ts)                     | 将当前真实方法/bridge 组合为能力位                                         | 猜测业务成功                           |
-| [`adapter/projection.ts`](../../bigSale/templates/HDLKiosk/adapter/projection.ts)                         | Cart/Customer/Summary/Payment 标准化、lineId、fingerprint                  | 发命令、主动修订单                     |
-| [`adapter/sales.ts`](../../bigSale/templates/HDLKiosk/adapter/sales.ts)                                   | 实现全部 `HDLSalesPort` query/command，转换结果                            | 决定 target Screen                     |
-| [`adapter/weightedProduct.ts`](../../bigSale/templates/HDLKiosk/adapter/weightedProduct.ts)               | 解析称重商品、单位价格换算、验证重量、生成 prepared product                | 原生秤监听、页面状态                   |
-| [`adapter/customizationProduct.ts`](../../bigSale/templates/HDLKiosk/adapter/customizationProduct.ts)     | 安全投影单选 options、验证 selection、合成 SKU/options payload             | 通用商品详情 Flow                      |
-| [`adapter/devices.ts`](../../bigSale/templates/HDLKiosk/adapter/devices.ts)                               | 扫码/称重原始订阅转 `HDLDeviceEvent`，管理连接与释放                       | 判断当前 Workflow 是否消费             |
-| [`adapter/scaleTrigger.tsx`](../../bigSale/templates/HDLKiosk/adapter/scaleTrigger.tsx)                   | 隔离 `useNativeScale`、入口触发边沿、连接状态、共享 Scale Runtime          | 称重商品价格计算                       |
+| [`adapter/host/capabilities.ts`](../../bigSale/templates/HDLKiosk/adapter/host/capabilities.ts)           | 将当前真实方法/bridge 组合为能力位                                         | 猜测业务成功                           |
+| [`adapter/host/projection.ts`](../../bigSale/templates/HDLKiosk/adapter/host/projection.ts)               | Cart/Customer/Summary/Payment 标准化、lineId、fingerprint                  | 发命令、主动修订单                     |
+| [`adapter/sales/`](../../bigSale/templates/HDLKiosk/adapter/sales)                                       | 按能力实现 `HDLSalesPort` query/command，并在 `index.ts` 组合              | 决定 target Screen                     |
+| [`adapter/sales/weightedProduct.ts`](../../bigSale/templates/HDLKiosk/adapter/sales/weightedProduct.ts)   | 解析称重商品、单位价格换算、验证重量、生成 prepared product                | 原生秤监听、页面状态                   |
+| [`adapter/sales/customizationProduct.ts`](../../bigSale/templates/HDLKiosk/adapter/sales/customizationProduct.ts) | 安全投影单选 options、验证 selection、合成 SKU/options payload       | 通用商品详情 Flow                      |
+| [`adapter/devices/devicePort.ts`](../../bigSale/templates/HDLKiosk/adapter/devices/devicePort.ts)         | 扫码原始事件与 ScaleBridge 标准事件汇入 `HDLDevicePort`                    | 判断当前 Workflow 是否消费             |
+| [`runtime/scaleBridge.ts`](../../bigSale/templates/HDLKiosk/runtime/scaleBridge.ts)                       | 统一 Scale Snapshot、owner 身份与标准设备事件流                            | React Hook、称重商品价格计算           |
+| [`runtime/BigSaleScaleRuntimeOwner.tsx`](../../bigSale/templates/HDLKiosk/runtime/BigSaleScaleRuntimeOwner.tsx) | 隔离 `useNativeScale`，校验实时帧并发布给 ScaleBridge                 | Workflow 跳转、购物车写入              |
 | [`adapter/normalize.ts`](../../bigSale/templates/HDLKiosk/adapter/normalize.ts)                           | Host 错误与未知结果标准化、安全路径读取                                    | 业务重试策略                           |
-| [`adapter/telemetry.ts`](../../bigSale/templates/HDLKiosk/adapter/telemetry.ts)                           | 当前 no-op Telemetry Port，保留正式 sink 接口                              | `console` 散落埋点                     |
+| [`adapter/host/telemetry.ts`](../../bigSale/templates/HDLKiosk/adapter/host/telemetry.ts)                 | 当前 no-op Telemetry Port，保留正式 sink 接口                              | `console` 散落埋点                     |
 
 兼容层还扩展了 SalesSDK Products Context：
 
@@ -84,12 +85,12 @@ Core 不能反向 import BigSale；Adapter 不能决定下一个 Workflow 节点
 ```mermaid
 flowchart LR
   CTX["BigSaleContext\nsales / products / cart / customer / summary"]
-  BRIDGE["Internal HDLKioskBigSaleHostBridge\ncurrent: scale hub subscriptions\nreserved: member / fulfillment"]
+  BRIDGE["Internal HDLKioskBigSaleHostBridge\nscale event source / member / fulfillment"]
   PLUGIN["Engine nativeScaleTools"]
   REF["Stable source refs\nlatest context / bridge / scan"]
   PROJECTION["projection.ts\nObservedSalesSnapshot"]
   SALES["sales.ts\nHDLSalesPort"]
-  DEVICE["devices.ts + scaleTrigger.tsx\nHDLDevicePort / ScaleRuntime"]
+  DEVICE["devicePort.ts + ScaleBridge + ScaleOwner\nHDLDevicePort / ScaleRuntime"]
   CAP["capabilities.ts\ndynamic capability getter"]
   HOST["Stable HDLKioskHost"]
   CORE["Independent HDLKiosk Core"]
@@ -120,10 +121,10 @@ resolveHDLKioskBigSaleConfig
         ↓
 读取 Engine nativeScaleTools plugin
         ↓
-创建 ScaleTriggerHub + HDLScaleRuntime
+创建 ScaleBridge（内部统一 ownerId + HDLScaleRuntime + device events）
         ↓
 创建模板内部 internalBridge
-  └─ weight/connection 订阅来自 ScaleTriggerHub
+  └─ subscribeScaleEvents 来自 ScaleBridge
         ↓
 useBigSaleHDLKioskHost → stable HDLKioskHost
         ↓
@@ -338,25 +339,25 @@ acquireScanFocus(handler, { priority: 100, id: 'hdl-kiosk' })
 `useNativeScale` 是 Hook，不能直接塞进普通 Adapter 函数。`BigSaleScaleRuntimeOwner` 常驻模板顶层：
 
 - Hook `autoStart` 随物料 active；
-- 发布完整 Scale Snapshot 给 Core `HDLScaleRuntime`；
-- 发布连接状态和首次有效正重给 `ScaleTriggerHub`；
+- 通过 `ScaleBridge` 发布完整 Snapshot 给 Core `HDLScaleRuntime`；
+- 通过同一个 Bridge 发布连接状态和首次有效正重标准事件；
 - 重量回落到阈值下后才允许下一次入口触发；
 - Error Boundary 将 Hook 异常转成 scale error，不炸毁 HDLKiosk；
 - ownerId 防止多个发布者同时写同一 Runtime。
 
-内部 Bridge 的 `subscribeWeightChange/subscribeScaleConnection` 只承接 ScaleTriggerHub 的入口事件；当前详情实时读数和 capability 仍要求 `nativeScaleTools.useNativeScale`，不能把一个只发入口事件的 bridge 冒充完整称重能力。
+内部 Host Bridge 只暴露一个 `subscribeScaleEvents` 标准事件源；详情连续读数直接读取同一 `ScaleBridge.runtime`。Capability 仍要求 `nativeScaleTools.useNativeScale`，不能把一个没有真实 Hook 来源的 Bridge 冒充完整称重能力。
 
 ## 13. 模板内部 Narrow Host Bridge
 
 [`HDLKioskBigSaleHostBridge`](../../bigSale/templates/HDLKiosk/types.ts) 只承接尚未由 SalesSDK 标准化的能力。它有意声明在 `bigSale/templates/HDLKiosk` 内部，不从 `bigSale/types.ts` 导出，也不通过 `BigSaleProps → BigSaleBaseProps → BigSaleTemplateRendererProps` 透传。
 
-当前装配提供称重 Hub 订阅和 Identity H5 认证客户读取；履约字段仍是模板适配层的待接能力描述，并不存在外部调用方：
+当前装配提供 ScaleBridge 事件订阅和 Identity H5 认证客户读取；履约字段仍是模板适配层的待接能力描述，并不存在外部调用方：
 
 | Bridge                             | 契约要求                                    |
 | ---------------------------------- | ------------------------------------------- |
 | `getAuthenticatedCustomer`         | 按 customerId 读取模板内认证结果；只读，不在 UI 中写订单客户 |
 | `writeFulfillment`                 | 真正写入堂食/外带订单事实，不能只改 UI 参数 |
-| `subscribeWeightChange/Connection` | 可选入口触发覆盖，不替代详情 Scale Runtime  |
+| `subscribeScaleEvents`             | ScaleBridge 的标准入口事件；连续详情读数来自同一 Bridge Runtime |
 
 Bridge 使用 getter/ref 消费最新实例。新增字段前先判断它是否应成为 SalesSDK 正式能力；不要把业务对象塞进通用 metadata。
 
@@ -433,7 +434,7 @@ Abort 的时机很重要：dispatch 前可 cancelled；dispatch 后再 abort 通
 | 连续加购进入 checking              | Core cart consistency + SalesSDK barrier  | Host 屏障与 React pending 展示态是否混淆                     |
 | Catalog 加购时闪动                 | Shell/Screen busy presentation            | 是否全屏遮罩或全部卡片透明度变化，不先怀疑数据丢失           |
 | Scale 入口 unavailable             | plugin + capability + bridge gating       | `useNativeScale`、prepared product、queryProducts 是否齐全   |
-| Scale 有读数但不自动进入           | `scaleTrigger` + Core ScaleIngress        | 阈值、connection、重复边沿、当前 session lock                |
+| Scale 有读数但不自动进入           | `ScaleBridge` + Core ScaleIngress         | 阈值、connection、重复边沿、当前 session lock                |
 | 登录成功但金额不变                 | identity Operation + Summary Projection   | customer 是否写入、consistency/重报价是否完成                |
 | Checkout 后 blocked                | callback normalizer + Payment Projection  | 是明确 failed 还是 unknown，禁止直接放行                     |
 | 刷新后存在旧订单或支付状态         | Host/OS 订单与支付处置                    | 当前 OS payment/cart 事实与员工处置入口                       |