Merge branch 'develop' of http://gitlab.dev.shxrtech.com/doc/ldp-docs into develop

LDP框架ChangeLog&升级方式.md

@@ -24,6 +24,75 @@
 
 
 
+## 2021-09-18
+
+版本号： **1.2.49**
+
+**base-service**
+
+Feat：
+
+1. 云存储上传、下载、删除实现
+2. 流程状态值自动填充
+3. 流程状态字典项、实体扩展字典项
+
+other：
+
+1. 接口审计日志写到业务库的实现，注解@SysAuditLog，默认为写业务库，需要**创建数据表**
+
+   
+
+**gen-service**
+
+`feat`：
+
+1. 代码生成集成流程处理相关接口（提交、审批、回调等）
+2. 模型添加扩展属性（流程、附件）
+3. 代码生成mybatis版本单据接口
+4. 增加/save接口（保存或新增）
+5. 实现业务发布逻辑
+
+fix：
+
+1. 修复mybatis版本单据删除时条件错误问题
+
+2. 前端代码下载时替换服务名
+
+   
+
+**mcs-ui**
+
+`feat`：
+
+1. 模型设计增加流程状态
+2. 模型设计添加扩展属性选项卡
+3. 视图设计模板中增加流程审批
+4. 新版视图设计中增加附件上传
+5. 新增数据源管理菜单
+6. 新增发布配置以及发布日志
+
+other：
+
+1. 优化模型设计关联配置
+2. 优化视图设计模型筛选逻辑
+3. 修复optional编译失败问题
+
+
+
+**本次更新方式**
+
+1. 替换ldp-manage/fatjar 目录下对应的jar包
+
+2. 替换nginx中mcs、bpm的前端代码
+
+3. 脚手架更新到1.2.49
+
+   
+
+- 审计日志变更为默认写入到业务库，需要在业务库中创建日志表
+- 业务发布操作文档：[LDP-MCS快速开发-业务发布说明.md](操作文档/LDP-MCS快速开发-业务发布说明.md)
+- 代码生成操作文档：[LDP代码生成功能操作说明v2.1.docx](操作文档/LDP代码生成功能操作说明v2.1.docx)
+
 
 
 ## 2021-09-07

开发文档/LDP代码生成IDEA插件安装和使用说明.md

@@ -4,7 +4,7 @@ LDP Generate是基于MyBatis-Plus 的官方代码生成器开发的一个IDEA插
 
 ## 一、IDEA插件安装
 
