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

package/skills/meritdata-dev-docs-file-finder/references/dev-docs//346/224/273/347/225/245-01-/346/265/201/347/250/213API-/347/253/240/350/212/20216_/346/265/201/347/250/213/345/210/206/347/261/273/347/233/270/345/205/263.md

@@ -0,0 +1,176 @@
+---
+name: 攻略-01-流程API-章节16_流程分类相关
+description: 流程分类相关 — 美林平台 BPM 流程 HTTP API 接口全集（启动流程、完成任务、追踪、阅知、退回等）
+keywords: [BPM, 流程API, 工作流, 启动流程, 完成任务, 追踪, 退回, 阅知, Camunda, 流程分类相关]
+use-cases: [BPM 流程 API 调用, 流程审批集成, 流程追踪, 流程退回]
+source-section: 15. 流程分类相关
+source-file: 应用开发平台-流程管理-使用攻略（一）：流程API接口.md
+---
+
+# 15. 流程分类相关
+
+## 📋 API 契约（机器可读）
+
+```json
+{
+  "apiName": "",
+  "method": "POST",
+  "urlPattern": null,
+  "signature": "Result addFormAddress()",
+  "functionDesc": "查询流程分类编码",
+  "module": "bpm.process",
+  "pathParameters": [],
+  "requestParameters": [],
+  "returnType": "Map<String，String>对象      key 分类编码     value  分类名称",
+  "returnFields": [
+    "timestamp",
+    "status",
+    "message",
+    "data",
+    "success"
+  ],
+  "exceptionList": [
+    "BusinessException",
+    "SystemException"
+  ],
+  "exampleCall": "bpmEngine.getProcTypes(...)",
+  "bestPractice": "传入 bpmOperName 和 bpmOperValue 必须匹配流程定义中的按钮配置"
+}
+```
+
+### 15.1 查询流程分类编码
+
+说明: 查询流程分类编码
+
+- method : GET
+
+- url : `http://IP:端口/gateway/服务名/api/bpm/core/query/proctypes`
+
+- RequestParams：
+
+  无
+
+- PathVariables
+
+```json
+无
+```
+
+- RequestBody
+
+```json
+无
+```
+
+- ResponseBody
+
+返回数据类型：Map<String，String>对象      key 分类编码     value  分类名称
+
+Postman测试样例：
+
+http://127.0.0.1:8080/gateway/cloud-system-bpm-demo/api/bpm/core/query/proctypes
+
+```json
+{
+    "timestamp": 1629941964744,
+    "status": 1,
+    "message": "成功",
+    "stackmessage": null,
+    "path": "/api/bpm/core/query/proctypes",
+    "data": {
+        "apply": "请假",
+        "travel": "差旅"  
+    },
+    "extraInfo": {},
+    "success": true
+}
+```
+
+<b>java样例</b>
+适用于后端调用,结合业务数据筛选使用
+ 注入com.meritdata.cloud.bpm.core.BpmEngine类
+
+```java
+@Autowired
+    BpmEngine bpmEngine;
+
+    @ApiOperation(value = "查询流程分类", notes = "查询流程分类")
+    @RequestMapping(value = "/query/proctypes", method = RequestMethod.GET)
+    public @ResponseBody ResultBody<Map<String,String>> queryProcTypes() {
+
+        // 调用查询流程实例
+        ResultBody<Map<String, String>> procTypes = bpmEngine.getProcTypes();
+        return procTypes;
+    }
+```
+
+### 15.2 添加表单地址
+
+说明: 查询流程分类编码
+
+- method : POST
+
+- url : `http://IP:端口/gateway/服务名/api/bpm/core/add/formaddress`
+
+- RequestParams：
+
+  | 参数     | 参数类型 | 是否必须 | 释义     | 备注 |
+  | -------- | -------- | -------- | -------- | ---- |
+  | name     | String   | 是       | 表单名称 |      |
+  | address  | String   | 是       | 表单地址 |      |
+  | sort     | Integer  | 否       | 排序号   |      |
+  | typecode | String   | 是       | 分类编码 |      |
+
+- PathVariables
+
+```json
+无
+```
+
+- RequestBody
+
+```json
+无
+```
+
+- ResponseBody
+
+返回数据类型：Boolean  
+
+Postman测试样例：
+
+http://127.0.0.1:8080/gateway/cloud-system-bpm-demo/api/bpm/core/add/formaddress
+
+```json
+{
+    "timestamp": 1629942567618,
+    "status": 1,
+    "message": "成功",
+    "stackmessage": null,
+    "path": "/api/bpm/core/add/formaddress",
+    "data": true,
+    "extraInfo": {},
+    "success": true
+}
+```
+
+<b>java样例</b>
+适用于后端调用,结合业务数据筛选使用
+ 注入com.meritdata.cloud.bpm.core.BpmEngine类
+
+```java
+@Autowired
+    BpmEngine bpmEngine;
+
+    @ApiOperation(value = "添加表单地址", notes = "添加表单地址")
+    @RequestMapping(value = "/add/formaddress", method = RequestMethod.POST)
+    public @ResponseBody ResultBody<Boolean> addFormAddress() {
+		String name = "测试表单地址";
+        String address = "/index.html";
+        Integer sort = 99;
+        String typecode = "apply";
+        // 调用查询流程实例
+        ResultBody<boolean> result = bpmEngine.addFormAddress(name,address, sort, typecode);
+        return result;
+    }
+```

