@alanwang-merit/meritdata-platform-skill-package 1.0.0

package/skills/meritdata-dev-docs-file-finder/references/dev-docs/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-dev-docs-file-finder/references/dev-docs/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-dev-docs-file-finder/references/dev-docs/AGENTS.md

@@ -0,0 +1,252 @@
+# dev-docs/ — 美林开发平台参考文档
+
+## 概述
+
+本目录是**美林数据「微服务应用开发平台」** 的核心参考文档集。
+
+**目标**：二开项目应优先复用平台组件，避免重复造轮子。
+
+**原文件**已按章节拆分为 49 个小文件 + 1 个 README 总索引，**强烈推荐使用拆分后的文件查阅**：
+
+| 入口 | 用途 |
+|------|------|
+| **[[README.md]]** | 📚 **总索引**：场景反查表 + 关键词搜索 + 原文章节→拆分文件映射表 |
+| **[[.bak/verify_coverage.py]]** | 🔬 字段级覆盖率自动验证脚本（`python .bak/verify_coverage.py`） |
+
+---
+
+## 文件清单
+
+### 拆分文件（49 个 + README + 17 个使用攻略）
+
+| 范围 | 编号 | 文件数 | 入口 |
+|------|------|------|------|
+| 公共资产清单 | 01–17 | 17 | `README.md` "按场景快速匹配" |
+| 外部接口清单 | 18–49 | 32 | `README.md` "按场景快速匹配" |
+| 使用攻略（2026-08 新增） | 攻略-01…12 | 80 | `README.md` "使用攻略" + 每个 `00_总览.md` |
+
+### 原文件（备份在 `.bak/`）
+
+| 文件 | 行数 | 核心内容 |
+|------|------|---------|
+| `.bak/公共资产清单-原文件.md` | 3516 | 43 个组件/工具类，111+ 个方法（基础设施+通用工具+平台服务+业务组件+前端资产） |
+| `.bak/外部接口清单-原文件.md` | 12391 | 1.0 基础配置 / 2.0 组织机构 / 3.0 资源管理 全部外部接口 |
+| `.bak/应用开发平台-流程管理-使用攻略*.md` | 7 个 | 流程 API / 工作流程开发 / 监听表达式 / 流程模块设计 / 流程前端组件 / 模板 / 自定义人员 |
+| `.bak/应用开发平台-基础平台-使用攻略*.md` | 16 个 | 含 系统认证集成（已替换为 md）/ 系统配置项管理 / 消息中心 / 日志备份 / 密级 / 国际化 / 数据源 / VUE 弹框等 |
+
+> ⚠️ **2026-08-04 更新**：PDF 形式的「系统认证集成」已替换为 markdown，16 个基础平台攻略含 3 个大文档已拆。
+
+
+
+> ⚠️ **不建议直接查阅原文件**：拆分后每个文件 200-600 行，按原文章节一对一映射，可直接定位所需章节。
+
+---
+
+## 文档一：微服务前后端公共资产清单
+
+**版本**：V1.0
+**日期**：2026-05-20
+**范围**：前端 `cloud_front` 模块 + 后端 `cloud_back` 模块
+
+### 五大章节速查
+
+#### 一、基础设施类
+
+| 子类 | 工具类 | 核心方法 | 用途 |
+|------|--------|---------|------|
+| 1.1 缓存操作 | `SysCacheServiceFacade`（23 方法） | `put/putExpire/get/hget/hset/queue/incr/publish/subscribe` | Redis 统一门面 |
+| 1.1 字符串缓存 | `StringCacheFacade`（3 方法） | `put/get/multiGet` | String 类型专用 |
+| 1.2 配置中心 | `NacosUtils`（10 方法） | `getConfigList/getConfigValue/updateConfig/addConfig` | 动态读写 Nacos |
+
+#### 二、通用工具类
+
+| 子类 | 工具类 | 方法数 | 用途 |
+|------|--------|--------|------|
+| 2.1 SM2 加解密 | `Sm2Utils` | 3 | 国密非对称（生成密钥对/加密/解密） |
+| 2.1 SM3 哈希 | `SM3Encoder` | 2 | 国密哈希（HMAC/普通加密） |
+| 2.1 SM4 对称 | `Sm4Utils` | 2 | 国密对称加密（相同密钥加解密） |
+
+#### 三、平台服务支撑
+
+| 子类 | 组件 | 说明 |
+|------|------|------|
+| 3.1 日志服务 | `ILogPostService` + `@LogDesc` / `@AddDesc` / `@DelDesc` / `@LogOperation` | 通用操作日志记录，含字段描述注解 |
+| 3.3 会话信息 | `SessionUtils`（21 方法）| 获取当前用户/部门/组织/角色/权限/租户/在线时长 |
+| 3.3 在线用户 | `IUserOnlineTime` | 踢出在线用户 |
+| 3.4 多系统集成 | WebService/RESTful 同步接口 | Feign/HttpClient 跨系统对接 |
+| 3.5 数据密级过滤 | `@EnableDataSecretFilter` | 注解式启用 Hibernate 数据密级过滤 |
+| 3.6 服务通知 | `CloudFeignMessageClient` | 5 种消息发送（角色/资源/用户/分派/应用） |
+
+#### 四、业务组件
+
+| 子类 | 组件 | 引擎 | 核心方法 |
+|------|------|------|---------|
+| 4.1 工作流 | `BpmEngine` | Camunda BPM 7.21.0 | 13 方法：`startProcess/complete/processRetfirnode/processRetprenode/deleteProcInsts/queryMainForms/getPage/getGraphTrack/getOpinions/addOrUpdate/getUndoPage/ruleEngineInit/ruleEngineRun` |
+| 4.2 调度 | `ICloudClient` | Taier (DolphinScheduler) | 12 方法：`submit/status/log/getTaskList/cancelJob/frozenTask/createFlowAndTask` 等 |
+| 4.3 定时任务 | `IJobApi` | XXL-JOB | 11 方法：`getJob/pageList/triggerJob/startJob/stopJob/add/update/remove` 等 |
+
+#### 五、前端资产
+
+| 子类 | 内容 |
+|------|------|
+| 5.1 UI 组件库 | 14 个 Vue 组件（CloudDialog/UserSelect/DeptSelect/RoleSelect/ImportButton/MenuAuth/ResourceCodeAuth/ThreeMemberAuth/TableHeadSearch/VerifiyPassword/CommonHeader/BpmGridButtonsNew/BpmFormTools） |
+| 5.2 工具函数库 | 6 个 JS 工具（sm4-utils.js / sm2.js / accessLogs.js / dataFormat.js / form-rules.js / globalValitor.js） |
+| 5.3 流程组件 | `MeritBPM` 5 个方法对应后端 API |
+
+### Maven 依赖坐标（附录 A）
+
+```xml
+<dependency>
+    <groupId>com.meritdata.cloud</groupId>
+    <artifactId>cloud-module-base</artifactId>
+    <version>6.13.2</version>
+</dependency>
+<dependency>
+    <groupId>com.meritdata.cloud</groupId>
+    <artifactId>cloud-module-cache</artifactId>
+    <version>6.13.2</version>
+</dependency>
+<dependency>
+    <groupId>com.meritdata.cloud</groupId>
+    <artifactId>cloud-starter-core</artifactId>
+    <version>6.13.2</version>
+</dependency>
+```
+
+### 组件开发注意事项（附录 B）
+
+1. **EventBus**：所有组件通过 `Vue.prototype.EventBus` 进行内部通信
+2. **国际化**：组件使用 `$t()` 函数进行国际化处理，需要配置 i18n
+3. **依赖**：BPM 组件依赖 Element-UI 和 cloud-module-base
+4. **样式**：CloudDialog 组件需引入 `import 'cloud-module-base/static/css/cloud-dialog.css';`
+
+---
+
+## 文档二：微服务外部接口清单
+
+**版本**：2026-07-16
+**日期**：2026-07-16
+**结构**：3 大部分 + 附录
+
+### 第 1 部分 基础配置（17 个接口簇）
+
+| 编号 | 接口 | 用途 |
+|------|------|------|
+| 1.1 | 获取产品基本信息 | 平台首页加载 |
+| 1.2 | 获取是否可以左侧拖动 | UI 渲染 |
+| 1.3 | 获取初始化密码 | 初始密码策略 |
+| 1.4 | 获取图片输出流 | Logo/Tag |
+| 1.5 | 获取平台密级信息 | 密级标签 |
+| 1.6 | 获取是否自定义平台信息 | 平台定制 |
+| 1.7 | tagimage 获取和 | 标签图片 |
+| 1.8 | 获取登录页超链接名称和地址 | 登录页定制 |
+| 1.9 | tempo 授权信息首页加载使用 | 授权 |
+| 1.10 | 保存和发送消息 | 消息发送 |
+| 1.11 | 获取管理页面已读未读消息 | 消息中心 |
+| 1.12 | 获取发送信息详情 | 消息详情 |
+| 1.13 | 保存信息 | 草稿 |
+| 1.14 | 查询首页框架配置接口 | 框架配置 |
+| 1.15 | 根据不同登录角色跳转至不同的地址页面 | 角色路由 |
+| 1.16 | 组织人员同步 | 4 个子接口（组织/人员/资源/角色同步） |
+| 1.17 | 资源数据密级 | 8 个子接口（密级范围/配置/字典/关联） |
+
+→ 二开项目可能用到：**1.1/1.5/1.14/1.16/1.17**
+
+### 第 2 部分 组织机构（5 大块）
+
+| 编号 | 模块 | 接口数 |
+|------|------|--------|
+| 2.1 | 组织维护 | 10 个（新增/删除/停用/启用/查询/树） |
+| 2.2 | 人员维护 | 14 个（CRUD/角色/工作组/部门查询） |
+| 2.3 | 角色维护 | 16 个（人员/角色/角色查询/系统角色/成果管理员） |
+| 2.4 | 用户维护 | 13 个（CRUD/密码/启停/登录） |
+| 2.5 | 工作组维护 | 2 个（机构树/工作组查询） |
+| 2.6 | 其他接口 | ID/cateCode 查询 |
+
+→ 二开项目可能用到：**2.1/2.2/2.3/2.4**（涉及部门、承办人、审批人）
+
+### 第 3 部分 资源管理（20 个接口簇）
+
+| 编号 | 接口 | 用途 |
+|------|------|------|
+| 3.1 | 按角色获取分配资源集合 | 权限 |
+| 3.2 | 根据资源删除对应资源的权限 | 授权 |
+| 3.3 | 按用户获取分配资源集合 | 菜单 |
+| 3.4 | 根据资源获取资源的所有权限信息 | 授权详情 |
+| 3.5 | 获取按人授权的人员信息 | 详情 |
+| 3.6 | 按资源菜单授权 | 菜单权限 |
+| 3.7 | 按资源授权接口 | 资源权限 |
+| 3.8 | 根据资源获取资源的所有权限信息 | 重复（注意） |
+| 3.9 | 根据资源删除对应资源的全部权限 | 删除 |
+| 3.10 | 资源授权列表树 | 树形 |
+| 3.11 | 基础数据 | 字典 |
+| 3.12 | 数据源维护 | 动态数据源 |
+| 3.13 | 第三方资源维护 | 外部资源 |
+| 3.14 | 服务管理 | 服务列表 |
+| 3.15 | 资源维护 | 菜单 CRUD |
+| 3.16 | 人员选择器 | 选人 |
+| 3.17 | 填报报表 | 报表 |
+| 3.18 | 获取验证码 | 登录 |
+| 3.19 | 工作台维护 | 工作台 |
+| 3.20 | 调度编排 | 调度 |
+
+→ 二开项目可能用到：**3.10/3.14/3.16/3.20**
+
+### 第 4 部分 附录
+
+- 4.1 返回码列表
+- 4.2 V6.8 版本发布新增接口清单
+- 4.3 V6.9 版本发布新增接口清单
+
+---
+
+## 二开项目可复用的平台能力清单
+
+| 能力 | 引用 | 复杂度 |
+|------|------|--------|
+| 数据字典 | `3.11 基础数据` | 低 |
+| 通用缓存 | `1.1 SysCacheServiceFacade` | 低 |
+| 通用日志 | `3.1 ILogPostService` + `@LogDesc` | 中 |
+| 用户/部门选择器 | `3.16 人员选择器` + `2.1/2.2` | 中 |
+| 权限控制 | `3.1/3.3` 资源集 | 中 |
+| 审批流程 | `4.1 BpmEngine`（Camunda） | 高 |
+| 定时任务 | `4.3 IJobApi`（XXL-JOB） | 中 |
+| 消息通知 | `3.6 CloudFeignMessageClient` | 中 |
+| 调度编排 | `3.20 调度编排` | 高 |
+| 密级标签 | `1.5/1.17 数据密级` | 中 |
+| 数据脱敏 | `3.5 @EnableDataSecretFilter` | 中 |
+| 加解密 | `2.1 Sm2/Sm3/Sm4` | 低 |
+| 导出 | `5.1 ImportButton` + 后端导入导出 | 中 |
+| 二级鉴别 | `5.1 VerifiyPassword` | 低 |
+
+---
+
+## 注意事项
+
+1. **平台版本**：所有引用版本号是 **6.13.2**（与 `pom.xml` 中 `meritdata-cloud.version` 对齐）
+2. **接口版本**：外部接口清单截至 2026-07-16，新增接口需查最新版 Nacos 配置
+3. **国密必读**：电子签章类业务（如合同签署）必须使用 SM2 签名 + SM4 加密，密钥在 [[../nacos_config_export/CLAUDE.md]]
+4. **不要重复造轮子**：优先调用平台服务（如 `SysCacheServiceFacade`），不要直接用 RedisTemplate
+5. **Feign 客户端**：跨服务调用统一用 `@FeignClient` 注解，详见 `cloud-system-manage` 公开接口
+
+---
+
+## 快速检索
+
+> **推荐**：查阅 `README.md` 的"按场景快速匹配"表（30+ 场景一次命中）和"原文章节→拆分文件映射表"
+
+| 想找什么 | 看哪个拆分文件 |
+|---------|---------------|
+| 缓存 23 方法 | `02_一基础设施-1.1缓存操作-SysCacheServiceFacade.md` |
+| Nacos 10 方法 | `04_一基础设施-1.2配置中心-NacosUtils.md` |
+| 国密 7 方法 | `05_二通用工具-2.1加解密-SM2-SM3-SM4.md` |
+| 日志 2 接口 + 注解 | `06_三平台服务-3.1日志服务-ILogPostService.md` + `07_*.md` |
+| 会话 21 方法 | `08_三平台服务-3.3会话信息-SessionUtils.md` |
+| BPM 13 方法 | `12_四业务组件-4.1工作流BpmEngine.md` |
+| XXL-JOB 11 方法 | `14_四业务组件-4.3定时任务IJobApi.md` |
+| 前端 14 组件 | `15_五前端资产-5.1UI组件库-上半.md` + `16_*.md` |
+| 组织人员同步 | `22_1.16组织人员同步.md` |
+| 数据密级配置 | `23_1.17资源数据密级-上半.md` + `24_*.md` |
+| 资源授权 | `36_3.1-3.7资源授权基础.md` + `37_*.md` |
+| 人员选择器 | `44_3.16人员选择器-上半.md` + `45_*.md` |
+| 调度编排 | `48_3.20调度编排.md` |

