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

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)