@alanwang-merit/meritdata-platform-skill-package 1.0.9 → 1.0.10

package/skills/meritdata-platform-integration/references/external-api/full/48_3.20/350/260/203/345/272/246/347/274/226/346/216/222.md

@@ -0,0 +1,106 @@
+---
+name: 3.20 调度编排
+source-file: 外部接口清单
+source-section: 3.20 调度编排（含 L12375 孤立文字）
+keywords: [调度编排, 业务系统状态, 立即执行, 业务流生成]
+use-cases: [调度编排管理]
+related: [13, 49_附录-4.1-4.3返回码与版本清单.md]
+---
+
+# 3.20 调度编排
+
+> **原文章节**：`外部接口清单 → 3.20 调度编排（含 L12375 孤立文字）`
+> **行号范围**：L12299-L12376
+
+## 🎯 一句话
+本章节提供业务系统调度状态查询、业务流及任务生成发布和调度立即执行接口。
+
+## 📋 接口清单
+
+## 3.20 调度编排
+
+---
+
+### 3.20.1 查询业务系统在调度编排状态
+
+- **接口地址**：`/taier/schedule/sync/job-schedule-status`
+- **请求类型**：`application/json`
+- **请求方式**：`post`
+- **接口备注**：`暂无描述`
+- **调试工具**：`ApiPost`
+
+**请求头参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| Cookie | cloudSessionId=Ym VjODg3YzA2YmE0N Dc1MmFiZDg3MGY 4MDdiN2FlOWE=; TENANCY_ID_ee9c 625bd39ed9697d7 4c3de921d2c72=""; accessToken=eyJhb GciOiJIUzI1NiIsInpp cCI6IkRFRiJ9.eNqM zN2KwjAQhuF7mW NbvqTpZOLNyOSn NYtW0Qqi7L1voHjg 2TInw8vD96b7I9Ke Xsd61GWmHT3u5X aouTUXrWRhZnjr4 HL0CJY9IGFyHsMH L3ouXxOX27wtTJO gnREraUwJaF8Y48S iCoCbzeW6_huX55 | Text | 是 | 暂无描述 |
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |  |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661321187914 | Number | 时间戳 |
+| status | 1 | Number | 状态 |
+| message | 成功 | String | 返回消息 |
+| stackmessage |  | Object | 堆栈消息 |
+| path | /taier/schedule/sync/job- schedule-status | String | api 路径 |
+| data |  | Object | 返回数据 |
+| extraInfo | {} | Object | 拓展信息 |
+| success | true | String | 成功响应 |
+---
+
+### 统计日志的任务
+
+### 工作流程项目成功依赖上衣周期的流
+
+### 3.20.2 定制接口生成业务流及任务并发布
+
+- **接口地址**：`/taier/batchTask/create-flow-and-task请求类型：application/json`
+- **请求方式**：`post`
+- **接口备注**：`暂无描述 调试工具：ApiPost`
+
+**返回成功参数说明**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1699323482124 | Number | 时间戳 |
+| status | 1 | Number | 状态 |
+| message | 成功 | String | 返回消息 |
+| stackmessage |  | Object | 堆栈消息 |
+| path | /taier/batchTask/create- flow- and-task | String | api 路径 |
+| data |  | Object | 返回数据任务 |
+| extraInfo | {} | Object | 拓展信息 |
+| success | true | String | 成功响应 |
+---
+
+### 3.20.3 调度编排立即执行接口
+
+- **接口地址**：`/schedule/thirdSystemDealScheduleJob`
+- **请求类型**：`application/json`
+- **请求方式**：`post`
+- **接口备注**：`立即执行`
+- **调试工具**：`ApiPost`
+
+**请求头参数说明：请求头获取方式参见技术共享中心《调度编排二开说明》-第三**
+
+| 参数名 | 示例值 |  | 参数类型 |  |  | 是否必填 |  | 参数描述 |
+|---|---|---|---|---|---|---|---|---|
+---
+
+### 是任务流id
+
+
+## 💡 使用建议
+- 调度编排接口依赖平台会话和租户请求头，调用前确认认证信息已正确注入。
+- 生成业务流及立即执行属于有副作用操作，建议先查询业务系统状态并做好幂等控制。
+- 原文末尾保留了孤立文字“是任务流id”，需结合平台二开说明解释其参数语义。
+
+## 🔗 相关章节
+- 13
+- 49_附录-4.1-4.3返回码与版本清单.md

