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

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

@@ -0,0 +1,230 @@
+---
+name: dev-docs 总索引
+description: 美林开发平台 dev-docs/ 目录拆分文件总索引
+keywords: [平台总览, 文件索引, 场景反查, 章节映射, 公共资产, 外部接口]
+---
+
+# dev-docs/ 总索引
+
+> **拆分时间**：2026-07-31
+> **拆分依据**：严格按源文件章节一对一映射
+> **源文件**：
+> - `公共资产清单-原文件.md`（3516 行）→ 拆分为 17 个文件
+> - `外部接口清单-原文件.md`（12391 行）→ 拆分为 32 个文件
+> **验证脚本**：`.bak/verify_coverage.py`
+
+---
+
+## 📚 按场景快速匹配（一次命中 90%+）
+
+### 后端开发
+
+| 我想做什么 | 看哪个文件 |
+|-----------|-----------|
+| 用 Redis 缓存用户会话/Token | `02_一基础设施-1.1缓存操作-SysCacheServiceFacade.md` |
+| 用 String 类型缓存配置项 | `03_一基础设施-1.1缓存操作-StringCacheFacade.md` |
+| 动态读取 Nacos 配置 | `04_一基础设施-1.2配置中心-NacosUtils.md` |
+| SM2/SM3/SM4 加解密（电子签章） | `05_二通用工具-2.1加解密-SM2-SM3-SM4.md` |
+| 记录操作审计日志 | `06_三平台服务-3.1日志服务-ILogPostService.md` + `07` |
+| 获取当前登录用户/部门/组织 | `08_三平台服务-3.3会话信息-SessionUtils.md` |
+| 强制踢出在线用户 | `09_三平台服务-3.3在线用户-IUserOnlineTime.md` |
+| 多系统数据同步（HR/ERP） | `10_三平台服务-3.4多系统集成+3.5数据密级.md` |
+| 启用数据密级过滤 | `10_三平台服务-3.4多系统集成+3.5数据密级.md` |
+| 发送角色/资源/用户变更消息 | `11_三平台服务-3.6服务通知-CloudFeignMessageClient.md` |
+| 流程发起/审批/撤回 | `12_四业务组件-4.1工作流BpmEngine.md` |
+| 调度编排（Taier/DolphinScheduler）| `13_四业务组件-4.2调度组件ICloudClient.md` |
+| 定时任务（XXL-JOB） | `14_四业务组件-4.3定时任务IJobApi.md` |
+| 缓存键加业务前缀 | `02` 末尾"注意事项" |
+
+### 前端开发
+
+| 我想做什么 | 看哪个文件 |
+|-----------|-----------|
+| 用通用对话框组件 | `15_五前端资产-5.1UI组件库-上半.md` |
+| 用户/多用户选择 | `15` |
+| 部门选择/角色选择 | `15` |
+| 导入 Excel/CSV 按钮 | `15` |
+| 菜单权限控制 | `15` |
+| 资源代码授权 | `16_五前端资产-5.1UI组件库-下半.md` |
+| 三员授权 | `16` |
+| 二级鉴别密码弹窗 | `16` |
+| 通用头部布局 | `16` |
+
+### 外部接口调用
+
+| 我想做什么 | 看哪个文件 |
+|-----------|-----------|
+| 获取平台基础信息 | `19_1.1-1.6基础配置-平台信息类.md` |
+| 获取/发送消息 | `20_1.7-1.10基础配置-页面与消息类.md` / `21` |
+| 同步组织/人员/资源/角色 | `22_1.16组织人员同步.md` |
+| 数据密级配置 | `23_1.17资源数据密级-上半.md` + `24` |
+| 组织 CRUD | `25_2.1组织维护-上半.md` + `26` |
+| 组织树查询 | `26_2.1组织维护-下半.md` |
+| 人员 CRUD | `27_2.2人员维护-上半.md` + `28` |
+| 角色管理 | `29_2.3角色维护-上半.md` + `30` |
+| 用户管理 | `31_2.4用户维护-上半.md` + `32` |
+| 工作组管理 | `33_2.5工作组维护.md` |
+| 资源授权（角色/用户） | `36_3.1-3.7资源授权基础.md` + `37` |
+| 数据字典 | `38_3.11基础数据.md` |
+| 动态数据源 | `39_3.12数据源维护.md` |
+| DAM 第三方资源 | `40_3.13第三方资源维护.md` |
+| 应用服务管理 | `41_3.14服务管理.md` |
+| 资源菜单 CRUD | `42_3.15资源维护-上半.md` + `43` |
+| 人员选择器 | `44_3.16人员选择器-上半.md` + `45` |
+| 验证码 | `46_3.17填报报表+3.18验证码.md` |
+| 工作台/Logo | `47_3.19工作台维护.md` |
+| 调度编排（业务系统状态） | `48_3.20调度编排.md` |
+
+---
+
+## 📚 使用攻略（2026-08 新增拆分）
+
+**来源**：`.bak/` 下 12 个使用攻略 markdown，已按章节拆分。每篇攻略生成 1 个 `00_总览.md` + N 个章节文件。
+
+| 攻略 | 章节数 | 入口 |
+|------|--------|------|
+| **攻略-01-流程API** | 15 章 | `攻略-01-流程API-00_总览.md` |
+| **攻略-02-工作流程** | 8 章 | `攻略-02-工作流程-00_总览.md` |
+| **攻略-03-监听表达式** | 6 章 | `攻略-03-监听表达式-00_总览.md` |
+| **攻略-06-系统认证** | 5 章 | `攻略-06-系统认证-00_总览.md` |
+| **攻略-07-流程模块设计** | 8 章 | `攻略-07-流程模块设计-00_总览.md` |
+| **攻略-08-流程前端组件** | 6 章 | `攻略-08-流程前端组件-00_总览.md` |
+| **攻略-09-组织人员同步** | 7 章 | `攻略-09-组织人员同步-00_总览.md` |
+| **攻略-10-定时调度** | 7 章 | `攻略-10-定时调度-00_总览.md` |
+| **攻略-11-配置项** | 3 章 | `攻略-11-配置项-00_总览.md` |
+| **攻略-12-消息中心** | 4 章 | `攻略-12-消息中心-00_总览.md` |
+
+### 使用攻略快速匹配
+
+| 我想做什么 | 看哪个攻略 |
+|-----------|-----------|
+| 流程 API 接口清单（启动/完成/追踪/退回） | `攻略-01-流程API-00_总览.md` |
+| 从零创建 BPM 工程（pom / bootstrap） | `攻略-02-工作流程-00_总览.md` |
+| 自定义流程监听器（JavaDelegate） | `攻略-03-监听表达式-00_总览.md` |
+| **系统认证集成（token / CAS / 第三方）** | `攻略-06-系统认证-00_总览.md` |
+| BPM 模块前后端架构设计 | `攻略-07-流程模块设计-00_总览.md` |
+| 前端 BPM 组件（BpmFormTools / BpmGridButtonsNew） | `攻略-08-流程前端组件-00_总览.md` |
+| HR / ERP 同步组织人员（WebService / RESTful） | `攻略-09-组织人员同步-00_总览.md` |
+| XXL-JOB 定时任务开发 | `攻略-10-定时调度-00_总览.md` |
+| **Nacos 配置项查询 / 修改** | `攻略-11-配置项-00_总览.md` |
+| **消息中心页面 / 接口 / 附件** | `攻略-12-消息中心-00_总览.md` |
+
+---
+
+## 🔍 按关键词快速搜索
+
+| 关键词 | 命中文件 |
+|--------|---------|
+| **Redis / 缓存** | 02, 03 |
+| **Nacos / 配置中心** | 04 |
+| **国密 / SM2 / SM3 / SM4** | 05 |
+| **日志 / 审计 / LogOperation** | 06, 07 |
+| **Session / 当前用户 / getUserId** | 08 |
+| **踢出用户 / 在线** | 09 |
+| **WebService / RESTful / 同步** | 10, 22 |
+| **数据密级 / EnableDataSecretFilter** | 10, 23, 24 |
+| **CloudFeignMessageClient / 消息通知** | 11 |
+| **BPM / 流程 / Camunda** | 12 |
+| **XXL-JOB / 定时任务** | 14 |
+| **UI 组件 / Vue / CloudDialog / UserSelect** | 15, 16 |
+| **组织 / Org** | 22, 25, 26 |
+| **人员 / Emp** | 27, 28 |
+| **角色 / Role** | 29, 30 |
+| **用户 / User** | 31, 32 |
+| **工作组 / WorkGroup** | 33 |
+| **资源授权 / 权限 / Resource** | 36, 37, 42, 43 |
+| **数据源 / 动态数据源** | 39 |
+| **第三方资源 / DAM** | 40 |
+| **服务管理 / App Service** | 41 |
+| **人员选择器 / Selector** | 44, 45 |
+| **调度编排 / Schedule** | 48 |
+
+---
+
+## 📑 原文章节 → 拆分文件映射表（核对用）
+
+### 公共资产清单（17 文件）
+
+| 原文章节 | 拆分文件 | 行号范围 |
+|---------|---------|---------|
+| 文档结构 | `01_目录与文档结构.md` | L1–66 |
+| 1.1 缓存操作（SysCache） | `02_一基础设施-1.1缓存操作-SysCacheServiceFacade.md` | L70–464 |
+| 1.1 缓存操作（String） | `03_一基础设施-1.1缓存操作-StringCacheFacade.md` | L465–517 |
+| 1.2 配置中心 | `04_一基础设施-1.2配置中心-NacosUtils.md` | L518–684 |
+| 2.1 SM 加解密 | `05_二通用工具-2.1加解密-SM2-SM3-SM4.md` | L687–835 |
+| 3.1 日志服务 | `06_三平台服务-3.1日志服务-ILogPostService.md` | L844–1127 |
+| 3.1 日志注解 | `07_三平台服务-3.1日志注解-LogDesc-LogOperation.md` | L1128–1304 |
+| 3.3.1 SessionUtils | `08_三平台服务-3.3会话信息-SessionUtils.md` | L1313–1636 |
+| 3.3.2 IUserOnlineTime | `09_三平台服务-3.3在线用户-IUserOnlineTime.md` | L1636–1674 |
+| 3.4 + 3.5 多系统集成+数据密级 | `10_三平台服务-3.4多系统集成+3.5数据密级.md` | L1675–1735 |
+| 3.6 服务通知 | `11_三平台服务-3.6服务通知-CloudFeignMessageClient.md` | L1736–2176 |
+| 4.1 工作流 | `12_四业务组件-4.1工作流BpmEngine.md` | L2179–2235 |
+| 4.2 调度组件 | `13_四业务组件-4.2调度组件ICloudClient.md` | L2236–2266 |
+| 4.3 定时任务 | `14_四业务组件-4.3定时任务IJobApi.md` | L2267–2295 |
+| 5.1 UI 组件库（前 7） | `15_五前端资产-5.1UI组件库-上半.md` | L2298–~2780 |
+| 5.1 UI 组件库（后 5） | `16_五前端资产-5.1UI组件库-下半.md` | ~2784–3054 |
+| 附录 + 统计 + Maven | `17_附录-统计汇总-Maven依赖-注意事项.md` | L3416–3516 |
+
+### 外部接口清单（32 文件）
+
+| 原文章节 | 拆分文件 | 行号范围 |
+|---------|---------|---------|
+| 目录与文档说明 | `18_目录与文档说明.md` | L1–282 |
+| 1.1–1.6 基础配置-平台信息 | `19_1.1-1.6基础配置-平台信息类.md` | L287–627 |
+| 1.7–1.10 基础配置-页面与消息 | `20_1.7-1.10基础配置-页面与消息类.md` | L628–940 |
+| 1.11–1.15 基础配置-消息与配置 | `21_1.11-1.15基础配置-消息与配置类.md` | L941–1215 |
+| 1.16 组织人员同步 | `22_1.16组织人员同步.md` | L1216–1511 |
+| 1.17.1–1.17.4 | `23_1.17资源数据密级-上半.md` | L1512–1784 |
+| 1.17.5–1.17.8 | `24_1.17资源数据密级-下半.md` | L1785–2113 |
+| 2.1.1–2.1.6 | `25_2.1组织维护-上半.md` | L2118–2545 |
+| 2.1.7–2.1.11 | `26_2.1组织维护-下半.md` | L2546–3086 |
+| 2.2（含 2.2.11 错位） | `27_2.2人员维护-上半.md` | L3087–3892 |
+| 2.2.9–2.2.14 | `28_2.2人员维护-下半.md` | L3893–4449 |
+| 2.3.1–2.3.8 | `29_2.3角色维护-上半.md` | L4450–4995 |
+| 2.3.9–2.3.16 | `30_2.3角色维护-下半.md` | L4996–5565 |
+| 2.4.1–2.4.7 | `31_2.4用户维护-上半.md` | L5566–6029 |
+| 2.4.8–2.4.13 | `32_2.4用户维护-下半.md` | L6030–6563 |
+| 2.5 工作组维护 | `33_2.5工作组维护.md` | L6564–6746 |
+| 2.6.1–2.6.6 | `34_2.6其他接口-上半.md` | L6747–7373 |
+| 2.6.7–2.6.11 | `35_2.6其他接口-下半.md` | L7374–7938 |
+| 3.1–3.7 资源授权基础 | `36_3.1-3.7资源授权基础.md` | L7943–8740 |
+| 3.8–3.10 资源授权进阶 | `37_3.8-3.10资源授权进阶.md` | L8741–9172 |
+| 3.11 基础数据 | `38_3.11基础数据.md` | L9173–9356 |
+| 3.12 数据源维护 | `39_3.12数据源维护.md` | L9357–9607 |
+| 3.13 第三方资源 | `40_3.13第三方资源维护.md` | L9608–9891 |
+| 3.14 服务管理 | `41_3.14服务管理.md` | L9892–10385 |
+| 3.15.1–3.15.6 | `42_3.15资源维护-上半.md` | L10386–11125 |
+| 3.15.7–3.15.10 | `43_3.15资源维护-下半.md` | L11126–11476 |
+| 3.16.1–3.16.4 | `44_3.16人员选择器-上半.md` | L11477–11760 |
+| 3.16.5–3.16.7 | `45_3.16人员选择器-下半.md` | L11761–11976 |
+| 3.17 + 3.18 | `46_3.17填报报表+3.18验证码.md` | L11977–12128 |
+| 3.19 工作台维护 | `47_3.19工作台维护.md` | L12129–12298 |
+| 3.20 调度编排 | `48_3.20调度编排.md` | L12299–12376 |
+| 4.1–4.3 附录 | `49_附录-4.1-4.3返回码与版本清单.md` | L12377–12391 |
+
+---
+
+## ⚠️ 拆分时已知异常
+
+| 异常 | 位置 | 处理 |
+|------|------|------|
+| 代码片段混入 `# 人员维护` | 公共资产 L1128 | 保留 + 文件 07 顶部加注释 |
+| 3.2 空占位 | 公共资产 L1305-1310 | 并入文件 10 顶部说明 |
+| 2.1.2/2.1.4/2.1.5 等标题不完整 | 外部接口 L48-64 | 保留原标题，不修改 |
+| 2.2 编号错位（2.2.11）| 外部接口 L3091 | 保留原编号 + 文件 27 顶部加注释 |
+| 3.1 标题含 `idid` 残留 | 外部接口 L7943 | 保留 + 文件 36 顶部加注释 |
+| 3.20 末尾孤立文字"是任务流id" | 外部接口 L12375 | 并入文件 48 |
+| 4.1/4.2/4.3 全部空章节 | 外部接口 L12377-12391 | 保留标题 + 文件 49 顶部加注释 |
+
+---
+
+## 🔧 验证脚本
+
+```bash
+# 字段级覆盖率验证（自动）
+python .bak/verify_coverage.py
+```
+
+输出覆盖统计：
+- 公共资产：`##` 章节 / `###` 子章节 / `####` 类名 / `完整包路径` / `方法签名` / `注解` 覆盖率
+- 外部接口：`##` 章节 / `###` 子章节 / `接口地址` / `接口备注` 覆盖率