@@ -1,6 +1,6 @@
# 任务直接来源查询
状态：P3 已实现服务端、独立SDK及普通任务、计划、人工恢复 示例。接口只读，使用已有模型和索引，不增加数据库外键或迁移。验证 证据见[回归 报告../reports/phase-3-task-source.md )。
状态：已实现普通任务、人工重试、计划和流程任务来源的 服务端、独立SDK及示例。接口只读， ， P3 报告../reports/phase-3-task-source.md )和[流程来源报告 ](../reports/phase-5-task-source.md ) 。
## 1. 请求与权限
@@ -8,7 +8,7 @@
请求头：`Authorization: Bearer <token>` 。不需要请求体、Content-Type或Idempotency-Key， ； ，
权限为`tasks:read` 及任务所属队列范围。每次请求验证当前凭据； ， 定义、模板 、管理或执行权限； `schedules:read` ，见[计划手册 ](schedules.md ) 。
权限为`tasks:read` 及任务所属队列范围。每次请求验证当前凭据； ， /流程定义、其他步骤 、管理或执行权限。 读取完整计划及固定版本仍需`schedules:read` ；读取流程需`workflows:read` 及全部固定队列范围，读取流程定义需`workflows:definitions:read` 。只拥有一个队列任务权限时，仍能读取该任务的有限流程来源 。
``` sh
" $ORBIT_URL /v1/tasks/ $TASK_ID /source " \
@@ -22,7 +22,7 @@ HTTP 200， ；
| 字段 | 类型 / 必填 | 含义 |
| --- | --- | --- |
| task_id | string / 是 | 已授权查询的任务ID |
| kind | string / 是 | DIRECT、MANUAL_RETRY或 SCHEDULE |
| kind | string / 是 | DIRECT、MANUAL_RETRY、 SCHEDULE或WORKFLOW |
| retry_of | string / 仅MANUAL_RETRY | 同命名空间、同队列的直接原任务ID |
| schedule | object / 仅SCHEDULE | 触发该任务的固定关联，字段如下 |
| schedule.schedule_id | string / 是 | 来源计划ID |
@@ -31,6 +31,7 @@ HTTP 200， ；
| schedule.scheduled_at | UTC RFC3339 / 是 | 原计划时间，最多微秒精度，与实际受理/执行时间分开 |
| schedule.decision | string / 是 | FIRED单点触发或COALESCED合并触发 |
| schedule.covered_until | UTC RFC3339 / 仅COALESCED | 合并范围的排除上界，
| workflow | object / 仅WORKFLOW | 此任务创建时的流程来源，
DIRECT表示普通任务受理， ； ， 人工重试 ](task-recovery.md )创建的新任务，只返回直接父任务，不递归遍历整条重试链。父任务继续保留原历史。
@@ -85,7 +86,9 @@ SCHEDULE中的版本来自触发记录，
## 3. 关联校验与错误
平台采用无外键设计，本接口在认证事务内显式核对命名空间、任务、队列、计划、不可变版本与触发 记录。人工重试父任务须为同队列中已失败/取消的独立任务。无所有者但存在触发记录、悬空父任务、缺失版本、错误队列、未知所有者或当前未支持的门控均拒绝， 。
平台采用无外键设计，本接口在认证事务内显式核对命名空间、任务、队列、计划或流程 、不可变版本和创建 记录。人工重试父任务须为同队列中已失败/取消的独立任务。流程来源核验实例门控、版本摘要与冻结策略、固定步骤处理器契约、任务与激活或轮次的双向关系； ， 。
无所有者但存在触发/激活/轮次反向记录、同时关联不同来源种类、悬空父任务、缺失版本、错误队列或未知所有者均拒绝， ， ， ，
| HTTP / code | 处理 |
| --- | --- |
@@ -117,6 +120,11 @@ case "SCHEDULE":
fmt . Println ( "来源计划" , source . Schedule . ScheduleID ,
"固定版本" , source . Schedule . ScheduleVersion ,
"触发记录" , source . Schedule . OccurrenceID )
case "WORKFLOW" :
fmt . Println ( "所属流程" , source . Workflow . WorkflowID ,
"步骤" , source . Workflow . StepKey ,
"激活代次" , source . Workflow . ActivationSequence ,
"业务查询轮次" , source . Workflow . PollRound )
}
```
@@ -127,5 +135,53 @@ SDK的ScheduleVersion为uint64， ；
| 单项受理、取消后读取来源 | [tasks ](../../sdk/go/examples/tasks/main.go ) | [SDK初始化 ](../sdk/README.md )，
| 按计划找到触发任务，再反查来源 | [schedules ](../../sdk/go/examples/schedules/main.go ) | [计划场景 ](schedules.md#6-sdk-与完整示例 )，
| 人工核查后创建关联新任务 | [recovery ](../../sdk/go/examples/recovery/main.go ) | [恢复场景 ](../examples/recovery.md )，
| 并行流程完成后核对每项任务来源 | [workflow ](../../sdk/go/examples/workflow/main.go ) | [流程场景 ](../examples/workflow.md )，
上述示例均运行在隔离回归中；新发布计划版本后老任务仍指向旧 版本，由真实数据库与SDK集成测试验证。Weave流程来源随P4– ， ， 不更改Task/TaskSummary或Worker消息结构， ；
上述示例均运行在隔离回归中；新发布计划/流程 版本后老任务仍指向原 版本，人工恢复后旧激活仍可追溯。WORKFLOW是新增来源种类， ； ， 不更改Task/TaskSummary或Worker消息结构， ； /503同样 不能理解为DIRECT。
## 5. 流程固定来源
以下字段位于`data.workflow` ， ：
| 字段 | 类型 / 必填 | 含义 |
| --- | --- | --- |
| workflow_id | string / 是 | 所属流程实例 |
| definition_id | string / 是 | 稳定定义身份 |
| definition_version_id | string / 是 | 实例固定的版本记录身份 |
| version | string / 是 | 固定发布版本名，不解析最新版本 |
| step_id / step_key | string / 是 | 逻辑步骤身份及固定名称 |
| step_kind | string / 是 | TASK或POLL |
| activation_id | string / 是 | 创建此任务的历史激活身份 |
| activation_sequence | uint32 / 是 | 步骤激活代次， ；
| poll_round | uint32 / 仅POLL | 首次查询开始累计的业务轮编号；人工恢复同轮不重置 |
| poll_round_id | string / 仅POLL | 唯一关联该任务的轮次记录身份 |
| retry_of | string / 恢复任务可有 | 同步骤、前一激活的直接旧任务；
TASK第二代及之后必有workflow.retry_of； ， ； ，
第二代激活重查原第2业务轮的完整响应：
``` json
{
"request_id" : "44444444444444444444444444444444" ,
"data" : {
"task_id" : "11111111111111111111111111111111" ,
"kind" : "WORKFLOW" ,
"workflow" : {
"workflow_id" : "22222222222222222222222222222222" ,
"definition_id" : "33333333333333333333333333333333" ,
"definition_version_id" : "55555555555555555555555555555555" ,
"version" : "v1" ,
"step_id" : "66666666666666666666666666666666" ,
"step_key" : "query" , "step_kind" : "POLL" ,
"activation_id" : "77777777777777777777777777777777" ,
"activation_sequence" : 2 ,
"poll_round" : 2 ,
"poll_round_id" : "88888888888888888888888888888888" ,
"retry_of" : "99999999999999999999999999999999"
}
}
}
```
流程暂停、结束、发布新版本或后续人工恢复，都不会把旧任务的来源改指向新激活。要取得当前步骤需另调[GetWorkflowStep ](workflows.md )，不要用来源中的历史代次向当前等待发送信号。完整激活/轮次历史分页仍按开发计划推进，本接口一次只查一个任务的直接来源。
