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