Răsfoiți Sursa

更新 '3-开发设计文档/3-5-服务监督模块/1121-服务监督模块-大屏展示-接口设计.md'

lyw 2 luni în urmă
părinte
comite
f6b965e3b8

+ 467 - 5
3-开发设计文档/3-5-服务监督模块/1121-服务监督模块-大屏展示-接口设计.md

@@ -177,7 +177,7 @@
     ]
 }
 
-#### (2)各诉求类型,一段时间内,诉求件数统计(no)--(厉)
+#### (2)各诉求类型,一段时间内,诉求件数统计(yes)--(厉)
 
 ![image-20241121163714250](img/image-20241121163714250.png)
 
@@ -187,7 +187,59 @@
 
 注意:所有占比加起来必须=100%
 
+- 接口地址:/interface4ext/supervision/appealStatement/getAppealTypeStatement
 
+- 请求方式:POST
+
+- 请求参数:
+
+  | 参数名    | 含义     | 类型   | 是否必填 | 备注                 |
+  | --------- | -------- | ------ | -------- | -------------------- |
+  | startDate | 开始日期 | String | 否       | 时间格式为yyyy-MM-dd |
+  | endDate   | 结束日期 | String | 否       | 时间格式为yyyy-MM-dd |
+
+- 返回结果:
+
+  | 中文名        | 字段名 | 类型   | 备注                |
+  | ------------- | ------ | ------ | ------------------- |
+  | 状态码        | code   | int    | 200:成功,其他:错误 |
+  | 成功/错误消息 | msg    | string |                     |
+
+  appealTypeName:诉求类型名称,appealType:诉求类型字典值,workorderNum:办理件数
+
+```
+{
+    "msg": "操作成功",
+    "code": 200,
+    "data": [
+        {
+            "appealTypeName": "意见建议",
+            "appealType": "1",
+            "workorderNum": 6
+        },
+        {
+            "appealTypeName": "表扬",
+            "appealType": "2",
+            "workorderNum": 1
+        },
+        {
+            "appealTypeName": "求助",
+            "appealType": "3",
+            "workorderNum": 1
+        },
+        {
+            "appealTypeName": "咨询",
+            "appealType": "4",
+            "workorderNum": 2
+        },
+        {
+            "appealTypeName": "投诉举报",
+            "appealType": "5",
+            "workorderNum": 1
+        }
+    ]
+}
+```
 
 
 
@@ -570,17 +622,292 @@ axios(config)
 
 
 
-#### (6)各单位,某诉求类别,一段时间内,各诉求类别办理诉求件数(no)--(厉)
+#### (6)各单位,一段时间内,全部诉求类型 或者 单个诉求类型 办理诉求件数(yes)--(厉)
 
 ![image-20241121165537460](img/image-20241121165537460.png)
 
-请求参数:开始日期,结束日期,诉求类
+请求参数:开始日期,结束日期,诉求类
 
 结果:部门id,部门名称,各个诉求类型分别数量
 