-首先，下载插件安装包：[ldp-mybatis-plugin](http://devdown.shxrtech.com/ldp-mybatis-plugin-1.0-SNAPSHOT.zip)
+首先，下载插件安装包：[ldp-mybatis-plugin](http://devdown.shxrtech.com/ldp-mybatis-plugin-1.0.zip)
 
 打开IDEA，File菜单，点击Settings
 
@@ -24,6 +24,8 @@ LDP Generate是基于MyBatis-Plus 的官方代码生成器开发的一个IDEA插
 
 
 
+1.0版本后，DB Config会跟随项目，打开不同的项目，可以配置不同的DB连接。
+
 ## 三、代码生成配置
 
 点击`Code Generate` 菜单，会根据数据库连接配置拉取表信息，选择需要生成的表，并点击下一步
@@ -39,8 +41,9 @@ LDP Generate是基于MyBatis-Plus 的官方代码生成器开发的一个IDEA插
 **基础配置**是属于全局配置一共4个配置项，相关配置对应如下：
 
 | 配置项        | 说明                                           | 默认值    |
-| ------------- | ------------------------------------------- | --------- |
+| ------------- | ---------------------------------------------- | --------- |
 | 开发者        | 类名注释中的author                             | generator |
+| 移除表前缀    | 输入指定的表前缀后，生成代码类名不再有前缀信息 | 空字符串  |
 | swagger注解   | 是否启用swagger，影响范围entity、controller    | 是        |
 | 是否覆盖      | 是否覆盖相同路径同名文件                       | 否        |
 | version乐观锁 | 是否将表里的version字段加上@Version注解        | 否        |

操作文档/LDP-MCS快速开发-业务发布说明.md

@@ -56,7 +56,7 @@
 >
 > 4、如果有流程，在bpm系统中确认流程定义绑定的表单key是否是模型编码，并检查回调配置中的回调接口是否设置。
 
-
+**PS：重复发布会覆盖之前的配置、同时也会新建数据表**
 
 ### 2.2、发布配置界面
 
@@ -78,15 +78,17 @@
 
 - 绑定流程
 
-如果选择的流程定义已经绑定过表单，则会覆盖以前的表单key，以发布的为准
+  如果选择的流程定义已经绑定过表单，则会覆盖以前的表单key，以发布的为准
 
 ![image-20210909163818896](../imgs/publish/06绑定流程.png)
 
 - 视图设计
 
-如果已经存在视图设计的文件，则会发布存在的视图设计，如果不存在则会根据规则自动生成表单、或者单据页面
+  如果已经存在视图设计的文件，则会发布存在的视图设计，如果不存在则会根据规则自动生成表单、或者单据页面
+
+- 是否在线
 
-- 是否在线影响便是菜单的页面类型（页面类型则决定了加载方式
+  影响便是菜单的页面类型（页面类型则决定了加载方式
 
 ![image-20210909163751799](../imgs/publish/07在线表单.png)
 

操作文档/NACOS升级文档.md

+#  Nacos升级文档
+
+LDP默认使用的Nacos1.1.4版本，但是此版本有一个很大的问题，便是在服务列表点击下线或者上线的时候无效。经过调查，发现这是Nacos服务端UI的bug，点击下线和上线的时候没有传入服务的分组，而一直传默认的`DEFAULT_GROUP`，LDP的服务都有自定义分组，导致下线请求无法成功。
+
+PS: 为了防止版本差异大，于是找到了修复此问题最近的一个Nacos，版本为1.3.0。
+
+## 一、导出当前Nacos的配置文件
+
+登录当前Nacos，打开左侧菜单`配置管理` -> `配置列表`，通过Data ID进行过滤，使用group名称过滤，例如`*-dev.yml`、`*-prod.yml`，最后可以选择导出配置，也可以直接导出查询结果，导出的文件是一个zip压缩包。
+
+![](../imgs/nacos/export.png)
+
+## 二、停止当前Nacos，并保留为备份
+
+在服务器上，Nacos的所在目录执行以下命令，将当前Nacos关闭，并保留一份备份（新版正常运行一段时间后，即可删除）
+
+```shell
+# 切换目录
+cd nacos/bin
+# 关闭Nacos
+./shutdown.sh
+# 切换目录
+cd ../..
+# 备份当前nacos
+mv nacos nacos_1.1.4
+```
+
+## 三、下载1.3.0版本的Nacos压缩包，并解压
+
+下载新版Nacos，查看[版本列表](https://github.com/alibaba/nacos/releases?after=2.0.0-ALPHA.1)，这里推荐使用1.3.0版本，距离1.1.4版本最近，并修复了服务上下线bug。可以直接进入页面下载，这里用命令下载做演示。
+
+```shell
+# 下载Nacos 1.3.0版本压缩包到当前目录
+wget https://github.com/alibaba/nacos/releases/download/1.3.0/nacos-server-1.3.0.zip
+# 解压nacos
+unzip nacos-server-1.3.0.zip
+```
+
+## 四、启动新版Nacos，并导入配置
+
+启动新版Nacos，登录后，并导入配置
+
+```shell
+# 切换目录
+cd nacos/bin
+# 启动nacos
+./startup.sh -m standalone
+```
+
+打开左侧菜单`配置管理` -> `配置列表`，点击导入配置，在弹窗中点击上传文件，并选中第一步导出的zip压缩包即可。
+
+![](../imgs/nacos/import.png)
\ No newline at end of file