服务监督模块，大屏展示-接口设计

createTime 2024-11-21

大屏尺寸

效果图

接口设计

基础数据

（1）数据字典（ok）

接口地址:/system/dict/data/list?pageNum=&pageSize=&dictType=
请求方式:GET
请求参数:

参数名含义类型是否必填备注

dictType 字典类型字符串必填

pageNum 第几页 int 默认1

pageSize 一页记录数 int 默认？
返回结果:

中文名字段名类型备注

状态码 code int 200:成功，其他:错误

成功/错误消息 msg string

总记录数 total int

结果集 rows 数组
- rows 结果集
  
  字段名含义类型备注
  
  dictValue 代码值字符串
  
  dictLabel 标题字符串
  
  dictSort 排序 int

参数名	含义	类型	是否必填	备注
dictType	字典类型	字符串	必填
pageNum	第几页	int		默认1
pageSize	一页记录数	int		默认？

字段名	含义	类型
dictValue	代码值	字符串
dictLabel	标题	字符串
dictSort	排序	int

（2）诉求来源列表（ok）

接口地址:/supervision/appealSource/list?pageNum=1&pageSize=20&orderByColumn=createTime&isAsc=descending
请求方式:GET

请求参数:

参数名	含义	类型	是否必填	备注
pageNum	第几页	int	否
pageSize	一页几条	int	否
orderByColumn	排序字段名	String
isAsc	是否升序	String		descending 降序，默认升序

返回结果:

中文名	字段名	类型	备注
状态码	code	int	200:成功，其他:错误
成功/错误消息	msg	string
总记录数	total	int
结果集	rows	数组

rows 结果集

字段名	含义	类型	备注
id	id	Long
sourceName	来源名称	字符串
sourceRemark	备注	字符串
delFlag	删除标记	字符串	0：没删，1：已删
createTime	创建时间

（3）诉求类型列表（ok）

调用数据字典接口，字典类型，传入: supervision_appeal_type

服务监督模块

（1）各诉求来源，某诉求类型一段时间内，诉求件数统计（yes） ------（段）

参数：诉求类型字典号，开始日期，结束日期

结果：来源id，来源名称，诉求件数（int），占比（字符串，比如 25%）

注意点：所有来源的占比，加起来 = 100%

接口地址:/interface4ext/supervision/appealStatement/getAppealSourceCount
请求方式:POST

请求参数:

参数名	含义	类型	是否必填
appealType	诉求类型	int	否
startTime	开始日期（时间格式为yyyy-MM-dd）	String	是
endTime	结束日期（时间格式为yyyy-MM-dd）	String	是

返回结果:

中文名字段名类型备注

状态码 code int 200:成功，其他:错误

成功/错误消息 msg string

结果集 data 对象
rows 结果集

字段名含义类型备注

id id Long

sourceName 来源名称字符串

manageUnit 主管单位字符串

sourceCount 诉求总件数 Long

createTime 创建时间

{

"msg": "操作成功",
"code": 200,
"data": [
    {
        "searchValue": null,
        "createBy": null,
        "createByUser": null,
        "createByNickName": null,
        "deptIdOfCreateBy": null,
        "deptNameOfCreateBy": null,
        "deptAncestorOfCreateBy": null,
        "deptAncestorsNamesOfCreateBy": null,
        "createTime": "2024-08-30 14:54:51",
        "updateBy": null,
        "updateTime": "2024-10-14 23:19:33",
        "remark": null,
        "ccedList": null,
        "sysAttachmentList": null,
        "params": {},
        "id": 2,
        "delFlag": "0",
        "sourceName": "市12345",
        "bindExcelFlag": 1,
        "manageUnit": "南京市政府",
        "sourceLinkTel": "12345",
        "sourceRemark": null,
        "weManageDept": "江宁公交集团",
        "weManageDeptId": "100",
        "weManageUser": "汪晶晶",
        "weManageUserId": "571",
        "sourceCount": 2,
        "attachmentIds": null,
        "bindExcelFile": null
    },
    ......
]

}

