syntax = "v1"

import (
	"base.api"
)

type (
	// === 任务管理（对齐 frontend-api.md 8.2-8.3 节）===

	QueryTasksReq {
		PageReq
		SortReq
		JobId       int      `form:"jobId,optional"`
		WorkOrderId int      `form:"workOrderId,optional"`
		Statuses    []string `form:"statuses,optional"`
		Type        string   `form:"type,optional"`
	}
	QueryTasksReply {
		PageReply
		Data []TaskReply `json:"data"`
	}
	TaskReply {
		Id            int         `json:"id"`
		JobId         int         `json:"jobId"`
		Type          string      `json:"type"`
		Status        string      `json:"status"`
		FromPosType   string      `json:"fromPosType,omitempty"`
		FromPosRefId  string      `json:"fromPosRefId,omitempty"`
		ToPosType     string      `json:"toPosType,omitempty"`
		ToPosRefId    string      `json:"toPosRefId,omitempty"`
		AssignedRobot string      `json:"assignedRobot,omitempty"`
		StartedTime   string      `json:"startedTime,omitempty"`
		CompletedTime string      `json:"completedTime,omitempty"`
		Result        interface{} `json:"result,omitempty"`
	}
)

@server (
	jwt:    Auth
	group:  task
	prefix: /api/v1
)
service hougai-api {
	@doc "任务分页列表"
	@handler queryTasks
	get /tasks (QueryTasksReq) returns (QueryTasksReply)

	@doc "任务详情"
	@handler getTask
	get /tasks/:id (PathId) returns (TaskReply)
}