Merge branch 'develop'

sso-auth-center-service/README.md

@@ -1,3 +1,104 @@
 # sso-auth-center
 
 统一认证中心服务端
+
+
+工程模块介绍
+
+| **工程模块** | **名称** | **备注** |
+| --- | --- | --- |
+| sso-auth-center-service | 父工程 | 定义统一依赖版本等 |
+| sso-auth-center-admin | 后台web，统一开放网关 | boot项目，后台controller层 |
+| sso-business | dao与业务层 | dao层，service层 |
+| sso-common  | 公共部分 | 工具类、常量类、注解、枚举、业务自定义异常 |
+| sso-framework | 核心配置 | 数据源配置、redis配置、验证码、统一异常处理 等 |
+
+
+
+类命名规范<br />
+
+| **所属层级** | **名称规则** | **备注** |
+| --- | --- | --- |
+| DAO层 | entity | entity包下与数据库表一致的实体 |
+|  | xxxMapper | 与表一致的Mapper |
+|  | xxxDTO | 中间转换对象，比如关联sql的返回对象 |
+|  | xxxQuery | dao层查询对象 |
+| service层 | xxxBaseService | 公共service，比如用户公共接口，在业务service多次使用的方法 |
+|  | xxxBaseServiceImpl |  |
+|  | xxxService | 业务 service层 |
+|  | xxxServiceImpl | 业务service层实现 |
+| controller层入参 | xxxAddBO或xxxUpdateBO | 新增业务入参 |
+|  | xxxEditBO | 修改业务入参 |
+|  | xxxListPageBO | 分页查询入参需要继承公共分类 BasePageModel |
+| controller层出参 | xxxPageVO或xxxListVO | 分页列表返回对象 |
+|  | xxxDetailVO | 查询详情返回对象 |
+|  | xxxCountVO | 统计业务返回对象 |
+|  | xxOptionVO | 下拉选项返回对象 |
+
+
+
+
+接口命名规范<br />
+
+|  | **请求方式** | **备注** |
+| --- | --- | --- |
+| /listPage | get |  分页列表 |
+| /listxxPage | get |  分页列表 |
+| /listxxx | get | 不分页的列表 |
+| /detail/{id} | get | _获取用户详细信息_ |
+| /getxxx | get | 其它详情接口 |
+| /add | post | 新增接口 |
+| /update 或/edit | put或post | 修改接口 |
+| /delete/{id} | / | 删除接口 |
+|  |  |  |
+
+公共返回类<br />
+
+|  | **类名** | **常用方法** |
+| --- | --- | --- |
+| 公共类 | ResultModel | ResultModel._success_(业务object内容)<br />ResultModel._error_("失败原因") |
+| 分页接口公共类 | ResultPageModel | ResultPageModel._success_(resultList,rowCount) |
+
+
+分页接口统一返回结构<br />
+
+| **参数** | **说明** |  |
+| --- | --- | --- |
+| code | 成功 | 200成功，非200失败 |
+| total | 总条数 |  |
+| data [] | 当前页内容列表 |  |
+| msg |  |  |
+
+JSON示例<br />
+
+```json
+{
+    "code": 200,
+    "total": 16213,
+    "data": [
+        {
+            "id": 1,
+            "name": "张三"
+        }
+    ],
+    "msg": "操作成功"
+}
+```
+
+<br />详情接口统一返回结构
+
+| **参数** | **说明** |  |
+| --- | --- | --- |
+| code | 成功 | 200成功，非200失败 |
+| data | object类型对象 |  |
+| msg |  |  |
+
+JSON示例<br />
+
+```json
+{
+    "code": 200,
+    "data": {},
+    "msg": "操作成功"
+}
+```

sso-auth-center-service/pom.xml

@@ -165,7 +165,7 @@
                 <version>${sso-auth-center.version}</version>
             </dependency>
 
-            <!-- 通用工具-->
+            <!-- 公共模块-->
             <dependency>
                 <groupId>com.sso</groupId>
                 <artifactId>sso-common</artifactId>

sso-auth-center-service/sso-auth-center-admin/src/main/java/com/sso/security/SecurityConfig.java

@@ -90,9 +90,9 @@ public class SecurityConfig extends WebSecurityConfigurerAdapter {
 	@Override
 	protected void configure(HttpSecurity httpSecurity) throws Exception {
 		httpSecurity
-				// CSRF禁用，因为不使用session
+				// 不使用session 禁用 CSRF
 				.csrf().disable()
-				// 认证失败处理类
+				// 认证失败处理
 				.exceptionHandling().authenticationEntryPoint(unauthorizedHandler).and()
 				// 基于token，所以不需要session
 				.sessionManagement().sessionCreationPolicy(SessionCreationPolicy.STATELESS).and()
@@ -110,7 +110,7 @@ public class SecurityConfig extends WebSecurityConfigurerAdapter {
 				).permitAll()
 				.antMatchers("/profile/**").anonymous()
 				.antMatchers("/**/webjars/**").anonymous()
-				.antMatchers("/**/api-docs").anonymous()
+				.antMatchers("/**/static/**").anonymous()
 				.antMatchers("/**/druid/**").anonymous()
 				//开放接口不拦截-内部有验签
 				.antMatchers("/open/gateway").anonymous()

sso-auth-center-service/sso-business/pom.xml

@@ -17,7 +17,7 @@
 
     <dependencies>
 
-        <!-- 通用模块 -->
+        <!-- 公共模块 -->
         <dependency>
             <groupId>com.sso</groupId>
             <artifactId>sso-common</artifactId>

sso-auth-center-service/sso-common/pom.xml

@@ -12,7 +12,7 @@
     <artifactId>sso-common</artifactId>
 
     <description>
-        common通用工具
+        common 公共模块
     </description>
 
     <dependencies>