openxiangda 2.59.1 → 2.59.3-http.0

package/skills/openxiangda-v2/references/workflow-events.md

@@ -620,6 +620,31 @@ outbox容量等事务故障会回滚，处理器按原键核对后重交，不
 等待处理器的失败从原事件管理受控重放，保留原执行键。普通详情只显示安全状态
 摘要；原输入、输出和外部回执不放入普通时间线。
 
+### 在固定步骤内写入业务数据 {#step-data-transaction}
+
+审批中途需要更新台账时，使用 `reconciled-effect` 动作，并在固定 `handler` 上声明
+`dataTransaction: true`。编译器自动要求 `workflow.step-data-transaction@1.0.0`，
+标记进入签名处理器合同；旧具名版本不可直接改变，增加新版本时保留原实现。
+
+在已验证并领取的事件处理器内，注入 `OpenXiangdaApplicationDataApiService`。
+`reconcile` 先调用 `resolveWorkflowStepData()`：`committed` 用原事务结果重建固定
+`output/receipt`，`not_observed` 返回 `not-executed`，响应未知或失败保留原执行键。
+`handle` 调用 `commitWorkflowStepData({ guards, operations })`。执行ID从事件上下文
+取得，应用不传人、角色、下一节点或幂等键。每个 execution 只允许一个 Native 事务，
+内容不同返回冲突；普通事务不能使用保留的 `workflow-step:` 键。
+
+计划必须包含流程 subject 的 `record-match` 或 `record-assert` guard，其 `revision`
+等于事件数据的固定 `dataRevision`。Native 继续强制来源读取权限、目标写入权限和
+CAS；此接口不能直接修改流程 subject，任务补填仍使用原任务页面。数据计划遵循
+Native 的2016操作、2MiB限制，不支持 decimalReservation 或排队命令。复用原应用
+`data:read/data:write/data:transaction` 权限，不额外授予全校数据读取。
+
+平台先取得环境围栏、实例和步骤锁，再检查有效投递/领取租约，最后执行数据计划。
+业务行、数据事件、Native回执和步骤的回执引用一起提交；任一行失败或租约过期全部
+回滚。取消先取得锁时拒绝新写；数据先提交后取消、换阶段或换Head，resolve仍恢复
+同一原回执。原回执缺失时明确拒绝，不能以未知结果为由重新写入。步骤输出和后续
+流转继续由原事件回执处理，晚拒绝不自动撤销已写台账；补偿属于应用显式业务规则。
+
 ## 代码任务页面与补填 {#task-page-submit}
 
 需要办理人补填时，在定义的 `taskPages` 声明命名页面，审批节点以

package/releases/2.55.1.json

@@ -1,32 +0,0 @@
-{
-  "schemaVersion": "openxiangda.release-notes/v1",
-  "version": "2.55.1",
-  "status": "reviewed",
-  "title": "持久原结果恢复与流程字段策略修复",
-  "summary": "已受理命令的短读取超时不会提前终止原三十分钟观察；同步主线的条件必填错误清理和冻结的选填撤回原因策略。",
-  "newFeatures": [
-    "固定流程定义支持 instanceCommands.withdraw.reasonRequired:false；省略仍必填，新声明要求 workflow.optional-withdrawal-reason@1.0.0。"
-  ],
-  "fixes": [
-    "已受理 durable 原结果查询收到 SDK 明确标记可恢复的短读取预算耗尽后，在原绝对截止前按退避继续只读查询；不重放提交。",
-    "另一字段解除条件必填后清除 SDK 自己生成的旧必填错误，保留其他客户端、子表和服务端错误。"
-  ],
-  "affectedUsers": [
-    "使用 durable 持久命令的热点报名应用和包含条件必填或撤回策略的 V2 流程。"
-  ],
-  "upgradeSteps": [
-    "使用正式精确版本升级应用 SDK；原结果恢复无需更改服务端协议。",
-    "使用选填撤回原因时，平台必须具备对应能力；已有实例继续使用冻结版本。"
-  ],
-  "knownLimitations": [
-    "一次读取仍最多两分钟，总观察仍为原三十分钟；权限、依赖和普通网络错误不会被自动隐藏。",
-    "容量必须在目标硬件上独立测量；单元验证不能证明万人或浏览器洪峰已通过。"
-  ],
-  "issues": [],
-  "compatibility": {
-    "node": ">=24",
-    "platform": "durable 恢复沿用既有结果协议；显式选填撤回原因要求 workflow.optional-withdrawal-reason@1.0.0"
-  },
-  "sha256": "c6c0691f9fe9571dfe1c9078546a5db3f63645ba11a67a3f3d0d6324ba7713d1",
-  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.55.1"
-}