+- 接口地址:/interface4ext/supervision/appealStatement/getAppealTypeDeptStatement
+
+- 请求方式:POST
+
+- 请求参数:
+
+  | 参数名         | 含义               | 类型   | 是否必填 | 备注                                                         |
+  | -------------- | ------------------ | ------ | -------- | ------------------------------------------------------------ |
+  | startDate      | 开始日期           | String | 否       | 时间格式为yyyy-MM-dd                                         |
+  | endDate        | 结束日期           | String | 否       | 时间格式为yyyy-MM-dd                                         |
+  | appealTypeDict | 诉求类型数据字典值 | String | 否       | 1:意见建议,2:表扬,3:求助,4:咨询,5:投诉举报,6:其他,7:文明服务,8:线路需求 |
+
+- 返回结果:
+
+  | 中文名        | 字段名 | 类型   | 备注                |
+  | ------------- | ------ | ------ | ------------------- |
+  | 状态码        | code   | int    | 200:成功,其他:错误 |
+  | 成功/错误消息 | msg    | string |                     |
+
+  deptName:单位名称,appealTypeName:诉求类型名称,appealType:诉求类型字典值,workorderNum:办理件数
+
+  ```
+  {
+      "msg": "操作成功",
+      "code": 200,
+      "data": [
+          {
+              "deptName": "东山公交汽车八队",
+              "appealTypeList": [
+                  {
+                      "appealTypeName": "意见建议",
+                      "appealType": "1",
+                      "workorderNum": 2
+                  },
+                  {
+                      "appealTypeName": "表扬",
+                      "appealType": "2",
+                      "workorderNum": 0
+                  },
+                  {
+                      "appealTypeName": "求助",
+                      "appealType": "3",
+                      "workorderNum": 1
+                  },
+                  {
+                      "appealTypeName": "咨询",
+                      "appealType": "4",
+                      "workorderNum": 1
+                  },
+                  {
+                      "appealTypeName": "投诉举报",
+                      "appealType": "5",
+                      "workorderNum": 0
+                  },
+                  {
+                      "appealTypeName": "其他",
+                      "appealType": "6",
+                      "workorderNum": 0
+                  }
+              ]
+          },
+          {
+              "deptName": "集团行政综合部",
+              "appealTypeList": [
+                  {
+                      "appealTypeName": "意见建议",
+                      "appealType": "1",
+                      "workorderNum": 0
+                  },
+                  {
+                      "appealTypeName": "表扬",
+                      "appealType": "2",
+                      "workorderNum": 1
+                  },
+                  {
+                      "appealTypeName": "求助",
+                      "appealType": "3",
+                      "workorderNum": 0
+                  },
+                  {
+                      "appealTypeName": "咨询",
+                      "appealType": "4",
+                      "workorderNum": 0
+                  },
+                  {
+                      "appealTypeName": "投诉举报",
+                      "appealType": "5",
+                      "workorderNum": 0
+                  },
+                  {
+                      "appealTypeName": "其他",
+                      "appealType": "6",
+                      "workorderNum": 0
+                  }
+              ]
+          },
+          {
+              "deptName": "公共交通信息科技有限公司",
+              "appealTypeList": [
+                  {
+                      "appealTypeName": "意见建议",
+                      "appealType": "1",
+                      "workorderNum": 0
+                  },
+                  {
+                      "appealTypeName": "表扬",
+                      "appealType": "2",
+                      "workorderNum": 1
+                  },
+                  {
+                      "appealTypeName": "求助",
+                      "appealType": "3",
+                      "workorderNum": 0
+                  },
+                  {
+                      "appealTypeName": "咨询",
+                      "appealType": "4",
+                      "workorderNum": 0
+                  },
+                  {
+                      "appealTypeName": "投诉举报",
+                      "appealType": "5",
+                      "workorderNum": 0
+                  },
+                  {
+                      "appealTypeName": "其他",
+                      "appealType": "6",
+                      "workorderNum": 0
+                  }
+              ]
+          },
+          {
+              "deptName": "集团党群工作部",
+              "appealTypeList": [
+                  {
+                      "appealTypeName": "意见建议",
+                      "appealType": "1",
+                      "workorderNum": 0
+                  },
+                  {
+                      "appealTypeName": "表扬",
+                      "appealType": "2",
+                      "workorderNum": 0
+                  },
+                  {
+                      "appealTypeName": "求助",
+                      "appealType": "3",
+                      "workorderNum": 0
+                  },
+                  {
+                      "appealTypeName": "咨询",
+                      "appealType": "4",
+                      "workorderNum": 1
+                  },
+                  {
+                      "appealTypeName": "投诉举报",
+                      "appealType": "5",
+                      "workorderNum": 0
+                  },
+                  {
+                      "appealTypeName": "其他",
+                      "appealType": "6",
+                      "workorderNum": 0
+                  }
+              ]
+          },
+          {
+              "deptName": "东山公交服务质量部",
+              "appealTypeList": [
+                  {
+                      "appealTypeName": "意见建议",
+                      "appealType": "1",
+                      "workorderNum": 2
+                  },
+                  {
+                      "appealTypeName": "表扬",
+                      "appealType": "2",
+                      "workorderNum": 0
+                  },
+                  {
+                      "appealTypeName": "求助",
+                      "appealType": "3",
+                      "workorderNum": 1
+                  },
+                  {
+                      "appealTypeName": "咨询",
+                      "appealType": "4",
+                      "workorderNum": 1
+                  },
+                  {
+                      "appealTypeName": "投诉举报",
+                      "appealType": "5",
+                      "workorderNum": 0
+                  },
+                  {
+                      "appealTypeName": "其他",
+                      "appealType": "6",
+                      "workorderNum": 0
+                  }
+              ]
+          },
+          {
+              "deptName": "集团资产合规部",
+              "appealTypeList": [
+                  {
+                      "appealTypeName": "意见建议",
+                      "appealType": "1",
+                      "workorderNum": 0
+                  },
+                  {
+                      "appealTypeName": "表扬",
+                      "appealType": "2",
+                      "workorderNum": 0
+                  },
+                  {
+                      "appealTypeName": "求助",
+                      "appealType": "3",
+                      "workorderNum": 0
+                  },
+                  {
+                      "appealTypeName": "咨询",
+                      "appealType": "4",
+                      "workorderNum": 1
+                  },
+                  {
+                      "appealTypeName": "投诉举报",
+                      "appealType": "5",
+                      "workorderNum": 0
+                  },
+                  {
+                      "appealTypeName": "其他",
+                      "appealType": "6",
+                      "workorderNum": 0
+                  }
+              ]
+          },
+          {
+              "deptName": "集团审计内控部",
+              "appealTypeList": [
+                  {
+                      "appealTypeName": "意见建议",
+                      "appealType": "1",
+                      "workorderNum": 0
+                  },
+                  {
+                      "appealTypeName": "表扬",
+                      "appealType": "2",
+                      "workorderNum": 1
+                  },
+                  {
+                      "appealTypeName": "求助",
+                      "appealType": "3",
+                      "workorderNum": 0
+                  },
+                  {
+                      "appealTypeName": "咨询",
+                      "appealType": "4",
+                      "workorderNum": 1
+                  },
+                  {
+                      "appealTypeName": "投诉举报",
+                      "appealType": "5",
+                      "workorderNum": 0
+                  },
+                  {
+                      "appealTypeName": "其他",
+                      "appealType": "6",
+                      "workorderNum": 0
+                  }
+              ]
+          }
+      ]
+  }
+  ```
 
