docs: refresh delivered workflow and protocol status

This commit is contained in:
2026-09-20 02:07:23 +08:00
parent 03310f1457
commit 79dd4d37a9
6 changed files with 6 additions and 6 deletions

View File

@@ -1,6 +1,6 @@
# Orbit 技术方案 # Orbit 技术方案
> 版本 0.2 · 2026-09-17。Orbit 统一项目内保留 Pulse 与 Weave 两个模块。本文描述总体技术方案;基础部分已实施,执行引擎尚未完成。 > 版本 0.2 · 2026-09-17。Orbit 统一项目内保留 Pulse 与 Weave 两个模块。本文描述总体技术方案;基础、任务执行和流程执行链路已实施,生产拓扑与容量验收仍按持续计划推进。
## 1. 技术基线 ## 1. 技术基线

View File

@@ -2,7 +2,7 @@
> 版本 0.2 · 2026-09-17。HTTP + WS 已确认。本文保留首版设计建议;已实现能力以[正式接口手册](api/README.md)为准,其余路径、消息名、字段和状态码仍待对应阶段实现及验证。 > 版本 0.2 · 2026-09-17。HTTP + WS 已确认。本文保留首版设计建议;已实现能力以[正式接口手册](api/README.md)为准,其余路径、消息名、字段和状态码仍待对应阶段实现及验证。
实现更新:HTTP 任务/队列接口已完成 P1;Worker 服务端已进入 P2,实际帧名、字段、回执与边界见 [Worker 契约](api/worker.md)。本文保留早期完整设计,未实现项目不能据此视为已交付。 实现更新:HTTP 任务/队列、Worker/Event WSS 以及 Weave 公共接口均已接入;实际帧名、字段、回执与边界见 [Worker 契约](api/worker.md)、[事件接口](api/subscriptions.md)和[流程接口](api/workflows.md)。本文保留协议推导和边界说明,生产兼容与拓扑验收仍以持续计划和发布清单为准。
## 1. 通用契约 ## 1. 通用契约

View File

