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

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

@@ -121,7 +121,7 @@
 
 
 
-#### （3）诉求对象按年龄段，统计一段时间内，诉求件数和占比（no）--（李）
+#### （3）诉求对象按年龄段，统计一段时间内，诉求件数和占比（yes）--（李）
 
 ![image-20241121163934191](img/image-20241121163934191.png)
 
@@ -131,6 +131,102 @@
 
 占比总和必须=100%
 
+- 修改为根据性别统计 (男,女,未知)
+
+- 接口地址:/interface4ext/supervision/appealStatement/getAppealSex
+
+- 请求方式:POST
+
+- 请求参数:
+
+  | 参数名  | 含义                 | 类型   | 是否必填 | 备注 |
+  | ------- | -------------------- | ------ | -------- | ---- |
+  | staTime | 开始时间(2024-10-01) | String | 是       |      |
+  | endTime | 结束时间(2024-11-30) | String | 是       |      |
+
+- 返回结果:
+
+  | 中文名        | 字段名 | 类型   | 备注                |
+  | ------------- | ------ | ------ | ------------------- |
+  | 状态码        | code   | int    | 200:成功，其他:错误 |
+  | 成功/错误消息 | msg    | string |                     |
+  | 结果集        | data   | 对象   |                     |
+
+  ```
+  {
+  	"msg": "操作成功",
+  	"code": 200,
+  	"data": {
+  		"totalNum": 11,
+  		"finishedNum": null,
+  		"pendingNum": null,
+  		"execNum": null,
+  		"satisfaction": null,
+  		"satisfactionNum": null,
+  		"finishOnTime": null,
+  		"finishOnTimeNum": null,
+  		"averageProcessingTimeConsult": null,
+  		"averageProcessingTimeNoConsult": null,
+  		"type": null,
+  		"mom": null,
+  		"manNum": 10,
+  		"manPercentage": "90.91%",
+  		"girlNum": 1,
+  		"girlPercentage": "9.09%",
+  		"unknownNum": 0,
+  		"unknownPercentage": "0.0%"
+  	}
+  }
+  package com.legend.supervision.domain;
+  
+  import lombok.Data;
+  
+  /**
+   * @author ls
+   * @date 2024-11-27 10:31
+   * 诉求总览
+   */
+  @Data
+  public class AppealAll {
+      //总件数
+      private Integer totalNum;
+      //已办
+      private Integer finishedNum;
+      //待办
+      private Integer pendingNum;
+      //执行分配中
+      private Integer execNum;
+      //满意度
+      private String satisfaction;
+      //满意数量
+      private Integer satisfactionNum;
+      //按时办结率
+      private String finishOnTime;
+      //按时办结数量
+      private Integer finishOnTimeNum;
+      //平均处理时长咨询
+      private Integer averageProcessingTimeConsult;
+      //平均处理时长非咨询
+      private Integer averageProcessingTimeNoConsult;
+      //类型 null,0-总览,1-当月
+      private Integer type;
+      //本月环比
+      private String mom;
+      //男数量
+      private Integer manNum;
+      //男占比
+      private String manPercentage;
+      //女数量
+      private Integer girlNum;
+      //女占比
+      private String girlPercentage;
+      //未知数量
+      private Integer unknownNum;
+      //未知占比
+      private String unknownPercentage;
+  }
+  
+  ```
 
 
 
@@ -156,6 +252,101 @@
 非咨询类-平均处理时长-值（小数，精度3），非咨询类-平均处理时长-单位（1：小时，2：分钟，3：工作日）
 
 
+- 接口地址:/interface4ext/supervision/appealStatement/getAppealAllCount
+
+- 请求方式:POST
+
+- 请求参数:
+
+  | 参数名  | 含义                          | 类型   | 是否必填 | 备注                 |
+  | ------- | ----------------------------- | ------ | -------- | -------------------- |
+  | type    | 类型(null,0 = 全部, 1 = 上月) | int    | 否       | type=0,null 时间必填 |
+  | staTime | 开始时间      (2024-10-01)                | String | 否       |                      |
+  | endTime | 结束时间     (2024-11-30)                 | String | 否       |                      |
+
+- 返回结果:
+
+  | 中文名        | 字段名 | 类型   | 备注                |
+  | ------------- | ------ | ------ | ------------------- |
+  | 状态码        | code   | int    | 200:成功，其他:错误 |
+  | 成功/错误消息 | msg    | string |                     |
+  | 结果集        | data   | 对象   |                     |
+
+  ```
+  {
+  	"msg": "操作成功",
+  	"code": 200,
+  	"data": {
+  		"totalNum": 11,
+  		"finishedNum": 4,
+  		"pendingNum": 5,
+  		"execNum": 2,
+  		"satisfaction": "50.0%",
+  		"satisfactionNum": 2,
+  		"finishOnTime": "100.0%",
+  		"finishOnTimeNum": 4,
+  		"averageProcessingTimeConsult": 0,
+  		"averageProcessingTimeNoConsult": 8,
+  		"type": null,
+  		"mom": null,
+  		"manNum": null,
+  		"manPercentage": null,
+  		"girlNum": null,
+  		"girlPercentage": null,
+  		"unknownNum": null,
+  		"unknownPercentage": null
+  	}
+  }
+  package com.legend.supervision.domain;
+  
+  import lombok.Data;
+  
+  /**
+   * @author ls
+   * @date 2024-11-27 10:31
+   * 诉求总览
+   */
+  @Data
+  public class AppealAll {
+      //总件数
+      private Integer totalNum;
+      //已办
+      private Integer finishedNum;
+      //待办
+      private Integer pendingNum;
+      //执行分配中
+      private Integer execNum;
+      //满意度
+      private String satisfaction;
+      //满意数量
+      private Integer satisfactionNum;
+      //按时办结率
+      private String finishOnTime;
+      //按时办结数量
+      private Integer finishOnTimeNum;
+      //平均处理时长咨询
+      private Integer averageProcessingTimeConsult;
+      //平均处理时长非咨询
+      private Integer averageProcessingTimeNoConsult;
+      //类型 null,0-总览,1-当月
+      private Integer type;
+      //本月环比
+      private String mom;
+      //男数量
+      private Integer manNum;
+      //男占比
+      private String manPercentage;
+      //女数量
+      private Integer girlNum;
+      //女占比
+      private String girlPercentage;
+      //未知数量
+      private Integer unknownNum;
+      //未知占比
+      private String unknownPercentage;
+  }
+  
+
 
 #### （5）诉求办理进展（ok）--（纪）