。。。

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

@@ -426,7 +426,7 @@
   ```
 
 
-#### （5）诉求办理进展   (yes)--（纪）
+#### （5）诉求办理进展                                                                                     (yes)--（纪）
 
 ![image-20241121165411597](img/image-20241121165411597.png)
 
@@ -434,11 +434,11 @@
 
 
 
-接口地址:/interface4ext/supervision/appealStatement/getAppealWorkorderStatus
+- 接口地址:/interface4ext/supervision/appealStatement/getAppealWorkorderStatus
 
-请求方式：get请求
+- 请求方式：get请求
 
-参数：params.startAppealTime 开始日期 格式 yyyy-MM-dd
+- 参数：params.startAppealTime 开始日期 格式 yyyy-MM-dd
 
 ​           params.endAppealTime 结束日期 格式  yyyy-MM-dd
 
@@ -447,13 +447,15 @@
     "params": {
         "startAppealTime": "2024-01-01",   
         "endAppealTime": "2024-11-30"
-    }
+    },
+    "pageNum": 1,
+    "pageSize": 10
 }
 ```
 
 
 
-返回值
+- 返回值
 
 | emergentFlagDictName | 是否紧急-名称         | 字符串 |                                                              |      |
 | -------------------- | --------------------- | ------ | ------------------------------------------------------------ | ---- |
@@ -467,7 +469,43 @@
 | status               | 工单状态 code         | 字符串 | 0:待交办,1:待（下级）接收,2:（下级）已退回,3:待子公司办结,4:待集团办结,5:已退回（给外面）,6:已办结 |      |
 |                      |                       |        |                                                              |      |
 
