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

package/skills/meritdata-platform-bpm/references/todo-portal.md

@@ -0,0 +1,239 @@
+## 1. 背景
+
+待办同步会传递流程和人员相关数据。目标门户必须使用受认证的服务到服务通道，并校验调用身份、租户和数据范围；不要把同步回调暴露为匿名接口。
+有部分项目需要将流程产生的待办同步到其他门户页面处理。
+## 2. 功能实现
+应用开发平台通过项目配置中的同步参数将待办信息同步到其他服务。配置值和服务发现范围以目标环境为准。
+下面说明参数含义及实现原理
+### 2.1 nacos 配置
+配置参数位置：
+common-cloud-bpm-engine.properties 
+配置项：
+支持向两个门户同时同步
+```properties
+#同步待办参数portal 门户  RTX
+#默认为false 不开启同步
+meritdata.cloud.synundo.portal.status=false
+#默认为false 不开启同步
+meritdata.cloud.synundo.rtx.status=false
+#向portal同步未处理的待办地址
+meritdata.cloud.sync.undeal.undo.portal.url=<portal-service>/<undo-path>
+#向portal同步已处理待办的地址
+meritdata.cloud.sync.deal.undo.portal.url=<portal-service>/<undo-path>
+#向Rtx门户同步未处理的待办地址
+meritdata.cloud.sync.undeal.undo.rtx.url=<rtx-service>/<undo-path>
+#向Rtx门户同步已处理的待办地址
+meritdata.cloud.sync.deal.undo.rtx.url=<rtx-service>/<undo-path>
+#向portal同步已删除代办数据的待办地址
+meritdata.cloud.sync-del-undo-portal-url=<portal-service>/<deleted-undo-path>
+#向Rtx门户同步已删除代办数据的待办地址
+meritdata.cloud.sync-del-undo-rtx-url=<rtx-service>/<deleted-undo-path>
+
+```
+原理：通过获取这些参数，通过feign的方式将待办数据以json入参的形式，调用配置的接口达到向其它服务同步待办的目的 。
+由于采用feign的调用方式，因此配置的服务必须是同一个nacos管理的服务。
+### 2.2 应用开发平台平台侧的实现代码
+```java
+package com.meritdata.cloud.bpm.event;
+
+import com.alibaba.fastjson.JSON;
+import com.meritdata.cloud.bpm.common.Constant;
+import com.meritdata.cloud.bpm.entity.Undo;
+import com.meritdata.cloud.bpm.feign.IBpmUndoServiceClient;
+import com.meritdata.cloud.bpm.undo.service.IUndoService;
+import com.meritdata.cloud.utils.NacosUtils;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.stereotype.Service;
+
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.logging.Logger;
+
+/**
+ * 待办同步处理类
+ * @author merit
+ * 同步门户和RTX待办
+ */
+@Service
+public class UndoEvent {
+
+    @Autowired
+    NacosUtils nacosUtils;
+    private final static Logger LOGGER = Logger.getLogger(UndoEvent.class.getName());
+
+    @com.google.common.eventbus.Subscribe
+    public void sub(Map<String, Object> params){
+        IBpmUndoServiceClient synUndoClient = (IBpmUndoServiceClient)params.get("synUndoClient");
+        IUndoService undoService = (IUndoService)params.get("undoService");
+        // 调用参数 dealStatus : 待办处理状态 0 未处理 1 已处理 undos: 待办list
+        //portal同步  是否开启同步的判断
+        if(undoService.getSynUndo2Portal()){
+            syncToPortal(undoService, synUndoClient);
+        }
+        //RTX同步待办
+        if(undoService.getSynUndo2Rtx()){
+           syncToRtx(undoService, synUndoClient);
+        }
+    }
+
+    private void syncToRtx(IUndoService undoService, IBpmUndoServiceClient synUndoClient) {
+        // 获取未处理待办同步门户地址
+        String unDealRtxUrl = nacosUtils.getConfigValue(Constant.BPM_NACOS_CONFIG_FILE_NAME,
+                Constant.UNDEAL_UNDO_SYNC_RTX_URL_KEY);
+        LOGGER.info("unDealRtxUrl:" + unDealRtxUrl);
+        if (null != unDealRtxUrl && unDealRtxUrl.length() > Constant.INT_ZERO){
+            List<Undo> undealUndos = undoService.getSynFailedUndealUndosRtx();
+            if(undealUndos != null && undealUndos.size() > Constant.INT_ZERO){
+                boolean synFlag = synUndoClient.syncUndealUndoToRtx(unDealRtxUrl, JSON.toJSONString(undealUndos));
+                if(synFlag){
+                    for(Undo undo : undealUndos){
+                        undoService.updataUnodSynRtxStatus(undo,Constant.UNDEAL_SYNC_SUCESS);
+                    }
+                }
+            }
+        }
+
+        // 获取未处理待办同步门户地址
+        String dealRtxUrl = nacosUtils.getConfigValue(Constant.BPM_NACOS_CONFIG_FILE_NAME,
+                Constant.DEAL_UNDO_SYNC_RTX_URL_KEY);
+        LOGGER.info("dealRtxUrl: " + dealRtxUrl);
+        if (null != unDealRtxUrl && unDealRtxUrl.length() > Constant.INT_ZERO) {
+            List<Undo> dealUndos = undoService.getSynFailedDealUndosRtx();
+            if (dealUndos != null && dealUndos.size() > Constant.INT_ZERO) {
+                boolean synFlag = synUndoClient.syncDealUndoToRtx(dealRtxUrl, JSON.toJSONString(dealUndos));
+                if (synFlag) {
+                    for (Undo undo : dealUndos) {
+                        undoService.updataUnodSynRtxStatus(undo, Constant.DEAL_SYNC_SUCESS);
+                    }
+                }
+            }
+        }
+    }
+
+    private void syncToPortal(IUndoService undoService, IBpmUndoServiceClient synUndoClient) {
+        // 获取未处理待办同步门户地址
+        String unDealPortalUrl = nacosUtils.getConfigValue(Constant.BPM_NACOS_CONFIG_FILE_NAME,
+                Constant.UNDEAL_UNDO_SYNC_PORTAL_URL_KEY);
+        LOGGER.info("unDealPortalUrl: " + unDealPortalUrl);
+        if ( null != unDealPortalUrl && unDealPortalUrl.length() > Constant.INT_ZERO){
+            // 获取同步失败的未处理的待办
+            List<Undo> undealUndos = undoService.getSynFailedUndealUndos();
+            if(undealUndos != null && undealUndos.size() > Constant.INT_ZERO){
+                boolean synFlag = synUndoClient.syncUndealUndoToPortal(unDealPortalUrl, JSON.toJSONString(undealUndos));
+                if(synFlag){
+                    for(Undo undo : undealUndos){
+                        undoService.updataUnodSynStatus(undo, Constant.UNDEAL_SYNC_SUCESS);
+                    }
+                }
+            }
+        }
+        // 获取已处理待办同步门户地址
+        String dealPortalUrl = nacosUtils.getConfigValue(Constant.BPM_NACOS_CONFIG_FILE_NAME,
+                Constant.DEAL_UNDO_SYNC_PORTAL_URL_KEY);
+        LOGGER.info("dealPortalUrl" + dealPortalUrl);
+        if (null != dealPortalUrl && dealPortalUrl.length() > Constant.INT_ZERO){
+            List<Undo> dealUndos = undoService.getSynFailedDealUndos();
+            if(dealUndos != null && dealUndos.size() > Constant.INT_ZERO){
+                boolean synFlag = synUndoClient.syncDealUndoToPortal(dealPortalUrl, JSON.toJSONString(dealUndos));
+                if(synFlag){
+                    for(Undo undo : dealUndos){
+                        undoService.updataUnodSynStatus(undo,Constant.DEAL_SYNC_SUCESS);
+                    }
+                }
+            }
+        }
+
+    }
+
+
+}
+
+```
+Feign类代码
+```java
+package com.meritdata.cloud.bpm.feign;
+
+import com.meritdata.cloud.bpm.entity.Undo;
+import com.meritdata.cloud.config.CloudFeignConfiguration;
+import io.swagger.annotations.ApiOperation;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+import java.util.Map;
+
+/**
+ * @author merit
+ *
+ * 同步待办feign接口
+ */
+@RestController
+@FeignClient(value = "${meritdata.cloud.custom-syncundo-service-name}",configuration = CloudFeignConfiguration.class)
+public interface IBpmUndoServiceClient {
+
+    /**
+     * 向portal同步未处理待办
+     *
+     * @param unDealPortalUrl 未处理待办地址
+     * @param undos 待办集合
+     * @return boolean
+     */
+    @ApiOperation(value = "向portal端同步未处理待办")
+    @RequestMapping(value = "/api/{unDealPortalUrl}",method = RequestMethod.POST)
+    public Boolean syncUndealUndoToPortal(@PathVariable("unDealPortalUrl") String unDealPortalUrl,
+                                          @RequestBody  String undos);
+
+    /**
+     * 向portal同步已处理待办
+     *
+     * @param dealPortalUrl 已处理待办地址
+     * @param undos 待办集合
+     * @return boolean
+     */
+    @ApiOperation(value = "向portal端同步待办")
+    @RequestMapping(value = "/api/{dealPortalUrl}",method = RequestMethod.POST)
+    public Boolean syncDealUndoToPortal(@PathVariable("dealPortalUrl") String dealPortalUrl, @RequestBody  String undos);
+
+
+    /**
+     * 向RTX同步未处理待办
+     *
+     * @param unDealRtxUrl 未处理待办同步RTX地址
+     * @param undos 待办集合
+     * @return Boolean
+     */
+    @ApiOperation(value = "向RTX端同步待办")
+    @RequestMapping(value = "/api/{unDealRtxUrl}",method = RequestMethod.POST)
+    public Boolean syncUndealUndoToRtx(@PathVariable("unDealRtxUrl") String unDealRtxUrl, @RequestBody  String undos);
+
+    /**
+     * 向RTX同步已处理待办
+     *
+     * @param dealRtxUrl 已处理待办同步RTX地址
+     * @param undos 待办集合
+     * @return Boolean
+     */
+    @ApiOperation(value = "向RTX端同步待办")
+    @RequestMapping(value = "/api/{dealRtxUrl}",method = RequestMethod.POST)
+    public Boolean syncDealUndoToRtx(@PathVariable("dealRtxUrl") String dealRtxUrl, @RequestBody  String undos);
+
+}
+
+```
+其他服务接收到待办数据后，就可以对待办数据进行处理展现或者继续同步到其它第三方系统。
+### 2.3 二开侧代码
+由于需要把JsonString转换为List\<UndoDTO>所以需要引入cloud-system-bpm-module-base 依赖包使用UndoDTO对象。接收端必须在 Controller 前执行目标平台的服务身份认证与授权，以下代码只说明数据反序列化和业务处理位置。
+样例代码：入参 String    返参 Boolean   
+接口地址必须以/api/开头，后面的部分地址就是配置在nacos中
+```java
+ @ApiOperation(value = "同步门户待办接口")
+    @RequestMapping(value = "/synundo/to-portal", method = RequestMethod.POST)
+    public Boolean synUndoToPortal(@RequestBody  String undos){
+        LOGGER.info("调用到了门户待办");
+        List<UndoDTO> undoList = JSON.parseArray(undos,UndoDTO.class);
+        // 后续处理逻辑
+        return true;
+    }
+```

package/skills/meritdata-platform-bpm/references/workflow//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-platform-bpm/references/workflow//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-platform-bpm/references/workflow//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 工程应用
+
+生成的目录结构如下图所示：
+
+[IMG: (图片)]

package/skills/meritdata-platform-bpm/references/workflow//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
+```