yida-process-atomic Specification

Purpose

TBD - created by archiving change extend-yida-api-coverage. Update Purpose after archive.

Requirements

Requirement: 流程实例生命周期

YDClient_Process SHALL 覆盖流程发起、终止、撤回、跳转四个关键动作。每个方法 MUST 对应宜搭官方的一个流程实例 endpoint。

Scenario: 发起流程

WHEN startProcess(conf, processCode, formUuid, formDataJson, body_ext)
THEN 对应 POST /v1.0/yida/processes/instances/start
AND 返回 processInstanceId

Scenario: 终止流程

WHEN terminateProcess(conf, processInstanceId, body_ext)
AND body_ext 中支持 operator / noExecuteExpression 等

Scenario: 撤回流程

WHEN revokeProcess(conf, processInstanceId, body_ext)
THEN 发起人撤回已提交但未审批完成的流程

Requirement: 审批任务动作

YDClient_Process SHALL 覆盖同意 / 拒绝 / 转交 / 抄送 / 评论五类审批任务动作。每个方法 MUST 与宜搭官方 task 类 endpoint 1:1 对应。

Scenario: 同意任务

WHEN agreeTask(conf, processInstanceId, taskId, comment, body_ext)
THEN 对应 POST /v1.0/yida/processes/tasks/agree

Scenario: 拒绝任务

WHEN disagreeTask(conf, processInstanceId, taskId, comment, body_ext)
AND body_ext 支持 nextOperatorUserIds（拒绝后指定下一个审批人，部分流程开启此功能）

Scenario: 转交任务

WHEN redirectTask(conf, processInstanceId, taskId, toUserId, comment, body_ext)

Scenario: 抄送

WHEN ccTask(conf, processInstanceId, taskId, toUserIds, comment, body_ext)

Scenario: 添加评论

WHEN commentTask(conf, processInstanceId, taskId, comment, body_ext)

Requirement: 流程与任务查询

YDClient_Process SHALL 提供流程详情、流程列表、任务列表三类查询能力。

Scenario: 查单个流程详情

WHEN getProcess(conf, processInstanceId, body_ext)
THEN 返回流程全量信息含已走过的所有节点

Scenario: 分页查流程

WHEN searchProcesses(conf, appType, formUuid, processCode, searchCriteria, body_ext)
THEN 支持按发起人 / 状态 / 时间范围过滤

Scenario: 查任务列表

WHEN searchTasks(conf, userId, statuses, body_ext)
THEN 返回某用户当前的待办 / 已办任务

Requirement: 节点跳转

YDClient_Process SHALL 提供流程节点跳转能力，允许运维干预流程路径。

Scenario: 跳转到指定节点

WHEN redirectProcess(conf, processInstanceId, targetActivityId, body_ext)
THEN 流程跳转到指定节点，支持前跳与后跳