-```bash
+
+
+- 调用示例
+
+```javascript
+var axios = require('axios');
+var data = JSON.stringify({
+   "params": {
+      "startAppealTime": "2024-01-01",
+      "endAppealTime": "2024-11-30"
+   }
+});
+
+var config = {
+   method: 'post',
+   url: 'http://192.168.2.16:8182/interface4ext/supervision/appealStatement/getAppealWorkorderStatus',
+   headers: { 
+      'User-Agent': 'Apifox/1.0.0 (https://apifox.com)', 
+      'Content-Type': 'application/json', 
+      'Accept': '*/*', 
+      'Host': '192.168.2.16:8182', 
+      'Connection': 'keep-alive'
+   },
+   data : data
+};
+
+axios(config)
+.then(function (response) {
+   console.log(JSON.stringify(response.data));
+})
+.catch(function (error) {
+   console.log(error);
+});
+
+```
+
+```json
 {
     "total": 1,
     "rows": [
@@ -532,6 +570,8 @@
 
 
 
+
+
 #### （6）各单位，某诉求类别，一段时间内，各诉求类别办理诉求件数（no）--（厉）
 
 ![image-20241121165537460](img/image-20241121165537460.png)
@@ -558,15 +598,15 @@
 
 ![image-20241121165913634](img/image-20241121165913634.png)
 
-接口地址：/interface4ext/supervision/appealStatement/getDutyDeptWorkorderRank
+- 接口地址：/interface4ext/supervision/appealStatement/getDutyDeptWorkorderRank
 
-请求方式：GET
+- 请求方式：GET
 
-请求参数：startDate 开始日期 字符串 yyyy-MM-dd 默认7天前的日期
+- 请求参数：startDate 开始日期 字符串 yyyy-MM-dd 默认7天前的日期
 
 endDate 结束日期 字符串，yyyy-MM-dd 默认今天的日期
 
-结果：
+- 结果：
 
 dutyDeptId 责任单位部门id Long
 
@@ -576,14 +616,41 @@ workorderSize 涉及诉求工单数，int
 
 proportion 占比，（0-1 的小数）float 进度3
 
-
+- axios 请求示例
 
 比如：http://localhost:8182/interface4ext/supervision/appealStatement/getDutyDeptWorkorderRank?startDate=&endDate=
 
+```javascript
+var axios = require('axios');
+
+var config = {
+   method: 'get',
+   url: 'http://192.168.2.16:8182/interface4ext/supervision/appealStatement/getDutyDeptWorkorderRank?startDate=&endDate',
+   headers: { 
+      'User-Agent': 'Apifox/1.0.0 (https://apifox.com)', 
+      'Accept': '*/*', 
+      'Host': '192.168.2.16:8182', 
+      'Connection': 'keep-alive'
+   }
+};
+
+axios(config)
+.then(function (response) {
+   console.log(JSON.stringify(response.data));
+})
+.catch(function (error) {
+   console.log(error);
+});
+
+```
+
+结果：
+
 ```bash
 {
-    "total": 1,
-    "rows": [
+    "msg": "操作成功",
+    "code": 200,
+    "data": [
         {
             "startDate": null,
             "endDate": null,
@@ -592,9 +659,7 @@ proportion 占比，（0-1 的小数）float 进度3
             "workorderSize": 4,
             "proportion": 1.0
         }
-    ],
-    "code": 200,
-    "msg": "查询成功"
+    ]
 }
 ```
 
@@ -829,7 +894,36 @@ proportion 占比，（0-1 的小数）float 进度3
  isTop int 1:倒序（根据总数据量排名，取多的），0：升序（根据总数据量排名，取少的）
  size int 取多少，默认 20
 ```
+- 请求示例 axios
+
+```javascript
+var axios = require('axios');
+
+var config = {
+   method: 'get',
+   url: 'http://192.168.2.16:8182/interface4ext/supervision/inspectionStatement/getProblemDeptDealRank?startDate=2024-01-01&endDate=2024-12-31&isTop=1&size=10',
+   headers: { 
+      'User-Agent': 'Apifox/1.0.0 (https://apifox.com)', 
+      'Accept': '*/*', 
+      'Host': '192.168.2.16:8182', 
+      'Connection': 'keep-alive'
+   }
+};
+
+axios(config)
+.then(function (response) {
+   console.log(JSON.stringify(response.data));
+})
+.catch(function (error) {
+   console.log(error);
+});
+
+```
+
+
+
 - 返回结果:
+
 ```java
 package com.legend.supervision.domain.vo;
 import lombok.Data;
@@ -875,38 +969,28 @@ public class ProblemDeptRankVo {
 - 结果示例
 ```json
 {
-    "total": 16,
-    "rows": [
-        {
-            "deptName": "公共自行车有限公司",
-            "deptId": 200,
-            "mainDealSize": 29,
-            "assistDealSize": 1,
-            "totalDealSize": 30,
-            "startDate": "2024-01-01",
-            "endDate": "2024-12-31"
-        },
+    "msg": "操作成功",
+    "code": 200,
+    "data": [
         {
             "deptName": "东山公交服务质量部",
             "deptId": 230,
-            "mainDealSize": 27,
+            "mainDealSize": 8,
             "assistDealSize": 0,
-            "totalDealSize": 27,
+            "totalDealSize": 8,
             "startDate": "2024-01-01",
             "endDate": "2024-12-31"
         },
         {
-            "deptName": "公共交通场站建设有限公司",
-            "deptId": 214,
-            "mainDealSize": 17,
+            "deptName": "东山公交汽车八队",
+            "deptId": 241,
+            "mainDealSize": 0,
             "assistDealSize": 1,
-            "totalDealSize": 18,
+            "totalDealSize": 1,
             "startDate": "2024-01-01",
             "endDate": "2024-12-31"
         }
-    ],
-    "code": 200,
-    "msg": "查询成功"
+    ]
 }
 ```
 
@@ -945,11 +1029,39 @@ public class ProblemDeptRankVo {
     Integer taskRecordSize;
 ```
 
-- 示例：
+- 请求示例
+
+```javascript
+var axios = require('axios');
+
+var config = {
+   method: 'get',
+   url: 'http://192.168.2.16:8182/interface4ext/supervision/inspectionStatement/getCheeckedDeptTaskRecordRank?startDate=2024-01-01&endDate=2024-12-31&isTop=1&size=10',
+   headers: { 
+      'User-Agent': 'Apifox/1.0.0 (https://apifox.com)', 
+      'Accept': '*/*', 
+      'Host': '192.168.2.16:8182', 
+      'Connection': 'keep-alive'
+   }
+};
+
+axios(config)
+.then(function (response) {
+   console.log(JSON.stringify(response.data));
+})
+.catch(function (error) {
+   console.log(error);
+});
+
+```
+
+返回结果
+
 ```bash
 {
-    "total": 2,
-    "rows": [
+    "msg": "操作成功",
+    "code": 200,
+    "data": [
         {
             "startDate": "2024-01-01",
             "endDate": "2024-12-31",
@@ -968,9 +1080,7 @@ public class ProblemDeptRankVo {
             "taskRecordSize": 4,
             "totalSize": 5
         }
-    ],
-    "code": 200,
-    "msg": "查询成功"
+    ]
 }
 ```
 
@@ -1060,7 +1170,11 @@ public class ProblemDeptRankVo {
 
 是否在岗，不好做，很难做
 
-改成其他的，统计每日，外勤检查人员总数，和有检查单的人数。
+改成其他的图形（比如：xxx），统计每日，外勤检查人员总数，和有检查单的人数。
+
+![image-20241202103737757](img/image-20241202103737757.png)
+
+
 
 注意: 结果集里面，日期不要求连续，就统计检查单表里面的创建日期。
 
@@ -1071,6 +1185,34 @@ public class ProblemDeptRankVo {
      startDate  开始日期 yyyy-MM-dd
      endDate    结束日期 yyyy-MM-dd
 ```
+- 请求示例
+
+```javascript
+var axios = require('axios');
+
+var config = {
+   method: 'get',
+   url: 'http://192.168.2.16:8182/interface4ext/supervision/inspectionStatement/getCheckingUserSize?startDate=2024-01-01&endDate=2024-12-31',
+   headers: { 
+      'User-Agent': 'Apifox/1.0.0 (https://apifox.com)', 
+      'Accept': '*/*', 
+      'Host': '192.168.2.16:8182', 
+      'Connection': 'keep-alive'
+   }
+};
+
+axios(config)
+.then(function (response) {
+   console.log(JSON.stringify(response.data));
+})
+.catch(function (error) {
+   console.log(error);
+});
+
+```
+
+
+
 - 结果:
 
 ```java
@@ -1107,8 +1249,9 @@ public class CheckUserSizeVo {
 
 ```json
 {
-    "total": 3,
-    "rows": [
+    "msg": "操作成功",
+    "code": 200,
+    "data": [
         {
             "startDate": "2024-01-01",
             "endDate": "2024-12-31",
@@ -1133,9 +1276,7 @@ public class CheckUserSizeVo {
             "workUserSize": 2,
             "totalSize": 8
         }
-    ],
-    "code": 200,
-    "msg": "查询成功"
+    ]
 }
 ```