+  
 
-#### (7)各单位一段时间内,主办和协办诉求件数排名,根据总数排名(no)--(厉)
+#### (7)各单位一段时间内,主办和协办诉求件数排名,根据总数排名(yes)--(厉)
 
 ![image-20241121165813972](img/image-20241121165813972.png)
 
@@ -588,7 +915,83 @@ axios(config)
 
 结果:部门id,部门名称,主办件数,协办件数,总件数
 
+- 接口地址:/interface4ext/supervision/appealStatement/getAppealDeptStatement
+
+- 请求方式:POST
+
+- 请求参数:
+
+  | 参数名    | 含义     | 类型   | 是否必填 | 备注                 |
+  | --------- | -------- | ------ | -------- | -------------------- |
+  | startDate | 开始日期 | String | 否       | 时间格式为yyyy-MM-dd |
+  | endDate   | 结束日期 | String | 否       | 时间格式为yyyy-MM-dd |
+
+- 返回结果:
+
+  | 中文名        | 字段名 | 类型   | 备注                |
+  | ------------- | ------ | ------ | ------------------- |
+  | 状态码        | code   | int    | 200:成功,其他:错误 |
+  | 成功/错误消息 | msg    | string |                     |
+
+  deptName:单位名称,deptId:单位id,organizerNum:主办件数,assistingNum:协办件数,totalNum:主办协办总数
 
