From 79dd4d37a9bddd7b40f8be552c49054362028a87 Mon Sep 17 00:00:00 2001 From: k2safe Date: Sun, 20 Sep 2026 02:07:23 +0800 Subject: [PATCH] docs: refresh delivered workflow and protocol status --- docs/02-technical-design.md | 2 +- docs/03-http-websocket-protocol.md | 2 +- docs/12-workflow-runtime.md | 2 +- docs/README.md | 2 +- docs/api/subscriptions.md | 2 +- docs/api/workflow-history.md | 2 +- 6 files changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/02-technical-design.md b/docs/02-technical-design.md index 30874bf..9803478 100644 --- a/docs/02-technical-design.md +++ b/docs/02-technical-design.md @@ -1,6 +1,6 @@ # Orbit 技术方案 -> 版本 0.2 · 2026-09-17。Orbit 统一项目内保留 Pulse 与 Weave 两个模块。本文描述总体技术方案；基础部分已实施，执行引擎尚未完成。 +> 版本 0.2 · 2026-09-17。Orbit 统一项目内保留 Pulse 与 Weave 两个模块。本文描述总体技术方案；基础、任务执行和流程执行链路已实施，生产拓扑与容量验收仍按持续计划推进。 ## 1. 技术基线 diff --git a/docs/03-http-websocket-protocol.md b/docs/03-http-websocket-protocol.md index d4dccf6..5b800a9 100644 --- a/docs/03-http-websocket-protocol.md +++ b/docs/03-http-websocket-protocol.md @@ -2,7 +2,7 @@ > 版本 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. 通用契约 diff --git a/docs/12-workflow-runtime.md b/docs/12-workflow-runtime.md index 83d34d9..7e6457f 100644 --- a/docs/12-workflow-runtime.md +++ b/docs/12-workflow-runtime.md @@ -43,7 +43,7 @@ flowchart LR 后继创建使用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)已接入。 diff --git a/docs/README.md b/docs/README.md index 4e2b089..882af6e 100644 --- a/docs/README.md +++ b/docs/README.md @@ -20,7 +20,7 @@ | [09 可靠结果订阅](09-result-subscription-core.md) | 提交水位、冻结结果与可靠交付 | | [10 Weave决策与交付](10-workflow-engine-core.md) | 有限步骤决策和内部结果Inbox | | [11 Weave实例受理](11-workflow-admission.md) | 固定版本、初始图和首批任务事务 | -| [12 Weave结果消费与推进](12-workflow-runtime.md) | 后台消费、根接续、事务与进程恢复，及尚未完成的等待/控制边界 | +| [12 Weave结果消费与推进](12-workflow-runtime.md) | 后台消费、根接续、事务、等待/控制与进程恢复 | | [13 Weave定时等待与查询轮次](13-workflow-clock.md) | 原截止、轮次/尝试预算、时钟检查点、升级与全停恢复 | | [流程历史查询](api/workflow-history.md) | 指定历史激活、查询轮次、信号摘要与信号资源审计 | | [流程状态时间线](api/workflow-events.md) | 原始流程/步骤/信号状态事件、分页和历史详情 | diff --git a/docs/api/subscriptions.md b/docs/api/subscriptions.md index 8704858..f03baec 100644 --- a/docs/api/subscriptions.md +++ b/docs/api/subscriptions.md @@ -1,6 +1,6 @@ # 可靠结果订阅 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. 授权与共同规则 diff --git a/docs/api/workflow-history.md b/docs/api/workflow-history.md index a1e5305..9c9ad98 100644 --- a/docs/api/workflow-history.md +++ b/docs/api/workflow-history.md @@ -161,4 +161,4 @@ POLL继续用ListWorkflowPollRounds(ctx, workflowID, stepKey, activation.ID, pag 所有查询只读，不重算截止、重置预算、消耗轮次或触发恢复。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阶段验收，生产容量、跨版本和高可用验收仍未完成。