# JeecgBoot BPM 流程自动生成 — Skills 使用指南

> 通过自然语言描述，AI 自动生成 Flowable BPMN 2.0 XML 并调用 API 创建/修改流程。

## 前置准备

使用前需准备两样东西：

| 信息 | 获取方式 | 示例 |
|------|---------|------|
| **后端地址** | 运维/开发提供 | `https://api3.boot.jeecg.com` |
| **X-Access-Token** | 浏览器 F12 → Network → 任意请求 Headers | `eyJhbGciOiJIUzI1NiJ9...` |

---

## 实战案例：车辆出差申请流程

以下是一个完整的流程创建和迭代修改过程，展示了 skill 的实际使用方式。

### 第一步：创建基础流程

**用户输入：**
```
创建一个车辆出差申请流程
```

**AI 交互过程：**

1. AI 询问后端地址和 Token
2. 用户提供凭据后，AI 设计流程并展示摘要：

```
## 流程摘要

- 流程名称：车辆出差申请流程
- 流程类型：oa

### 流程节点

| 序号 | 节点名称 | 类型 | 审批人 |
|------|---------|------|--------|
| 1 | 开始 | startEvent | - |
| 2 | 申请人填写 | userTask (草稿) | ${applyUserId} |
| 3 | 部门负责人审批 | userTask | 表达式(部门负责人) |
| 4 | 分管领导审批 | userTask | 表达式(上一级部门负责人) |
| 5 | 车辆调度确认 | userTask | 上一节点指派 |
| 6 | 结束 | endEvent | - |

确认以上信息正确？(y/n)
```

3. 用户确认 `y` 后，AI 自动生成 BPMN XML 并调用 API
4. 返回结果：

```
## 流程创建成功

- 流程ID：2032497475959439362
- 流程Key：process_1773420125267
```

---

### 第二步：增加审批节点

**用户输入：**
```
修改刚才的流程，加入一个总经理审批节点，最后一个节点
```

**AI 交互过程：**

1. AI 基于已有流程信息，展示修改后的摘要（标注变更项）：

```
| 序号 | 节点名称 | 类型 | 审批人 | 变更 |
|------|---------|------|--------|------|
| ... | （原有节点） | ... | ... | |
| 6 | 总经理审批 | userTask | 表达式(上两级部门负责人) | 新增 |
| 7 | 结束 | endEvent | - | |
```

2. 用户确认后，AI 使用相同的 `processDefinitionId` 和 `processkey` 调用 API 更新流程
3. 流程修改成功

---

### 第三步：增加条件分支

**用户输入：**
```
在部门负责人审批节点后面增加分支条件，如果用车时间超过3天则需要人力审批，然后再流向车辆调度确认
```

**AI 交互过程：**

1. AI 识别出需要排他网关（exclusiveGateway），展示分支逻辑：

```
开始 → 申请人填写 → 部门负责人审批 → 用车天数判断
  ├─ ≤3天 ──────────────→ 分管领导审批 → 车辆调度确认 → 总经理审批 → 结束
  └─ >3天 → 人力审批(hr角色) ↗
```

2. 用户确认后，API 更新流程

**最终流程图效果：**

```
        ○ 开始
        ↓
   [申请人填写]        ← 草稿节点，首次自动跳过
        ↓
  [部门负责人审批]      ← 表达式: getDepartLeaders
        ↓
     ◇ 用车天数判断
    ↙         ↘
  ≤3天        >3天
   ↓          ↓
   │      [人力审批]    ← hr 角色组
   ↓        ↙
  [分管领导审批]        ← 表达式: getLevel1DepartLeaders
        ↓
   [车辆调度确认]       ← 上一节点指派
        ↓
   [总经理审批]         ← 表达式: getLevel2DepartLeaders
        ↓
        ● 结束
```

---

## 使用技巧

### 1. 描述流程的多种方式

```
# 简单描述
创建一个请假审批流程，先经理审批再HR审批

# 指定审批人
创建流程：开始 → admin审批 → hr角色组审批 → 结束

# 描述条件分支
报销流程，金额大于1万需要总监审批，否则经理审批即可

# 描述会签
创建合同审批流程，需要法务部和财务部同时会签
```

### 2. 修改已有流程

```
# 增加节点
在经理审批后面加一个总监审批

# 增加条件分支
在提交节点后加一个金额判断，超过5000走总监审批

# 修改审批人
把部门经理审批改成角色组 manager

# 删除节点
去掉HR审批节点
```

### 3. 支持的审批人类型

| 说法 | AI 识别为 |
|------|----------|
| "admin审批" | 固定指定人 |
| "发起人/申请人" | `${applyUserId}` 表达式 |
| "部门负责人" | `getDepartLeaders` 表达式 |
| "分管领导" | `getLevel1DepartLeaders` 表达式 |
| "hr角色" / "角色组" | `candidateGroups` + `groupType="role"` |
| "上一节点指派" | `isAssignedByPreviousNode=true` |
| "张三或李四" | `candidateUsers` 候选人 |
| "会签/多人同时审批" | 多实例 + `countersignRule` |

### 4. 支持的条件分支

| 说法 | AI 生成 |
|------|--------|
| "金额大于1万" | `${amount > 10000}` |
| "天数超过3天" | `${use_days > 3}` |
| "通过/拒绝" | `${result == 1}` / `${result == 0}` |
| "部长以上职务" | `${oaUtil.branchConditionByPost(...)}` |

> 条件变量名需与业务表单字段名一致。

---

## 注意事项

1. **Token 有效期**：JWT Token 有过期时间，过期后需重新从浏览器获取
2. **流程字段绑定**：条件分支中的变量名（如 `use_days`）需与关联表单的字段名一致
3. **同一会话内可连续修改**：AI 会记住当前流程的 ID 和 Key，无需重复提供
4. **修改是覆盖式的**：每次修改会提交完整的 BPMN XML，不是增量更新
5. **创建后需绑定表单**：流程创建后，需在 JeecgBoot 后台绑定业务表单才能正常发起