package/skills/meritdata-platform-integration/references/external-api/full/49_/351/231/204/345/275/225-4.1-4.3/350/277/224/345/233/236/347/240/201/344/270/216/347/211/210/346/234/254/346/270/205/345/215/225.md

@@ -0,0 +1,43 @@
+---
+name: 附录 4.1–4.3 返回码与版本清单
+source-file: 外部接口清单
+source-section: 4.1–4.3 返回码与版本清单
+keywords: [返回码, V6.8版本接口, V6.9版本接口, 附录]
+use-cases: [返回码查询, 版本接口清单]
+related: [01_目录与文档结构.md]
+---
+
+> **注**：原文 PDF 中此节无表格内容（仅章节标题）。
+
+# 附录 4.1–4.3 返回码与版本清单
+
+> **原文章节**：`外部接口清单 → 4.1–4.3 返回码与版本清单`
+> **行号范围**：L12377-L12391
+
+## 🎯 一句话
+本章节保留原文附录 4.1、4.2、4.3 的章节标题；原始 PDF 未提供对应表格内容。
+
+## 📋 接口清单
+
+# 4 附录
+
+---
+
+## 4.1 返回码列表
+
+---
+
+## 4.2 V6.8 版本发布新增接口清单
+
+---
+
+## 4.3 V6.9 版本发布新增接口清单
+
+---
+
+## 💡 使用建议
+- 当前附录仅用于标记原文章节位置，具体返回码和版本接口需查平台正式版本文档。
+- 接入新版本接口前应以实际平台发布清单为准，不要根据空章节推断返回码。
+
+## 🔗 相关章节
+- 01_目录与文档结构.md

package/skills/meritdata-platform-integration/references/external-api.md

