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

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

@@ -1,176 +0,0 @@
----
-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

@@ -1,84 +0,0 @@
----
-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

@@ -1,37 +0,0 @@
----
-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

@@ -1,39 +0,0 @@
----
-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

@@ -1,234 +0,0 @@
----
-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
-```