k2safe/orbit
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: serialize keyed tasks across queues with durable fencing tokens

Browse Source
This commit is contained in:
k2safe
2026-09-17 18:25:00 +08:00
parent 993786476e
commit 958b4a8cea
43 changed files with 1319 additions and 82 deletions
Download Patch File Download Diff File Expand all files Collapse all files

25
pulse/service/history.go
View File

@@ -19,18 +19,19 @@ type HistoryPageInput struct {
// AttemptSummary 是执行尝试的查询快照，不提供当前执行授权。
type AttemptSummary struct {
ID core.ID `json:"id"` // ID 尝试标识，不是执行秘密。
TaskID core.ID `json:"task_id"` // TaskID 所属任务；查询始终限定在该任务下。
Epoch uint64 `json:"epoch,string"` // Epoch 单任务执行代次，JSON 为十进制字符串。
State pulse.AttemptState `json:"state"` // State 尝试状态，与整个任务状态分开。
Revision uint64 `json:"revision,string"` // Revision 当前记录版本，可因续租/恢复变化。
LeaseUntil time.Time `json:"lease_until"` // LeaseUntil 数据库记录的租约期限；查询不能授权业务执行。
AuthorizedAt *time.Time `json:"authorized_at,omitempty"` // AuthorizedAt 开始批准时间；空表示未批准，不证明副作用已经发生。
EndedAt *time.Time `json:"ended_at,omitempty"` // EndedAt 尝试结束时间；仍在执行时为空。
Retryable bool `json:"retryable,omitempty"` // Retryable 该明确失败报告是否声明可安全重试；不代表平台必定安排重试。
ErrorCode string `json:"error_code,omitempty"` // ErrorCode 稳定错误分类；无错误时为空。
CreatedAt time.Time `json:"created_at"` // CreatedAt 创建时间，UTC 微秒精度。
UpdatedAt time.Time `json:"updated_at"` // UpdatedAt 最新变更时间，不能代替版本校验。
ConcurrencyToken uint64 `json:"concurrency_token,omitempty,string"` // ConcurrencyToken 资源键的单调许可序号；无资源键时为零，不能代替当前授权。
ID core.ID `json:"id"` // ID 尝试标识，不是执行秘密。
TaskID core.ID `json:"task_id"` // TaskID 所属任务；查询始终限定在该任务下。
Epoch uint64 `json:"epoch,string"` // Epoch 单任务执行代次，JSON 为十进制字符串。
State pulse.AttemptState `json:"state"` // State 尝试状态，与整个任务状态分开。
Revision uint64 `json:"revision,string"` // Revision 当前记录版本，可因续租/恢复变化。
LeaseUntil time.Time `json:"lease_until"` // LeaseUntil 数据库记录的租约期限；查询不能授权业务执行。
AuthorizedAt *time.Time `json:"authorized_at,omitempty"` // AuthorizedAt 开始批准时间；空表示未批准，不证明副作用已经发生。
EndedAt *time.Time `json:"ended_at,omitempty"` // EndedAt 尝试结束时间；仍在执行时为空。
Retryable bool `json:"retryable,omitempty"` // Retryable 该明确失败报告是否声明可安全重试；不代表平台必定安排重试。
ErrorCode string `json:"error_code,omitempty"` // ErrorCode 稳定错误分类；无错误时为空。
CreatedAt time.Time `json:"created_at"` // CreatedAt 创建时间，UTC 微秒精度。
UpdatedAt time.Time `json:"updated_at"` // UpdatedAt 最新变更时间，不能代替版本校验。
}
// AttemptView 增加当前归属与已保存结果，不返回令牌、摘要或原始请求秘密。