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)
}