+```
+{
+    "msg": "操作成功",
+    "code": 200,
+    "data": [
+        {
+            "deptName": "东山公交汽车八队",
+            "deptId": 241,
+            "organizerNum": 0,
+            "assistingNum": 4,
+            "totalNum": 4
+        },
+        {
+            "deptName": "东山公交服务质量部",
+            "deptId": 230,
+            "organizerNum": 4,
+            "assistingNum": 0,
+            "totalNum": 4
+        },
+        {
+            "deptName": "集团审计内控部",
+            "deptId": 284,
+            "organizerNum": 0,
+            "assistingNum": 2,
+            "totalNum": 2
+        },
+        {
+            "deptName": "集团行政综合部",
+            "deptId": 275,
+            "organizerNum": 1,
+            "assistingNum": 0,
+            "totalNum": 1
+        },
+        {
+            "deptName": "公共交通信息科技有限公司",
+            "deptId": 101,
+            "organizerNum": 0,
+            "assistingNum": 1,
+            "totalNum": 1
+        },
+        {
+            "deptName": "集团党群工作部",
+            "deptId": 278,
+            "organizerNum": 1,
+            "assistingNum": 0,
+            "totalNum": 1
+        },
+        {
+            "deptName": "集团资产合规部",
+            "deptId": 281,
+            "organizerNum": 0,
+            "assistingNum": 1,
+            "totalNum": 1
+        }
+    ]
+}
+```
 
 
 
@@ -1082,7 +1485,7 @@ axios(config)
 }
 ```
 
-#### (5)被检查单位,一段时间内,合格率排名(no)--(厉)
+#### (5)被检查单位,一段时间内,合格率排名(yes)--(厉)
 
 ![image-20241121171016304](img/image-20241121171016304.png)
 
@@ -1090,6 +1493,65 @@ axios(config)
 
 结果:
 
+- 接口地址:/interface4ext/supervision/inspectionStatement/getInspectionDeptQualifiedRate
+
+- 请求方式:POST
+
+- 请求参数:
+
+  | 参数名    | 含义     | 类型   | 是否必填 | 备注                 |
+  | --------- | -------- | ------ | -------- | -------------------- |
+  | startDate | 开始日期 | String | 否       | 时间格式为yyyy-MM-dd |
+  | endDate   | 结束日期 | String | 否       | 时间格式为yyyy-MM-dd |
+
+- 返回结果:
+
+  | 中文名        | 字段名 | 类型   | 备注                |
+  | ------------- | ------ | ------ | ------------------- |
+  | 状态码        | code   | int    | 200:成功,其他:错误 |
+  | 成功/错误消息 | msg    | string |                     |
+
+  deptName:部门名称,qualifiedRate:合格率
+
+  ```
+  {
+      "msg": "操作成功",
+      "code": 200,
+      "data": [
+          {
+              "deptName": "dddd",
+              "qualifiedRate": 1.0000
+          },
+          {
+              "deptName": "测试",
+              "qualifiedRate": 0.6667
+          },
+          {
+              "deptName": "公交集团",
+              "qualifiedRate": 0.0000
+          },
+          {
+              "deptName": "江宁公交集团",
+              "qualifiedRate": 0.0000
+          },
+          {
+              "deptName": "东山公交五队",
+              "qualifiedRate": 0.0000
+          },
+          {
+              "deptName": "东山公交",
+              "qualifiedRate": 0.0000
+          },
+          {
+              "deptName": "佘山水库-公交场站-111",
+              "qualifiedRate": 0.0000
+          }
+      ]
+  }
+  ```
+
+  
+
 #### (6)各类型检查任务数量和占比(yes)--(段)
 
 ![image-20241121171057240](img/image-20241121171057240.png)