sino-bc-cli 1.0.0-beta.0

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

@@ -0,0 +1,1114 @@
+# 营销协同项目
+
+对应命令：`project +<shortcut>` 与 `project api <name>`。
+
+执行前 MUST 读取 [sino-bc-shared](../../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
+## 1. 按项目查询最新操作日志（分页倒序）
+
+`POST /sino-bc-nexus/project-action-log/page-by-project`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli project api project-action-log-page-by-project --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 |
+| `projectId` | integer | body | 否 | 所属项目ID |
+
+## 2. 预算分布动态字段配置（按签约主体解析：主体 > 行业 > 不展示）
+
+`GET /sino-bc-nexus/project/budget-field-config`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli project api project-budget-field-config --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+预算分布动态字段配置（按签约主体解析：主体 > 行业 > 不展示）
+
+## 3. 创建对客项目
+
+`POST /sino-bc-nexus/project/create`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`write`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli project api project-create --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+创建对客项目
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `groupId` | integer | body | 否 | 项目分组 |
+| `name` | string | body | 否 | 节点名称 |
+| `projectInfo` | string | body | 否 | 项目信息（最多2000字，纯富文本内容，附件通过t_nexus_document管理） |
+| `stageTemplateId` | integer | body | 否 | 创建时选用的阶段模板来源（运营统计） |
+| `projectLevel` | string | body | 否 | S/A/B/C |
+| `startDate` | string | body | 否 | 项目开始时间；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
+| `endDate` | string | body | 否 | 项目结束时间；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
+| `projectType` | string | body | 否 | 项目类型 |
+| `businessLine` | string | body | 否 | 所属业务线编码 |
+| `marketScope` | string | body | 否 | 市场范围编码 |
+| `budgetAmount` | number | body | 否 | 项目预算 |
+| `budgets` | array | body | 否 | 预算分布明细（维度+金额） |
+| `milestones` | array | body | 否 | 重要时间节点（名称+日期），创建时会序列化到milestones_json） |
+| `milestonesJson` | string | body | 否 | 重要时间节点（名称+日期），JSON字符串，兼容老入参 |
+| `riskNote` | string | body | 否 | 风险点 |
+| `remark` | string | body | 否 | 备注 |
+| `amPocUserIds` | array | body | 否 | AM POC（多选，用户ID列表） |
+| `pmPocUserIds` | array | body | 否 | PM POC（多选，用户ID列表） |
+| `participantUserIds` | array | body | 否 | 项目参与人（多选，用户ID列表） |
+| `mentorUserId` | integer | body | 否 | 带教（单选，用户ID） |
+| `customerOwnerUserId` | integer | body | 否 | 客户负责人（单选，用户ID） |
+| `uploadRecordIdList` | array | body | 否 | 文件上传记录主键列表（批量关联为项目附件） |
+| `isStaged` | boolean | body | 否 | 是否分阶段投放 |
+| `deliveryStages` | array | body | 否 | 投放阶段列表；isStaged=true 时必填阶段信息；isStaged=false 时可仅传一条且只含 kpiTargets |
+| `when` | string | body | 否 | 节点时间，支持日期或日期时间文本 |
+
+## 4. 删除对客项目
+
+`POST /sino-bc-nexus/project/delete`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`write`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli project api project-delete --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+删除对客项目
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `id` | integer | body | 否 | 项目ID |
+
+## 5. 投放阶段列表
+
+`GET /sino-bc-nexus/project/delivery-data/stage-tabs`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli project api project-delivery-data-stage-tabs --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+投放阶段 Tab 下拉（含起止时间）
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `projectId` | integer | query | 是 |  |
+
+## 6. 对客项目详情
+
+`GET /sino-bc-nexus/project/detail`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli project api project-detail --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+对客项目详情（平铺 JSON：ext_json values + 业务组装字段）
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `id` | integer | query | 是 | 项目ID |
+
+## 7. 删除项目文档
+
+`POST /sino-bc-nexus/project/document/delete`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`write`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli project api project-document-delete --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+删除项目文档
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `documentId` | integer | body | 否 | 文档ID |
+
+## 8. 查询项目文档已关联任务列表
+
+`POST /sino-bc-nexus/project/document/linked-tasks`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli project api project-document-linked-tasks --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+查询项目文档已关联任务列表（同项目同 storage_key 的 TASK 文档行）
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `documentId` | integer | body | 否 | 项目文档ID（doc_type=PROJECT） |
+
+## 9. 查询项目文档
+
+`POST /sino-bc-nexus/project/document/list`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli project api project-document-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+查询项目文档
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `projectId` | integer | body | 否 | 项目ID |
+| `fileName` | string | body | 否 | 文件名（模糊匹配） |
+| `projectStageId` | integer | body | 否 | 项目阶段ID；传 0 表示「其他」（无 PROJECT_STAGE 标记或 ref_id=0） |
+
+## 10. 修改项目文档所属阶段
+
+`POST /sino-bc-nexus/project/document/update-stage`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`write`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli project api project-document-update-stage --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+修改项目文档所属阶段
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `documentId` | integer | body | 否 | 项目文档ID |
+| `projectStageId` | integer | body | 否 | 项目阶段ID；不传或 null 表示「其他」 |
+
+## 11. 上传项目文档
+
+`POST /sino-bc-nexus/project/document/upload`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`write`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli project api project-document-upload --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+上传项目文档（multipart/form-data：projectId项目ID，file 为文件 part）
+
+编码：`multipart/form-data`；文件字段填写本地路径，`--dry-run` 只预览、不上传。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `file` | string | form | 是 | 本地文件路径；发送时读取为文件。文件 |
+| `projectId` | integer | query | 是 | 项目ID |
+| `projectStageId` | integer | query | 否 | 项目阶段ID |
+
+## 12. 动态表单创建对客项目
+
+`POST /sino-bc-nexus/project/form-create`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`write`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli project api project-form-create --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+请求入参按动态表单接口来，参考：
+/sino-bc-nexus/admin/corp-project-form-template/form-schema，此处 request 给出目前字段样例，不完备。动态表单变更，根据动态表单返回结构解析后选择入参。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `groupId` | integer | body | 否 | 项目分组 |
+| `name` | string | body | 是 | 创建必填且不能全为空白；编辑请提交完整项目名称。 |
+| `projectInfo` | string | body | 否 | 项目说明内容；附件通过 uploadRecordIdList 关联。 |
+| `stageTemplateId` | integer | body | 否 | 创建时选用的阶段模板来源（运营统计） |
+| `projectLevel` | string | body | 否 | S/A/B/C |
+| `startDate` | string | body | 否 | 项目开始时间；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
+| `endDate` | string | body | 否 | 项目结束时间；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
+| `projectType` | string | body | 否 | 项目类型 |
+| `businessLine` | string | body | 否 | 所属业务线编码 |
+| `marketScope` | string | body | 否 | 市场范围编码 |
+| `budgetAmount` | number | body | 否 | 项目总预算，不能小于0；budgets 非空时必填。 |
+| `budgets` | array | body | 否 | 预算分布明细（维度+金额） |
+| `milestonesJson` | string | body | 否 | JSON 字符串，节点包含 name（名称）和 when（日期或日期时间文本）；直接提交同名 DTO 字段。 |
+| `riskNote` | string | body | 否 | 风险点 |
+| `remark` | string | body | 否 | 备注 |
+| `amPocUserIds` | array | body | 否 | AM POC（多选，用户ID列表） |
+| `pmPocUserIds` | array | body | 否 | PM POC（多选，用户ID列表） |
+| `participantUserIds` | array | body | 否 | 项目参与人（多选，用户ID列表） |
+| `mentorUserId` | integer | body | 否 | 带教（单选，用户ID） |
+| `customerOwnerUserId` | integer | body | 否 | 客户负责人（单选，用户ID） |
+| `uploadRecordIdList` | array | body | 否 | 文件上传记录主键列表（批量关联为项目附件） |
+| `isStaged` | boolean | body | 否 | 是否分阶段投放；deliveryStages 非空且本字段未传时，服务端自动补 true。不分阶段仅提交 KPI 时应显式传 false。 |
+| `deliveryStages` | array | body | 否 | 投放阶段列表；isStaged=true 时至少一条，名称必填且不超过20字、不能重复，起止时间必填且须在项目时间内，阶段不得重叠，预算大于0；提供项目总预算时阶段预算之和须与之相等。isStaged=false 时可传一条仅含 kpiTargets 的记录。 |
+| `templateType` | string | body | 否 | 默认 PROJECT；服务端去除首尾空白并转为大写。 |
+| `templateId` | integer | body | 否 | 选填。显式传入时必须存在；创建未传时依次使用签约主体绑定模板、SYSTEM 种子模板；编辑未传时先沿用该项目同类型的已有模板绑定。 |
+| `members` | array | body | 否 | 元素为 userId、role；非空时优先于按角色拆分的成员字段。 |
+| `taskSource` | string | body | 否 | 来源编码：BC_NEXUS（协同）、WEB_EMBED（网页内嵌）、AGENT-AILY、OPTI_HIVE（优化工作台）；仅用于本次操作，不保存到表单扩展快照。 |
+| `taskSourceSubtype` | string | body | 否 | 飞书子类型：LARK_SINGLE_CHAT、LARK_GROUP_CHAT、LARK_AILY_AGENT_CHAT；命中任一类型时必须传完整 larkChat。 |
+| `larkChat` | object | body | 否 | 飞书来源子类型时必填，chatId/startMessageId/endMessageId 均不能为空白；仅用于本次操作。 |
+| `mpLink` | string | body | 否 | 动态扩展字段；链接新增或变更会进入异步解析流程。 |
+
+## 13. 动态表单编辑对客项目
+
+`POST /sino-bc-nexus/project/form-update`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`write`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli project api project-form-update --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+请求入参按动态表单接口来，参考：
+/sino-bc-nexus/admin/corp-project-form-template/form-schema，此处 request 给出目前字段样例，不完备。动态表单变更，根据动态表单返回结构解析后选择入参。
+
+编辑采用整体替换，不是只更新传入字段。提交前先读取项目详情，以现有可写业务字段为基础合并本次修改，保留未修改的普通字段、动态扩展字段、完整成员和附件列表；不要直接回传权限、审计等只读字段，也不要仅提交 id 和变更字段。预算、投放阶段等字段另有未传/null/空列表的处理规则时，以对应字段说明为准。
+
+获取编辑表单时，调用 /sino-bc-nexus/admin/corp-project-form-template/form-schema 并传 refId=目标项目ID、templateType=对应模板类型，使用项目绑定模板。创建和编辑提交的 templateType 缺省为 PROJECT。
+
+已有 mpLink 被漏传或清空会按删除链接处理；已有 mpLink 被删除或更换时，会清理原投放阶段及其 KPI、预算明细，不清空项目总预算金额。换链后再异步解析新文档，删除链接不会重新解析。仅修改其他字段时必须保留原 mpLink；提交前明确核对链接变化及其清理后果。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `id` | integer | body | 是 | 必填，待编辑项目ID；服务端校验主体及项目编辑权限。 |
+| `groupId` | integer | body | 否 | 项目分组 |
+| `name` | string | body | 否 | 创建必填且不能全为空白；编辑请提交完整项目名称。 |
+| `projectInfo` | string | body | 否 | 项目说明内容；附件通过 uploadRecordIdList 关联。 |
+| `stageTemplateId` | integer | body | 否 | DTO 可接收；当前表单编辑不据此重建项目阶段模板。 |
+| `projectLevel` | string | body | 否 | S/A/B/C |
+| `startDate` | string | body | 否 | 项目开始时间；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
+| `endDate` | string | body | 否 | 项目结束时间；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
+| `projectType` | string | body | 否 | 项目类型 |
+| `businessLine` | string | body | 否 | 所属业务线编码 |
+| `marketScope` | string | body | 否 | 市场范围编码 |
+| `budgetAmount` | number | body | 否 | 项目总预算，不能小于0；budgets 非空时必填。 |
+| `budgets` | array | body | 否 | 预算分布明细；未传或 null 且未修改投放阶段时保留原明细，[] 显式清空普通维度；修改投放阶段时按阶段规则合并。 |
+| `milestonesJson` | string | body | 否 | JSON 字符串，节点包含 name（名称）和 when（日期或日期时间文本）；直接提交同名 DTO 字段。 |
+| `riskNote` | string | body | 否 | 风险点 |
+| `remark` | string | body | 否 | 备注 |
+| `amPocUserIds` | array | body | 否 | AM POC（多选，用户ID列表） |
+| `pmPocUserIds` | array | body | 否 | PM POC（多选，用户ID列表） |
+| `participantUserIds` | array | body | 否 | 项目参与人（多选，用户ID列表） |
+| `mentorUserId` | integer | body | 否 | 带教（单选，用户ID） |
+| `customerOwnerUserId` | integer | body | 否 | 客户负责人（单选，用户ID） |
+| `uploadRecordIdList` | array | body | 否 | 文件上传记录ID列表；按整组替换项目附件，未传或空列表会移除原项目附件关联，请提交完整列表。 |
+| `isStaged` | boolean | body | 否 | 是否分阶段投放；deliveryStages 非空且本字段未传时，服务端自动补 true。不分阶段仅提交 KPI 时应显式传 false。 |
+| `deliveryStages` | array | body | 否 | 投放阶段列表；isStaged=true 时至少一条，名称必填且不超过20字、不能重复，起止时间必填且须在项目时间内，阶段不得重叠，预算大于0；提供项目总预算时阶段预算之和须与之相等。isStaged=false 时可传一条仅含 kpiTargets 的记录。 |
+| `templateType` | string | body | 否 | 默认 PROJECT；服务端去除首尾空白并转为大写。 |
+| `templateId` | integer | body | 否 | 选填。显式传入时必须存在；创建未传时依次使用签约主体绑定模板、SYSTEM 种子模板；编辑未传时先沿用该项目同类型的已有模板绑定。 |
+| `members` | array | body | 否 | 元素为 userId、role；非空时优先于按角色拆分的成员字段。 编辑时重建成员关系，未传不能视为保留原成员；请提交完整成员。 |
+| `taskSource` | string | body | 否 | 来源编码：BC_NEXUS（协同）、WEB_EMBED（网页内嵌）、AGENT-AILY、OPTI_HIVE（优化工作台）；仅用于本次操作，不保存到表单扩展快照。 |
+| `taskSourceSubtype` | string | body | 否 | 飞书子类型：LARK_SINGLE_CHAT、LARK_GROUP_CHAT、LARK_AILY_AGENT_CHAT；命中任一类型时必须传完整 larkChat。 |
+| `larkChat` | object | body | 否 | 飞书来源子类型时必填，chatId/startMessageId/endMessageId 均不能为空白；仅用于本次操作。 |
+| `mpLink` | string | body | 否 | 动态扩展字段。编辑时保留未修改的原链接；已有链接被漏传或清空视为删除。删除或更换已有链接会清理原投放阶段及其 KPI、预算明细，不清空项目总预算金额；换链后再异步解析新文档，删除不再解析。首次新增链接进入异步解析流程。 |
+| `projectStatus` | string | body | 否 | DTO 可接收此字段，但当前表单编辑不据此更新主表状态；状态变更使用 /project/status/update。 |
+
+## 14. 批量修改项目分组（将指定项目移动到目标分组）
+
+`POST /sino-bc-nexus/project-group/batch-update-projects`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`write`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli project api project-group-batch-update-projects --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+批量修改项目分组（将指定项目移动到目标分组）
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `groupId` | integer | body | 否 | 目标分组ID |
+| `projectIds` | array | body | 否 | 项目ID列表 |
+
+## 15. 创建项目分组
+
+`POST /sino-bc-nexus/project-group/create`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`write`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli project api project-group-create --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+创建项目分组
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `name` | string | body | 否 | 分组名称 |
+
+## 16. 删除项目分组
+
+`POST /sino-bc-nexus/project-group/delete`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`write`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli project api project-group-delete --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+删除项目分组
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `id` | integer | body | 否 | 分组ID |
+
+## 17. 分组详情
+
+`GET /sino-bc-nexus/project-group/detail`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli project api project-group-detail --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+分组详情
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `id` | integer | query | 是 |  |
+
+## 18. 分组列表（全量）
+
+`POST /sino-bc-nexus/project-group/list`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli project api project-group-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+分组列表（全量）
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `name` | string | body | 否 | 分组名称（模糊匹配） |
+
+## 19. 更新项目分组名称
+
+`POST /sino-bc-nexus/project-group/update`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`write`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli project api project-group-update --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+更新项目分组名称
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `id` | integer | body | 否 | 分组ID |
+| `name` | string | body | 否 | 分组名称 |
+
+## 20. 对客项目列表（全量）
+
+`POST /sino-bc-nexus/project/list`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli project api project-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+对客项目列表（全量）
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `projectId` | integer | body | 否 | 项目ID（精确） |
+| `projectIdList` | array | body | 否 | 项目ID列表 |
+| `groupId` | integer | body | 否 | 分组ID |
+| `name` | string | body | 否 | 项目名称（模糊匹配） |
+| `projectLevel` | string | body | 否 | 项目等级：S/A/B/C |
+| `projectLevelList` | array | body | 否 | 项目等级多选：S/A/B/C |
+| `projectTypeList` | array | body | 否 | 项目类型多选 |
+| `stageNameList` | array | body | 否 | 当前阶段名称多选（与仪表盘阶段分布 code 一致） |
+| `projectStatus` | string | body | 否 | 项目状态（可选，空=全部） |
+
+## 21. 邀请项目成员
+
+`POST /sino-bc-nexus/project-member/invite`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`write`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli project api project-member-invite --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+邀请项目成员
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `projectId` | integer | body | 否 | 项目ID |
+| `userIdList` | array | body | 否 | 待邀请用户ID列表 |
+
+## 22. 项目成员列表
+
+`GET /sino-bc-nexus/project-member/list`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli project api project-member-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+项目成员列表
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `projectId` | integer | query | 是 |  |
+
+## 23. 指定用户关联项目列表（项目成员+任务成员）
+
+`GET /sino-bc-nexus/project-member/projects`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli project api project-member-projects --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+指定用户关联项目列表（项目成员+任务成员）
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `userId` | integer | query | 是 |  |
+
+## 24. 移除项目成员
+
+`POST /sino-bc-nexus/project-member/remove`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`write`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli project api project-member-remove --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+移除项目成员
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `projectId` | integer | body | 否 | 项目ID |
+| `userId` | integer | body | 否 | 被移除用户ID |
+
+## 25. 项目成员参与任务
+
+`GET /sino-bc-nexus/project-member/tasks`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli project api project-member-tasks --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+项目成员参与任务
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `projectId` | integer | query | 是 |  |
+| `userId` | integer | query | 是 |  |
+
+## 26. 对客项目列表（分页）
+
+`POST /sino-bc-nexus/project/page`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli project api project-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 |
+| `projectId` | integer | body | 否 | 项目ID（精确） |
+| `projectIdList` | array | body | 否 | 项目ID列表 |
+| `groupId` | integer | body | 否 | 分组ID |
+| `name` | string | body | 否 | 项目名称（模糊匹配） |
+| `projectLevel` | string | body | 否 | 项目等级：S/A/B/C |
+| `projectLevelList` | array | body | 否 | 项目等级多选：S/A/B/C |
+| `projectTypeList` | array | body | 否 | 项目类型多选 |
+| `stageNameList` | array | body | 否 | 当前阶段名称多选（与仪表盘阶段分布 code 一致） |
+| `projectStatus` | string | body | 否 | 项目状态（可选，空=全部） |
+| `createTimeStart` | string | body | 否 | 项目创建时间开始（非必填）；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
+| `createTimeEnd` | string | body | 否 | 项目创建时间结束（非必填）；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
+| `startDate` | string | body | 否 | 项目开始时间（非必填，筛选 start_date >= startDate）；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
+| `endDate` | string | body | 否 | 项目结束时间（非必填，筛选 end_date <= endDate）；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
+
+## 27. 查询项目阶段列表（含可见任务数）
+
+`GET /sino-bc-nexus/project-stage/list-with-task-count`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli project api project-stage-list-with-task-count --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+按 sortOrder 升序返回。status 按该阶段全部未删除任务计算；
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `projectId` | integer | query | 是 | 项目 ID |
+
+## 28. 查询项目阶段列表
+
+`GET /sino-bc-nexus/project-stage/listByProjectId`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli project api project-stage-listByProjectId --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+按 sortOrder 升序返回；含阶段状态 status（有任务时计算，可能为空）
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `projectId` | integer | query | 是 | 项目 ID |
+
+## 29. 批量保存项目阶段
+
+`POST /sino-bc-nexus/project-stage/save`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`write`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli project api project-stage-save --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+一次提交完整 stages 列表，服务端 diff 完成增/删/改名/排序（单事务）。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `projectId` | integer | body | 否 | 项目 ID |
+| `stages` | array | body | 否 | 提交后的完整阶段列表（含增删改序后的最终顺序） |
+
+## 30. 项目阶段名称列表
+
+`POST /sino-bc-nexus/project-stage/stage-name-list`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli project api project-stage-stage-name-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+当前用户具备 PROJECT_QUERY 的项目下，t_project_stage 按 name 去重；name 可选模糊匹配，供筛选下拉
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `name` | string | body | 否 | 阶段名称（模糊匹配，可选） |
+
+## 31. 更新对客项目状态
+
+`POST /sino-bc-nexus/project/status/update`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`write`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli project api project-status-update --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+更新对客项目状态
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `projectId` | integer | body | 否 | 项目ID |
+| `projectStatus` | string | body | 否 | 项目状态编码 |
+
+## 32. 编辑对客项目
+
+`POST /sino-bc-nexus/project/update`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`write`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli project api project-update --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+编辑对客项目
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `id` | integer | body | 否 | 项目ID |
+| `groupId` | integer | body | 否 | 项目分组 |
+| `name` | string | body | 否 | 项目名称（必填，最多100字） |
+| `projectInfo` | string | body | 否 | 项目信息（最多2000字，纯富文本内容） |
+| `stageTemplateId` | integer | body | 否 | 创建时选用的阶段模板来源（运营统计） |
+| `projectLevel` | string | body | 否 | S/A/B/C |
+| `startDate` | string | body | 否 | 项目开始时间；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
+| `endDate` | string | body | 否 | 项目结束时间；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
+| `projectStatus` | string | body | 否 | 项目状态 |
+| `projectType` | string | body | 否 | 项目类型 |
+| `businessLine` | string | body | 否 | 所属业务线编码 |
+| `marketScope` | string | body | 否 | 市场范围编码 |
+| `budgetAmount` | number | body | 否 | 项目预算 |
+| `budgets` | array | body | 否 | 预算分布明细（维度+金额）；null=不修改，[] = 清空 |
+| `milestones` | array | body | 否 | 重要时间节点（名称+日期），会序列化到milestones_json） |
+| `riskNote` | string | body | 否 | 风险点 |
+| `remark` | string | body | 否 | 备注 |
+| `amPocUserIds` | array | body | 否 | AM POC（多选，用户ID列表） |
+| `pmPocUserIds` | array | body | 否 | PM POC（多选，用户ID列表） |
+| `mentorUserId` | integer | body | 否 | 带教（单选，用户ID） |
+| `customerOwnerUserId` | integer | body | 否 | 客户负责人（单选，用户ID） |
+| `uploadRecordIdList` | array | body | 否 | 文件上传记录主键列表（批量关联为项目附件） |
+| `participantUserIds` | array | body | 否 | 项目参与人（多选，用户ID列表） |
+| `isStaged` | boolean | body | 否 | 是否分阶段投放 |
+| `deliveryStages` | array | body | 否 | 投放阶段列表；isStaged=true 时必填阶段信息；isStaged=false 时可仅传一条且只含 kpiTargets |
+
+## 33. 根据签约主体获取创建项目动态表单
+
+`GET /sino-bc-nexus/admin/corp-project-form-template/form-schema`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli project api corp-project-form-template-form-schema --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+根据签约主体获取创建项目动态表单
+
+新建项目时可省略 refId，按签约主体绑定模板或系统种子模板获取表单。编辑项目时应传 refId=目标项目ID，并传对应 templateType，以优先获取该项目已绑定的模板；省略 refId 会走新建模板选择，主体更换模板后可能与原项目模板不同。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `templateType` | string | query | 是 | 模板类型，非空；如PROJECT，可动态扩展 |
+| `refId` | integer | query | 否 | 业务记录ID；PROJECT 时为项目ID。新建可省略；编辑应传目标项目ID，以优先获取该项目已绑定模板，避免取到主体当前的新建模板。 |
+
+## 34. 项目操作权限汇总
+
+`POST /sino-bc-nexus/project/actions`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli project api project-actions --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+项目操作权限汇总
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `corporationId` | string | body | 是 | 必填，不能为空白字符串。 |
+| `projectId` | integer | body | 否 | 可选；省略时只判断创建权限。传入时必须为正整数，最大 Long.MAX_VALUE - 1。 建议需要精确大整数的调用方使用原始 JSON 数字文本，避免 JavaScript number 精度损失。 |
+
+## 35. 查询项目已绑定飞书群
+
+`POST /sino-bc-nexus/project/chat/bindings`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli project api project-chat-bindings --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+查询项目已绑定飞书群
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `projectId` | integer | body | 是 | 必填，正整数，最大 Long.MAX_VALUE - 1（9223372036854775806）；建议十进制字符串传递以避免 JavaScript 精度丢失。 |
+| `keyword` | string | body | 否 | 可选，最多 255 字符；候选群查询使用，绑定列表忽略。 |
+| `pageNum` | integer | body | 否 | 可省略，默认 1；显式 null 不允许。 |
+| `pageSize` | integer | body | 否 | 可省略，默认 20；范围 1～100，显式 null 不允许。 |
+
+## 36. 分页查询项目可绑定飞书群
+
+`POST /sino-bc-nexus/project/chat/eligible`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli project api project-chat-eligible --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+分页查询项目可绑定飞书群
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `projectId` | integer | body | 是 | 必填，正整数，最大 Long.MAX_VALUE - 1（9223372036854775806）；建议十进制字符串传递以避免 JavaScript 精度丢失。 |
+| `keyword` | string | body | 否 | 可选，最多 255 字符；候选群查询使用，绑定列表忽略。 |
+| `pageNum` | integer | body | 否 | 可省略，默认 1；显式 null 不允许。 |
+| `pageSize` | integer | body | 否 | 可省略，默认 20；范围 1～100，显式 null 不允许。 |
+
+## 37. 绑定项目飞书群
+
+`POST /sino-bc-nexus/project/chat/bind`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/system`。
+
+风险：`write`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli project api project-chat-bind --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+绑定项目飞书群
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `projectId` | integer | body | 是 | 必填，正整数，最大 Long.MAX_VALUE - 1（9223372036854775806）；建议十进制字符串传递以避免 JavaScript 精度丢失。 |
+| `chatId` | string | body | 是 | 必填，飞书群 ID；非空白，最长 128 字符，不能包含首尾空白字符。 |
+| `larkChat` | object | body | 否 | 可选；传入时三个字段必须齐全且非空白，用于操作日志关联聊天范围。 |
+
+## 38. 解绑项目飞书群
+
+`POST /sino-bc-nexus/project/chat/unbind`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/system`。
+
+风险：`write`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli project api project-chat-unbind --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+解绑项目飞书群
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `projectId` | integer | body | 是 | 必填，正整数，最大 Long.MAX_VALUE - 1（9223372036854775806）；建议十进制字符串传递以避免 JavaScript 精度丢失。 |
+| `bindingId` | integer | body | 是 | 必填，正整数，最大 Long.MAX_VALUE - 1（9223372036854775806）；建议十进制字符串传递以避免 JavaScript 精度丢失。 |
+| `larkChat` | object | body | 否 | 可选；传入时三个字段必须齐全且非空白，用于操作日志关联聊天范围。 |
+
+## 39. 换绑项目飞书群
+
+`POST /sino-bc-nexus/project/chat/replace`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/system`。
+
+风险：`write`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli project api project-chat-replace --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+换绑项目飞书群
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `projectId` | integer | body | 是 | 必填，正整数，最大 Long.MAX_VALUE - 1（9223372036854775806）；建议十进制字符串传递以避免 JavaScript 精度丢失。 |
+| `bindingId` | integer | body | 是 | 必填，正整数，最大 Long.MAX_VALUE - 1（9223372036854775806）；建议十进制字符串传递以避免 JavaScript 精度丢失。 |
+| `newChatId` | string | body | 是 | 必填，飞书群 ID；非空白，最长 128 字符，不能包含首尾空白字符。 |
+
+## 40. 按飞书群查询关联项目
+
+`POST /sino-bc-nexus/project/chat/projects`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/system`。
+
+风险：`read`。
+
+按飞书群 ID 查询当前签约主体下的有效项目绑定，并仅返回当前用户拥有 PROJECT_QUERY 权限的项目。结果为数组，不分页；未匹配到可查询项目时返回空数组。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `chatId` | string | body | 是 | 必填，非空白字符串，最长 128 字符；不能包含首尾 ASCII 控制字符或空白。使用当前用户身份所属飞书租户限定查询，无默认值。 |
+
+## 41. 查询机器人所在飞书群
+
+`POST /sino-bc-nexus/project/chat/chats`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/system`。
+
+风险：`read`。
+
+查询当前用户身份所属飞书租户内，机器人仍在群内且未删除的群列表。返回全部匹配记录，不分页，不按项目或关键词筛选。
+
+## 42. 系统身份查询对客项目列表（分页）
+
+`POST /sino-bc-nexus/project/system/page`
+
+主体上下文：`tenant=false`。
+
+角色范围：`system`。
+
+风险：`read`。
+
+为系统身份提供项目列表查询
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageNum` | integer | body | 否 | 页码，从 1 开始 |
+| `pageSize` | integer | body | 否 | 每页条数 |
+| `corporationId` | string | body | 否 | 可选；去除首尾空格后为空或未传时查询全部主体，仅系统身份分页接口使用 |
+| `sortType` | string | body | 否 | 排序字段；本接口固定按项目变更时间倒序，此入参会被服务端覆盖 |
+| `sortDirection` | string | body | 否 | 排序方向 ASC/DESC；本接口固定按项目变更时间倒序，此入参会被服务端覆盖 |
+| `projectId` | integer | body | 否 | 项目ID（精确） |
+| `projectIdList` | array | body | 否 | 项目ID列表 |
+| `groupId` | integer | body | 否 | 分组ID |
+| `name` | string | body | 否 | 项目名称（模糊匹配） |
+| `projectLevel` | string | body | 否 | 项目等级：S/A/B/C |
+| `projectLevelList` | array | body | 否 | 项目等级多选：S/A/B/C |
+| `projectTypeList` | array | body | 否 | 项目类型多选 |
+| `stageNameList` | array | body | 否 | 当前阶段名称多选（与仪表盘阶段分布 code 一致） |
+| `projectStatus` | string | body | 否 | 项目状态（可选，空=全部） |
+| `createTimeStart` | string | body | 否 | 项目创建时间开始（非必填）；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
+| `createTimeEnd` | string | body | 否 | 项目创建时间结束（非必填）；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
+| `startDate` | string | body | 否 | 项目开始时间（非必填，筛选 start_date >= startDate）；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
+| `endDate` | string | body | 否 | 项目结束时间（非必填，筛选 end_date <= endDate）；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
+
+## 43. 项目详情（系统）
+
+`GET /sino-bc-nexus/project/system/detail`
+
+主体上下文：`tenant=false`。
+
+角色范围：`system`。
+
+风险：`read`。
+
+仅 系统身份 可调用；签约主体从项目记录获取。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `id` | integer | query | 是 | 项目ID |