diff --git a/diboot-docs/guide/diboot-devtools/images/er_example.jpg b/diboot-docs/guide/diboot-devtools/images/er_example.jpg
new file mode 100644
index 0000000..8f9936b
Binary files /dev/null and b/diboot-docs/guide/diboot-devtools/images/er_example.jpg differ
diff --git a/diboot-docs/guide/diboot-devtools/介绍.md b/diboot-docs/guide/diboot-devtools/介绍.md
index 540041e..0e24f17 100644
--- a/diboot-docs/guide/diboot-devtools/介绍.md
+++ b/diboot-docs/guide/diboot-devtools/介绍.md
@@ -4,17 +4,19 @@
> 众多开发团队现状: 效率低、质量差、可维护性差,我们也常听到开发者抱怨每天CRUD、工作就是搬砖。
-> diboot-devtools 是面向Java开发人员的自动化助理,有了她,你可以彻底摆脱CRUD等重复性的工作,专注于数据结构设计、业务实现,提高软件的质量、效率、可维护性。
+> diboot-devtools 是面向Java开发人员的自动化助理,有了她,你可以彻底摆脱常规SQL与CRUD等重复性的工作,专注于数据结构设计、业务实现,提高软件的质量、效率、可维护性。
> **diboot-devtools - 将复杂的事情简单化,重复的事情自动化**
## diboot-devtools 的核心特性
-* 支持多数据库(MySQL、MariaDB、PostgreSQL、ORACLE、SQLServer)
+* 支持多种数据库(MySQL、MariaDB、PostgreSQL、ORACLE、SQLServer)
* 使用很简单(UI界面操作,引入依赖,配置参数后,即可随SpringBoot本地项目启动运行)
-* 功能很强大(数据结构变更与代码联动同步,一键生成&非覆盖式更新后端代码,一键生成前端功能代码,自动记录变更SQL、维护索引)
+* 功能很强大(数据结构变更与代码联动同步,一键生成&非覆盖式更新后端代码,自动记录变更SQL、维护索引,一键生成前端功能代码,自动进行前后端权限绑定,自动完成数据关联相关前后端工作,ER图展示关联关系等)
* 单表与联表场景完整CRUD功能前后端代码完全自动生成,无需手写代码
* SQL与代码很标准(devtools标准化了数据结构定义与代码实现,降低维护成本)
* 配置很灵活(可按需配置生成代码路径、是否启用`Lombok`、`Swagger`等)
+* 开发很快捷(即便需要自己编写代码来实现特定业务逻辑,也能依赖我们生成的标准基础代码来快速完成)
+* 使用很省心(能自动化处理的我们都会自动化帮您搞定,让您省心)
* 代码基于diboot高效基础框架生成,是diboot的最佳实践
## devtools支持的数据库版本
diff --git a/diboot-docs/guide/diboot-devtools/开始使用.md b/diboot-docs/guide/diboot-devtools/开始使用.md
index 2469d39..95bb4b0 100644
--- a/diboot-docs/guide/diboot-devtools/开始使用.md
+++ b/diboot-docs/guide/diboot-devtools/开始使用.md
@@ -3,7 +3,7 @@
推荐使用 [Spring Initializer](https://start.spring.io/),快速初始化一个 Spring Boot 工程。
如果您使用IntelliJ IDEA,可以直接通过菜单: File -> New -> Project -> Spring Initializr 创建。
-> 如果需要生成前端,需下载前端项目: [diboot-element-admin](https://github.com/dibo-software/diboot-element-admin) 或 [diboot-antd-admin](https://github.com/dibo-software/diboot-antd-admin)
+> 如果需要生成前端,需根据相关版本下载对应的前端项目: [diboot-element-admin](https://github.com/dibo-software/diboot-element-admin/releases) 或 [diboot-antd-admin](https://github.com/dibo-software/diboot-antd-admin/releases)
## 2. 引入依赖
* Gradle项目引入依赖
@@ -22,9 +22,28 @@ providedCompile("com.diboot:diboot-devtools-spring-boot-starter:{latestVersion}"
com.diboot
diboot-devtools-spring-boot-starter
{latestVersion}
- provided
+ provided
```
+如果spring boot项目需要打jar包运行,则需要参考如下配置确保打包时剔除devtools:
+~~~
+
+
+ org.springframework.boot
+ spring-boot-maven-plugin
+
+
+
+
+ com.diboot
+ diboot-devtools-spring-boot-starter
+
+
+
+
+
+~~~
+
> diboot-devtools-spring-boot-starter 是用于开发过程的助手工具,须声明 **provided**以免打包至非开发环境。
## 3. 添加配置信息
@@ -54,7 +73,7 @@ diboot.devtools.output-path-sql=example/src/main/resources/
diboot.devtools.enable-lombok=true
#diboot.devtools.enable-swagger=false
#diboot.devtools.generate-mapper-xml=false
-# 前端项目路径(diboot-element-admin 或 diboot-antd-admin项目)
+# 前端项目路径(diboot-element-admin 或 diboot-antd-admin项目,此处如果与后端项目为同一项目下不同模块,可只配置模块名,否则需要配置绝对路径,即全路径)
diboot.devtools.output-path-frontend=/D:/Workspace/diboot/diboot-antd-admin/
~~~
@@ -72,7 +91,7 @@ diboot.devtools.output-path-frontend=/D:/Workspace/diboot/diboot-antd-admin/
* generate-mapper-xml:是否生成Mapper.xml文件,默认true
* enable-lombok:是否引入`Lombok`注解,若设置true,请注意添加Lombok依赖。
* enable-swagger:是否引入`Swagger`注解,若设置true,请注意添加Swagger依赖。
- * output-path-frontend:前端Vue项目路径,用于前端代码生成。前端项目下载: [diboot-element-admin](https://github.com/dibo-software/diboot-element-admin) 或 [diboot-antd-admin](https://github.com/dibo-software/diboot-antd-admin)
+ * output-path-frontend:前端Vue项目路径,用于前端代码生成(此处如果与后端项目为同一项目下不同模块,可只配置模块名,否则需要配置绝对路径,即全路径)。前端项目下载: [diboot-element-admin](https://github.com/dibo-software/diboot-element-admin) 或 [diboot-antd-admin](https://github.com/dibo-software/diboot-antd-admin)
:::warning
如果您使用的是**PostgreSQL数据库**,那么需要额外添加两行配置,以此来适配boolean类型字段所对应的数据库的boolean类型,需添加的配置如下:
@@ -111,11 +130,27 @@ diboot-devtools在初次运行中,会自动检测安装以diboot_前缀的数
```
* Maven配置
```
+ // dependency节点
com.diboot
diboot-devtools-spring-boot-starter
- provided
+ provided
+
+ //plugins节点配置
+
+ org.springframework.boot
+ spring-boot-maven-plugin
+
+
+
+
+ com.diboot
+ diboot-devtools-spring-boot-starter
+
+
+
+
```
* 方式二(为devtools创建专属项目,与代码项目隔离开):
diff --git a/diboot-docs/guide/diboot-devtools/数据表管理.md b/diboot-docs/guide/diboot-devtools/数据表管理.md
index 72aba87..8d8e3e5 100644
--- a/diboot-docs/guide/diboot-devtools/数据表管理.md
+++ b/diboot-docs/guide/diboot-devtools/数据表管理.md
@@ -96,7 +96,7 @@
填写样例数据,方便后续的开发调试。
::: warning
- 注:非空字段的样例数据不能为空,并且须严格按照字段的数据类型填写。
+ 注:在2.0.x版本中,非空字段的样例数据不能为空,并且须严格按照字段的数据类型填写。在2.1.x版本中,非空字段的样例数据可以被自动填充个,也可以自己填写。
:::
## 关联配置
@@ -105,3 +105,5 @@
## 关系图
> 显示数据表之间的关联关系,方便开发人员清晰的了解项目的数据模型。
+
+![关联配置示例](./images/er_example.jpg)