57 lines
3.9 KiB
Go
57 lines
3.9 KiB
Go
package orbit
|
||
|
||
import "time"
|
||
|
||
// CreateWorkflowDefinitionRequest 创建命名空间内的稳定定义身份，不发布版本或启动实例。
|
||
type CreateWorkflowDefinitionRequest struct {
|
||
Name string `json:"name"` // Name 命名空间内唯一ASCII名称，最长128字符。
|
||
Description string `json:"description"` // Description 用途说明，最多1024个Unicode字符。
|
||
}
|
||
|
||
// PublishWorkflowVersionRequest 发布不可变版本；同版本内容冲突不能通过更换幂等键覆盖。
|
||
type PublishWorkflowVersionRequest struct {
|
||
Version string `json:"version"` // Version 研发指定的ASCII版本名，最长64字符，不包含路径分隔符。
|
||
Specification WorkflowSpecification `json:"specification"` // WorkflowSpecification 完整且显式的冻结规则。
|
||
Reason string `json:"reason"` // Reason 非空发布原因，最多1024个字符，写入审计。
|
||
}
|
||
|
||
// WorkflowDefinition 仅含命名空间级元数据；读取完整版本还须授权所有引用队列。
|
||
type WorkflowDefinition struct {
|
||
ID string `json:"id"` // ID 定义稳定标识。
|
||
NamespaceID string `json:"namespace_id"` // NamespaceID 定义隔离范围。
|
||
Name string `json:"name"` // Name 创建时冻结的唯一名称。
|
||
Description string `json:"description"` // Description 创建时冻结的用途说明。
|
||
Revision uint64 `json:"revision,string"` // Revision 从1开始，每个新发布版本增加1，不能替代业务版本名。
|
||
CreatedAt time.Time `json:"created_at"` // CreatedAt UTC数据库创建时间。
|
||
UpdatedAt time.Time `json:"updated_at"` // UpdatedAt 最近新版本发布的UTC数据库时间。
|
||
}
|
||
|
||
// WorkflowAnalysis 是静态预算上界；不表示业务任务已执行或已分配配额。
|
||
type WorkflowAnalysis struct {
|
||
Steps uint32 `json:"steps"` // Steps 全定义静态步骤数。
|
||
MaxConcurrency uint32 `json:"max_concurrency"` // MaxConcurrency 并行业务任务上界。
|
||
MaxTaskAttempts uint32 `json:"max_task_attempts"` // MaxTaskAttempts 所有路径的保守尝试预算总和。
|
||
Queues []string `json:"queues"` // Queues 排序去重队列，始终为数组。
|
||
}
|
||
|
||
// WorkflowVersion 返回原始发布内容和身份，不使用可变的latest别名。
|
||
type WorkflowVersion struct {
|
||
ID string `json:"id"` // ID 不可变版本记录标识。
|
||
NamespaceID string `json:"namespace_id"` // NamespaceID 隔离范围。
|
||
DefinitionID string `json:"definition_id"` // DefinitionID 父定义标识，由应用事务校验。
|
||
Version string `json:"version"` // Version 发布版本名。
|
||
Specification WorkflowSpecification `json:"specification"` // WorkflowSpecification 已冻结规则，数字精度不经float64转换。
|
||
ContentDigest string `json:"content_digest"` // ContentDigest 带域分隔的SHA-256，64位小写十六进制。
|
||
PublishedBy string `json:"published_by"` // PublishedBy 原发布凭据标识，不包含凭据秘密。
|
||
PublishedAt time.Time `json:"published_at"` // PublishedAt 原发布时间，重复发布不更新。
|
||
Analysis WorkflowAnalysis `json:"analysis"` // WorkflowAnalysis 根据结构版本1规则计算的静态检查结果。
|
||
}
|
||
type WorkflowDefinitionResult struct {
|
||
Definition WorkflowDefinition `json:"definition"` // Definition 创建事务的原始快照。
|
||
Deduplicated bool `json:"deduplicated"` // Deduplicated 是否返回原回执。
|
||
}
|
||
type WorkflowVersionResult struct {
|
||
Version WorkflowVersion `json:"version"` // Version 原版本快照，不包含当前父定义状态。
|
||
Deduplicated bool `json:"deduplicated"` // Deduplicated 原键或同版本同内容重复请求。
|
||
}
|