Browse Source

外勤检查人员是否在岗,改成每日有多少人在外面检查。

jxhspring 2 months ago
parent
commit
a73834872d

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

@@ -826,7 +826,7 @@ proportion 占比,(0-1 的小数)float 进度3
 
 
 
-#### (4)被检查单位,一段时间内,检查任务和检查单数量汇总排名(no)--(纪)
+#### (4)被检查单位,一段时间内,检查任务和检查单数量汇总排名(ok)--(纪)
 
 设计图上:右侧,每日诉求汇总 (标题写错了)
 
@@ -834,9 +834,60 @@ proportion 占比,(0-1 的小数)float 进度3
 
 请求参数:开始日期,结束日期,是否倒序(1:倒序,2:升序),排序字段标识(1:检查任务数量,2:检查单数量)
 
-结果:
+- 接口地址: /interface4ext/supervision/inspectionStatement/getCheeckedDeptTaskRecordRank
+- 请求方式: GET
+- 请求参数
+```bash
+     startDate  开始日期 yyyy-MM-dd
+     endDate    结束日期 yyyy-MM-dd
+     isTop 1:倒序(根据总数据量排名,取多的),0:升序(根据总数据量排名,取少的)
+     size 取多少,默认 10
+```
 
+- 结果
+```java
+    //开始日期 yyyy-MM-dd
+    String startDate;
+    //结束日期 yyyy-MM-dd
+    String endDate;
+    //检查单位id
+    Long checkedDeptId;
+    //检查单位名称
+    String checkedDeptName;
+    //检查任务数量
+    Integer taskSize;
+    //检查单数量
+    Integer taskRecordSize;
+```
 
+- 示例:
+```bash
+{
+    "total": 2,
+    "rows": [
+        {
+            "startDate": "2024-01-01",
+            "endDate": "2024-12-31",
+            "checkedDeptId": 100,
+            "checkedDeptName": "江宁公交集团",
+            "taskSize": 3,
+            "taskRecordSize": 3,
+            "totalSize": 6
+        },
+        {
+            "startDate": "2024-01-01",
+            "endDate": "2024-12-31",
+            "checkedDeptId": 102,
+            "checkedDeptName": "东山公交客运有限公司",
+            "taskSize": 1,
+            "taskRecordSize": 4,
+            "totalSize": 5
+        }
+    ],
+    "code": 200,
+    "msg": "查询成功"
+}
+```
 
 #### (5)被检查单位,一段时间内,合格率排名(no)--(厉)
 
@@ -918,19 +969,90 @@ proportion 占比,(0-1 的小数)float 进度3
 
 
 
-#### (7)外勤检查人员,一段时间内,在岗、不在岗数量统计(no)--(纪)
+#### (7)外勤检查人员,一段时间内,在岗、不在岗数量统计(ok)--(纪)
 
 ![image-20241121171115762](img/image-20241121171115762.png)
 
-是否在岗,不好做,很难做,我们就不做了。
+是否在岗,不好做,很难做
 
-统计每日,外勤检查人员总数,和有检查单的人数。
+改成其他的,统计每日,外勤检查人员总数,和有检查单的人数。
 
-请求参数:开始日期,结束日期
+注意: 结果集里面,日期不要求连续,就统计检查单表里面的创建日期。
 
-结果:日期,外勤人员总数,检查人员(当天有检查单的)数量
+- 接口地址: /interface4ext/supervision/inspectionStatement/getCheckingUserSize
+- 请求方式: GET
+- 请求参数:
+```bash
+     startDate  开始日期 yyyy-MM-dd
+     endDate    结束日期 yyyy-MM-dd
+```
+- 结果:
+
+```java
+/**
+ * 外勤检查人员 vo 对象
+ */
+@Data
+public class CheckUserSizeVo {
+    /**
+     * 检查日期 yyyy-MM-dd
+     */
+    private String workDateStr;
+    private Date workDate;
+    /**
+     * 当天检查人员用户数
+     */
+    private Integer workUserSize;
+    /**
+     * 外勤检查人员总数
+     */
+    private Integer totalSize;
+
+    /**
+     * 开始日期 yyyy-MM-dd
+     */
+    private String startDate;
+    /**
+     * 结束日期 yyyy-MM-dd
+     */
+    private String endDate;
+}
+```
 
-结果集里面,日期不要求连续,就统计检查单表里面的创建日期。
+
+```json
+{
+    "total": 3,
+    "rows": [
+        {
+            "startDate": "2024-01-01",
+            "endDate": "2024-12-31",
+            "workDateStr": "2024-10-16",
+            "workDate": "2024-10-16T00:00:00.000+08:00",
+            "workUserSize": 1,
+            "totalSize": 7
+        },
+        {
+            "startDate": "2024-01-01",
+            "endDate": "2024-12-31",
+            "workDateStr": "2024-10-28",
+            "workDate": "2024-10-28T00:00:00.000+08:00",
+            "workUserSize": 1,
+            "totalSize": 7
+        },
+        {
+            "startDate": "2024-01-01",
+            "endDate": "2024-12-31",
+            "workDateStr": "2024-10-29",
+            "workDate": "2024-10-29T00:00:00.000+08:00",
+            "workUserSize": 2,
+            "totalSize": 8
+        }
+    ],
+    "code": 200,
+    "msg": "查询成功"
+}
+```