package/skills/meritdata-dev-docs-file-finder/references/dev-docs//346/224/273/347/225/245-02-/345/267/245/344/275/234/346/265/201/347/250/213-00_/346/200/273/350/247/210.md

@@ -0,0 +1,84 @@
+---
+name: 攻略-02-工作流程-00_总览
+description: 美林平台 BPM 工作流程应用开发完整教程（工程创建 / 配置 / 业务类）
+keywords: [BPM, 工作流程, 开发教程, 工程创建, pom.xml, bootstrap.properties, 二开]
+use-cases: [从零创建 BPM 二开工程, 配置 nacos, 编写流程业务类]
+related: [cloud-system-bpm-module-core / Spring Boot 3.4.13]
+source: 应用开发平台-流程管理-使用攻略（二）：工作流程应用开发.md
+---
+
+# 应用开发平台流程管理使用攻略（二）：工作流程应用开发 — 总览
+
+**摘要**：美林平台 BPM 工作流程应用开发完整教程（工程创建 / 配置 / 业务类）
+
+**关联**：cloud-system-bpm-module-core / Spring Boot 3.4.13
+
+## 章节索引
+
+01. [样例说明](攻略-02-工作流程-章节01_样例说明.md)
+02. [后端工程创建](攻略-02-工作流程-章节02_后端工程创建.md) (原 1)
+03. [后端工程配置](攻略-02-工作流程-章节03_后端工程配置.md) (原 2)
+04. [后端工程业务类创建](攻略-02-工作流程-章节04_后端工程业务类创建.md) (原 3)
+05. [启动后端应用工程](攻略-02-工作流程-章节05_启动后端应用工程.md) (原 4)
+06. [流程应用前端开发](攻略-02-工作流程-章节06_流程应用前端开发.md) (原 5)
+07. [启动前端应用工程](攻略-02-工作流程-章节07_启动前端应用工程.md) (原 6)
+08. [流程设计](攻略-02-工作流程-章节08_流程设计.md) (原 7)
+
+## 引言
+
+查看应用开发平台系统运行环境是否正常；环境搭建参考《应用开发平台使用攻略（一）：系统环境搭建》
+
+
+## 📑 API 速查
+
+本攻略共 **4 个 API**（按章节排序）：
+
+| 章节 | API | 方法 | 路径/签名 | 类型 | 描述 |
+|------|------|------|----------|------|------|
+| 章节02_后端工程创建 | `ProjectBusinessSSODemo` | - | `class ProjectBusinessSSODemo` | class | BPM 后端业务工程脚手架（pom.xml + Application class） |
+| 章节03_后端工程配置 | `BootstrapProperties` | - | `class BootstrapProperties` | class | Nacos bootstrap 配置（端口 / namespace / spring.applica... |
+| 章节04_后端工程业务类创建 | `BusinessService` | - | `class BusinessService` | java | BPM 业务 Service 类（@Service + @Autowired BpmEngine） |
+| 章节06_流程应用前端开发 | `-` | - | `-` | http |  |
+
+### JSON Schema 完整索引
+
+```json
+[
+  {
+    "chapter": "章节02_后端工程创建",
+    "apiName": "ProjectBusinessSSODemo",
+    "method": "",
+    "urlPattern": "",
+    "type": "class",
+    "signature": "class ProjectBusinessSSODemo",
+    "functionDesc": "BPM 后端业务工程脚手架（pom.xml + Application class）"
+  },
+  {
+    "chapter": "章节03_后端工程配置",
+    "apiName": "BootstrapProperties",
+    "method": "",
+    "urlPattern": "",
+    "type": "class",
+    "signature": "class BootstrapProperties",
+    "functionDesc": "Nacos bootstrap 配置（端口 / namespace / spring.application.name）"
+  },
+  {
+    "chapter": "章节04_后端工程业务类创建",
+    "apiName": "BusinessService",
+    "method": "",
+    "urlPattern": "",
+    "type": "java",
+    "signature": "class BusinessService",
+    "functionDesc": "BPM 业务 Service 类（@Service + @Autowired BpmEngine）"
+  },
+  {
+    "chapter": "章节06_流程应用前端开发",
+    "apiName": "",
+    "method": "",
+    "urlPattern": "",
+    "type": "http",
+    "signature": "",
+    "functionDesc": ""
+  }
+]
+```

