package instance import ( "context" "encoding/json" "time" "git.yuntuo.hk/k2safe/orbit/internal/fault" core "git.yuntuo.hk/k2safe/orbit/model" "git.yuntuo.hk/k2safe/orbit/platform/auth" "git.yuntuo.hk/k2safe/orbit/pulse/service" ) // ActivationSummary 描述指定历史激活的当前记录,不携带大输入/结果或执行凭据。 type ActivationSummary struct { ID core.ID `json:"id"` // ID 激活身份,人工恢复时新建且保留原记录。 StepID core.ID `json:"step_id"` // StepID 本激活所属逻辑步骤。 Sequence uint32 `json:"sequence"` // Sequence 该步骤的激活代次,和POLL业务轮次分开。 State string `json:"state"` // State 此激活状态,不代表实例当前状态。 Revision uint64 `json:"revision,string"` // Revision 此激活记录的版本,保留整数精度。 TaskID *core.ID `json:"task_id,omitempty"` // TaskID TASK的直接任务;POLL从轮次列表查询。 CreatedAt time.Time `json:"created_at"` // CreatedAt 激活创建时间,不代表恢复获得新截止。 UpdatedAt time.Time `json:"updated_at"` // UpdatedAt 此记录最后变更时间。 CompletedAt *time.Time `json:"completed_at,omitempty"` // CompletedAt 此激活已保存的结束时间;未记录时省略。 } type ActivationPage struct { InstanceID core.ID `json:"instance_id"` // InstanceID 已授权的所属实例。 Revision uint64 `json:"revision,string"` // Revision 本页读取时的实例版本;跨页不保证同一快照。 StepID core.ID `json:"step_id"` // StepID 已核验的逻辑步骤。 CurrentActivationID *core.ID `json:"current_activation_id,omitempty"` // CurrentActivationID 本页读取时的当前激活,未激活时省略。 Items []ActivationSummary `json:"items"` // Items 按代次倒序的有界摘要,空页为[]。 NextCursor string `json:"next_cursor,omitempty"` // NextCursor 绑定实例、步骤和查询类型的后续位置。 } type ActivationDetail struct { InstanceID core.ID `json:"instance_id"` // InstanceID 所属实例。 Revision uint64 `json:"revision,string"` // Revision 读取详情时的实例版本。 Step StepView `json:"step"` // Step 逻辑步骤的当前视图,不能替代Activation中的历史代次。 Activation ActivationSummary `json:"activation"` // Activation 指定的历史激活,不自动改为当前激活。 Input json.RawMessage `json:"input"` // Input 此激活原输入,显式null保留。 Output json.RawMessage `json:"output,omitempty"` // Output 此激活当前保存的结果,缺失与显式null不同。 Poll *PollView `json:"poll,omitempty"` // Poll 此激活的查询预算及最后任务,只用于POLL。 Wait *WaitView `json:"wait,omitempty"` // Wait 此激活的等待记录,恢复不修改旧记录的截止。 } type PollRoundSummary struct { ID core.ID `json:"id"` // ID 该任务唯一对应的轮次记录。 ActivationID core.ID `json:"activation_id"` // ActivationID 产生本次查询的激活。 Round uint32 `json:"round"` // Round 从首次激活累计的业务轮编号;恢复同轮不重置。 TaskID core.ID `json:"task_id"` // TaskID 该轮Pulse任务,尝试和结果由任务接口读取。 CreatedAt time.Time `json:"created_at"` // CreatedAt 本次轮次记录创建时间。 } type PollRoundPage struct { InstanceID core.ID `json:"instance_id"` // InstanceID 所属实例。 Revision uint64 `json:"revision,string"` // Revision 本页读取时的实例版本。 ActivationID core.ID `json:"activation_id"` // ActivationID 明确指定的历史激活。 Items []PollRoundSummary `json:"items"` // Items 本激活内按业务轮倒序的摘要,空页为[]。 NextCursor string `json:"next_cursor,omitempty"` // NextCursor 绑定实例、激活及查询类型的后续位置。 } func historyPage(in service.HistoryPageInput) (service.HistoryPageInput, error) { if in.Limit == 0 { in.Limit = 20 } if in.Limit < 1 || in.Limit > 100 || len(in.Cursor) > 1024 { return in, fault.Invalid("invalid workflow history page") } return in, nil } func (s *Service) ListActivations(ctx context.Context, t auth.Token, id core.ID, key string, in service.HistoryPageInput) (ActivationPage, error) { if id.Validate() != nil || !versionName(key) { return ActivationPage{}, fault.Invalid("invalid workflow step identity") } in, err := historyPage(in) if err != nil { return ActivationPage{}, err } return s.store.ListActivations(ctx, t, id, key, in) } func (s *Service) GetActivation(ctx context.Context, t auth.Token, id core.ID, key string, activation core.ID) (ActivationDetail, error) { if id.Validate() != nil || !versionName(key) || activation.Validate() != nil { return ActivationDetail{}, fault.Invalid("invalid workflow activation identity") } return s.store.GetActivation(ctx, t, id, key, activation) } func (s *Service) ListPollRounds(ctx context.Context, t auth.Token, id core.ID, key string, activation core.ID, in service.HistoryPageInput) (PollRoundPage, error) { if id.Validate() != nil || !versionName(key) || activation.Validate() != nil { return PollRoundPage{}, fault.Invalid("invalid workflow activation identity") } in, err := historyPage(in) if err != nil { return PollRoundPage{}, err } return s.store.ListPollRounds(ctx, t, id, key, activation, in) }