@@ -43,7 +43,7 @@ flowchart LR
后继创建使用SAVEPOINT隔离本轮结构变更。多后继中任何一个遇到队列或应用满额,全部本轮后继和对应额度预占回滚;已接受的来源结果及步骤完成仍能与ROOT待续记录一起提交。下一次尝试从当前图重新计算,不能留下部分激活、重复后继或多扣用量。持续满额仅移动检查时间,不逐秒制造相同业务审计。 后继创建使用SAVEPOINT隔离本轮结构变更。多后继中任何一个遇到队列或应用满额,全部本轮后继和对应额度预占回滚;已接受的来源结果及步骤完成仍能与ROOT待续记录一起提交。下一次尝试从当前图重新计算,不能留下部分激活、重复后继或多扣用量。持续满额仅移动检查时间,不逐秒制造相同业务审计。
暂停、关闭门控或停用应用/命名空间时,继续收集已经落库的结果,但不激活新步骤;若还有后继,将其保存为待续。重新允许推进后,从持久记录继续。测试通过直接设置控制状态验证该行为;内部暂停/继续控制已按[控制运行约定](15-workflow-controls.md)实现,公共HTTP/SDK尚未交付。 暂停、关闭门控或停用应用/命名空间时,继续收集已经落库的结果,但不激活新步骤;若还有后继,将其保存为待续。重新允许推进后,从持久记录继续。内部暂停/继续控制已按[控制运行约定](15-workflow-controls.md)实现,并已通过[公共控制API](api/workflows.md#4-暂停继续与取消)和独立SDK调用。
已过实例总截止时不创建后继,未能全部完成则进入核查。最后的有效任务结果在截止前已由Pulse接受,而消费发生较晚时,可以整理完整结果并完成实例。暂停或重启不延长截止。TIMER与POLL的时钟已接入;[SIGNAL及其超期/最终查询裁决](14-workflow-signals.md)已接入。 已过实例总截止时不创建后继,未能全部完成则进入核查。最后的有效任务结果在截止前已由Pulse接受,而消费发生较晚时,可以整理完整结果并完成实例。暂停或重启不延长截止。TIMER与POLL的时钟已接入;[SIGNAL及其超期/最终查询裁决](14-workflow-signals.md)已接入。

View File

@@ -20,7 +20,7 @@
| [09 可靠结果订阅](09-result-subscription-core.md) | 提交水位、冻结结果与可靠交付 | | [09 可靠结果订阅](09-result-subscription-core.md) | 提交水位、冻结结果与可靠交付 |
| [10 Weave决策与交付](10-workflow-engine-core.md) | 有限步骤决策和内部结果Inbox | | [10 Weave决策与交付](10-workflow-engine-core.md) | 有限步骤决策和内部结果Inbox |
| [11 Weave实例受理](11-workflow-admission.md) | 固定版本、初始图和首批任务事务 | | [11 Weave实例受理](11-workflow-admission.md) | 固定版本、初始图和首批任务事务 |
| [12 Weave结果消费与推进](12-workflow-runtime.md) | 后台消费、根接续、事务与进程恢复,及尚未完成的等待/控制边界 | | [12 Weave结果消费与推进](12-workflow-runtime.md) | 后台消费、根接续、事务、等待/控制与进程恢复 |
| [13 Weave定时等待与查询轮次](13-workflow-clock.md) | 原截止、轮次/尝试预算、时钟检查点、升级与全停恢复 | | [13 Weave定时等待与查询轮次](13-workflow-clock.md) | 原截止、轮次/尝试预算、时钟检查点、升级与全停恢复 |
| [流程历史查询](api/workflow-history.md) | 指定历史激活、查询轮次、信号摘要与信号资源审计 | | [流程历史查询](api/workflow-history.md) | 指定历史激活、查询轮次、信号摘要与信号资源审计 |
| [流程状态时间线](api/workflow-events.md) | 原始流程/步骤/信号状态事件、分页和历史详情 | | [流程状态时间线](api/workflow-events.md) | 原始流程/步骤/信号状态事件、分页和历史详情 |

View File

@@ -1,6 +1,6 @@
# 可靠结果订阅 HTTP 与 WebSocket # 可靠结果订阅 HTTP 与 WebSocket
状态:已实现服务端 HTTP/WSS、管理 SDK 和管理示例。事件连接 SDK、自动重连消费器、持久化 Inbox 示例及真实进程强杀验证继续开发,完整 P3 订阅验收尚未完成。[存储语义与升级边界](../09-result-subscription-core.md),[本阶段验证](../reports/phase-3-result-subscription-transport.md)。 状态:服务端 HTTP/WSS、管理 SDK、事件连接 SDK、自动重连消费器、持久化 Inbox 示例及真实进程强杀验证均已实现。当前页面说明接口语义;生产积压、跨节点聚合、容量和发布兼容仍按[交付清单](../release-checklist.md)验收。[存储语义与升级边界](../09-result-subscription-core.md),[阶段验证](../reports/phase-3-event-consumer-sdk.md)。
## 1. 授权与共同规则 ## 1. 授权与共同规则

View File

@@ -161,4 +161,4 @@ POLL继续用ListWorkflowPollRounds(ctx, workflowID, stepKey, activation.ID, pag
所有查询只读,不重算截止、重置预算、消耗轮次或触发恢复。SDK拒绝非法路径/分页及响应父资源不匹配;不自动创建新身份。读操作网络失败可以按原资源重读,状态可能已经前进。 所有查询只读,不重算截止、重置预算、消耗轮次或触发恢复。SDK拒绝非法路径/分页及响应父资源不匹配;不自动创建新身份。读操作网络失败可以按原资源重读,状态可能已经前进。
服务端需先应用`000023_workflow_signal_history`,只增加(namespace_id,workflow_id,accepted_at,id)索引;原数据、迁移历史、模型字段和零外键要求保持。维护窗口和DDL锁需按目标数据库演练。当前SDK仍为开发版,使用与服务端匹配的开发提交;P4/P5整体和生产验收尚未完成。 服务端需先应用`000023_workflow_signal_history`,只增加(namespace_id,workflow_id,accepted_at,id)索引;原数据、迁移历史、模型字段和零外键要求保持。维护窗口和DDL锁需按目标数据库演练。当前SDK仍为开发版,使用与服务端匹配的开发提交;历史/事件功能已进入P4/P5阶段验收,生产容量、跨版本和高可用验收仍未完成。