package/skills/meritdata-dev-docs-file-finder/references/dev-docs//346/224/273/347/225/245-02-/345/267/245/344/275/234/346/265/201/347/250/213-/347/253/240/350/212/20201_/346/240/267/344/276/213/350/257/264/346/230/216.md

@@ -0,0 +1,37 @@
+---
+name: 攻略-02-工作流程-章节01_样例说明
+description: 样例说明 — 美林平台 BPM 工作流程应用开发完整教程（工程创建 / 配置 / 业务类）
+keywords: [BPM, 工作流程, 开发教程, 工程创建, pom.xml, bootstrap.properties, 二开, 样例说明]
+use-cases: [从零创建 BPM 二开工程, 配置 nacos, 编写流程业务类]
+source-section: 无编号. 样例说明
+source-file: 应用开发平台-流程管理-使用攻略（二）：工作流程应用开发.md
+---
+
+# 样例说明
+
+- <b>案例：</b> 差旅费报销功能的开发案例
+
+- <b>场景说明</b>
+
+  - 员工填写差旅费报销单，包括出差地，出差时间，出差费用等，将差旅费报销单提交给部门领导。
+  - 部门领导审批，如果审批结束（批准或者不批准），流程结束。如果需要员工修改申请，退回去给员工进行修改。
+
+- <b>流程应用后端工程：</b>business-bpm-demo
+  
+  - 功能简介：
+    - 1.根据条件查找差旅费
+    - 2.删除差旅费
+    - 3.修改差旅费
+    - 4.保存差旅费
+  
+- <b>流程应用前端工程：</b>business-bpm-expense
+
+  - 功能简介：
+    - 1.引入流程按钮
+    - 2.查看差旅费表单界面
+    - 3.编辑/新增差旅费表单界面
+
+- <b>参考文档</b>
+  《二次开发--流程接口》
+  
+  **以下为手动搭建方案，另一种方案直接利用代码生成工具生成流程前后端应用，具体生成指导见代码生成工具文档**。

package/skills/meritdata-dev-docs-file-finder/references/dev-docs//346/224/273/347/225/245-02-/345/267/245/344/275/234/346/265/201/347/250/213-/347/253/240/350/212/20202_/345/220/216/347/253/257/345/267/245/347/250/213/345/210/233/345/273/272.md

@@ -0,0 +1,39 @@
+---
+name: 攻略-02-工作流程-章节02_后端工程创建
+description: 后端工程创建 — 美林平台 BPM 工作流程应用开发完整教程（工程创建 / 配置 / 业务类）
+keywords: [BPM, 工作流程, 开发教程, 工程创建, pom.xml, bootstrap.properties, 二开, 后端工程创建]
+use-cases: [从零创建 BPM 二开工程, 配置 nacos, 编写流程业务类]
+source-section: 1. 后端工程创建
+source-file: 应用开发平台-流程管理-使用攻略（二）：工作流程应用开发.md
+---
+
+# 1. 后端工程创建
+
+## 📋 API 契约（机器可读）
+
+```json
+{
+  "apiName": "ProjectBusinessSSODemo",
+  "type": "class",
+  "signature": "class ProjectBusinessSSODemo",
+  "functionDesc": "BPM 后端业务工程脚手架（pom.xml + Application class）",
+  "module": "platform",
+  "classMethods": [],
+  "usagePattern": "通过 Spring 容器注入使用",
+  "bestPractice": "遵循 Spring Bean 生命周期，使用 @Autowired 注入"
+}
+```
+
+### 1.1 操作场景
+
+使用 IntelliJ IDEA 新建一个 Maven 工程；按照工程创建操作步骤，生成后端工程；修改相关配置信息；加载依赖包，启动工程，nacos 中查看。
+
+### 1.2 操作步骤
+
+根据《应用开发平台使用攻略(一)：系统环境搭建》 的后端工程创建，进行后端工程搭建。
+
+创建 business-bpm-demo 工程应用
+
+生成的目录结构如下图所示：
+
+![](./imgs/流程应用开发/1-6.jpg)

