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

package/skills/meritdata-platform-bpm/references/bpm-/346/224/273/347/225/245/INDEX.md

@@ -1,140 +0,0 @@
-# BPM 流程二开攻略索引
-
-> **来源**：研发版 `meritdata-bpm-2nd-dev`（v2.3.1 整合，原独立 skill 已并入本 skill）
-> **实际内容位置**：[`meritdata-dev-docs-file-finder/references/dev-docs/攻略-NN-*.md`](../../../meritdata-dev-docs-file-finder/references/dev-docs/)
-> **策略**：**索引 + 指向**（不复制文件，避免内容重复）——所有章节内容均在 dev-docs/ 维护，本目录仅提供"按场景→攻略→章节"的导航。
-
----
-
-## 一、6 篇攻略总览
-
-| 攻略 | 主题 | 章节数 | 总览入口 | 触发场景 |
-|------|------|:------:|---------|---------|
-| **攻略-01** | 流程 API | 16 | [攻略-01-流程API-00_总览.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-01-流程API-00_总览.md) | 调用启动/完成/退回/追踪 API |
-| **攻略-02** | 工作流程 | 8 | [攻略-02-工作流程-00_总览.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-02-工作流程-00_总览.md) | 从零创建 BPM 工程（pom / bootstrap）|
-| **攻略-03** | 监听表达式 | 6 | [攻略-03-监听表达式-00_总览.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-03-监听表达式-00_总览.md) | 自定义流程监听器（JavaDelegate）|
-| **攻略-06** | 系统认证 | 5 | [攻略-06-系统认证-00_总览.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-06-系统认证-00_总览.md) | 系统认证集成（token / CAS / 第三方）— 详见 `meritdata-platform-sso` |
-| **攻略-07** | 流程模块设计 | 8 | [攻略-07-流程模块设计-00_总览.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-07-流程模块设计-00_总览.md) | BPM 模块前后端架构设计 |
-| **攻略-08** | 流程前端组件 | 6 | [攻略-08-流程前端组件-00_总览.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-08-流程前端组件-00_总览.md) | BpmFormTools / BpmGridButtonsNew — 详见 `meritdata-platform-frontend` |
-
----
-
-## 二、按场景快速匹配
-
-| 我想做什么 | 看哪个攻略 |
-|-----------|-----------|
-| 启动流程实例 / 完成任务 / 退回拟稿人 | 攻略-01（章节03 启动流程 / 章节05 完成任务 / 章节09 退回拟稿人）|
-| 查询个人待办 / 阅知消息 | 攻略-01（章节12 个人待办 / 章节13 阅知）|
-| 查询流程追踪图 | 攻略-01（章节08 查看追踪接口）|
-| 从零搭建 BPM 工程（pom + bootstrap）| 攻略-02（章节02 后端工程创建）|
-| 自定义流程监听器 | 攻略-03（章节01 实现策略）|
-| 系统认证 token 集成 | 攻略-06（章节02 token 认证集成）|
-| CAS 单点登录 | 攻略-06（章节03 CAS 统一认证中心）|
-| BPM 模块前后端设计 | 攻略-07（章节05 流程后端设计 / 章节06 流程前端设计）|
-| 自定义 BPM 前端组件 | 攻略-08（章节03 BpmFormTools / 章节04 BpmGridButtonsNew）|
-
----
-
-## 三、章节清单
-
-### 攻略-01 流程 API（16 章）
-
-| 章节 | 标题 | 路径 |
-|:-:|------|------|
-| 00 | 总览 | [攻略-01-流程API-00_总览.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-01-流程API-00_总览.md) |
-| 01 | 前置条件 | [攻略-01-流程API-章节01_前置条件.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-01-流程API-章节01_前置条件.md) |
-| 02 | 规则引擎初始化接口 | [攻略-01-流程API-章节02_规则引擎初始化接口.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-01-流程API-章节02_规则引擎初始化接口.md) |
-| 03 | 启动流程实例接口 | [攻略-01-流程API-章节03_启动流程实例接口.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-01-流程API-章节03_启动流程实例接口.md) |
-| 04 | 运行规则引擎 | [攻略-01-流程API-章节04_运行规则引擎.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-01-流程API-章节04_运行规则引擎.md) |
-| 05 | 完成任务接口 | [攻略-01-流程API-章节05_完成任务接口.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-01-流程API-章节05_完成任务接口.md) |
-| 06 | 填写意见接口 | [攻略-01-流程API-章节06_填写意见接口.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-01-流程API-章节06_填写意见接口.md) |
-| 07 | 根据任务节点获取意见内容 | [攻略-01-流程API-章节07_根据任务节点获取意见内容.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-01-流程API-章节07_根据任务节点获取意见内容.md) |
-| 08 | 查看追踪接口 | [攻略-01-流程API-章节08_查看追踪接口.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-01-流程API-章节08_查看追踪接口.md) |
-| 09 | 退回拟稿人接口 | [攻略-01-流程API-章节09_退回拟稿人接口.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-01-流程API-章节09_退回拟稿人接口.md) |
-| 10 | 退回上一环节处理人接口 | [攻略-01-流程API-章节10_退回上一环节处理人接口.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-01-流程API-章节10_退回上一环节处理人接口.md) |
-| 11 | 流程设计器列表查询 | [攻略-01-流程API-章节11_流程设计器列表查询.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-01-流程API-章节11_流程设计器列表查询.md) |
-| 12 | 个人待办 | [攻略-01-流程API-章节12_个人待办.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-01-流程API-章节12_个人待办.md) |
-| 13 | 阅知 | [攻略-01-流程API-章节13_阅知.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-01-流程API-章节13_阅知.md) |
-| 14 | 流程最新定义 ID | [攻略-01-流程API-章节14_流程最新定义ID.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-01-流程API-章节14_流程最新定义ID.md) |
-| 15 | 业务相关接口 | [攻略-01-流程API-章节15_业务相关接口.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-01-流程API-章节15_业务相关接口.md) |
-| 16 | 流程分类相关 | [攻略-01-流程API-章节16_流程分类相关.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-01-流程API-章节16_流程分类相关.md) |
-
-### 攻略-02 工作流程（8 章）
-
-| 章节 | 标题 | 路径 |
-|:-:|------|------|
-| 00 | 总览 | [攻略-02-工作流程-00_总览.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-02-工作流程-00_总览.md) |
-| 01 | 样例说明 | [攻略-02-工作流程-章节01_样例说明.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-02-工作流程-章节01_样例说明.md) |
-| 02 | 后端工程创建 | [攻略-02-工作流程-章节02_后端工程创建.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-02-工作流程-章节02_后端工程创建.md) |
-| 03 | 后端工程配置 | [攻略-02-工作流程-章节03_后端工程配置.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-02-工作流程-章节03_后端工程配置.md) |
-| 04 | 后端工程业务类创建 | [攻略-02-工作流程-章节04_后端工程业务类创建.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-02-工作流程-章节04_后端工程业务类创建.md) |
-| 05 | 启动后端应用工程 | [攻略-02-工作流程-章节05_启动后端应用工程.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-02-工作流程-章节05_启动后端应用工程.md) |
-| 06 | 流程应用前端开发 | [攻略-02-工作流程-章节06_流程应用前端开发.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-02-工作流程-章节06_流程应用前端开发.md) |
-| 07 | 启动前端应用工程 | [攻略-02-工作流程-章节07_启动前端应用工程.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-02-工作流程-章节07_启动前端应用工程.md) |
-| 08 | 流程设计 | [攻略-02-工作流程-章节08_流程设计.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-02-工作流程-章节08_流程设计.md) |
-
-### 攻略-03 监听表达式（6 章）
-
-| 章节 | 标题 | 路径 |
-|:-:|------|------|
-| 00 | 总览 | [攻略-03-监听表达式-00_总览.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-03-监听表达式-00_总览.md) |
-| 01 | 实现策略 | [攻略-03-监听表达式-章节01_实现策略.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-03-监听表达式-章节01_实现策略.md) |
-| 02 | 自定义 jar 包的实现流程 | [攻略-03-监听表达式-章节02_自定义_jar_包的实现流程.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-03-监听表达式-章节02_自定义_jar_包的实现流程.md) |
-| 03 | 自定义服务搭建 | [攻略-03-监听表达式-章节03_自定义服务搭建（若已存在工程和接口，此步骤可省略）.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-03-监听表达式-章节03_自定义服务搭建（若已存在工程和接口，此步骤可省略）.md) |
-| 04 | 流程设计中设置 listener 参数 | [攻略-03-监听表达式-章节04_流程设计中设置_listener_参数.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-03-监听表达式-章节04_流程设计中设置_listener_参数.md) |
-| 05 | 测试触发流程监听事件 | [攻略-03-监听表达式-章节05_测试触发流程监听事件是否生效.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-03-监听表达式-章节05_测试触发流程监听事件是否生效.md) |
-| 06 | 备注 | [攻略-03-监听表达式-章节06_备注：.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-03-监听表达式-章节06_备注：.md) |
-
-### 攻略-06 系统认证（5 章）— 已归口 `meritdata-platform-sso`
-
-| 章节 | 标题 | 路径 |
-|:-:|------|------|
-| 00 | 总览 | [攻略-06-系统认证-00_总览.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-06-系统认证-00_总览.md) |
-| 01 | 系统认证集成介绍 | [攻略-06-系统认证-章节01_系统认证集成介绍.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-06-系统认证-章节01_系统认证集成介绍.md) |
-| 02 | token 认证集成 | [攻略-06-系统认证-章节02_token_认证集成.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-06-系统认证-章节02_token_认证集成.md) |
-| 03 | CAS 统一认证中心 | [攻略-06-系统认证-章节03_cas_统一认证中心.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-06-系统认证-章节03_cas_统一认证中心.md) |
-| 04 | 第三方认证中心 | [攻略-06-系统认证-章节04_第三方认证中心.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-06-系统认证-章节04_第三方认证中心.md) |
-| 05 | 附录：认证中心端配置 | [攻略-06-系统认证-章节05_附录_1_认证中心端配置.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-06-系统认证-章节05_附录_1_认证中心端配置.md) |
-
-> **归口说明**：攻略-06 主题是 SSO 集成（BPM 工程经常需要 token / CAS），**主要用法在 `meritdata-platform-sso/references/`**，本目录仅保留索引。
-
-### 攻略-07 流程模块设计（8 章）
-
-| 章节 | 标题 | 路径 |
-|:-:|------|------|
-| 00 | 总览 | [攻略-07-流程模块设计-00_总览.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-07-流程模块设计-00_总览.md) |
-| 01 | 背景 | [攻略-07-流程模块设计-章节01_背景.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-07-流程模块设计-章节01_背景.md) |
-| 02 | 工作流相关介绍 | [攻略-07-流程模块设计-章节02_工作流相关介绍.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-07-流程模块设计-章节02_工作流相关介绍.md) |
-| 03 | 应用开发平台流程包含模块 | [攻略-07-流程模块设计-章节03_应用开发平台流程包含模块.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-07-流程模块设计-章节03_应用开发平台流程包含模块.md) |
-| 04 | 流程功能模块介绍 | [攻略-07-流程模块设计-章节04_流程功能模块介绍.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-07-流程模块设计-章节04_流程功能模块介绍.md) |
-| 05 | 流程后端设计 | [攻略-07-流程模块设计-章节05_流程后端设计.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-07-流程模块设计-章节05_流程后端设计.md) |
-| 06 | 流程前端设计 | [攻略-07-流程模块设计-章节06_流程前端设计.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-07-流程模块设计-章节06_流程前端设计.md) |
-| 07 | 二次开发 | [攻略-07-流程模块设计-章节07_二次开发.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-07-流程模块设计-章节07_二次开发.md) |
-| 08 | 个人样例流程的配置 | [攻略-07-流程模块设计-章节08_个人样例流程的配置.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-07-流程模块设计-章节08_个人样例流程的配置.md) |
-
-### 攻略-08 流程前端组件（6 章）— 已归口 `meritdata-platform-frontend`
-
-| 章节 | 标题 | 路径 |
-|:-:|------|------|
-| 00 | 总览 | [攻略-08-流程前端组件-00_总览.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-08-流程前端组件-00_总览.md) |
-| 01 | 概述 | [攻略-08-流程前端组件-章节01_概述.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-08-流程前端组件-章节01_概述.md) |
-| 02 | 组件与方法概览表 | [攻略-08-流程前端组件-章节02_组件与方法概览表.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-08-流程前端组件-章节02_组件与方法概览表.md) |
-| 03 | BpmFormTools - BPM 表单工具组件 | [攻略-08-流程前端组件-章节03_BpmFormTools_-_BPM表单工具组件.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-08-流程前端组件-章节03_BpmFormTools_-_BPM表单工具组件.md) |
-| 04 | BpmGridButtonsNew - BPM 表格按钮组件 | [攻略-08-流程前端组件-章节04_BpmGridButtonsNew_-_BPM表格按钮组件.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-08-流程前端组件-章节04_BpmGridButtonsNew_-_BPM表格按钮组件.md) |
-| 05 | 后端 BpmEngine 核心接口 | [攻略-08-流程前端组件-章节05_后端BpmEngine核心接口.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-08-流程前端组件-章节05_后端BpmEngine核心接口.md) |
-| 06 | 附录 | [攻略-08-流程前端组件-章节06_附录.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-08-流程前端组件-章节06_附录.md) |
-
-> **归口说明**：攻略-08 是前端组件（BpmFormTools / BpmGridButtonsNew），**主要用法在 `meritdata-platform-frontend/references/`**，本目录仅保留索引。
-
----
-
-## 四、使用规则
-
-- 本目录**仅是导航**：实际章节内容在 dev-docs/。
-- 找内容时优先用 `meritdata-dev-docs-file-finder`（带场景匹配 + 关键词反查）。
-- 想了解 BPM 全貌（API + 工作流 + 监听 + 模块设计），按上述表格按攻略-01→02→03→07 顺序读。
-
----
-
-**最后更新**：2026-09-08（v2.3.1 P1 补齐）
-**来源**：研发版 `meritdata-bpm-2nd-dev` + dev-docs/ 攻略-01~08

