62 lines
3.7 KiB
Go
62 lines
3.7 KiB
Go
package service
|
||
|
||
import (
|
||
"context"
|
||
core "git.yuntuo.hk/k2safe/orbit/model"
|
||
"git.yuntuo.hk/k2safe/orbit/platform/auth"
|
||
"time"
|
||
)
|
||
|
||
// TaskSourceView 只读的直接来源，不遍历整条重试链，也不授予来源资源管理权限。
|
||
type TaskSourceView struct {
|
||
// TaskID 本次已授权查询的任务标识。
|
||
TaskID core.ID `json:"task_id"`
|
||
// Kind DIRECT、MANUAL_RETRY、SCHEDULE或WORKFLOW；分别是普通受理、人工派生、计划触发或流程步骤。
|
||
Kind string `json:"kind"`
|
||
// RetryOf 人工重试的直接原任务，限同一命名空间及队列；其他种类省略。
|
||
RetryOf *core.ID `json:"retry_of,omitempty"`
|
||
// Schedule 计划触发的固定来源，仅SCHEDULE返回，不包含任务模板或计划配置。
|
||
Schedule *TaskScheduleSource `json:"schedule,omitempty"`
|
||
// Workflow 流程任务的固定来源，不返回其他步骤、业务输入或完整定义。
|
||
Workflow *TaskWorkflowSource `json:"workflow,omitempty"`
|
||
}
|
||
|
||
// TaskWorkflowSource 指向任务自己的历史激活；人工恢复不会把旧任务改指向当前激活。
|
||
type TaskWorkflowSource struct {
|
||
WorkflowID core.ID `json:"workflow_id"` // WorkflowID 所属流程实例。
|
||
DefinitionID core.ID `json:"definition_id"` // DefinitionID 稳定定义身份。
|
||
DefinitionVersionID core.ID `json:"definition_version_id"` // DefinitionVersionID 实例固定的不可变版本记录。
|
||
Version string `json:"version"` // Version 固定发布版本名，不跟随新发布版本。
|
||
StepID core.ID `json:"step_id"` // StepID 实例内逻辑步骤身份。
|
||
StepKey string `json:"step_key"` // StepKey 固定定义中的步骤名称。
|
||
StepKind string `json:"step_kind"` // StepKind TASK或POLL，不返回内部根或等待节点。
|
||
ActivationID core.ID `json:"activation_id"` // ActivationID 创建此任务的激活身份，可能已经是历史代次。
|
||
ActivationSequence uint32 `json:"activation_sequence"` // ActivationSequence 此步骤的激活代次，从1开始。
|
||
PollRound uint32 `json:"poll_round,omitempty"` // PollRound 原业务查询轮编号，跨激活恢复不重置；TASK省略。
|
||
PollRoundID *core.ID `json:"poll_round_id,omitempty"` // PollRoundID 当前任务对应的唯一轮次记录；TASK省略。
|
||
RetryOf *core.ID `json:"retry_of,omitempty"` // RetryOf 人工恢复所关联的直接旧任务，限同一流程/步骤及业务轮次，不递归展开。
|
||
}
|
||
|
||
// TaskScheduleSource 关联已生成任务的触发记录及当时的不可变计划版本。
|
||
type TaskScheduleSource struct {
|
||
// ScheduleID 原计划标识，不因发布新版本而变化。
|
||
ScheduleID core.ID `json:"schedule_id"`
|
||
// ScheduleVersion 触发时使用的固定版本，JSON字符串避免精度丢失。
|
||
ScheduleVersion uint64 `json:"schedule_version,string"`
|
||
// OccurrenceID 唯一关联该任务的触发记录标识。
|
||
OccurrenceID core.ID `json:"occurrence_id"`
|
||
// ScheduledAt 原计划时间，UTC微秒精度，不等于实际受理/执行时间。
|
||
ScheduledAt time.Time `json:"scheduled_at"`
|
||
// Decision FIRED为单点触发，COALESCED为合并触发；跳过不会产生任务。
|
||
Decision string `json:"decision"`
|
||
// CoveredUntil 合并范围的排除边界，仅COALESCED返回。
|
||
CoveredUntil *time.Time `json:"covered_until,omitempty"`
|
||
}
|
||
|
||
func (s *Service) GetTaskSource(ctx context.Context, t auth.Token, id core.ID) (TaskSourceView, error) {
|
||
if err := validateHistoryIDs(id); err != nil {
|
||
return TaskSourceView{}, err
|
||
}
|
||
return s.store.GetTaskSource(ctx, t, id)
|
||
}
|