Merge pull request #41 from Daye1112/develop

完成系统基本功能

doc/开发说明文档/后端api/后台管理端/权限管理api.md

@@ -0,0 +1,120 @@
+[TOC]
+
+# 修改记录
+
+# 权限管理API(v1.0)(均以Json数据交互)
+
+## + 查询所有权限
+
+【例】${url}/m/authority/list
+
+### - 接口
+
+GET m/authority/list
+
+### - 请求参数
+
+| 参数名 | 类型 | 必需 | 默认值 | 备注 |
+| :----: | :--: | :--: | :----: | :--: |
+|   无   |  无  |  无  |   无   |  无  |
+
+### - Json响应
+
+```json
+{
+    "code": 1,
+    "success": true,
+    "message": "操作成功！",
+    "data": {
+        "部门管理": [						//权限组
+            {
+                "id": 1,					//权限id
+                "saDisplayName": "部门查询",	//权限名
+                "checked": false			//是否选中
+            }
+        ],
+        "用户管理": [
+            {
+                "id": 3,
+                "saDisplayName": "用户筛选",
+                "checked": false
+            },
+            {
+                "id": 4,
+                "saDisplayName": "用户添加",
+                "checked": false
+            }
+        ],
+        "权限管理": [
+            {
+                "id": 12,
+                "saDisplayName": "权限重载",
+                "checked": false
+            },
+            {
+                "id": 13,
+                "saDisplayName": "权限查询",
+                "checked": false
+            }
+        ],
+        "角色管理": [
+            {
+                "id": 2,
+                "saDisplayName": "角色查询",
+                "checked": false
+            }
+        ]
+    }
+}
+```
+
+## + 重新加载权限
+
+【例】${url}/m/authority/reload
+
+### - 接口
+
+GET m/authority/reload
+
+### - 请求参数
+
+| 参数名 | 类型 | 必需 | 默认值 | 备注 |
+| :----: | :--: | :--: | :----: | :--: |
+|   无   |  无  |  无  |   无   |  无  |
+
+### - Json响应
+
+```json
+{
+    "code": 1,
+    "success": true,
+    "message": "操作成功！",
+    "data": null
+}
+```
+
+## + 重新加载权限
+
+【例】${url}/m/authority/no
+
+### - 接口
+
+GET m/authority/no
+
+### - 请求参数
+
+| 参数名 | 类型 | 必需 | 默认值 | 备注 |
+| :----: | :--: | :--: | :----: | :--: |
+|   无   |  无  |  无  |   无   |  无  |
+
+### - Json响应
+
+```json
+{
+    "code": 0,
+    "success": false,
+    "message": "无操作权限",
+    "data": null
+}
+```
+

doc/开发说明文档/后端api/后台管理端/用户管理api.md

@@ -6,8 +6,6 @@
 
 ## + 添加用户所有基本信息
 
-**【注】必须登录才可使用**
-
 【例】${url}/m/user/add
 
 ### - 接口
@@ -26,7 +24,7 @@ POST m/user/add
 |     phone     | String |  Y   |        |                           联系方式                           |
 |     email     | String |  Y   |        |                    邮箱（确保是邮箱格式）                    |
 
-### 1.3 Json请求
+### - Json请求
 
 ```json
 {
@@ -558,15 +556,15 @@ GET m/user/find
     code: 1,				//0-失败；1-成功
     success: true,			//true-成功；false-失败
     message: "操作成功！",	 //提示信息
-    data: {
-        departmentName: "开发小组",		//部门名
-        realName: "陆宇豪",			//真实姓名
-        phone: "17758178532",		  //电话号码
-        idCode: "33108211111111111",  //身份证					  
-        workId: "Xb16620208",		  //职工编号
-        email: "[email protected]"	  //邮箱
-        password: "456",				//密码
-        id: 1,							//用户id
+    data: {							
+        "departmentName": "开发小组",		//部门名
+        "realName": "管理员",				//真实姓名
+        "password": "12345",				//密码
+        "phone": "15868163726",				//职工编号
+        "idCard": "332624199812102117",		//身份证
+        "id": 4,						//用户id
+        "workId": "admin",				//工号
+        "email": "[email protected]"	//邮箱
     }
 }
 ```