（2）各诉求类型，一段时间内，诉求件数统计（no）--（厉）

参数：开始日期，结束日期

结果：诉求类型字典代码，诉求类型名称，诉求件数，占比（字符串，比如：12%）

注意：所有占比加起来必须=100%

（3）诉求对象按年龄段，统计一段时间内，诉求件数和占比（yes）--（李）

参数：开始日期，结束日期

结果：年龄区间（比如 30以内，30-40,40-50,50-60,60-70,70以上），诉求件数，占比

占比总和必须=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;
  }

（4）诉求总览（一段时间内）（yes）--（李）

请求参数：开始日期，结束日期

结果：总件数，已办件数，待处理件数，执行分配中件数，

本月环比（小数，精度3）考虑一下环比的计算公式，是否会出现正负，若有，正负，前端怎么表现？

满意度（0-1的小时，精度3，比如0.985 最后显示的是98.5%），按时办结率（小时，精度3），

咨询类-平均处理时长-值（小数，精度3），咨询类-平均处理时长-单位（1：小时，2：分钟，3：工作日）

非咨询类-平均处理时长-值（小数，精度3），非咨询类-平均处理时长-单位（1：小时，2：分钟，3：工作日）

接口地址:/interface4ext/supervision/appealStatement/getAppealAllCount
请求方式:POST
请求参数:

参数名含义类型是否必填备注

type 类型(null,0 = 全部, 1 = 上月) int 否 type=0,null 时间必填

staTime 开始时间 String 否

endTime 结束时间 String 否
返回结果:

参数名	含义	类型	是否必填	备注
type	类型(null,0 = 全部, 1 = 上月)	int	否	type=0,null 时间必填
staTime	开始时间	String	否
endTime	结束时间	String	否

  {
  	"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）--（纪）

接口地址:/interface4ext/supervision/appealStatement/getAppealWorkorderStatus

请求方式：get请求

参数：params.startAppealTime 开始日期格式 yyyy-MM-dd

params.endAppealTime 结束日期格式 yyyy-MM-dd

{
    "params": {
        "startAppealTime": "2024-01-01",   
        "endAppealTime": "2024-11-30"
    }
}

返回值

emergentFlagDictName	是否紧急-名称	字符串
emergentFlag	是否紧急-数据字典code	字符串
appealTypeDictName	诉求类型-字典名称
appealType	诉求类型-字典code
workorderNo	工单编号
serviceObject	诉求对象（谁投诉的）
callTel	来电号码
statusDictName	工单状态 name	字符串
status	工单状态 code	字符串	0:待交办,1:待（下级）接收,2:（下级）已退回,3:待子公司办结,4:待集团办结,5:已退回（给外面）,6:已办结

{
    "total": 1,
    "rows": [
        {
            "createTime": "2024-10-16 17:36:44",            
            "updateTime": "2024-11-07 16:25:37",            
            "id": 1487,
            "delFlag": "0",
            "workorderNo": "GD20241016-0002",
            "sourceId": 9,
            "sourceName": "宁易行APP",
            "serviceObject": "孙杰",
            "serviceObjectSex": 0,
            "letterFlag": 0,
            "callTel": "13225210913",
            "callTime": "2024-10-24 16:23:49",
            "linkTel1": null,
            "linkTel2": null,
            "cardType": null,
            "cardNo": null,
            "appealPurpose": "ces11",
            "appealAddress": null,
            "appealContent": "拒绝更改d6，方便那些所谓居民，他们不上班换乘怎么了，也就多十几分钟，但是对上班人不一样，要早起半小时，换乘说不定动不动迟到，希望领导大公无私，而不是所谓的卖那边楼",
            "appealEmotional": null,
            "appealType": "2",
            "appealTypeDictName": "表扬",
            "serviceType": "0",
            "incidentTime": null,
            "receiveTime": null,
            "emergentFlag": 0,
            "emergentFlagDictName": "不紧急",
            "classificType": null,
            "classificTypeSubdivision": "5",
            "completedDeadlineTime": null,
            "returnDeadlineTime": null,
            "assignedDeadlineTime": "2024-10-24 16:24:33",
            "returnVisitFlag": 0,
            "status": "1",
            "statusDictName": "待接收",
            "organizerUnit": "集团行政综合部",
            "organizerUnitId": 275,            
            "reviewFlag": 0,
            "appealFlow": null,
            "attachmentIds": null,
            "assistingRelationId": null,
            "assistingUnit": null,
            "assistingUnitIds": null,
            "handleFlag": null,
            "dealId": null,
            "dealType": null,
            "dealTime": null,
            "dealDept": null,
            "assistingRelationStatus": null,
            "appealReturnVisit": null,
            "appealDeal": null 
        }
    ],
    "code": 200,
    "msg": "查询成功"
}

（6）各单位，某诉求类别，一段时间内，各诉求类别办理诉求件数（no）--（厉）

请求参数：开始日期，结束日期，诉求类别，

结果：部门id，部门名称，各个诉求类型分别数量

（7）各单位一段时间内，主办和协办诉求件数排名，根据总数排名（no）--（厉）

请求参数：开始日期，结束日期，诉求类型，诉求来源

结果：部门id，部门名称，主办件数，协办件数，总件数

（8）各责任单位一段时间内，涉及诉求件数排名（ok）--（纪）

接口地址：/interface4ext/supervision/appealStatement/getDutyDeptWorkorderRank

请求方式：GET

请求参数：startDate 开始日期字符串 yyyy-MM-dd 默认7天前的日期

endDate 结束日期字符串，yyyy-MM-dd 默认今天的日期

结果：

dutyDeptId 责任单位部门id Long

dutyDeptName 责任单位名称字符串

workorderSize 涉及诉求工单数，int

proportion 占比，（0-1 的小数）float 进度3

比如：http://localhost:8182/interface4ext/supervision/appealStatement/getDutyDeptWorkorderRank?startDate=&endDate=

{
    "total": 1,
    "rows": [
        {
            "startDate": null,
            "endDate": null,
            "dutyDeptId": 241,
            "dutyDeptName": "东山公交汽车八队",
            "workorderSize": 4,
            "proportion": 1.0
        }
    ],
    "code": 200,
    "msg": "查询成功"
}

（9）各责任线路，一段时间内，某诉求类型，涉及诉求件数排名（yes）--（段）

请求参数：开始日期，结束日期，诉求类型，诉求来源

结果：名次，线路code，线路名称，诉求件数

根据名次倒序

接口地址:/interface4ext/supervision/appealStatement/getAppealLineCount
请求方式:POST

请求参数:

参数名	含义	类型	是否必填
appealType	诉求类型	int	否
startTime	开始日期（时间格式为yyyy-MM-dd）	String	是
endTime	结束日期（时间格式为yyyy-MM-dd）	String	是

返回结果:

中文名字段名类型备注

状态码 code int 200:成功，其他:错误

成功/错误消息 msg string

结果集 data 对象

rows 结果集

字段名	含义	类型
id	id	Long
extLineNames	线路号	字符串
extLineCodes	线路编号	字符串
dealCount	数量	Long
appealType	诉求类型数据字典项	字符串
appealTypeName	诉求类型	字符串

{

"msg": "操作成功",
"code": 200,
"data": [
    {
        "searchValue": null,
        "createBy": null,
        "createByUser": null,
        "createByNickName": null,
        "deptIdOfCreateBy": null,
        "deptNameOfCreateBy": null,
        "deptAncestorOfCreateBy": null,
        "deptAncestorsNamesOfCreateBy": null,
        "createTime": null,
        "updateBy": null,
        "updateTime": null,
        "remark": null,
        "ccedList": null,
        "sysAttachmentList": null,
        "params": {},
        "id": null,
        "delFlag": null,
        "workorderId": null,
        "dealDept": null,
        "dealDeptId": null,
        "dealDeptType": null,
        "dealDeptTypeList": null,
        "dealType": null,
        "dealTime": null,
        "dealContent": null,
        "flowId": null,
        "flowIdList": null,
        "assistingRelationId": null,
        "dutyFlag": null,
        "answerFlag": null,
        "evaluateFlag": null,
        "concernLineReamrk": null,
        "extLineCodes": "453",
        "extLineNames": "701",
        "dutyDeptIds": null,
        "dutyDeptNames": null,
        "beforeDistributeFlowId": null,
        "attachmentIds": null,
        "handleFlag": null,
        "workorderIds": "1000,1486",
        "dealCount": 2,
        "appealType": "1",
        "appealTypeName": "意见建议"
    },
    ......
]

}

外勤检查模块

（1）检查任务总览（yes）--（李）

请求参数：开始日期，结束日期

结果：任务总数，未发布任务数，有检查单的任务数，没有检查单的任务数，已关闭任务数，进行中的（已发布，未关闭）任务数

接口地址:/interface4ext/supervision/inspectionStatement/getInspectionTaskAll
请求方式:POST
请求参数:

| 参数名 | 含义 | 类型 | 是否必填 | 备注 | | ------- | -------- | ------ | -------- | ---- | | staTime | 开始时间 | String | 否 | | | endTime | 结束时间 | String | 否 | |

返回结果:

  {
  	"msg": "操作成功",
  	"code": 200,
  	"data": {
  		"totalTasks": 5,
  		"taskWithRecords": 4,
  		"taskWithoutRecords": 1,
  		"taskClose": 1,
  		"taskUnpublished": 0
  	}
  }
  public class InspectionTaskAll {
      /** 总任务数 **/
      private Integer totalTasks;
      /** 有检查单任务数 **/
      private Integer taskWithRecords;
      /** 没有检查单任务数 **/
      private Integer taskWithoutRecords;
      /** 已关闭任务数 **/
      private Integer taskClose;
      /** 未发布任务数 **/
      private Integer taskUnpublished;
  }

（2）检查单总览（yes）--（李）

请求参数：开始日期，结束日期

结果：检查单位总数，已结束的检查单总数，有不合格的检查单数，整改中的检查单数量，已整改的检查单数量，已结束的检查单数量

接口地址:/interface4ext/supervision/inspectionStatement/getInspectionTaskRecordAll
请求方式:POST
请求参数:

| 参数名 | 含义 | 类型 | 是否必填 | 备注 | | ------- | -------- | ------ | -------- | ---- | | staTime | 开始时间 | String | 否 | | | endTime | 结束时间 | String | 否 | |

返回结果:

  {
  	"msg": "操作成功",
  	"code": 200,
  	"data": {
  		"totalTaskRecord": 13,
  		"taskRecordSubstandard": 13,
  		"taskRecordRectification": 2,
  		"taskRecordRectified": 2,
  		"taskRecordClose": 7
  	}
  }
  public class InspectionTaskRecordAll {
      /** 检查单总数 **/
      private Integer totalTaskRecord;
          /** 不合格检查单 **/
      private Integer taskRecordSubstandard;
          /** 整改中检查单 **/
      private Integer taskRecordRectification;
          /** 已整改检查单 **/
      private Integer taskRecordRectified;
          /** 已关闭检查单 **/
      private Integer taskRecordClose;
  
  }

（3）各整改单位、一段时间内、主办和协办整改的数量排名（正序、倒序）（no）--（纪）

请求参数：开始日期，结束日期，是否倒序（1：倒序，2：升序）

结果：

（4）被检查单位，一段时间内，检查任务和检查单数量汇总排名（no）--（纪）

设计图上：右侧，每日诉求汇总（标题写错了）

请求参数：开始日期，结束日期，是否倒序（1：倒序，2：升序），排序字段标识（1：检查任务数量，2：检查单数量）

结果：

（5）被检查单位，一段时间内，合格率排名（no）--（厉）

请求参数：开始日期，结束日期，是否倒序（1：倒序，2：升序）

结果：

（6）各类型检查任务数量和占比（yes）--（段）

接口地址:/interface4ext/supervision/inspectionStatement/getInspectionTaskCount
请求方式:POST
请求参数: 无
返回结果:

中文名字段名类型备注

状态码 code int 200:成功，其他:错误

成功/错误消息 msg string

结果集 data 对象
rows 结果集

字段名含义类型备注

taskCount 各类型任务数量 Long

taskFlagName 计划类型名称字符串

字段名	含义	类型	备注
taskCount	各类型任务数量	Long
taskFlagName	计划类型名称	字符串

{

"msg": "操作成功",
"code": 200,
"data": [
    {
        "searchValue": null,
        "createBy": null,
        "createByUser": null,
        "createByNickName": null,
        "deptIdOfCreateBy": null,
        "deptNameOfCreateBy": null,
        "deptAncestorOfCreateBy": null,
        "deptAncestorsNamesOfCreateBy": null,
        "createTime": null,
        "updateBy": null,
        "updateTime": null,
        "remark": null,
        "ccedList": null,
        "sysAttachmentList": null,
        "params": {},
        "id": null,
        "delFlag": null,
        "taskTitle": null,
        "taskContent": null,
        "taskStartTime": null,
        "taskEndTime": null,
        "taskFlag": "0",
        "publishFlag": null,
        "taskUserId": null,
        "taskUserName": null,
        "extDeptIds": null,
        "extDeptNames": null,
        "attachmentIds": null,
        "taskCount": 5,
        "taskId": "1001,1003,1004",
        "taskFlagName": "周计划"
    },
    ......
]

}

（7）外勤检查人员，一段时间内，在岗、不在岗数量统计（no）--（纪）

是否在岗，不好做，很难做，我们就不做了。

只统计每日，外勤检查人员总数，和有检查单的人数。

请求参数：开始日期，结束日期

结果：日期，外勤人员总数，检查人员（当天有检查单的）数量

结果集里面，日期不要求连续，就统计检查单表里面的创建日期。

1121-服务监督模块-大屏展示-接口设计.md 29 KB Историја Датотека

服务监督模块，大屏展示-接口设计

大屏尺寸

效果图

接口设计

基础数据

（1）数据字典 （ok）

（2）诉求来源列表（ok）

（3）诉求类型列表（ok）

服务监督模块

（1）各诉求来源，某诉求类型一段时间内，诉求件数统计 （yes） ------（段）

（2）各诉求类型，一段时间内，诉求件数统计（no）--（厉）

（3）诉求对象按年龄段，统计一段时间内，诉求件数和占比（yes）--（李）

（4）诉求总览（一段时间内）（yes）--（李）

（5）诉求办理进展（ok）--（纪）

（6）各单位，某诉求类别，一段时间内，各诉求类别办理诉求件数（no）--（厉）

（7）各单位一段时间内，主办和协办诉求件数排名，根据总数排名（no）--（厉）

（8）各责任单位一段时间内，涉及诉求件数排名（ok）--（纪）

（9）各责任线路，一段时间内，某诉求类型，涉及诉求件数排名（yes）--（段）

外勤检查模块

（1）检查任务总览（yes）--（李）

（2）检查单总览（yes）--（李）

（3）各整改单位、一段时间内、主办和协办整改的数量排名（正序、倒序）（no）--（纪）

（4）被检查单位，一段时间内，检查任务和检查单数量汇总排名（no）--（纪）

（5）被检查单位，一段时间内，合格率排名（no）--（厉）

（6）各类型检查任务数量和占比（yes）--（段）

（7）外勤检查人员，一段时间内，在岗、不在岗数量统计（no）--（纪）

1121-服务监督模块-大屏展示-接口设计.md 29 KB

Историја Датотека

（1）数据字典（ok）

（1）各诉求来源，某诉求类型一段时间内，诉求件数统计（yes） ------（段）