调整web接口文档说明，调整idea破解

docs/dev/lib/README.md

@@ -1,7 +1,7 @@
+# 架构图
+
+![架构图 idea](./img/system-img.jpg)
 
 
 
 
-#### 架构图
-#### jar 包怎么引用
-#### 

docs/dev/lib/coding/README.md

@@ -1,6 +1,10 @@
-# 开发规范
+# 开发实现
 
-## 代码文档规范
+::: details 目录
+[[toc]]
+:::
+
+## 代码文档
 * 为保持代码与文档一致，所有代码的类，函数，属性都必需写入相应的注释。注释以javadoc规范为准。
 * 代码文档将使用dokka工具自动化生成。
 

docs/dev/lib/index.js

@@ -1,7 +1,10 @@
 const content = [
     {
-        title: "系统架构介绍",
-        path: "/dev/lib/system/"
+        title: "系统架构",
+        path: "/dev/lib/system/",
+        children: [
+            ["/dev/lib/system/create", "系统架构"]
+        ]
     },
     {
         title: "web接口",

docs/dev/lib/system/README.md

@@ -1,5 +1,9 @@
 # 系统架构
-## 主要问题
+::: details 目录
+[[toc]]
+:::
+
+## 接口标准化
 * 接口标准化，各对象支持标准的增删改查。查询支持过滤、排序、映射、分页等标准操作；
 * 标准化的代码不需要重复开发。框架支持以最少的代码完成增删改查，只需要写好实体类与controller接口类即可。实现描述型开发
 

docs/dev/lib/web/README.md

@@ -1,10 +1,25 @@
-# web 接口
-## swagger 接口文档
+# web接口
+
+::: details 目录
+[[toc]]
+:::
+
+## 接口文档
+接口文档，相当于后端对产品需求提供数据以及功能的一个说明书，为什么这样说那，一个产品的说明书，内容详细介绍，突出功能明确指出应该怎样操作执行的指令是什么，会达到什么样的效果，
+减少客户和客服沟通的频率，或者不需要询问客服看说明书就能明白功能以及达到的效果。接口文档意是如此，我们不可能每完成一个接口都开会或发到工作群中给大家讲解，也不可能一个产品的
+数据结构定好，所有的接口开发完统一大家一起开会做现场解说，不能保证所有的能记得所有内容，都会使用。为了高效而又节省时间需要我们写一个简单易懂的文档出来，而对于接口，在明确数
+据结构以及功能，还要测试接口是否可用，是否正确处理了数据，是否达到了前端的效果。即使后端测试过了，前端也要测试功能，还需要每个属性结构进行确认，这就需要我们整理出一份详细的
+文档出来，把功能、数据结构、示例都介绍详细、清楚，最好直接提供可以测试的接口文档，这样只要有一份接口文档就够了，不用再看着接口文档一个一个粘贴到别的工具上调试，节省了前端调
+试沟通数据结构了解属性功能接口使用方式的时间。
+
+### 接口文档调试工具
+
 ![接口文档 swagger](./img/web-swager_001.jpg)
- 
-* 为保持代码与文档一致，接口说明使用swagger注解写在代码中。controller类及相关对外接口，实体类及属性要编写对应的swagger注解
-* swagger可以直接使用提供的接口页面测试。不需安装使用postman ,接口及相关参数在页面上都有明确说明。
-* 通过注解自动生成文档，节省编写文档时间
+
+* swagger 接口文档调试工具，保证了代码和文档的一致性，swagger 是直接集成在后端的项目中。使用注解的方式在代码中进行了更改 swagger 也会随之变化。
+* swagger 提供了接口测试功能，不需要安装 postmain , 文档中把每个属性、数据结构 接口的请求方式标注的很清楚，也可以把注意事项标记清楚。
+* 通过注解的方式自动生成文档，只需要补录一些需要注意事项，一些简单的示例介绍，节省了编写文档的时间
+
 ![接口文档 swagger](./img/web-swager_004.jpg)
 
 ![接口文档 swagger](./img/web-swager_005.jpg)

docs/setup/dev/idea.md

@@ -39,6 +39,80 @@
 点击“Finish”按钮，完成安装。
 
 ## 破解
+为什么要破解，你懂得。商业版的费用数目也是不少的，官方提供的有个人免费版，功能方面指定没有商业版的全，想要使用正版的商业版我们就要想办法来破解，不破解的话最多免费使用 30 天，废话不多说开始弄它。
+
+破解包下载地址：[https://pan.baidu.com/s/1HlI1atmeOiHs4dLK668T6w](https://pan.baidu.com/s/1HlI1atmeOiHs4dLK668T6w)
+提取码：y7xa 
+
+![破解 idea](./img/idea-crack_001.jpg)
+
+如上图，点击 jetbrains-agent.jar 进行下载，下载完成自己指定一个目录存放，最好放在你存放应用包的地方，不会把它误删除了。我的放在了idea 的目录下：
+
+![破解 idea](./img/idea-crack_002.jpg)
+
+我的路径为 idea 的安装目录：D:\software\IntelliJ IDEA 2019.3.3\bin ，不容易被误删掉，因为我会定期清理一下电脑上无用的程序和文件。
+
+![破解 idea](./img/idea-crack_003.jpg)
+
+点击 idea 上方菜单的 Help -> Edit Custom Properties... 来配置上面下载的破解 jar 包
+
+![破解 idea](./img/idea-crack_004.jpg)
+
+配置路径一定看好整个路径是怎么配置的，-javaagent: 开头，然后是 jetbrains-agent.jar 存放的路径。一定要写对，写错的话可能导致 idea 打不开，配置完成重启 idea ,重要的事情说三遍
+
+    * 修改完配置文件之后切记重启idea软件
+    * 修改完配置文件之后切记重启idea软件
+    * 修改完配置文件之后切记重启idea软件
+
+如果修改完打不开软件，或者提示没有jdk等问题，这时候可以删除用户目录下的 idea 文件夹，或者查看这个文件夹中的 idea64.exe.vmoptions 文件中是否有上面添加的破解包的路径，没有添加上，重启 idea
+
+    * 修改完配置文件之后切记重启idea软件
+    * 修改完配置文件之后切记重启idea软件
+    * 修改完配置文件之后切记重启idea软件
+
+![破解 idea](./img/idea-crack_005.jpg)
+
+如上图，我的地址为 C:\Users\Saga\.IntelliJIdea2019.3\config ，在这个路径下的 idea64.exe.vmoptions 内容和上面的内容一致就可以了。
+
+![破解 idea](./img/idea-crack_006.jpg)
+
+继续完成激活，点击上方菜单 Help -> Register... 会弹出激活 idea 菜单。
+
+![破解 idea](./img/idea-crack_007.jpg)
+
+首先选择激活方式 Activation code 方式激活，然后把激活码粘贴在下面，点击 Activate ,会有提示是否激活成功 ，以及激活使用年限，从图中可以看出，软件到期为 2089年7月，激活码如下：
+::: details 查看激活码
+```metadata json
+3AGXEJXFK9-eyJsaWNlbnNlSWQiOiIzQUdYRUpYRks5IiwibGljZW5zZWVOYW1lIjoiaHR0cHM6Ly96aGlsZS5pbyIsImFzc2lnbmVlTmFtZSI6IiIsImFzc2lnbmVlRW1haWwiOiIiLCJsaWNlbnNlUmVz
+dHJpY3Rpb24iOiIiLCJjaGVja0NvbmN1cnJlbnRVc2UiOmZhbHNlLCJwcm9kdWN0cyI6W3siY29kZSI6IklJIiwiZmFsbGJhY2tEYXRlIjoiMjA4OS0wNy0wNyIsInBhaWRVcFRvIjoiMjA4OS0wNy0wNyJ9
+LHsiY29kZSI6IkFDIiwiZmFsbGJhY2tEYXRlIjoiMjA4OS0wNy0wNyIsInBhaWRVcFRvIjoiMjA4OS0wNy0wNyJ9LHsiY29kZSI6IkRQTiIsImZhbGxiYWNrRGF0ZSI6IjIwODktMDctMDciLCJwYWlkVXBUb
+yI6IjIwODktMDctMDcifSx7ImNvZGUiOiJQUyIsImZhbGxiYWNrRGF0ZSI6IjIwODktMDctMDciLCJwYWlkVXBUbyI6IjIwODktMDctMDcifSx7ImNvZGUiOiJHTyIsImZhbGxiYWNrRGF0ZSI6IjIwODktMDc
+tMDciLCJwYWlkVXBUbyI6IjIwODktMDctMDcifSx7ImNvZGUiOiJETSIsImZhbGxiYWNrRGF0ZSI6IjIwODktMDctMDciLCJwYWlkVXBUbyI6IjIwODktMDctMDcifSx7ImNvZGUiOiJDTCIsImZhbGxiYWNrR
+GF0ZSI6IjIwODktMDctMDciLCJwYWlkVXBUbyI6IjIwODktMDctMDcifSx7ImNvZGUiOiJSUzAiLCJmYWxsYmFja0RhdGUiOiIyMDg5LTA3LTA3IiwicGFpZFVwVG8iOiIyMDg5LTA3LTA3In0seyJjb2RlIjoi
+UkMiLCJmYWxsYmFja0RhdGUiOiIyMDg5LTA3LTA3IiwicGFpZFVwVG8iOiIyMDg5LTA3LTA3In0seyJjb2RlIjoiUkQiLCJmYWxsYmFja0RhdGUiOiIyMDg5LTA3LTA3IiwicGFpZFVwVG8iOiIyMDg5LTA3LTA
+3In0seyJjb2RlIjoiUEMiLCJmYWxsYmFja0RhdGUiOiIyMDg5LTA3LTA3IiwicGFpZFVwVG8iOiIyMDg5LTA3LTA3In0seyJjb2RlIjoiUk0iLCJmYWxsYmFja0RhdGUiOiIyMDg5LTA3LTA3IiwicGFpZFVwVG8
+iOiIyMDg5LTA3LTA3In0seyJjb2RlIjoiV1MiLCJmYWxsYmFja0RhdGUiOiIyMDg5LTA3LTA3IiwicGFpZFVwVG8iOiIyMDg5LTA3LTA3In0seyJjb2RlIjoiREIiLCJmYWxsYmFja0RhdGUiOiIyMDg5LTA3LTA
+3IiwicGFpZFVwVG8iOiIyMDg5LTA3LTA3In0seyJjb2RlIjoiREMiLCJmYWxsYmFja0RhdGUiOiIyMDg5LTA3LTA3IiwicGFpZFVwVG8iOiIyMDg5LTA3LTA3In0seyJjb2RlIjoiUlNVIiwiZmFsbGJhY2tEYXRl
+IjoiMjA4OS0wNy0wNyIsInBhaWRVcFRvIjoiMjA4OS0wNy0wNyJ9XSwiaGFzaCI6IjEyNzk2ODc3LzAiLCJncmFjZVBlcmlvZERheXMiOjcsImF1dG9Qcm9sb25nYXRlZCI6ZmFsc2UsImlzQXV0b1Byb2xvbmdhd
+GVkIjpmYWxzZX0=-WGTHs6XpDhr+uumvbwQPOdlxWnQwgnGaL4eRnlpGKApEEkJyYvNEuPWBSrQkPmVpim/8Sab6HV04Dw3IzkJT0yTc29sPEXBf69+7y6Jv718FaJu4MWfsAk/ZGtNIUOczUQ0iGKKnSSsfQ/3UoM
+v0q/yJcfvj+me5Zd/gfaisCCMUaGjB/lWIPpEPzblDtVJbRexB1MALrLCEoDv3ujcPAZ7xWb54DiZwjYhQvQ+CvpNNF2jeTku7lbm5v+BoDsdeRq7YBt9ANLUKPr2DahcaZ4gctpHZXhG96IyKx232jYq9jQrFDbQM
+tVr3E+GsCekMEWSD//dLT+HuZdc1sAIYrw==-MIIElTCCAn2gAwIBAgIBCTANBgkqhkiG9w0BAQsFADAYMRYwFAYDVQQDDA1KZXRQcm9maWxlIENBMB4XDTE4MTEwMTEyMjk0NloXDTIwMTEwMjEyMjk0NlowaDELM
+AkGA1UEBhMCQ1oxDjAMBgNVBAgMBU51c2xlMQ8wDQYDVQQHDAZQcmFndWUxGTAXBgNVBAoMEEpldEJyYWlucyBzLnIuby4xHTAbBgNVBAMMFHByb2QzeS1mcm9tLTIwMTgxMTAxMIIBIjANBgkqhkiG9w0BAQEFAAO
+CAQ8AMIIBCgKCAQEA5ndaik1GD0nyTdqkZgURQZGW+RGxCdBITPXIwpjhhaD0SXGa4XSZBEBoiPdY6XV6pOfUJeyfi9dXsY4MmT0D+sKoST3rSw96xaf9FXPvOjn4prMTdj3Ji3CyQrGWeQU2nzYqFrp1QYNLAbaVi
+HRKuJrYHI6GCvqCbJe0LQ8qqUiVMA9wG/PQwScpNmTF9Kp2Iej+Z5OUxF33zzm+vg/nYV31HLF7fJUAplI/1nM+ZG8K+AXWgYKChtknl3sW9PCQa3a3imPL9GVToUNxc0wcuTil8mqveWcSQCHYxsIaUajWLpFzoO2
+AhK4mfYBSStAqEjoXRTuj17mo8Q6M2SHOcwIDAQABo4GZMIGWMAkGA1UdEwQCMAAwHQYDVR0OBBYEFGEpG9oZGcfLMGNBkY7SgHiMGgTcMEgGA1UdIwRBMD+AFKOetkhnQhI2Qb1t4Lm0oFKLl/GzoRykGjAYMRYwF
+AYDVQQDDA1KZXRQcm9maWxlIENBggkA0myxg7KDeeEwEwYDVR0lBAwwCgYIKwYBBQUHAwEwCwYDVR0PBAQDAgWgMA0GCSqGSIb3DQEBCwUAA4ICAQBonMu8oa3vmNAa4RQP8gPGlX3SQaA3WCRUAj6Zrlk8AesKV1Y
+Skh5D2l+yUk6njysgzfr1bIR5xF8eup5xXc4/G7NtVYRSMvrd6rfQcHOyK5UFJLm+8utmyMIDrZOzLQuTsT8NxFpbCVCfV5wNRu4rChrCuArYVGaKbmp9ymkw1PU6+HoO5i2wU3ikTmRv8IRjrlSStyNzXpnPTwt7b
+ja19ousk56r40SmlmC04GdDHErr0ei2UbjUua5kw71Qn9g02tL9fERI2sSRjQrvPbn9INwRWl5+k05mlKekbtbu2ev2woJFZK4WEXAd/GaAdeZZdumv8T2idDFL7cAirJwcrbfpawPeXr52oKTPnXfi0l5+g9Gnt/w
+fiXCrPElX6ycTR6iL3GC2VR4jTz6YatT4Ntz59/THOT7NJQhr6AyLkhhJCdkzE2cob/KouVp4ivV7Q3Fc6HX7eepHAAF/DpxwgOrg9smX6coXLgfp0b1RU2u/tUNID04rpNxTMueTtrT8WSskqvaJd3RH8r7cnRj6Y
+2hltkja82HlpDURDxDTRvv+krbwMr26SB/40BjpMUrDRCeKuiBahC0DCoU/4+ze1l94wVUhdkCfL0GpJrMSCDEK+XEurU18Hb7WT+ThXbkdl6VpFdHsRvqAnhR2g4b+Qzgidmuky5NUZVfEaZqV/g==
+```
+:::
+
+![破解 idea](./img/idea-crack_008.jpg)
+
+查看 idea 是否激活或者查看激活年限，点击上方菜单 Help -> About 就可以看到 idea 的基本信息以及激活年限，现在开始你的编码之旅吧，加油 juvenile 。
+
 
 ## 配置
 ![配置 idea](./img/idea-setting_001.jpg)
@@ -68,7 +142,8 @@ UTF-8 解决中文乱码，面向国际化 , 防止字符集不一样导致出
 ![配置 idea](./img/idea-setting_005.jpg)
  
 点击 persagy ，替换框选内容，点击 apply 保存 ，内容如下:
-```
+::: details 查看样式
+``` 
 **********************************************************************************************************************
 
          !!
@@ -93,6 +168,7 @@ UTF-8 解决中文乱码，面向国际化 , 防止字符集不一样导致出
 
 **********************************************************************************************************************
 ```
+:::
 
 ![配置 idea](./img/idea-setting_006.jpg)
 
@@ -165,7 +241,14 @@ com.persagy.server 因为我要创建的是后端项目所以域名后面使用
  
  ![创建项目 idea](./img/idea-project_005.jpg)
  
-### 添加 Module 模块
+### build.gradle 整体项目的构建文件
+ build.gradle 是项目的构建文件，里面有阿里的镜像地址，kotlin 构建地址，内部框架支持库地址设置，请点击查看代码
+ 
+ ::: details 查看代码
+ <<< @/docs/setup/dev/src/project/build.gradle
+ :::
+ 
+## 添加 Module 模块
 上面我们完成了新项目的创建，但只是创建了一个基础的项目的壳在 IDEA 中项目可以集中管理，创建一个项目主项目，把其他的项目创建为主项目的 Module 模块，虽然添加多少个模块没有限制，还是要让我们视觉能过得去，添加多少看自己
 我们会把业务相关的模块统一放在一个项目中管理，如果你的项目不多，也不用例会业务是否相关只是为了方便，可能有人问我每个项目都单独管理不行吗？，可以的看个人习惯，也看公司或团队开发规范，视情况而定，可能项目多了会比较麻烦，查看多个项目需要打开多个 idea ，下面我们开始添加 Module 模块之旅吧。
 
@@ -190,7 +273,14 @@ com.persagy.server 因为我要创建的是后端项目所以域名后面使用
 
 ![创建项目 idea](./img/idea-module_005.jpg)
 
-#### 添加 Module 模块的项目结构
+### settings.gradle 项目设置文件
+在添加 Module 模块中有提到配置 settings.gradle ，因为创建完的 Module 项目并没有识别到需要在下面的文件中添加 Module 配置，有多少个 Module 就应该写多少条配置，这样 Module 才能被项目识别到，正常的加载运行
+
+::: details 查看代码
+<<< @/docs/setup/dev/src/project/settings.gradle
+:::
+
+### 添加 Module 模块的项目结构
 
 上面我们只是完成了 Module 模块的创建，从结构中可以看出还缺少相应的代码包路径，基本的配置，这里以 Spring boot 项目为例，因为我们使用的 Spring boot，所以... 跟着我的脚步一起来吧。
 添加代码包路径，也是创建项目或 Module 都有提到了域名，示例中使用的包名为 com.persagy.server，鼠标左键选择 kotlin ，因为我们使用的是 kotlin 开发。    
@@ -213,7 +303,24 @@ com.persagy.server 因为我要创建的是后端项目所以域名后面使用
 
 现在可以创建实体类了，controllers 和 services 还不能操作，因为我们还没有集成 spring boot，集成部分查看下面的“添加支持库模块”。
 
-#### 添加程序入口
+### 添加支持库模块
+首相我们来分析一下为什么要添加支持库，目前 data-center 模块中 只有基本的 java JDK 的支持，我们想要使用 spring boot 框架，数据库管理框架，都需要通过构建工具把他们添加到 data-denter 模块中，以及一些辅助的依赖包，由于我们使用的是  gradle ，需要把相关的引用添加到 data-denter 下的 build.gradle  文件中
+
+::: details 查看代码
+<<< @/docs/setup/dev/src/project/build1.gradle
+:::
+
+::: warning 注意 
+每个依赖都有版本号，对应的版本号在 gradle.properties 属性配置文件中，请参考 gradle.properties，添加类对应的包引用，有可能下载不下来，毕竟是有限制的，参考 build.gradle 整体项目的构建文件添加了阿里的镜像已经公司内部的数据库底层框架地址。
+:::
+
+### gradle.properties 属性配置文件
+这个文件中记录了项目中引用的所有的依赖的版本号，集中管理方便修改的时候或者查询的时候直接定位到当前使用的依赖的版本号，可以对应写详细的备注说明
+::: details 查看代码
+<<< @/docs/setup/dev/src/project/gradle.properties
+:::
+
+### 添加程序入口
 一个程序的运行，一定会有一个程序的入口来启动程序，然后执行后续的动作，spring boot 项目一定有一个 main 函数入口，自定义一个类 DataCenterApp 继承自 SpringBootServletInitializer，原因是我们使用的是外部 tomcat 来运行程序，重新 configure() 函数，类的外部要把 main 函数入口添加添加上
 
 ![创建项目 idea](./img/idea-module_006.jpg)
@@ -223,7 +330,7 @@ com.persagy.server 因为我要创建的是后端项目所以域名后面使用
 :::
 代码中已经很详细了，对 spring boot 不是很了解的童鞋可以找相关的文章脑补一下，这里不做详细的介绍了，只是简单的集成运行起来一个项目。
 
-#### WebMvcConfigurerAdapter 
+### WebMvcConfigurerAdapter 
 ![创建项目 idea](./img/idea-module_007.jpg)
 
 * WebMvcConfigurerAdapter是什么
@@ -261,7 +368,7 @@ void configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer)
 <<< @/docs/setup/dev/src/project/WebMvcConfg.kt
 :::
 
-#### yml 文件配置
+### yml 文件配置
 完成上面的操作还不能正常项目或 module 模块，需要配置 yml 数据库驱动，以及其他的配置，看需求你的项目需要配置什么，yml 里面使用的三方依赖都是在“添加支持库模块” 中添加的操作 yml 一定要确定相关的依赖已经添加，没有添加的可以查看下面的“添加支持库模块”。
 
 ![创建项目 idea](./img/idea-module_008.jpg)
@@ -281,39 +388,30 @@ void configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer)
 :::
 
 
-
-#### 添加支持库模块
-首相我们来分析一下为什么要添加支持库，目前 data-center 模块中 只有基本的 java JDK 的支持，我们想要使用 spring boot 框架，数据库管理框架，都需要通过构建工具把他们添加到 data-denter 模块中，以及一些辅助的依赖包，由于我们使用的是  gradle ，需要把相关的引用添加到 data-denter 下的 build.gradle  文件中
+## 关键文件说明
+### git 忽略文件
 ::: details 查看代码
-<<< @/docs/setup/dev/src/project/build1.gradle
+<<< @/docs/setup/dev/src/project/gitignore
 :::
 
 ::: warning 注意 
-每个依赖都有版本号，对应的版本号在 gradle.properties 属性配置文件中，请参考 gradle.properties，添加类对应的包引用，有可能下载不下来，毕竟是有限制的，参考 build.gradle 整体项目的构建文件添加了阿里的镜像已经公司内部的数据库底层框架地址。
+根据上面的配置、设置、添加依赖库就完成了项目的配置，项目可以正常运行了，运行时可能会遇到一个问题 Error running ‘App’: Command line is too long. Shorten command line for App
 :::
 
+### 解决问题
+* 运行项目时会遇到 Error running ‘App’: Command line is too long. Shorten command line for App
+
+解决方案：修改项目目录下的 .idea\workspace.xml
+
+![问题 idea](./img/idea-error_001.jpg)
+
+打开 workspace.xml 文件，找到名称为 PropertiesComponent 标签： \<component name="PropertiesComponent"\>，在这个标签中添加一行标签说明 \<property name="dynamic.classpath" value="true" \/\>
+添加完运行就可以了。
+
+![问题 idea](./img/idea-error_002.jpg)
 
-## 关键文件说明
-### git 忽略文件
-::: details 查看代码
-<<< @/docs/setup/dev/src/project/gitignore
-:::
 
-### build.gradle 整体项目的构建文件
-build.gradle 是项目的构建文件，里面有阿里的镜像地址，kotlin 构建地址，内部框架支持库地址设置，请点击查看代码
 
-::: details 查看代码
-<<< @/docs/setup/dev/src/project/build.gradle
-:::
 
-### settings.gradle 项目设置文件
-在添加 Module 模块中有提到配置 settings.gradle ，因为创建完的 Module 项目并没有识别到需要在下面的文件中添加 Module 配置，有多少个 Module 就应该写多少条配置，这样 Module 才能被项目识别到，正常的加载运行
 
-::: details 查看代码
-<<< @/docs/setup/dev/src/project/settings.gradle
-:::
 
-### gradle.properties 属性配置文件
-::: details 查看代码
-<<< @/docs/setup/dev/src/project/gradle.properties
-:::