package/releases/2.55.6.json

@@ -1,32 +0,0 @@
-{
-  "schemaVersion": "openxiangda.release-notes/v1",
-  "version": "2.55.6",
-  "status": "reviewed",
-  "title": "OpenXiangda 2.55.6：入口排队与身份加载连续性",
-  "summary": "修复平台入口等待期限与浏览器身份读取恢复期限不一致导致有效等待过早中断的问题。",
-  "newFeatures": [],
-  "fixes": [
-    "仅对有效平台入口回执接续身份等待，固定原期限并上限三十分钟，后续回执只能缩短。",
-    "入口身份读取遵循有界排队提示，普通请求、权限拒绝、投影重试和网络失败保持各自边界。"
-  ],
-  "affectedUsers": [
-    "启用 V2 平台入口排队并在拥挤时加载当前用户信息的应用。"
-  ],
-  "upgradeSteps": [
-    "安装同源 SDK 并重新构建应用，验证权限拒绝、入口期限、页面取消、原报名结果恢复及真实冷入口并发。"
-  ],
-  "knownLimitations": [
-    "本地测试不代表线上容量；r62 的 48 人中断仍保留，必须使用新隔离活动重新压测。",
-    "本次 HTTP 请求图不证明完整 SSO 或浏览器渲染上限。"
-  ],
-  "compatibility": {
-    "node": ">=24",
-    "platform": "V2 原入口回执协议；无数据库迁移",
-    "v1": "V1 引擎和应用不变"
-  },
-  "issues": [
-    "r62-entry-identity-interrupted"
-  ],
-  "sha256": "48803b23bb19feee37b60779064e03c2cb60c26a591f794755bcf4c2b5b887a7",
-  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.55.6"
-}

package/releases/2.57.1.json

@@ -1,31 +0,0 @@
-{
-  "schemaVersion": "openxiangda.release-notes/v1",
-  "version": "2.57.1",
-  "status": "reviewed",
-  "title": "身份入口暂不可用时保留固定恢复期限",
-  "summary": "启用入口等待的平台可声明有界读取恢复预算，SDK继续恢复身份而不刷新原截止。",
-  "newFeatures": [],
-  "fixes": [
-    "修复入口429 unavailable无票据剩余时间时回落普通五分钟恢复的问题。",
-    "后续票据回执只能缩短截止；保留权限拒绝、失效、取消及写操作约束。"
-  ],
-  "affectedUsers": [
-    "使用高并发入口等待与runtime身份读取的V2应用。"
-  ],
-  "upgradeSteps": [
-    "同时使用提供recoveryBudgetMs的Server及同源SDK；无该元数据时维持原五分钟恢复。",
-    "完整分发组合通过正式门禁后部署，保留原压测失败与期限。"
-  ],
-  "knownLimitations": [
-    "本批尚未完成公开npm发行和学校站点部署，源码测试不代表线上验收。",
-    "恢复预算只用于读取重试，不提供身份或队列位置，不延长Redis票据。"
-  ],
-  "issues": [],
-  "compatibility": {
-    "node": ">=24",
-    "platform": "native-4、可选入口unavailable recoveryBudgetMs",
-    "v1": "V1不消费该恢复接口"
-  },
-  "sha256": "d797d800560e8e24b276c6674fa2ea303f89b844cf1f5ee7b1199543180174c4",
-  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.57.1"
-}

package/releases/2.59.0.json

