已完成 P0–P3 平台功能阶段验收：35 个数据模型、版本化迁移、凭据及范围校验、队列与任务 API、WSS 执行、独立 SDK、自动 Worker 和执行尝试/证据查询。Worker Schema 与真实进程强杀恢复回归已通过；安全重试、定时计划、运行中取消、队列资源控制、应用共享配额、资源键互斥和优先级/节点公平派发已接入服务端和 SDK，可靠结果订阅已实现持久化核心、HTTP/WSS、管理 SDK 与示例，消费 SDK 和独立 MySQL Inbox 示例已实现；批量任务受理已提供逐项幂等、失败分类与 SDK 示例；人工核查与重试已提供带证据的管理接口、关联新任务、审计查询及运行示例；业务键与时间范围查询已提供过滤、分页与SDK场景；任务来源查询已提供人工重试父任务、计划触发记录与固定版本；业务事务Outbox 已提供独立业务库、稳定提交身份、发送恢复与CLI；相对延迟执行已提供数据库计时及原请求恢复；完整范围核对见P3验收，流程引擎与生产验证按持续开发计划继续实现。

P4已实现流程定义与不可变版本发布、结构版本1及SDK发布例子。有限步骤决策器与内部结果交付已实现；已补实例受理及首批工作存储。Inbox消费、持久化等待运行器和实例公共API/SDK继续开发，发布定义不会启动任务。

数据库禁止外键，关联一致性通过服务端事务校验，索引、唯一约束和 CHECK 保留；readiness 同时检查迁移及零外键要求。这不表示完整平台已具备生产服务能力。验证证据见 P0、P1、P2 阶段验收、安全重试、计划调度、取消与无外键回归及队列资源回归。

cmd/orbit/                    基础 HTTP 服务入口
cmd/orbit-migrate/            独立数据库迁移命令
cmd/orbit-admin/              受控初始化与私密凭据交付
model/                       公共 ID、JSON、摘要与记录原语
platform/model/              应用、命名空间、幂等、事件和审计
platform/auth/               凭据格式与动作/队列授权范围
pulse/model/                 任务、尝试、队列、计划和执行许可
pulse/service/               任务与队列应用契约、输入校验
pulse/worker/                会话、开始、续租、结果和恢复契约
pulse/retry/                 冻结策略、有限退避与未知效果决策
pulse/schedule/              Cron/间隔、漏跑、版本及计划接口
internal/timezone/           随计划冻结的内置时区数据快照
weave/model/                 定义、实例、步骤、信号和查询轮次
weave/definition/            有限结构/类型校验与定义发布契约
weave/engine/                不可变规则的有限步骤决策与精确结果映射
weave/instance/              内部实例受理/查询契约，公共运行API继续开发
internal/config/             配置校验
internal/storage/mysql/      连接、事务、迁移及集成测试
internal/transport/httpserver/ HTTP 接入
sdk/go/                      独立 Go SDK module 与示例
scripts/                     可复现的回归工具
docs/                        设计、接口、SDK、场景与验证报告

本地运行

要求 Go 1.27.1、MySQL 8.4+。先准备专用数据库和凭据，通过环境变量注入；程序不会自动读取 .env 文件。

export ORBIT_MYSQL_DSN='user:password@tcp(127.0.0.1:3306)/orbit'
export ORBIT_HTTP_ADDR='127.0.0.1:8080'
go run ./cmd/orbit-migrate up
go run ./cmd/orbit

上方 DSN 为本地占位示例，需替换为实际凭据。部署时使用秘密管理和经过验证的 TLS 配置；迁移账户与运行账户分开授权。运行程序不自动迁移数据库。

另一个终端执行 SDK 示例：

cd sdk/go
ORBIT_URL=http://127.0.0.1:8080 go run ./examples/health

任务接入从初始化凭据开始，再按 SDK 接入运行受理/取消示例。自动 Worker 示例演示处理器注册、并发消费、结果确认与排空；特殊接入也可使用底层协议示例。

开发与回归

make fmt
make test
make vet
make build
make integration

make integration 要求 Docker、OpenSSL 等标准命令，启动独立的临时 MySQL 容器，使用随机凭据和回环随机端口；完成后删除该测试容器。不会连接已有业务数据库。可通过 GO、DOCKER 和 ORBIT_TEST_MYSQL_IMAGE 指定工具/测试镜像。

修改已应用迁移时会触发校验和拒绝；新增结构使用新的前向迁移。初始结构尚未部署生产。

文档入口

Git 远端：https://git.yuntuo.hk/k2safe/orbit.git。当前在本地开发分支推进，SDK 尚未发布版本。

Languages

Go 90.5%

JavaScript 3.8%

Shell 2.6%

HTML 2.1%

Python 0.8%

Other 0.1%

README.md Unescape Escape

Orbit · 星轨

当前进度

目录

本地运行

开发与回归

文档入口

README.md