sino-bc-cli 1.0.0-beta.0

package/dist/api-doc/oapi/task.md

@@ -0,0 +1,528 @@
+# 营销协同任务
+
+对应命令：`task +<shortcut>` 与 `task api <name>`。
+
+执行前 MUST 读取 [sino-bc-shared](../../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
+## 1. 任务操作日志列表（全量）
+
+`POST /sino-bc-nexus/task-action-log/list`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli task api task-action-log-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+任务操作日志列表（全量）
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `projectId` | integer | body | 否 | 项目ID |
+| `projectIdList` | array | body | 否 | 项目ID列表 |
+| `taskId` | integer | body | 否 | 任务ID |
+| `taskIdList` | array | body | 否 | 任务ID列表 |
+| `refId` | integer | body | 否 | 操作对象ID |
+| `refIdList` | array | body | 否 | 操作对象ID列表 |
+| `refType` | string | body | 否 | 操作对象类型 |
+| `refTypeList` | array | body | 否 | 操作对象类型列表 |
+
+## 2. 调整任务(编辑任务基本信息、成员等，状态重新流转)
+
+`POST /sino-bc-nexus/task/adjust`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`write`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli task api task-adjust --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+调整任务(编辑任务基本信息、成员等，状态重新流转)
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `taskId` | integer | body | 否 | 任务ID |
+| `name` | string | body | 否 | 任务名称 |
+| `taskInfo` | string | body | 否 | 任务信息，富文本 |
+| `dueAt` | string | body | 否 | 截止时间；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
+| `members` | array | body | 否 | 任务成员列表（userId + role） |
+| `uploadRecordIdList` | array | body | 否 | 附件上传记录ID列表（来自文件上传接口返回的uploadRecordId） |
+| `skipPendingExecution` | boolean | body | 否 | 是否跳过待执行：true-跳过 false-不跳过；不传沿用任务已有值 |
+
+## 3. 审核通过
+
+`POST /sino-bc-nexus/task/approve-review`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`write`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli task api task-approve-review --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+审核通过
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `taskId` | integer | body | 否 | 任务ID |
+| `deliveryId` | integer | body | 否 | 交付记录ID |
+
+## 4. 确认通过
+
+`POST /sino-bc-nexus/task/confirm`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`write`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli task api task-confirm --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+确认通过
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `taskId` | integer | body | 否 | 任务ID |
+| `deliveryId` | integer | body | 否 | 交付记录ID |
+| `taskSource` | string | body | 否 | 任务来源 RequestSourceEnum（可选，与创建一致） |
+| `taskSourceSubtype` | string | body | 否 | 任务来源子类型 TaskSourceSubtypeEnum（可选，与创建一致） |
+| `larkChat` | object | body | 否 | 本次操作关联的飞书聊天范围 |
+
+## 5. 创建任务
+
+`POST /sino-bc-nexus/task/create`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`write`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli task api task-create --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+创建任务
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `projectId` | integer | body | 否 | 项目ID |
+| `stageId` | integer | body | 否 | 阶段ID |
+| `name` | string | body | 否 | 任务名称 |
+| `taskInfo` | string | body | 否 | 任务信息，富文本 |
+| `dueAt` | string | body | 否 | 截止时间；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
+| `members` | array | body | 否 | 任务成员列表（userId + role） |
+| `uploadRecordIdList` | array | body | 否 | 附件上传记录ID列表（来自文件上传接口返回的uploadRecordId） |
+| `skipPendingExecution` | boolean | body | 否 | 是否跳过待执行：true-跳过 false-不跳过；不传默认true |
+| `larkChat` | object | body | 否 | 关联飞书聊天范围 |
+| `taskSource` | string | body | 否 | 任务来源 RequestSourceEnum（一般由入口层写入，可选） |
+| `taskSourceSubtype` | string | body | 否 | 任务来源子类型 TaskSourceSubtypeEnum：LARK_SINGLE_CHAT（飞书单聊）/ LARK_GROUP_CHAT（飞书群聊）/ LARK_AILY_AGENT_CHAT（飞书Aily智能体聊天） |
+
+## 6. 删除任务
+
+`POST /sino-bc-nexus/task/delete`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`write`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli task api task-delete --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+删除任务
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `taskId` | integer | body | 否 | 任务ID |
+| `taskSource` | string | body | 否 | 任务来源 RequestSourceEnum（可选，与创建一致） |
+| `taskSourceSubtype` | string | body | 否 | 任务来源子类型 TaskSourceSubtypeEnum（可选，与创建一致） |
+| `larkChat` | object | body | 否 | 本次操作关联的飞书聊天范围（写入删除日志 extra） |
+
+## 7. 协同任务详情
+
+`GET /sino-bc-nexus/task/detail`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli task api task-detail --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+协同任务详情
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `id` | integer | query | 是 |  |
+
+## 8. 编辑任务（修改基本信息、所属阶段、成员、附件，状态不变更，仅限待执行/待确认）
+
+`POST /sino-bc-nexus/task/edit`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`write`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli task api task-edit --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+编辑任务（修改基本信息、所属阶段、成员、附件，状态不变更，仅限待执行/待确认）
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `taskId` | integer | body | 否 | 任务ID |
+| `name` | string | body | 否 | 任务名称 |
+| `taskInfo` | string | body | 否 | 任务信息，富文本 |
+| `dueAt` | string | body | 否 | 截止时间；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
+| `members` | array | body | 否 | 任务成员列表（userId + role） |
+| `uploadRecordIdList` | array | body | 否 | 附件上传记录ID列表（来自文件上传接口返回的uploadRecordId） |
+| `skipPendingExecution` | boolean | body | 否 | 是否跳过待执行：true-跳过 false-不跳过；不传不修改 |
+| `stageId` | integer | body | 否 | 所属阶段ID；传入则改为该阶段（须属于同一项目），不传不改 |
+| `larkChat` | object | body | 否 | 本次操作关联的飞书聊天范围（写入编辑日志 extra，不覆盖任务创建范围） |
+
+## 9. 协同任务列表（全量）
+
+`POST /sino-bc-nexus/task/list`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli task api task-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+协同任务列表（全量）
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `projectId` | integer | body | 否 | 项目ID |
+| `projectIdList` | array | body | 否 | 项目ID列表 |
+| `stageId` | integer | body | 否 | 阶段ID |
+| `status` | string | body | 否 | 任务状态 |
+| `statusList` | array | body | 否 | 任务状态列表 |
+| `todoFlag` | boolean | body | 否 | 仅查询待办任务标识 |
+| `dueAtStart` | string | body | 否 | 截止时间-起；LocalDateTime，JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；包含时分秒，精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
+| `dueAtEnd` | string | body | 否 | 截止时间-止；LocalDateTime，JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；包含时分秒，精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
+
+## 10. 协同任务列表（分页）
+
+`POST /sino-bc-nexus/task/page`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli task api task-page --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+协同任务列表（分页）
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageNum` | integer | body | 否 | 页码，从 1 开始 |
+| `pageSize` | integer | body | 否 | 每页条数 |
+| `sortType` | string | body | 否 | 排序字段 |
+| `sortDirection` | string | body | 否 | 排序方向 ASC/DESC |
+| `id` | integer | body | 否 | 任务ID |
+| `idList` | array | body | 否 | 任务ID列表 |
+| `projectId` | integer | body | 否 | 项目ID |
+| `projectIdList` | array | body | 否 | 项目ID列表 |
+| `stageId` | integer | body | 否 | 阶段ID |
+| `status` | string | body | 否 | 任务状态 |
+| `statusList` | array | body | 否 | 任务状态列表，元素为 TaskStatusTypeEnum.type。 |
+| `todoFlag` | boolean | body | 否 | 仅查询待办任务标识 |
+| `dueAtStart` | string | body | 否 | 截止时间-起；LocalDateTime，JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；包含时分秒，精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
+| `dueAtEnd` | string | body | 否 | 截止时间-止；LocalDateTime，JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；包含时分秒，精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
+| `projectStatus` | string | body | 否 | 项目状态（可选，空=全部），与 /project/page 一致：PENDING/IN_PROGRESS/FINISHED |
+| `projectStartDate` | string | body | 否 | 项目开始日期（格式 yyyy-MM-dd；与 projectEndDate 同时传入才启用项目时间筛选，不传则无时间限制）；JSON 字符串；格式 yyyy-MM-dd；仅日期，不含时分秒及时区；示例：2025-01-01 |
+| `projectEndDate` | string | body | 否 | 项目结束日期（格式 yyyy-MM-dd；与 projectStartDate 同时传入才启用项目时间筛选，不传则无时间限制）；JSON 字符串；格式 yyyy-MM-dd；仅日期，不含时分秒及时区；示例：2025-06-30 |
+
+## 11. 暂停任务
+
+`POST /sino-bc-nexus/task/pause`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`write`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli task api task-pause --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+暂停任务
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `taskId` | integer | body | 否 | 任务ID |
+
+## 12. 需修改（驳回）
+
+`POST /sino-bc-nexus/task/reject-modify`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`write`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli task api task-reject-modify --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+需修改（驳回）
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `taskId` | integer | body | 否 | 任务ID |
+| `deliveryId` | integer | body | 否 | 交付记录ID |
+| `confirmComment` | string | body | 否 | 驳回原因 |
+| `taskInfo` | string | body | 否 | 修改后的任务信息，富文本 |
+| `dueAt` | string | body | 否 | 修改后的截止时间；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
+| `members` | array | body | 否 | 修改后的任务成员列表（userId + role） |
+| `uploadRecordIdList` | array | body | 否 | 驳回附件上传记录ID列表（来自文件上传接口返回的uploadRecordId） |
+
+## 13. 审核需修改
+
+`POST /sino-bc-nexus/task/reject-review`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`write`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli task api task-reject-review --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+审核需修改
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `taskId` | integer | body | 否 | 任务ID |
+| `deliveryId` | integer | body | 否 | 交付记录ID |
+| `reviewComment` | string | body | 否 | 审核驳回原因 |
+| `uploadRecordIdList` | array | body | 否 | 驳回附件上传记录ID列表 |
+
+## 14. 去完成（提交交付）
+
+`POST /sino-bc-nexus/task/submit-delivery`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`write`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli task api task-submit-delivery --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+去完成（提交交付）
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `taskId` | integer | body | 否 | 任务ID |
+| `deliveryInfo` | string | body | 否 | 交付内容，富文本 |
+| `uploadRecordIdList` | array | body | 否 | 附件上传记录ID列表（来自文件上传接口返回的uploadRecordId） |
+| `members` | array | body | 否 | 任务成员（仅解析 role=REVIEWER 的审核人，与 create/edit 同型） |
+
+## 15. 创建任务（系统）
+
+`POST /sino-bc-nexus/task/system/create`
+
+主体上下文：`tenant=false`。
+
+角色范围：`system`。
+
+风险：`write`。
+
+仅 系统身份 可调用；请求体须提供 corporationId。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `corporationId` | string | body | 是 | 必填，须与项目所属主体一致。 |
+| `projectId` | integer | body | 是 | 项目ID |
+| `stageId` | integer | body | 是 | 阶段ID |
+| `name` | string | body | 是 | 任务名称 |
+| `taskInfo` | string | body | 否 | 任务信息，富文本 |
+| `dueAt` | string | body | 是 | 截止时间；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
+| `members` | array | body | 是 | 任务成员列表（userId + role） |
+| `uploadRecordIdList` | array | body | 否 | 附件上传记录ID列表（来自文件上传接口返回的uploadRecordId） |
+| `targetStatus` | string | body | 否 | 可选，优先于 skipPendingExecution；不传时不补系统角色。无审核人时沿用跳过审核规则，状态异步推进。 |
+| `skipPendingExecution` | boolean | body | 否 | 是否跳过待执行：true-跳过 false-不跳过；不传默认true |
+
+## 16. 提交交付（系统）
+
+`POST /sino-bc-nexus/task/system/submit-delivery`
+
+主体上下文：`tenant=false`。
+
+角色范围：`system`。
+
+风险：`write`。
+
+仅 系统身份 可调用；请求体须提供 corporationId。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `corporationId` | string | body | 是 | 必填，须与任务所属主体一致。 |
+| `taskId` | integer | body | 是 | 任务ID |
+| `deliveryInfo` | string | body | 否 | 交付内容，富文本 |
+| `uploadRecordIdList` | array | body | 否 | 附件上传记录ID列表（来自文件上传接口返回的uploadRecordId） |
+| `members` | array | body | 否 | 任务成员（仅解析 role=REVIEWER 的审核人，与 create/edit 同型） |
+
+## 17. 确认通过（系统）
+
+`POST /sino-bc-nexus/task/system/confirm`
+
+主体上下文：`tenant=false`。
+
+角色范围：`system`。
+
+风险：`write`。
+
+仅 系统身份 可调用；请求体须提供 corporationId。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `corporationId` | string | body | 是 | 必填，须与任务所属主体一致。 |
+| `taskId` | integer | body | 是 | 任务ID |
+| `deliveryId` | integer | body | 是 | 交付记录ID |
+
+## 18. 审核通过（系统）
+
+`POST /sino-bc-nexus/task/system/approve-review`
+
+主体上下文：`tenant=false`。
+
+角色范围：`system`。
+
+风险：`write`。
+
+仅 系统身份 可调用；请求体须提供 corporationId。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `corporationId` | string | body | 是 | 必填，须与任务所属主体一致。 |
+| `taskId` | integer | body | 是 | 任务ID |
+| `deliveryId` | integer | body | 是 | 交付记录ID |
+
+## 19. 任务分页（系统）
+
+`POST /sino-bc-nexus/task/system/page`
+
+主体上下文：`tenant=false`。
+
+角色范围：`system`。
+
+风险：`read`。
+
+仅 系统身份 可调用；corporationId 可选，未传查询全部主体。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `corporationId` | string | body | 否 | 可选，未传或空白时查询全部主体。 |
+| `pageNum` | integer | body | 否 | 页码，从 1 开始 |
+| `pageSize` | integer | body | 否 | 每页条数 |
+| `sortType` | string | body | 否 | 固定按创建时间倒序，传入值会被覆盖。 |
+| `sortDirection` | string | body | 否 | 固定按创建时间倒序，传入值会被覆盖。 |
+| `id` | integer | body | 否 | 任务ID |
+| `idList` | array | body | 否 | 任务ID列表 |
+| `projectId` | integer | body | 否 | 项目ID |
+| `projectIdList` | array | body | 否 | 项目ID列表 |
+| `stageId` | integer | body | 否 | 阶段ID |
+| `statusList` | array | body | 否 | 任务状态列表，元素为 TaskStatusTypeEnum.type。 |
+| `todoFlag` | boolean | body | 否 | 仅查询待办任务标识 |
+| `dueAtStart` | string | body | 否 | 截止时间-起；LocalDateTime，JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；包含时分秒，精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
+| `dueAtEnd` | string | body | 否 | 截止时间-止；LocalDateTime，JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；包含时分秒，精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
+| `projectStatus` | string | body | 否 | 项目状态（可选，空=全部），与 /project/page 一致：PENDING/IN_PROGRESS/FINISHED |
+| `projectStartDate` | string | body | 否 | 项目开始日期（格式 yyyy-MM-dd；与 projectEndDate 同时传入才启用项目时间筛选，不传则无时间限制）；JSON 字符串；格式 yyyy-MM-dd；仅日期，不含时分秒及时区；示例：2025-01-01 |
+| `projectEndDate` | string | body | 否 | 项目结束日期（格式 yyyy-MM-dd；与 projectStartDate 同时传入才启用项目时间筛选，不传则无时间限制）；JSON 字符串；格式 yyyy-MM-dd；仅日期，不含时分秒及时区；示例：2025-06-30 |
+
+## 20. 任务详情（系统）
+
+`GET /sino-bc-nexus/task/system/detail`
+
+主体上下文：`tenant=false`。
+
+角色范围：`system`。
+
+风险：`read`。
+
+仅 系统身份 可调用；签约主体从任务记录获取。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `id` | integer | query | 是 | 任务ID |

package/dist/api-doc/oapi/tenant.md

@@ -0,0 +1,17 @@
+# 签约主体
+
+对应命令：`tenant +<shortcut>` 与 `tenant api <name>`。
+
+执行前 MUST 读取 [sino-bc-shared](../../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
+## 1. 查询用户签约主体列表
+
+`GET /bc-business-pu/cli/user/corporation/list`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+查询用户租户列表

package/dist/api-doc/oapi/user.md

@@ -0,0 +1,98 @@
+# 用户信息
+
+对应命令：`user +<shortcut>` 与 `user api <name>`。
+
+执行前 MUST 读取 [sino-bc-shared](../../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
+## 1. 批量查询租户用户信息
+
+`POST /platform/tenant/user/info/batch`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+按签约主体ID和用户ID集合批量查询租户用户信息。入参去重后查询，只返回命中项。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `corporationId` | integer | body | 是 | 签约主体ID |
+| `userIdList` | array | body | 是 | 用户ID集合 |
+
+## 2. 查询租户用户信息
+
+`POST /platform/tenant/user/info`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+按签约主体ID和用户ID查询租户用户信息，返回用户ID、用户名称。查不到返回 result 为 null。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `corporationId` | integer | body | 是 | 签约主体ID |
+| `userId` | integer | body | 是 | 用户ID |
+
+## 3. 查询SSO用户信息(用户ID)
+
+`POST /platform/sso/user/info`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+按用户ID查询SSO用户信息。返回用户ID、用户名称、账户登陆名。查不到返回 result 为 null。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `userId` | integer | body | 是 | 用户ID |
+
+## 4. 批量查询SSO用户信息(用户ID)
+
+`POST /platform/sso/user/info/batch`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+按用户ID集合批量查询SSO用户信息。返回用户ID、用户名称、账户登陆名。入参去重后查询，只返回命中项。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `userIdList` | array | body | 是 | 用户ID集合 |
+
+## 5. 查询SSO用户列表（支持名称模糊）
+
+`POST /bc-business-pu/user/querySsoUserList`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+查询 SSO 用户列表，userIdList和userName至少传一个。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `userIdList` | array | body | 否 | SSO 用户 ID 列表 |
+| `userName` | string | body | 否 | 名称模糊查询关键字 |