1121-服务监督模块-大屏展示-接口设计.md 8.9 KB
服务监督模块，大屏展示-接口设计
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
（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）各诉求来源，某诉求类型一段时间内，诉求件数统计 （no） ------（段）
参数：诉求类型字典号，开始日期，结束日期
结果：来源id，来源名称，诉求件数（int），占比（字符串，比如 25%）
注意点：所有来源的占比，加起来 = 100%
（2）各诉求类型，一段时间内，诉求件数统计（no）--（厉）
参数：开始日期，结束日期
结果：诉求类型字典代码，诉求类型名称，诉求件数，占比（字符串，比如：12%）
注意：所有占比加起来必须=100%
（3）诉求对象按年龄段，统计一段时间内，诉求件数和占比（no）--（李）
参数：开始日期，结束日期
结果：年龄区间（比如 30以内，30-40,40-50,50-60,60-70,70以上），诉求件数，占比
占比总和必须=100%
（4）诉求总览（一段时间内）（no）--（李）
请求参数：开始日期，结束日期
结果：总件数，已办件数，待处理件数，执行分配中件数，
本月环比（小数，精度3）考虑一下环比的计算公式，是否会出现正负，若有，正负，前端怎么表现？
满意度（0-1的小时，精度3，比如0.985 最后显示的是98.5%），按时办结率（小时，精度3），
咨询类-平均处理时长-值（小数，精度3），咨询类-平均处理时长-单位（1：小时，2：分钟，3：工作日）
非咨询类-平均处理时长-值（小数，精度3），非咨询类-平均处理时长-单位（1：小时，2：分钟，3：工作日）
（5）诉求办理进展（no）--（纪）
请求参数：开始日期，结束日期
结果：
（6）各单位，某诉求类别，一段时间内，各诉求类别办理诉求件数（no）--（厉）
请求参数：开始日期，结束日期，诉求类别，
结果：部门id，部门名称，各个诉求类型分别数量
（7）各单位一段时间内，主办和协办诉求件数排名，根据总数排名（no）--（厉）
请求参数：开始日期，结束日期，诉求类型，诉求来源
结果：部门id，部门名称，主办件数，协办件数，总件数
（8）各责任单位一段时间内，涉及诉求件数排名（no）--（纪）
请求参数：开始日期，结束日期，诉求类型，诉求来源
结果：责任部门id，责任部门名称，涉及诉求件数总数
（9）各责任线路，一段时间内，某诉求类型，涉及诉求件数排名（no）--（段）
请求参数：开始日期，结束日期，诉求类型，诉求来源
结果：名次，线路code，线路名称，诉求件数
根据名次倒序
外勤检查模块
（1）检查任务总览（no）--（李）
请求参数：开始日期，结束日期
结果：任务总数，未发布任务数，有检查单的任务数， 没有检查单的任务数，已关闭任务数，进行中的（已发布，未关闭）任务数
（2）检查单总览（no）--（李）
请求参数：开始日期，结束日期
结果：检查单位总数，已结束的检查单总数，有不合格的检查单数，整改中的检查单数量，已整改的检查单数量，已结束的检查单数量
（3）各整改单位、一段时间内、主办和协办整改的数量排名（正序、倒序）（no）--（纪）
请求参数：开始日期，结束日期，是否倒序（1：倒序，2：升序）
结果：
（4）被检查单位，一段时间内，检查任务和检查单数量汇总排名（no）--（纪）
设计图上：右侧，每日诉求汇总 （标题写错了）
请求参数：开始日期，结束日期，是否倒序（1：倒序，2：升序），排序字段标识（1：检查任务数量，2：检查单数量）
结果：
（5）被检查单位，一段时间内，合格率排名（no）--（厉）
请求参数：开始日期，结束日期，是否倒序（1：倒序，2：升序）
结果：
（6）各类型检查任务数量和占比（no）--（段）
（7）外勤检查人员，一段时间内，在岗、不在岗数量统计（no）--（纪）
是否在岗，不好做，很难做，我们就不做了。
只统计每日，外勤检查人员总数，和有检查单的人数。
请求参数：开始日期，结束日期
结果：日期，外勤人员总数，检查人员（当天有检查单的）数量
结果集里面，日期不要求连续，就统计检查单表里面的创建日期。