|
|
@@ -0,0 +1,295 @@
|
|
|
+# 服务监督模块，大屏展示-接口设计
|
|
|
+
|
|
|
+> 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）--（纪）
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+是否在岗，不好做，很难做，我们就不做了。
|
|
|
+
|
|
|
+只统计每日，外勤检查人员总数，和有检查单的人数。
|
|
|
+
|
|
|
+请求参数：开始日期，结束日期
|
|
|
+
|
|
|
+结果：日期，外勤人员总数，检查人员（当天有检查单的）数量
|
|
|
+
|
|
|
+结果集里面，日期不要求连续，就统计检查单表里面的创建日期。
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