doc/开发说明文档/后端api/后台管理端/用户角色管理api.md

@@ -0,0 +1,170 @@
+[TOC]
+
+# 修改记录
+
+# 用户角色管理API(v1.0)(均以Json数据交互)
+
+## + 查询所有用户的基本信息和其所拥有的所有权限
+
+【例】${url}/m/userRole/list
+
+### - 接口
+
+GET m/userRole/list
+
+### - 请求参数
+
+| 参数名 | 类型 | 必需 | 默认值 | 备注 |
+| :----: | :--: | :--: | :----: | :--: |
+|   无   |  无  |  无  |        |  无  |
+
+### - Json响应
+
+```json
+{
+    "code": 1,
+    "success": true,
+    "message": "操作成功！",
+    "data": [
+        {
+            "departmentName": "开发小组",	//部门名
+            "realName": "陆宇豪",		//用户名
+            "srNames": "超级管理员,教师",	//用户拥有的所有角色名，以逗号分隔
+            "id": 1,					//用户id
+            "workId": "Xb16620208"		//用户工号
+        },
+        {
+            "departmentName": "开发小组",
+            "realName": "管理员",
+            "srNames": "超级管理员,管理员",
+            "id": 4,
+            "workId": "admin"
+        },
+        {
+            "departmentName": "开发小组",
+            "realName": "123",
+            "id": 83,
+            "workId": "4989498"
+        }
+    ]
+}
+```
+
+## + 根据用户id查询用户所有角色的拥有状态
+
+【例】${url}/m/userRole/list/user
+
+### - 接口
+
+POST m/userRole/list/user
+
+### - 请求参数
+
+| 参数名 | 类型 | 必需 | 默认值 |  备注  |
+| :----: | :--: | :--: | :----: | :----: |
+|   id   | int  |  Y   |        | 用户id |
+
+### - Json请求
+
+```json
+{
+	"id":1
+}
+```
+
+### - Json响应
+
+```json
+{
+    "code": 1,
+    "success": true,
+    "message": "操作成功！",
+    "data": [
+        1,		//角色id
+        9,
+        10
+    ]
+}
+```
+
+## + 根据用户id更新用户角色
+
+【例】${url}/m/userRole/update
+
+### - 接口
+
+POST m/userRole/update
+
+### - 请求参数
+
+| 参数名 |      类型      | 必需 | 默认值 |   备注   |
+| :----: | :------------: | :--: | :----: | :------: |
+|   id   |      int       |  Y   |        |  用户id  |
+| roles  | `List<Object>` |  Y   |        | 角色集合 |
+
+### - Json请求
+
+```json
+{
+	"id":1,
+	"roles":[
+		1, 9, 10
+	]
+}
+```
+
+### - Json响应
+
+```json
+{
+    "code": 1,
+    "success": true,
+    "message": "操作成功！",
+    "data": null
+}
+```
+
+## + 根据workId, realName, departmentId筛选用户角色list
+
+【例】${url}/m/userRole/f/query
+
+### - 接口
+
+POST m/userRole/f/query
+
+### - 请求参数
+
+|    参数名    |  类型  | 必需 | 默认值 |   备注   |
+| :----------: | :----: | :--: | :----: | :------: |
+|    workId    | string |  N   |        | 用户工号 |
+|   realName   | string |  N   |        | 真实姓名 |
+| departmentId |  int   |  N   |        |  部门id  |
+
+### - Json请求
+
+```json
+{
+	"workId":"Xb",
+	"realName":"", 
+	"departmentId":null
+}
+```
+
+### - Json响应
+
+```json
+{
+    "code": 1,
+    "success": true,
+    "message": "操作成功！",
+    "data": [
+        {
+            "departmentName": "开发小组",		//用户部门
+            "realName": "陆宇豪",				//用户姓名
+            "srNames": "超级管理员,测试角色,测试角色",	//拥有角色
+            "id": 1,						//用户id
+            "workId": "Xb16620208"			//用户工号
+        }
+    ]
+}
+```