package/skills/meritdata-dev-docs-file-finder/references/dev-docs//346/224/273/347/225/245-02-/345/267/245/344/275/234/346/265/201/347/250/213-/347/253/240/350/212/20203_/345/220/216/347/253/257/345/267/245/347/250/213/351/205/215/347/275/256.md

@@ -0,0 +1,234 @@
+---
+name: 攻略-02-工作流程-章节03_后端工程配置
+description: 后端工程配置 — 美林平台 BPM 工作流程应用开发完整教程（工程创建 / 配置 / 业务类）
+keywords: [BPM, 工作流程, 开发教程, 工程创建, pom.xml, bootstrap.properties, 二开, 后端工程配置]
+use-cases: [从零创建 BPM 二开工程, 配置 nacos, 编写流程业务类]
+source-section: 2. 后端工程配置
+source-file: 应用开发平台-流程管理-使用攻略（二）：工作流程应用开发.md
+---
+
+# 2. 后端工程配置
+
+## 📋 API 契约（机器可读）
+
+```json
+{
+  "apiName": "BootstrapProperties",
+  "type": "class",
+  "signature": "class BootstrapProperties",
+  "functionDesc": "Nacos bootstrap 配置（端口 / namespace / spring.application.name）",
+  "module": "platform",
+  "classMethods": [],
+  "usagePattern": "通过 Spring 容器注入使用",
+  "bestPractice": "遵循 Spring Bean 生命周期，使用 @Autowired 注入"
+}
+```
+
+### 2.1 修改 pom.xml 文件
+
+引入流程 jar 包，${cloud-system-bpm.version}、${cloud-starter-core.version}、${cloud-starter-dbinit.version}、${cloud-system-bpm-module-core.version}版本信息根据需要自适配。
+
+```xml
+    <parent>
+        <artifactId>cloud-system-bpm</artifactId>
+        <groupId>com.meritdata.cloud</groupId>
+        <version>${cloud-system-bpm.version}</version>
+    </parent>
+```
+
+完整配置信息如下:
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <parent>
+        <artifactId>cloud-system-bpm</artifactId>
+        <groupId>com.meritdata.cloud</groupId>
+        <version>${cloud-system-bpm.version}</version>
+    </parent>
+    <modelVersion>4.0.0</modelVersion>
+
+    <artifactId>business-bpm-demo</artifactId>
+
+    <dependencies>
+        <dependency>
+            <groupId>com.meritdata.cloud</groupId>
+            <artifactId>cloud-starter-core</artifactId>
+            <version>${cloud-starter-core.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>com.meritdata.cloud</groupId>
+            <artifactId>cloud-starter-dbinit</artifactId>
+            <version>${cloud-starter-dbinit.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-devtools</artifactId>
+            <optional>true</optional>
+        </dependency>
+        <dependency>
+            <groupId>com.meritdata.cloud</groupId>
+            <artifactId>cloud-system-bpm-module-core</artifactId>
+            <version>${cloud-system-bpm-module-core.version}</version>
+        </dependency>
+        <!--QueryDSL支持-->
+        <dependency>
+            <groupId>com.querydsl</groupId>
+            <artifactId>querydsl-apt</artifactId>
+            <scope>provided</scope>
+            <exclusions>
+                <exclusion>
+                    <groupId>org.javassist</groupId>
+                    <artifactId>javassist</artifactId>
+                </exclusion>
+            </exclusions>
+        </dependency>
+        <!--QueryDSL支持-->
+        <dependency>
+            <groupId>com.querydsl</groupId>
+            <artifactId>querydsl-jpa</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.projectlombok</groupId>
+            <artifactId>lombok</artifactId>
+            <version>1.16.10</version>
+            <scope>provided</scope>
+        </dependency>
+    </dependencies>
+    <build>
+        <!--使配置文件可以直接读取pom中的系统参数 -->
+        <resources>
+            <resource>
+                <directory>src/main/resources</directory>
+                <filtering>true</filtering>
+            </resource>
+        </resources>
+        <plugins>
+            <plugin>
+                <groupId>org.springframework.boot</groupId>
+                <artifactId>spring-boot-maven-plugin</artifactId>
+                <configuration>
+                    <!--fork :  如果没有该项配置，肯定devtools不会起作用，即应用不会restart -->
+                    <fork>true</fork>
+                </configuration>
+            </plugin>
+            <plugin>
+                <groupId>net.alchim31.maven</groupId>
+                <artifactId>yuicompressor-maven-plugin</artifactId>
+                <version>1.3.0</version>
+                <executions>
+                    <execution>
+                        <phase>prepare-package</phase>
+                        <goals>
+                            <goal>compress</goal>
+                        </goals>
+                    </execution>
+                </executions>
+                <configuration>
+                    <encoding>UTF-8</encoding>
+                    <jswarn>false</jswarn>
+                    <nosuffix>true</nosuffix>
+                    <linebreakpos>-1</linebreakpos>
+                    <force>true</force>
+                    <includes>
+                        <include>**/*.css</include>
+                        <include>**/*.js</include>
+                    </includes>
+                </configuration>
+            </plugin>
+            <!-- css、js文件打包后添加版本号插件 -->
+            <plugin>
+                <groupId>com.google.code.maven-replacer-plugin</groupId>
+                <artifactId>replacer</artifactId>
+                <version>1.5.3</version>
+                <executions>
+                    <execution>
+                        <phase>prepare-package</phase>
+                        <goals>
+                            <goal>replace</goal>
+                        </goals>
+                    </execution>
+                </executions>
+                <configuration>
+                    <basedir>${build.directory}</basedir>
+                    <includes>
+                        <include>**/*.ftl</include>
+                    </includes>
+                    <replacements>
+                        <replacement>
+                            <token>\.css\"</token>
+                            <value>.css?v=${maven.build.timestamp}\"</value>
+                        </replacement>
+                        <replacement>
+                            <token>\.css\'</token>
+                            <value>.css?v=${maven.build.timestamp}\'</value>
+                        </replacement>
+                        <replacement>
+                            <token>\.js\"</token>
+                            <value>.js?v=${maven.build.timestamp}\"</value>
+                        </replacement>
+                        <replacement>
+                            <token>\.js\'</token>
+                            <value>.js?v=${maven.build.timestamp}\'</value>
+                        </replacement>
+                    </replacements>
+                </configuration>
+            </plugin>
+            <!--因为是类型安全的，所以还需要加上Maven APT plugin，使用 APT 自动生成一些类:-->
+            <plugin>
+                <groupId>com.mysema.maven</groupId>
+                <artifactId>apt-maven-plugin</artifactId>
+                <version>1.1.3</version>
+                <executions>
+                    <execution>
+                        <phase>generate-sources</phase>
+                        <goals>
+                            <goal>process</goal>
+                        </goals>
+                        <configuration>
+                            <outputDirectory>target/generated-sources</outputDirectory>
+                            <processor>com.querydsl.apt.jpa.JPAAnnotationProcessor</processor>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+</project>
+```
+
+### 2.2 修改 bootstrap.properties 文件
+
+在 src 目录->resources 目录-> bootstrap.properties 文件
+
+修改 server.port = 8099
+防止端口冲突
+
+完整配置信息如下:
+
+```properties
+#启动端口
+server.port=8099
+#nacos的启动地址，在nacos的启动日志中查看
+meritdata.cloud.nacos-addr=127.0.0.1:8848
+spring.cloud.nacos.config.server-addr=${meritdata.cloud.nacos-addr}
+spring.cloud.nacos.discovery.server-addr=${meritdata.cloud.nacos-addr}
+#程序加载的配置文件
+#服务启动的时候会读取 prefix.properties 和 prefix-profiles.properties 文件下的配置项
+spring.profiles.include=server,cache,freemarker,datasource,sentinel,oauth2,cloud-system-cas,@project.artifactId@
+spring.cloud.nacos.config.prefix=common
+#nacos 创建的namespace的标识码
+#spring.cloud.nacos.config.namespace=b62f9c4c-ab77-4de6-b6c5-8e8b8c45f79a
+#nacos的配置的命名空间，默认为空
+spring.cloud.nacos.config.namespace=
+#系统的程序名，在创建工程的时候确定，挂载到nacos中的名称
+spring.application.name=@project.artifactId@
+meritdata.cloud.product-name=cloud-system-framework
+spring.main.allow-bean-definition-overriding=true
+#日志文件最长保存添加
+logfile-max-history=30
+#应用日志级别
+logging-level=info
+```