@@ -0,0 +1,260 @@
+## 概述
+
+按网关路径规则调用：`{gatewayOrigin}{gatewayPrefix}/{serviceName}{contextPath}{controllerPath}`。`gatewayOrigin` 不含路径，`gatewayPrefix` 例如 `/gateway` 且只能出现一次。
+
+响应字段、成功条件、Header 和 `Content-Type` 以目标 Swagger 或服务实现为准；不要假定所有接口共享同一返回体。
+
+---
+
+## 1. 基础配置
+
+| 接口 | 方法 | 说明 |
+|------|------|------|
+| `/certificate/allInfo` | POST | 获取产品基本信息 |
+| `/certificate/get-allow-left-drag` | POST | 获取是否可左侧拖动 |
+| `/certificate/get-init-pass` | POST | 获取初始化密码 |
+| `/certificate/getImage` | POST | 获取图片输出流 |
+| `/certificate/getSecretInfo` | POST | 获取平台密级信息 |
+| `/certificate/getCustomPlatform` | POST | 是否自定义平台 |
+| `/certificate/get-tag-url` | POST | 获取 tag 和 image |
+| `/certificate/get-login-link` | POST | 获取登录页超链接 |
+| `/certificate/license-info` | POST | 授权信息 |
+| `/api/send-message` | POST | 保存和发送消息 |
+| `/api/basic/message/get-page` | POST | 消息列表 |
+| `/api/basic/message/{messageId}` | POST | 消息详情 |
+| `/api/basic/message` | POST | 保存消息 |
+| `/api/basic/page` | POST | 首页框架配置 |
+| `/api/user/get-page` | POST | 按角色跳转首页 |
+
+---
+
+## 2. 组织机构
+
+### 2.1 组织维护
+
+| 接口 | 方法 | 说明 |
+|------|------|------|
+| `/api/ou/org/create` | POST | 新增组织 |
+| `/api/ou/org/delete` | POST | 删除组织 |
+| `/api/ou/org/disable` | POST | 停用组织 |
+| `/api/ou/org/enable` | POST | 启用组织 |
+| `/api/ou/org/getAll` | POST | 获取所有组织 |
+| `/api/ou/org/get/{id}` | POST | 按 ID 查部门 |
+| `/api/ou/org/list` | POST | 组织列表 |
+| `/api/ou/org/get-by-id/{id}` | POST | 按 ID 查机构 |
+| `/api/ou/org/tree` | POST | 组织机构树 |
+| `/api/ou/org/tree/{orgId}` | POST | 按 ID 获取树 |
+
+### 2.2 人员维护
+
+| 接口 | 方法 | 说明 |
+|------|------|------|
+| `/api/ou/emp/create` | POST | 新增人员 |
+| `/api/ou/emp/delete` | POST | 删除人员 |
+| `/api/ou/emp/transfer` | POST | 人员调动 |
+| `/api/ou/emp/get/{id}` | POST | 按 ID 查人员 |
+| `/api/ou/emp/get-emp/{empId}` | POST | 按人员 ID 查信息 |
+| `/api/ou/emp/list` | POST | 人员列表 |
+| `/api/ou/emp/getAll` | POST | 所有人员 |
+| `/api/ou/emp/get-by-role/{roleId}` | POST | 按角色查人员 |
+| `/api/ou/emp/get-by-role-code/{roleCode}` | POST | 按角色编码查人员 |
+| `/api/ou/emp/get-by-group/{groupId}` | POST | 按工作组查人员 |
+| `/api/ou/emp/get-by-org/{orgId}` | POST | 按机构查人员 |
+| `/api/ou/emp/get-by-dept/{deptId}` | POST | 按部门查人员 |
+| `/api/ou/emp/update` | POST | 人员更新 |
+
+### 2.3 角色维护
+
+| 接口 | 方法 | 说明 |
+|------|------|------|
+| `/api/ou/role/add-role-member` | POST | 添加角色下人员 |
+| `/api/ou/role/create` | POST | 新增角色 |
+| `/api/ou/role/delete` | POST | 删除角色 |
+| `/api/ou/role/member-list` | POST | 角色下人员列表 |
+| `/api/ou/role/user-role-list` | POST | 用户角色列表 |
+| `/api/ou/role/get-by-code/{code}` | POST | 按编码查角色 ID |
+| `/api/ou/role/current-user-roles` | POST | 当前用户角色 |
+| `/api/ou/role/list` | POST | 角色列表 |
+| `/api/ou/role/sys-role-list` | POST | 系统角色列表 |
+| `/api/ou/role/get-user-by-role/{roleId}` | POST | 按角色获取用户 |
+| `/api/ou/role/delete-user-role` | POST | 删除用户角色 |
+
+### 2.4 用户维护
+
+| 接口 | 方法 | 说明 |
+|------|------|------|
+| `/api/ou/user/check-login` | POST | 校验用户是否登录 |
+| `/api/ou/user/create` | POST | 新增用户 |
+| `/api/ou/user/delete` | POST | 删除用户 |
+| `/api/ou/user/disable` | POST | 停用用户 |
+| `/api/ou/user/enable` | POST | 启用用户 |
+| `/api/ou/user/get/{id}` | POST | 按 ID 获取用户 |
+| `/api/ou/user/get-user` | POST | 获取用户信息 |
+| `/api/ou/user/password-strength` | POST | 密码强度规则 |
+| `/api/ou/user/list` | POST | 用户列表 |
+| `/api/ou/user/getAll` | POST | 所有用户 |
+| `/api/ou/user/init-pass` | POST | 密码初始化 |
+| `/api/ou/user/change-password` | POST | 修改密码 |
+
+---
+
+## 3. 资源管理
+
+| 接口 | 方法 | 说明 |
+|------|------|------|
+| `/api/authority/resource/get-by-role/{roleId}` | POST | 按角色获取资源 ID 集合 |
+| `/api/authority/resource/delete-by-resource` | POST | 删除资源权限 |
+| `/api/authority/resource/get-by-user/{userId}` | POST | 按用户获取资源 ID 集合 |
+| `/api/authority/resource/get-permission` | POST | 按资源查权限 |
+| `/api/authority/resource/get-user-detail` | POST | 按人授权详情 |
+| `/api/authority/resource/menu-auth` | POST | 按菜单授权 |
+| `/api/authority/resource/resource-auth` | POST | 按资源授权 |
+| `/api/authority/resource/delete-all-permission` | POST | 删除全部权限 |
+| `/api/authority/resource/auth-tree` | POST | 授权列表树 |
+| `/api/authority/resource/create` | POST | 新增资源 |
+| `/api/authority/resource/delete` | POST | 删除资源 |
+| `/api/authority/resource/list` | POST | 资源列表 |
+| `/api/authority/resource/update` | POST | 更新资源 |
+| `/api/authority/resource/query-resource-by-id` | POST | 按 ID 查资源 |
+| `/api/authority/resource/menu-tree` | POST | 用户门户菜单树 |
+| `/api/authority/resource/delete-by-code` | POST | 按扩展字段删除资源 |
+
+## 4. 数据源与服务管理
+
+### 数据源
+
+| 接口 | 方法 | 说明 |
+|------|------|------|
+| `/api/basic/datasource/create-prefix` | POST | 创建数据源前缀 |
+| `/api/basic/datasource/delete` | POST | 删除数据源 |
+| `/api/basic/datasource/list-enabled` | POST | 获取已启用数据源列表 |
+| `/api/basic/datasource/param` | POST | 查询数据源详情 |
+| `/api/basic/datasource/sync` | POST | 同步数据源 |
+
+### 服务管理
+
+| 接口 | 方法 | 说明 |
+|------|------|------|
+| `/api/basic/service/app-list` | POST | 应用信息列表 |
+| `/api/basic/service/create` | POST | 创建服务 |
+| `/api/basic/service/delete/{id}` | POST | 删除服务 |
+| `/api/basic/service/get/{id}` | POST | 获取服务信息 |
+| `/api/basic/service/add-permission` | POST | 添加服务权限 |
+| `/api/basic/service/remove-permission` | POST | 移除服务权限 |
+
+---
+
+## 5. 数据密级
+
+| 接口 | 方法 | 说明 |
+|------|------|------|
+| `/api/basic/secret/get-data-secret-scope` | POST | 数据密级范围 |
+| `/api/basic/secret/get-data-secret-config` | POST | 数据密级配置 |
+| `/api/basic/secret/get-data-secret-dict` | POST | 密级数据字典 |
+
+---
+
+## 6. 日程编排
+
+| 接口 | 方法 | 说明 |
+|------|------|------|
+| `/api/basic/schedule/check-system-schedule-status` | POST | 查询业务系统编排状态 |
+| `/taier/batchTask/create-flow-and-task` | POST | 生成业务流及任务并发布 |
+| `/schedule/thirdSystemDealScheduleJob` | POST | 调度编排立即执行 |
+
+---
+
+## 7. 人员选择器
+
+| 接口 | 方法 | 说明 |
+|------|------|------|
+| `/api/ou/org/get-by-pid/{pid}` | POST | 按 PID 查组织机构 |
+| `/api/ou/org/get-with-roles/{orgId}` | POST | 机构下级+角色 |
+| `/api/ou/emp/get-by-org/{orgId}` | POST | 按组织查人员 |
+| `/api/ou/emp/get-by-role/{roleId}` | POST | 按角色查人员 |
+| `/api/ou/emp/get-by-ids` | POST | 按人员 ID 集合查信息 |
+| `/api/ou/org/get-with-groups/{orgId}` | POST | 机构下级+工作组 |
+
+---
+
+## 附录：错误码
+
+| 错误码 | 说明 |
+|--------|------|
+| `SYS_API_0000` | 成功 |
+| `SYS_API_999` | 参数校验失败 |
+| `SYS_API_998` | 调用接口失败 |
+| `SYS_API_997` | 附件大小不符合规范 |
+
+---
+
+## 外部接口注意事项
+
+1. 所有接口先按目标网关路由核对；不要将本清单中的路径片段视为完整地址。
+2. 组织人员同步接口（`/webapi/ou/sync/*`）的 `app-key` 和 `app-token` 从受管配置读取。
+3. 详细参数、Header、内容类型和返回体以目标 Swagger 或服务实现为准。
+4. **完整接口清单**：本文档为结构化提取，涵盖主要接口分类。完整的 17000+ 行接口目录（含请求参数、返回体示例）见根目录 `微服务外部接口清单.md`。
+
+---
+
+## ⚠️ 接口路径与拼写陷阱速查（基于 2026-09-10 源码实测）
+
+### 1. 内部 API 与外部 WebApi 前缀区分
+
+| 路径前辍 | 用途 | 适用 skill |
+|---------|------|----------|
+| `/api/...`（如 `/api/ou/org/list`）| 内部 API（前端/同 JVM 调用）| `meritdata-platform-integration` |
+| `/webapi/...`（如 `/webapi/ou/user/handset/changePass`）| **外部接口**（跨系统对接，HTTP）| 单独章节 |
+
+**陷阱**：外部接口不是 `/api/ou/user/...` 而是 `/webapi/ou/user/...`，**前辍不同**！调用时必须按实际接口前缀选择。
+
+### 2. 已知的源码拼写错误（按源码原样保留）
+
+| 错误路径 | 正确拼写应为 | 影响 |
+|---------|-----------|------|
+| `/api/authority/assign/delete-by-resouce` | `delete-by-resource`（少一个 r）| 路径段"resouce"而非"resource" |
+| `/api/authority/assign/delete-by-resouce-all` | `delete-by-resource-all` | 同上 |
+| `/api/authority/assign/delete-by-resouce-objid` | `delete-by-resource-objid` | 同上 |
+| `/api/authority/assign/aaignTreeByOrg` | `assignTreeByOrg`（aaign 而非 assign）| 方法名也拼错 |
+
+**⚠️ 重要**：skill 文档**按源码原样引用**这些路径（不自行"修正"），否则接口会 404。源码修复后才能在文档中修正。
+
+### 3. 类级别路径斜杠不一致
+
+| Controller | 类级别路径 | 备注 |
+|-----------|----------|------|
+| `OrgController` | `/api/ou/org/` | 有尾斜杠 |
+| `EmpController` | `/api/ou/emp/` | 有尾斜杠 |
+| `RoleController` | `/api/ou/role` | **无尾斜杠** |
+| `WorkGroupController` | `/api/ou/workgroup` | **无尾斜杠** |
+| `ResourceController` | `/api/authority/resource` | 无尾斜杠 |
+| `AssignController` | `/api/authority/assign` | 无尾斜杠 |
+| `LookupController` | `/api/basic/lookup` | 无尾斜杠 |
+
+Spring MVC 会规范化，但文档应准确反映源码。
+
+### 4. CRUD 方法名风格不统一
+
+| Controller | 新增方法 | 修改方法 | 删除方法 |
+|-----------|---------|---------|---------|
+| `OrgController` | `create` | `update` | `delete` |
+| `EmpController` | `create` / `create1` | `update` / `update1` | `delete` |
+| `RoleController` | `create` | `update` | `delete` |
+| `WorkGroupController` | `add`（但 URL 是 `/create`）| `edit`（URL 是 `/update`）| `remove`（URL 是 `/delete`）|
+
+**陷阱**：skill 文档若引用 `/api/ou/workgroup/save`，**不存在**——实际 URL 是 `/api/ou/workgroup/create`。
+
+### 5. 顶层 `save` 端点陷阱
+
+只有以下路径含顶层 `save`：
+- `/api/ou/org/save/nacos`（保存 Nacos 配置，**非业务保存**）
+
+其他 Controller 没有顶层 `save` 端点，新增/修改用 `create`/`update`/`add`/`edit`。
+
+### 6. 数据源维护（3.12）路径待核实
+
+⚠️ **2026-09-10 核实警告**：3.12 数据源维护接口（`/api/basic/datasource/*`）的来源是 2026-07-16 原始外部接口清单。源码实测发现 `cloud-system-manage-module` 模块下不存在 `datasource` 包——可能已迁移到 `cloud-system-online-app` 模块的 `TableDefController`（路径 `/datamodel/tabledef/...`）。
+
+**使用前必须在目标版本中验证**。详细见 `external-api/full/39_3.12数据源维护.md` 顶部警告。
+
+---