package/skills/meritdata-dev-docs-file-finder/references/dev-docs/CLAUDE.md

@@ -0,0 +1,252 @@
+# dev-docs/ — 美林开发平台参考文档
+
+## 概述
+
+本目录是**美林数据「微服务应用开发平台」** 的核心参考文档集。
+
+**目标**：二开项目应优先复用平台组件，避免重复造轮子。
+
+**原文件**已按章节拆分为 49 个小文件 + 1 个 README 总索引，**强烈推荐使用拆分后的文件查阅**：
+
+| 入口 | 用途 |
+|------|------|
+| **[[README.md]]** | 📚 **总索引**：场景反查表 + 关键词搜索 + 原文章节→拆分文件映射表 |
+| **[[.bak/verify_coverage.py]]** | 🔬 字段级覆盖率自动验证脚本（`python .bak/verify_coverage.py`） |
+
+---
+
+## 文件清单
+
+### 拆分文件（49 个 + README + 17 个使用攻略）
+
+| 范围 | 编号 | 文件数 | 入口 |
+|------|------|------|------|
+| 公共资产清单 | 01–17 | 17 | `README.md` "按场景快速匹配" |
+| 外部接口清单 | 18–49 | 32 | `README.md` "按场景快速匹配" |
+| 使用攻略（2026-08 新增） | 攻略-01…12 | 80 | `README.md` "使用攻略" + 每个 `00_总览.md` |
+
+### 原文件（备份在 `.bak/`）
+
+| 文件 | 行数 | 核心内容 |
+|------|------|---------|
+| `.bak/公共资产清单-原文件.md` | 3516 | 43 个组件/工具类，111+ 个方法（基础设施+通用工具+平台服务+业务组件+前端资产） |
+| `.bak/外部接口清单-原文件.md` | 12391 | 1.0 基础配置 / 2.0 组织机构 / 3.0 资源管理 全部外部接口 |
+| `.bak/应用开发平台-流程管理-使用攻略*.md` | 7 个 | 流程 API / 工作流程开发 / 监听表达式 / 流程模块设计 / 流程前端组件 / 模板 / 自定义人员 |
+| `.bak/应用开发平台-基础平台-使用攻略*.md` | 16 个 | 含 系统认证集成（已替换为 md）/ 系统配置项管理 / 消息中心 / 日志备份 / 密级 / 国际化 / 数据源 / VUE 弹框等 |
+
+> ⚠️ **2026-08-04 更新**：PDF 形式的「系统认证集成」已替换为 markdown，16 个基础平台攻略含 3 个大文档已拆。
+
+
+
+> ⚠️ **不建议直接查阅原文件**：拆分后每个文件 200-600 行，按原文章节一对一映射，可直接定位所需章节。
+
+---
+
+## 文档一：微服务前后端公共资产清单
+
+**版本**：V1.0
+**日期**：2026-05-20
+**范围**：前端 `cloud_front` 模块 + 后端 `cloud_back` 模块
+
+### 五大章节速查
+
+#### 一、基础设施类
+
+| 子类 | 工具类 | 核心方法 | 用途 |
+|------|--------|---------|------|
+| 1.1 缓存操作 | `SysCacheServiceFacade`（23 方法） | `put/putExpire/get/hget/hset/queue/incr/publish/subscribe` | Redis 统一门面 |
+| 1.1 字符串缓存 | `StringCacheFacade`（3 方法） | `put/get/multiGet` | String 类型专用 |
+| 1.2 配置中心 | `NacosUtils`（10 方法） | `getConfigList/getConfigValue/updateConfig/addConfig` | 动态读写 Nacos |
+
+#### 二、通用工具类
+
+| 子类 | 工具类 | 方法数 | 用途 |
+|------|--------|--------|------|
+| 2.1 SM2 加解密 | `Sm2Utils` | 3 | 国密非对称（生成密钥对/加密/解密） |
+| 2.1 SM3 哈希 | `SM3Encoder` | 2 | 国密哈希（HMAC/普通加密） |
+| 2.1 SM4 对称 | `Sm4Utils` | 2 | 国密对称加密（相同密钥加解密） |
+
+#### 三、平台服务支撑
+
+| 子类 | 组件 | 说明 |
+|------|------|------|
+| 3.1 日志服务 | `ILogPostService` + `@LogDesc` / `@AddDesc` / `@DelDesc` / `@LogOperation` | 通用操作日志记录，含字段描述注解 |
+| 3.3 会话信息 | `SessionUtils`（21 方法）| 获取当前用户/部门/组织/角色/权限/租户/在线时长 |
+| 3.3 在线用户 | `IUserOnlineTime` | 踢出在线用户 |
+| 3.4 多系统集成 | WebService/RESTful 同步接口 | Feign/HttpClient 跨系统对接 |
+| 3.5 数据密级过滤 | `@EnableDataSecretFilter` | 注解式启用 Hibernate 数据密级过滤 |
+| 3.6 服务通知 | `CloudFeignMessageClient` | 5 种消息发送（角色/资源/用户/分派/应用） |
+
+#### 四、业务组件
+
+| 子类 | 组件 | 引擎 | 核心方法 |
+|------|------|------|---------|
+| 4.1 工作流 | `BpmEngine` | Camunda BPM 7.21.0 | 13 方法：`startProcess/complete/processRetfirnode/processRetprenode/deleteProcInsts/queryMainForms/getPage/getGraphTrack/getOpinions/addOrUpdate/getUndoPage/ruleEngineInit/ruleEngineRun` |
+| 4.2 调度 | `ICloudClient` | Taier (DolphinScheduler) | 12 方法：`submit/status/log/getTaskList/cancelJob/frozenTask/createFlowAndTask` 等 |
+| 4.3 定时任务 | `IJobApi` | XXL-JOB | 11 方法：`getJob/pageList/triggerJob/startJob/stopJob/add/update/remove` 等 |
+
+#### 五、前端资产
+
+| 子类 | 内容 |
+|------|------|
+| 5.1 UI 组件库 | 14 个 Vue 组件（CloudDialog/UserSelect/DeptSelect/RoleSelect/ImportButton/MenuAuth/ResourceCodeAuth/ThreeMemberAuth/TableHeadSearch/VerifiyPassword/CommonHeader/BpmGridButtonsNew/BpmFormTools） |
+| 5.2 工具函数库 | 6 个 JS 工具（sm4-utils.js / sm2.js / accessLogs.js / dataFormat.js / form-rules.js / globalValitor.js） |
+| 5.3 流程组件 | `MeritBPM` 5 个方法对应后端 API |
+
+### Maven 依赖坐标（附录 A）
+
+```xml
+<dependency>
+    <groupId>com.meritdata.cloud</groupId>
+    <artifactId>cloud-module-base</artifactId>
+    <version>6.13.2</version>
+</dependency>
+<dependency>
+    <groupId>com.meritdata.cloud</groupId>
+    <artifactId>cloud-module-cache</artifactId>
+    <version>6.13.2</version>
+</dependency>
+<dependency>
+    <groupId>com.meritdata.cloud</groupId>
+    <artifactId>cloud-starter-core</artifactId>
+    <version>6.13.2</version>
+</dependency>
+```
+
+### 组件开发注意事项（附录 B）
+
+1. **EventBus**：所有组件通过 `Vue.prototype.EventBus` 进行内部通信
+2. **国际化**：组件使用 `$t()` 函数进行国际化处理，需要配置 i18n
+3. **依赖**：BPM 组件依赖 Element-UI 和 cloud-module-base
+4. **样式**：CloudDialog 组件需引入 `import 'cloud-module-base/static/css/cloud-dialog.css';`
+
+---
+
+## 文档二：微服务外部接口清单
+
+**版本**：2026-07-16
+**日期**：2026-07-16
+**结构**：3 大部分 + 附录
+
+### 第 1 部分 基础配置（17 个接口簇）
+
+| 编号 | 接口 | 用途 |
+|------|------|------|
+| 1.1 | 获取产品基本信息 | 平台首页加载 |
+| 1.2 | 获取是否可以左侧拖动 | UI 渲染 |
+| 1.3 | 获取初始化密码 | 初始密码策略 |
+| 1.4 | 获取图片输出流 | Logo/Tag |
+| 1.5 | 获取平台密级信息 | 密级标签 |
+| 1.6 | 获取是否自定义平台信息 | 平台定制 |
+| 1.7 | tagimage 获取和 | 标签图片 |
+| 1.8 | 获取登录页超链接名称和地址 | 登录页定制 |
+| 1.9 | tempo 授权信息首页加载使用 | 授权 |
+| 1.10 | 保存和发送消息 | 消息发送 |
+| 1.11 | 获取管理页面已读未读消息 | 消息中心 |
+| 1.12 | 获取发送信息详情 | 消息详情 |
+| 1.13 | 保存信息 | 草稿 |
+| 1.14 | 查询首页框架配置接口 | 框架配置 |
+| 1.15 | 根据不同登录角色跳转至不同的地址页面 | 角色路由 |
+| 1.16 | 组织人员同步 | 4 个子接口（组织/人员/资源/角色同步） |
+| 1.17 | 资源数据密级 | 8 个子接口（密级范围/配置/字典/关联） |
+
+→ 二开项目可能用到：**1.1/1.5/1.14/1.16/1.17**
+
+### 第 2 部分 组织机构（5 大块）
+
+| 编号 | 模块 | 接口数 |
+|------|------|--------|
+| 2.1 | 组织维护 | 10 个（新增/删除/停用/启用/查询/树） |
+| 2.2 | 人员维护 | 14 个（CRUD/角色/工作组/部门查询） |
+| 2.3 | 角色维护 | 16 个（人员/角色/角色查询/系统角色/成果管理员） |
+| 2.4 | 用户维护 | 13 个（CRUD/密码/启停/登录） |
+| 2.5 | 工作组维护 | 2 个（机构树/工作组查询） |
+| 2.6 | 其他接口 | ID/cateCode 查询 |
+
+→ 二开项目可能用到：**2.1/2.2/2.3/2.4**（涉及部门、承办人、审批人）
+
+### 第 3 部分 资源管理（20 个接口簇）
+
+| 编号 | 接口 | 用途 |
+|------|------|------|
+| 3.1 | 按角色获取分配资源集合 | 权限 |
+| 3.2 | 根据资源删除对应资源的权限 | 授权 |
+| 3.3 | 按用户获取分配资源集合 | 菜单 |
+| 3.4 | 根据资源获取资源的所有权限信息 | 授权详情 |
+| 3.5 | 获取按人授权的人员信息 | 详情 |
+| 3.6 | 按资源菜单授权 | 菜单权限 |
+| 3.7 | 按资源授权接口 | 资源权限 |
+| 3.8 | 根据资源获取资源的所有权限信息 | 重复（注意） |
+| 3.9 | 根据资源删除对应资源的全部权限 | 删除 |
+| 3.10 | 资源授权列表树 | 树形 |
+| 3.11 | 基础数据 | 字典 |
+| 3.12 | 数据源维护 | 动态数据源 |
+| 3.13 | 第三方资源维护 | 外部资源 |
+| 3.14 | 服务管理 | 服务列表 |
+| 3.15 | 资源维护 | 菜单 CRUD |
+| 3.16 | 人员选择器 | 选人 |
+| 3.17 | 填报报表 | 报表 |
+| 3.18 | 获取验证码 | 登录 |
+| 3.19 | 工作台维护 | 工作台 |
+| 3.20 | 调度编排 | 调度 |
+
+→ 二开项目可能用到：**3.10/3.14/3.16/3.20**
+
+### 第 4 部分 附录
+
+- 4.1 返回码列表
+- 4.2 V6.8 版本发布新增接口清单
+- 4.3 V6.9 版本发布新增接口清单
+
+---
+
+## 二开项目可复用的平台能力清单
+
+| 能力 | 引用 | 复杂度 |
+|------|------|--------|
+| 数据字典 | `3.11 基础数据` | 低 |
+| 通用缓存 | `1.1 SysCacheServiceFacade` | 低 |
+| 通用日志 | `3.1 ILogPostService` + `@LogDesc` | 中 |
+| 用户/部门选择器 | `3.16 人员选择器` + `2.1/2.2` | 中 |
+| 权限控制 | `3.1/3.3` 资源集 | 中 |
+| 审批流程 | `4.1 BpmEngine`（Camunda） | 高 |
+| 定时任务 | `4.3 IJobApi`（XXL-JOB） | 中 |
+| 消息通知 | `3.6 CloudFeignMessageClient` | 中 |
+| 调度编排 | `3.20 调度编排` | 高 |
+| 密级标签 | `1.5/1.17 数据密级` | 中 |
+| 数据脱敏 | `3.5 @EnableDataSecretFilter` | 中 |
+| 加解密 | `2.1 Sm2/Sm3/Sm4` | 低 |
+| 导出 | `5.1 ImportButton` + 后端导入导出 | 中 |
+| 二级鉴别 | `5.1 VerifiyPassword` | 低 |
+
+---
+
+## 注意事项
+
+1. **平台版本**：所有引用版本号是 **6.13.2**（与 `pom.xml` 中 `meritdata-cloud.version` 对齐）
+2. **接口版本**：外部接口清单截至 2026-07-16，新增接口需查最新版 Nacos 配置
+3. **国密必读**：电子签章类业务（如合同签署）必须使用 SM2 签名 + SM4 加密，密钥在 [[../nacos_config_export/CLAUDE.md]]
+4. **不要重复造轮子**：优先调用平台服务（如 `SysCacheServiceFacade`），不要直接用 RedisTemplate
+5. **Feign 客户端**：跨服务调用统一用 `@FeignClient` 注解，详见 `cloud-system-manage` 公开接口
+
+---
+
+## 快速检索
+
+> **推荐**：查阅 `README.md` 的"按场景快速匹配"表（30+ 场景一次命中）和"原文章节→拆分文件映射表"
+
+| 想找什么 | 看哪个拆分文件 |
+|---------|---------------|
+| 缓存 23 方法 | `02_一基础设施-1.1缓存操作-SysCacheServiceFacade.md` |
+| Nacos 10 方法 | `04_一基础设施-1.2配置中心-NacosUtils.md` |
+| 国密 7 方法 | `05_二通用工具-2.1加解密-SM2-SM3-SM4.md` |
+| 日志 2 接口 + 注解 | `06_三平台服务-3.1日志服务-ILogPostService.md` + `07_*.md` |
+| 会话 21 方法 | `08_三平台服务-3.3会话信息-SessionUtils.md` |
+| BPM 13 方法 | `12_四业务组件-4.1工作流BpmEngine.md` |
+| XXL-JOB 11 方法 | `14_四业务组件-4.3定时任务IJobApi.md` |
+| 前端 14 组件 | `15_五前端资产-5.1UI组件库-上半.md` + `16_*.md` |
+| 组织人员同步 | `22_1.16组织人员同步.md` |
+| 数据密级配置 | `23_1.17资源数据密级-上半.md` + `24_*.md` |
+| 资源授权 | `36_3.1-3.7资源授权基础.md` + `37_*.md` |
+| 人员选择器 | `44_3.16人员选择器-上半.md` + `45_*.md` |
+| 调度编排 | `48_3.20调度编排.md` |