@@ -1,36 +0,0 @@
-{
-  "schemaVersion": "openxiangda.release-notes/v1",
-  "version": "2.59.0",
-  "status": "reviewed",
-  "title": "托管查询断连恢复与流程表单能力更新",
-  "summary": "托管只读查询在认证传输层明确标记断连后沿原预算恢复；正式发行同时包含主线已评审的可选流程、子表及连接开发能力。",
-  "newFeatures": [
-    "流程支持发起人补正、具名业务补正命令、审批节点代理范围、批准后代理和原子Native阶段条件；新能力通过目标平台协商。",
-    "owned子表支持最少行数、可信初始流程事实、具名只读展示和任务字段来源；资源关联支持显式绑定变化清空。",
-    "日期字段支持分钟精度，日期事件支持可信来源投影；大型应用声明与JSON节点预算可显式协商扩展。",
-    "连接开发支持普通浏览器登录身份与平台可信后台调用；新增纯表达式入口供浏览器和Node共享流程表达式。"
-  ],
-  "fixes": [
-    "read、mine、result、allocation的已标记连接中断与繁忙共用固定预算、尝试上限、退避及取消边界；已受理观察继续原结果，不延长首次提交截止。",
-    "修复受控子表字段联动、审批已确认任务转交后的页面继续和普通浏览器业务API的CSRF传递。"
-  ],
-  "affectedUsers": [
-    "使用托管并发查询、标准流程表单、owned子表或普通角色连接开发的V2应用。"
-  ],
-  "upgradeSteps": [
-    "通过精确版本安装完整同源发行组合；启用新声明前核验目标平台能力。托管高并发应用需在真实浏览器与隔离压测中重新校准恢复行为。"
-  ],
-  "knownLimitations": [
-    "客户上一档万人HTTP请求图有29人结果观察被断连中断；后台全部终结但该档仍未完整通过。本版本的新万人复测尚未完成，既有最高完整通过为8000人HTTP请求图。",
-    "不自动重放业务写入，不将断连认定为已受理，不覆盖集中SSO登录或浏览器JS渲染容量；权限、依赖及未标记错误继续拒绝。",
-    "新增可选流程及普通角色源码调用需要配套平台能力；旧平台不能启用未支持的声明。"
-  ],
-  "issues": [],
-  "compatibility": {
-    "node": ">=24",
-    "platform": "托管断连恢复复用现有接口；新增声明按目标平台能力协商",
-    "v1": "V1不消费本批V2运行时能力"
-  },
-  "sha256": "7cdc36d28dc77f417b8bbbbdd8ab1fe0da4cdc3aead69c0b2ad6c87fdaae09bb",
-  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.59.0"
-}

package/releases/2.59.1.json

@@ -1,37 +0,0 @@
-{
-  "schemaVersion": "openxiangda.release-notes/v1",
-  "version": "2.59.1",
-  "status": "reviewed",
-  "title": "同源托管断连恢复与声明生成修复",
-  "summary": "发布同源托管只读断连恢复及主线已评审能力，并补齐大型资源类型生成和自动审批只读详情的修复。",
-  "newFeatures": [
-    "流程支持发起人补正、具名业务补正命令、审批节点代理范围、批准后代理和原子Native阶段条件；新能力通过目标平台协商。",
-    "owned子表支持最少行数、可信初始流程事实、具名只读展示和任务字段来源；资源关联支持显式绑定变化清空。",
-    "日期字段支持分钟精度，日期事件支持可信来源投影；大型应用声明与JSON节点预算可显式协商扩展。",
-    "连接开发支持普通浏览器登录身份与平台可信后台调用；新增纯表达式入口供浏览器和Node共享流程表达式。"
-  ],
-  "fixes": [
-    "read、mine、result、allocation的已标记连接中断与繁忙共用固定预算、尝试上限、退避及取消边界；已受理观察继续原结果，不延长首次提交截止。",
-    "修复受控子表字段联动、审批已确认任务转交后的页面继续和普通浏览器业务API的CSRF传递。",
-    "大型资源目录使用命名条目与精确只读类型，避免TypeScript序列化上限；自动发起人审批允许已解析的完全只读详情，保留可编辑席位人工办理。"
-  ],
-  "affectedUsers": [
-    "使用托管并发查询、标准流程表单、owned子表或普通角色连接开发的V2应用。"
-  ],
-  "upgradeSteps": [
-    "通过精确版本安装完整同源发行组合；启用新声明前核验目标平台能力。托管高并发应用需在真实浏览器与隔离压测中重新校准恢复行为。"
-  ],
-  "knownLimitations": [
-    "客户上一档万人HTTP请求图有29人结果观察被断连中断；后台全部终结但该档仍未完整通过。本版本的新万人复测尚未完成，既有最高完整通过为8000人HTTP请求图。",
-    "不自动重放业务写入，不将断连认定为已受理，不覆盖集中SSO登录或浏览器JS渲染容量；权限、依赖及未标记错误继续拒绝。",
-    "新增可选流程及普通角色源码调用需要配套平台能力；旧平台不能启用未支持的声明。"
-  ],
-  "issues": [],
-  "compatibility": {
-    "node": ">=24",
-    "platform": "托管断连恢复复用现有接口；新增声明按目标平台能力协商",
-    "v1": "V1不消费本批V2运行时能力"
-  },
-  "sha256": "3a9716eafe5e14bfe5eda8b2482393e4aad28155fde5933f3fe759a6a98c5972",
-  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.59.1"
-}