package/skills/meritdata-platform-bpm/references/guide.md

@@ -1,204 +0,0 @@
-# BPM 流程引擎使用指南（bpm）
-
-> **核心约束**：业务状态字段（`status`）与流程实例 ID（`process_instance_id`）**必须分离**。流程状态变更走平台公共方法，不直接 UPDATE 业务表 status。
-
----
-
-## 1. BPMN 设计要点
-
-### 1.1 节点类型
-
-| 类型 | 用途 | 关键配置 |
-|------|------|---------|
-| `startEvent` | 流程起点 | 单节点 |
-| `userTask` | 审批节点 | 审批人 + 表单字段 |
-| `serviceTask` | 自动任务 | 调用 Java 类 / 表达式 |
-| `exclusiveGateway` | 排他网关 | 条件表达式 |
-| `parallelGateway` | 并行网关 | 多分支合并 |
-| `endEvent` | 流程终点 | 单节点 |
-
-### 1.2 审批人配置
-
-```
-方式 1：固定人员
-  → assignee = "${userId}"
-
-方式 2：角色
-  → candidateGroups = "dept_leader"
-
-方式 3：发起人上级
-  → ${initiatorLeader}
-
-方式 4：表单字段
-  → ${form.approverId}
-```
-
----
-
-## 2. 业务表设计（与 domain-model 配合）
-
-### 2.1 必须字段
-
-```sql
-CREATE TABLE t_purchase_order (
-  id              BIGINT PRIMARY KEY,
-  order_no        VARCHAR(64) NOT NULL,
-  status          VARCHAR(32) NOT NULL DEFAULT 'DRAFT',     -- 业务状态
-  process_instance_id VARCHAR(64),                          -- 流程实例 ID（可空）
-  -- ... 其他业务字段
-  deleted         TINYINT DEFAULT 0,
-  uk_order_no     UNIQUE (order_no, deleted)
-);
-```
-
-### 2.2 status 字典（与流程节点对应）
-
-| status | 含义 | 触发时机 |
-|--------|------|---------|
-| `DRAFT` | 草稿 | 创建时 |
-| `PENDING` | 审批中 | 提交后 |
-| `APPROVED` | 已通过 | 流程结束-通过 |
-| `REJECTED` | 已驳回 | 流程结束-驳回 |
-| `WITHDRAWN` | 已撤回 | 发起人撤回 |
-
----
-
-## 3. 启动流程
-
-### 3.1 注入 RuntimeService
-
-```java
-@Autowired
-private RuntimeService runtimeService;
-```
-
-### 3.2 启动并关联业务
-
-```java
-// ✅ 正确：通过 BusinessKey 关联
-ProcessInstance pi = runtimeService.startProcessInstanceByKey(
-    "purchase_order_approval",       // BPMN key
-    businessKey,                     // 通常是业务单据 ID
-    variables                        // 流程变量
-);
-
-// 保存流程实例 ID 到业务表
-order.setProcessInstanceId(pi.getProcessInstanceId());
-order.setStatus("PENDING");
-orderRepository.save(order);
-```
-
-### 3.3 ❌ 反例：业务 ID 与流程实例 ID 混用
-
-```java
-// ❌ 错：把 process_instance_id 当业务 ID
-String procId = pi.getId();
-order.setId(procId);   // 错！应该分开
-```
-
----
-
-## 4. 流程回调（监听）
-
-### 4.1 实现方式
-
-```java
-@Component
-public class PurchaseOrderProcessListener implements ProcessEventListener {
-
-    @EventListener
-    public void onComplete(ProcessCompletedEvent event) {
-        String processInstanceId = event.getProcessInstance().getId();
-        String businessKey = event.getProcessInstance().getBusinessKey();
-
-        // 通过 businessKey 找到业务单据
-        PurchaseOrder order = orderRepository.findById(Long.parseLong(businessKey))
-            .orElseThrow(() -> new BizException("单据不存在"));
-
-        // 更新业务状态（走 service，不直接 UPDATE）
-        orderService.updateStatusAfterProcess(order, event.getProcessInstance().getVariables());
-    }
-}
-```
-
-### 4.2 状态变更必须走 Service
-
-```java
-// ✅ 正确
-orderService.markApproved(order);
-
-// ❌ 错误：直接在监听器里 UPDATE
-orderRepository.updateStatus(order.getId(), "APPROVED");
-```
-
----
-
-## 5. 流程与业务状态字段同步
-
-### 5.1 同步矩阵
-
-| 流程事件 | 业务 status |
-|---------|------------|
-| 流程启动 | `DRAFT` → `PENDING` |
-| 审批通过 | `PENDING` → `APPROVED` |
-| 审批驳回 | `PENDING` → `REJECTED` |
-| 发起人撤回 | `PENDING` → `WITHDRAWN` |
-
-### 5.2 状态一致性校验（定时 Job）
-
-```java
-// 每天凌晨扫描 process_instance_id 非空但 status 与流程实例不一致的记录
-List<PurchaseOrder> inconsistent = orderRepository.findInconsistent();
-for (PurchaseOrder order : inconsistent) {
-    ProcessInstance pi = runtimeService.createProcessInstanceQuery()
-        .processInstanceId(order.getProcessInstanceId())
-        .singleResult();
-    if (pi == null) {
-        // 流程已结束但 status 还是 PENDING，查历史
-        HistoricProcessInstance historic = historyService.createHistoricProcessInstanceQuery()
-            .processInstanceId(order.getProcessInstanceId())
-            .singleResult();
-        // 校正 status
-    }
-}
-```
-
----
-
-## 6. 常见反模式
-
-### 6.1 ❌ 把流程状态当业务状态唯一来源
-
-```java
-// ❌ 错：业务查询不查 status，只查 process_instance_id
-List<PurchaseOrder> list = orderRepository.findByProcessInstanceIdNotNull();
-```
-
-业务查询应该查 `status`（业务状态字段），不依赖流程引擎。
-
-### 6.2 ❌ 在业务代码里直接调 RuntimeService 启动/结束流程
-
-应该封装成 `OrderProcessService.start(order)` / `complete(order)`，不在 Controller 直接调 RuntimeService。
-
-### 6.3 ❌ 流程图频繁修改导致历史数据不一致
-
-流程图改了，旧实例按新图跑会出错。**生产流程图只能新增版本**，不能原地修改。
-
----
-
-## 7. 与其他 skill 的配合
-
-| skill | 配合方式 |
-|-------|---------|
-| `meritdata-platform-domain-model` | 先做表设计（含 status + process_instance_id）|
-| `meritdata-platform-code-spec` | 流程回调的代码规范自查 |
-| `meritdata-platform-entities` | 获取审批人 UserDTO |
-| `meritdata-platform-integration` | 流程回调里 Feign 通知 |
-
----
-
-## 8. 关联阅读
-
-- [SKILL.md](../SKILL.md)
-- [rules/code-dev-rules.md §八.2](../../rules/code-dev-rules.md#82-业务建模规则domain-model)
-- [meritdata-platform-domain-model](../meritdata-platform-domain-model/SKILL.md)

package/skills/meritdata-platform-bpm/references/status-mapping.md

@@ -1,36 +0,0 @@
-# 流程状态 ↔ 业务字段映射
-
-> **v2.6.1 补建**：v2.5.0 拆分出 bpm 子目录时遗漏创建。
-> 配套主文档：[guide.md](guide.md)
-
-## 一、流程实例状态 ↔ 业务字段
-
-| 流程实例状态 | 业务表字段（建议） | 字段类型 | 说明 |
-|------------|------------------|---------|------|
-| `RUNNING` | `bpm_instance_id` + `bpm_status='RUNNING'` | `VARCHAR(64)` + `VARCHAR(16)` | 流程进行中，可撤回 |
-| `SUSPENDED` | `bpm_status='SUSPENDED'` | `VARCHAR(16)` | 流程挂起（管理员操作）|
-| `COMPLETED` | `bpm_status='COMPLETED'` + `bpm_complete_time` | `VARCHAR(16)` + `DATETIME` | 流程结束 |
-| `TERMINATED` | `bpm_status='TERMINATED'` + `bpm_terminate_reason` | `VARCHAR(16)` + `VARCHAR(255)` | 流程撤销/驳回终态 |
-
-## 二、节点 ↔ 审批人字段
-
-| 节点类型 | 审批人字段 | 数据来源 |
-|---------|-----------|---------|
-| 发起人 | `applicant_user_id` | `PF_USER.ID`（同 JVM 走 `IUserService`）|
-| 部门负责人 | `applicant_dept_id` → 部门负责人 | `IOrgService.getDeptLeader` |
-| 角色 | `*_role_id` | `IAssignService` 资源授权 |
-| 指定用户 | `assignee_user_ids`（多人逗号分隔或关联表）| 手动指定 |
-
-## 三、平台字段命名约定
-
-- **流程实例 ID**：`bpm_instance_id`（CHAR(64)，存 Activiti/TBPM 的 processInstanceId）
-- **当前节点**：`bpm_current_node`（VARCHAR(64)，存流程当前节点 name）
-- **审批状态**：`bpm_status`（VARCHAR(16)，业务展示字段；不要混用流程实例 ID）
-- **审批历史**：单独 `t_bpm_audit_log` 关联表，**不要**把审批意见塞业务主表
-
-> **配套规范**：`meritdata-platform-domain-model` §3.1 平台语义硬规则 → 审批状态独立字段
-
-## 四、参考
-
-- [guide.md](guide.md) — BPMN 节点类型 + 触发条件
-- [rules/meritdata-platform-domain-model-rules.md §3.1](../../../../rules/meritdata-platform-domain-model-rules.md) — 平台语义路由

package/skills/meritdata-platform-cache/references/distributed-lock.md

@@ -1,199 +0,0 @@
-# 分布式锁（cache）
-
-> 基于 Redis 的分布式锁实现。防重复提交、防并发修改、防超卖。
-
----
-
-## 1. 平台封装
-
-平台已封装 `DistributedLock` 接口，二开直接注入即可，不需要自己实现 SETNX。
-
-```java
-@Resource
-private DistributedLock distributedLock;
-```
-
-接口：
-
-```java
-public interface DistributedLock {
-    /**
-     * 尝试加锁
-     * @param key 锁 key
-     * @param waitSeconds 最长等待秒数
-     * @param leaseSeconds 锁自动释放秒数（防死锁）
-     * @return LockHandle（解锁用）
-     */
-    LockHandle tryLock(String key, long waitSeconds, long leaseSeconds);
-
-    /**
-     * 释放锁（必须在 finally 中调用）
-     */
-    void unlock(LockHandle handle);
-}
-```
-
-## 2. 基本用法
-
-### 2.1 防止重复提交
-
-```java
-@PostMapping("/order/submit")
-public Result submit(@RequestBody OrderRequest req) {
-    String userId = SecurityUtils.getCurrentUserId();
-    String lockKey = "lock:order:submit:" + userId;
-
-    LockHandle lock = distributedLock.tryLock(lockKey, 0, 30);
-    if (lock == null) {
-        return Result.error("操作过于频繁，请稍后再试");
-    }
-    try {
-        orderService.submit(req);
-        return Result.success();
-    } finally {
-        distributedLock.unlock(lock);
-    }
-}
-```
-
-### 2.2 防止超卖
-
-```java
-public void deductStock(String skuId, int quantity) {
-    String lockKey = "lock:stock:" + skuId;
-
-    LockHandle lock = distributedLock.tryLock(lockKey, 5, 10);
-    if (lock == null) {
-        throw new BizException("系统繁忙，请重试");
-    }
-    try {
-        int current = stockRepository.getStock(skuId);
-        if (current < quantity) {
-            throw new BizException("库存不足");
-        }
-        stockRepository.deduct(skuId, quantity);
-    } finally {
-        distributedLock.unlock(lock);
-    }
-}
-```
-
-### 2.3 定时任务防并发（多实例部署）
-
-```java
-@Scheduled(cron = "0 0 2 * * ?")
-public void dailyJob() {
-    String lockKey = "lock:job:dailyReport";
-
-    // waitSeconds=0: 不等待，拿不到锁就跳过
-    LockHandle lock = distributedLock.tryLock(lockKey, 0, 3600);
-    if (lock == null) {
-        log.info("另一个实例正在执行 dailyJob，跳过");
-        return;
-    }
-    try {
-        reportService.generate();
-    } finally {
-        distributedLock.unlock(lock);
-    }
-}
-```
-
-## 3. 关键参数
-
-### 3.1 waitSeconds（等待时间）
-
-| 值 | 场景 |
-|----|------|
-| 0 | 不等待，拿不到锁立即失败（防止重复提交） |
-| 1 ~ 5 | 短暂等待（库存扣减） |
-| 30+ | 长时间等待（一般不建议，业务应快速失败） |
-
-### 3.2 leaseSeconds（锁持有时间）
-
-**必须**设置且**必须** < 实际业务执行时间。防宕机导致死锁。
-
-```java
-// ❌ 错：leaseSeconds 不设或太长
-distributedLock.tryLock("key", 0, 99999);  // 30 小时后才会自动释放
-
-// ✅ 正确：根据业务最长执行时间
-distributedLock.tryLock("key", 0, 30);  // 30 秒后自动释放
-```
-
-### 3.3 锁粒度
-
-```java
-// ❌ 错：锁粒度太粗（全部用户一把锁）
-String lockKey = "lock:submit";
-
-// ✅ 正确：按用户隔离
-String lockKey = "lock:submit:" + userId;
-
-// ✅ 正确：按资源隔离
-String lockKey = "lock:stock:" + skuId;
-```
-
-## 4. ❌ 反模式
-
-### 4.1 ❌ 不释放锁
-
-```java
-// ❌ 错：忘记 unlock
-LockHandle lock = distributedLock.tryLock("key", 0, 30);
-if (lock != null) {
-    doSomething();
-    // 漏掉 unlock！
-}
-```
-
-✅ **必须**用 try-finally。
-
-### 4.2 ❌ 在锁内做 HTTP 调用
-
-```java
-// ❌ 错：锁内做远程调用（锁持有时间过长）
-LockHandle lock = distributedLock.tryLock("key", 0, 30);
-try {
-    String data = httpClient.get("https://slow-api.com");  // 慢调用！
-    process(data);
-} finally {
-    distributedLock.unlock(lock);
-}
-```
-
-✅ 锁内**只**做必要的临界区操作。
-
-### 4.3 ❌ 锁粒度过粗导致性能瓶颈
-
-```java
-// ❌ 错：所有订单一把锁
-String lockKey = "lock:order";
-
-// ✅ 正确：按订单 ID 隔离
-String lockKey = "lock:order:" + orderId;
-```
-
-### 4.4 ❌ 自己实现 SETNX
-
-```java
-// ❌ 错：自实现，没有 lease 机制 → 死锁风险
-if (redis.setnx(key, "1")) {
-    // 没有 expire → 如果进程崩溃 → 死锁
-}
-```
-
-✅ 用平台 DistributedLock（内部已用 Lua 脚本保证原子性）。
-
-## 5. Redlock（高级）
-
-需要更高可靠性（如金融场景）时，可考虑 Redlock 算法（多个独立 Redis 实例）。
-
-平台暂未集成，二开需要时使用 [Redisson](https://redisson.org/)。
-
-## 6. 关联阅读
-
-- [guide.md](guide.md) — 缓存基础
-- [resilience.md](resilience.md) — 防穿透/击穿/雪崩
-- [key-design.md](key-design.md) — 缓存 key 设计
-- [SKILL.md](../SKILL.md)