mediation-platform/doc/api.md

# 公共接口
### 1. 窗口列表
- 请求地址
`GET` `/blade-system/dict/common/getServerWindowList`

- 请求参数
`无`

- 返回示例
```json
{
    "code": 200,
    "success": true,
    "data": [
        {
            "id": "1666625605998895105",
            "name": "信访办"
        }
    ],
    "msg": "操作成功"
}
```

### 2. 所有诉求类型列表
- 请求地址
`GET` `/blade-system/dict/common/getDisputeList`

- 请求参数
`无`

- 返回示例
```json
{
    "code": 200,
    "success": true,
    "data": [
        {
            "id": "1666625605998895105",
            "name": "法律咨询",
            "is_link": 0
        },{
            "id": "166662560599889515",
            "name": "邻里纠纷",
            "is_link": 1
        }
    ],
    "msg": "操作成功"
}
```

### 3. 街道列表
- 请求地址
`GET` `/blade-system/dict/common/getStreetList`

- 请求参数
`无`

- 返回示例
```json
{
    "code": 200,
    "success": true,
    "data": [
        {
            "id": "1666625605998895105",
            "name": "胶西街道"
        },{
            "id": "166662560599889515",
            "name": "洋河镇"
        }
    ],
    "msg": "操作成功"
}
```

# 诉求类型管理

### 1. 列表
- 请求地址
`GET` `/blade-business/serverDsiputeConf/getList`

- 请求参数

|参数名称|参数类型|允许为空|参数说明|
| ---- | ---- | ---- | ---- |
|serverWindowId| long | N | 窗口ID |

- 返回示例
```json
{
    "code": 200,
    "success": true,
    "data": [
        {
            "id": "1666625605998895105",
            "serverWindowName": "市交通局",
            "disputeNames": "交通事故,道路纠纷",
            "status": 1
        },{
            "id": "166662560599889515",
            "serverWindowName": "市住建局",
            "disputeNames": "地界线因发争执",
            "status": 1
        }
    ],
    "msg": "操作成功"
}
```

### 2. 禁用/启用
- 请求地址
`POST` `/blade-business/serverDsiputeConf/enable`

- 请求参数

|参数名称|参数类型|允许为空|参数说明|
| ---- | ---- | ---- | ---- |
| id | long | N | 关联记录ID |

- 返回示例
```json
{
    "code": 200,
    "success": true,
    "data": "",
    "msg": "操作成功"
}
```

### 3. 删除
- 请求地址
`POST` `/blade-business/serverDsiputeConf/delete`

- 请求参数

|参数名称|参数类型|允许为空|参数说明|
| ---- | ---- | ---- | ---- |
| id | long | N | 关联记录ID |

- 返回示例
```json
{
    "code": 200,
    "success": true,
    "data": "",
    "msg": "操作成功"
}
```

### 4. 获取根据id获取详情
- 请求地址
`GET` `/blade-business/serverDsiputeConf/detail`

- 请求参数

|参数名称|参数类型|允许为空|参数说明|
| ---- | ---- | ---- | ---- |
| id | long | N | 关联记录ID |

- 返回示例
```json
{
    "code": 200,
    "success": true,
    "data": {
        "id": "1666625605998895105",
        "serverWindowId": "1666625235998895105",
        "serverWindowName": "市交通局",
        "disputeIds": "1666625605998898705,1666625605998894105",
        "disputeNames": "交通事故,道路纠纷",
        "status": 1
     },
    "msg": "操作成功"
}
```

### 5. 保存
- 请求地址
`POST` `/blade-business/serverDsiputeConf/save`

- 请求参数

|参数名称|参数类型|允许为空|参数说明|
| ---- | ---- | ---- | ---- |
| id | long | N | 关联记录ID |
| serverWindowId | long | N | 服务窗口ID |
| disputeIds | string | N | 纠纷id, 多个以逗号分割 |

- 返回示例
```json
{
    "code": 200,
    "success": true,
    "data": "",
    "msg": "操作成功"
}
```

# 诉求登记
### 1. 列表
- 请求地址
`GET` `/blade-business/appealReg/list`

- 请求参数

|参数名称|参数类型|允许为空|参数说明|
| ---- | ---- | ---- | ---- |
| appealStatus | string | N | 诉求状态 |
| startTime | string | N | 登记时间-结束 |
| endTime | string | N | 登记时间-开始 |
| appealType | string | N | 诉求类型 |
| windowId | string | N | 处理窗口ID |
| username | string | N | 代表姓名 |

- 返回示例
```json
{
    "code": 200,
    "success": true,
    "data": [
      {
        "id": "122555646684684",
        "appealUsernames": "张三(身份证号),李四(身份证号)",
        "disputeName": "土地纠纷",
        "firstRegTime": "2012-05-15 12:30",
        "finishTime": "",
        "problemDesc": "矛盾描述...........",
        "status": 0
      }     
    ],
    "msg": "操作成功"
}
```

### 2 导出诉求列表
- 请求地址
`GET` `/blade-business/appealReg/export`

- 请求参数

|参数名称|参数类型|允许为空|参数说明|
| ---- | ---- | ---- | ---- |
| appealStatus | string | N | 诉求状态 |
| startTime | string | N | 登记时间-结束 |
| endTime | string | N | 登记时间-开始 |
| appealType | string | N | 诉求类型 |
| windowId | string | N | 处理窗口ID |
| username | string | N | 代表姓名 |

### 3. 根据id获取诉求信息, 上一次调解记录(点击"再次调解")
- 请求地址
`GET` `/blade-business/appealReg/getById`

- 请求参数

|参数名称|参数类型|允许为空|参数说明|
| ---- | ---- | ---- | ---- |
| appealId | long | N | 诉求id |

- 返回示例
```json
{
    "code": 200,
    "success": true,
    "data": [
      {
        "id": "122555646684684",
        "streetName": "胶州市",
        "disputeName": "土地纠纷",
        "disposeDept": "市住建局",
        "hasProtocol": "无协议书",
        "hasOpinion": "无处理意见",
        "hasReviewOpinion": "无复查意见",
        "legalPaper": "无法律文书",
        "regTime": "2012-05-15 12:30",
        "problemDesc": "矛盾描述...........",
        "visitorList": [
            {
                "id": 1546486176165,
                "username": "张三",
                "gender": 1,
                "age": 32,
                "cardno": "3708821548488178",
                "address": "洋河镇",
                "addressNow": "洋河镇",
                "phone": "13564854126"
            }     
        ]     
      }     
    ],
    "msg": "操作成功"
}
```

### 4. 保存诉求登记
- 请求地址
`POST` `/blade-business/appealReg/save`

- 请求参数

|参数名称|参数类型|允许为空|参数说明|
| ---- | ---- | ---- | ---- |
| appealId | long | N | 诉求ID |
| userList | list | N | 上述人员列表 |
| - username | string | N | 名称 |
| - gender | string | N | 性别 |
| - age | string | N | 年龄 |
| - cardno | string | N | 身份证号 |
| - address | string | N | 地址 |
| - addressNow | string | N | 现住址 |
| - phone | string | N | 联系电话 |
| disposeDept | string | N | 何单位处理过 |
| hasProtocol | string | N | 协议书 |
| hasOpinion | string | N | 处理意见 |
| hasReviewOpinion | string | N | 复查意见 |
| legalPaper | string | N | 法律文书 |
| problemDesc | string | N | 主要问题 |

- 返回示例
```json
{
    "code": 200,
    "success": true,
    "data": "",
    "msg": "操作成功"
}
```

# 诉求调解
### 1. 调解记录列表(点击"调解记录")
- 请求地址

`GET` `/blade-business/appealMediate/getList`

- 请求参数

|参数名称|参数类型|允许为空|参数说明|
| ---- | ---- | ---- | ---- |
| appealId | string | N | 诉求ID |

- 返回示例
```json
{
    "code": 200,
    "success": true,
    "data": [
      {
        "id": "122555646684684",
        "mediateTime": "2012-05-15 12:30",
        "talkingAdvice": "接谈意见..........."
      }     
    ],
    "msg": "操作成功"
}
```

### 2. 根据诉求id获取最新的登记信息及所有调解访谈记录列表(点击"诉求调解")
- 请求地址

`GET` `/blade-business/appealMediate/getNewestReg`

- 请求参数

|参数名称|参数类型|允许为空|参数说明|
| ---- | ---- | ---- | ---- |
| appealId | string | N | 诉求ID |

- 返回示例
```json
{
    "code": 200,
    "success": true,
    "data": [
      {
        "appealId": "诉求ID",
        "appealRegId": "诉求登记ID",
        "streetName": "胶州市",
        "disputeName": "土地纠纷",
        "disposeDept": "市住建局",
        "hasProtocol": "无协议书",
        "hasOpinion": "无处理意见",
        "hasReviewOpinion": "无复查意见",
        "legalPaper": "无法律文书",
        "regTime": "2012-05-15 12:30",
        "problemDesc": "矛盾描述...........",
        "talkingAdviceList": [
            {
                "id": "调解记录id",
                "talkingTime": "2022-06-03 12:05",
                "talkingHis": "第一次接谈意见..........."
            },{
                "id": "调解记录id",
                "talkingTime": "2022-06-02 10:05",
                "talkingHis": "第二次接谈意见..........."
            }
          
        ],
        "userList": [
            {
                "id": 1546486176165,
                "username": "张三",
                "gender": 1,
                "age": 32,
                "cardno": "3708821548488178",
                "address": "洋河镇",
                "addressNow": "洋河镇",
                "phone": "13564854126"
            }     
        ]     
      }     
    ],
    "msg": "操作成功"
}
```


### 3. 根据调解记录id获取详情, 获取 诉求信息, 本次调解记录(参数id指定的调解记录), 所有调解访谈记录列表(带id)
- 请求地址

`GET` `/blade-business/appealMediate/detail`

- 请求参数

|参数名称|参数类型|允许为空|参数说明|
| ---- | ---- | ---- | ---- |
| mediateId | string | N | 调解记录ID |

- 返回示例
```json
{
    "code": 200,
    "success": true,
    "data": [
      {
        "id": "调解记录id",
        "appealId": "诉求ID",
        "appealRegId": "诉求登记ID",
        "streetName": "胶州市",
        "disputeLevel": "事件等级",
        "status": "诉求状态",
        "disputeName": "土地纠纷",
        "disposeDept": "市住建局",
        "hasProtocol": "无协议书",
        "hasOpinion": "无处理意见",
        "hasReviewOpinion": "无复查意见",
        "legalPaper": "无法律文书",
        "regTime": "2012-05-15 12:30",
        "problemDesc": "矛盾描述...........",
        "attitude": "上访人意见",
        "dutyDeptNames": "负责部门名称, 以逗号分割",
        "copyDeptNames": "抄送部门名称, 以逗号分割",
        "feedbackDeadline": "2022-12-02",
        "finishDeadline": "2022-12-02",
        "remark": "备注",
        "submitTime": "2022-08-19",
        "talkingAdviceList": [
            {
                "id": "调解记录id",
                "talkingTime": "2022-06-03 12:05",
                "talkingHis": "第一次接谈意见..........."
            },{
                "id": "调解记录id",
                "talkingTime": "2022-06-02 10:05",
                "talkingHis": "第二次接谈意见..........."
            }  
          
        ],
        "userList": [
            {
                "id": 1546486176165,
                "username": "张三",
                "gender": 1,
                "age": 32,
                "cardno": "3708821548488178",
                "address": "洋河镇",
                "addressNow": "洋河镇",
                "phone": "13564854126"
            }     
        ]     
      }     
    ],
    "msg": "操作成功"
}
```

### 4. 保存调解记录
- 请求地址

`POST` `/blade-business/appealMediate/save`

- 请求参数

|参数名称|参数类型|允许为空|参数说明|
| ---- | ---- | ---- | ---- |
| appealId | String | N | 诉求id |
| appealRegId | String | N | 诉求登记ID |
| disposeDept | string | N | 何单位处理过 |
| hasProtocol | string | N | 协议书 |
| hasOpinion | string | N | 处理意见 |
| hasReviewOpinion | string | N | 复查意见 |
| legalPaper | string | N | 法律文书 |
| problemDesc | string | N | 主要问题 |
| attitude | String | N | 上访人意见 |
| talkingTime | String | N | 接谈时间 | 
| talkingHis | String | N | 接谈记录 | 
| talkingAdvice | String | N | 接谈意见 | 
| disputeLevel | String | N | 事件等级 |
| status | String | N | 诉求状态 |
| dutyDeptIds | String | N | 负责部门ID, 以逗号分割 |
| copyDeptIds | String | N | 抄送部门ID, 以逗号分割 |
| feedbackDeadline | String | N | 反馈时限 |
| finishDeadline | String | N | 办结时限 |
| remark | String | N | 备注 |
| visitTime | String | N | 来访时间 |
| submitTime | String | N | 提交时间 |
| fileList | list | N | 上传文件列表 |
| - url | list | N | 上传文件路径 |

        
- 返回示例
```json
{
    "code": 200,
    "success": true,
    "data": "",
    "msg": "操作成功"
}
```

### 5. 图片上传接口
- 请求地址

`POST` `/blade-resource/oss/endpoint/put-file`

- 请求参数

|参数名称|参数类型|允许为空|参数说明|
| ---- | ---- | ---- | ---- |
| file | file | N | 要上传的文件 |

- 返回示例
```json
{
    "code": 200,
    "success": true,
    "data": {
        "link": "http://xxxx/file.png",
        "domain": "http:xxx",
        "name": "file.png",
        "originalName": "file"
    },
    "msg": "操作成功"
}
```

# 大屏接口
### 1. 化解统计(本月, 本季, 本年, 全部)
- 请求地址

`GET` `/blade-business/report/getMediateFinish`

- 请求参数

`无`

- 返回示例
```json
{
    "code": 200,
    "success": true,
    "data": {
        "mon": "20",
        "quarterly": "50",
        "year": "200",
        "all": "300"
    },
    "msg": "操作成功"
}
```


### 2. 上报统计(本月, 本季, 本年, 全部)
- 请求地址

`GET` `/blade-business/report/getAppealSubmit`

- 请求参数

`无`

- 返回示例
```json
{
    "code": 200,
    "success": true,
    "data": {
        "mon": "20",
        "quarterly": "50",
        "year": "200",
        "all": "300"
    },
    "msg": "操作成功"
}
```

### 3. 矛盾列表(先展示当天正在处理的, 然后展示以往未办结的)
- 请求地址

`GET` `/blade-business/report/getAppealList`

- 请求参数

`无`

- 返回示例
```json
{
    "code": 200,
    "success": true,
    "data": [
        {
            "disputeName": "矛盾纠纷",
            "street": "洋河镇",
            "firstRegTime": "2022-05-30",
            "statusName": "办结"
        }
    ],
    "msg": "操作成功"
}
```

### 4. 纠纷按月度统计(每月处理的和处理成功的)(近6个月)
- 请求地址

`GET` `/blade-business/report/getAppealByMon`

- 请求参数

`无`

- 返回示例
```json
{
    "code": 200,
    "success": true,
    "data": {
        "dateList": ["一月", "二月", "三月", "四月", "五月", "六月"],
        "handlerCountList": [20, 40, 32, 12, 43, 12],
        "finishContList": [20, 40, 32, 12, 43, 12]
    },
    "msg": "操作成功"
}
```


### 5. 矛盾类型占比(最高的5个, 剩余的归为其他)
- 请求地址

`GET` `/blade-business/report/getAppealTypePercent`

- 请求参数

`无`

- 返回示例
```json
{
    "code": 200,
    "success": true,
    "data": [
        {
            "name": "合同纠纷",
            "value": 20
        },{
            "name": "事故纠纷",
            "value": 24
        }
    ],
    "msg": "操作成功"
}
```


### 6. 按照矛盾发生地统计每个街道的矛盾上报数量, 查询条件:时间段或选择的时间范围
- 请求地址

`GET` `/blade-business/report/getAppealSubmitCountByLoc`

- 请求参数

`无`

- 返回示例
```json
{
    "code": 200,
    "success": true,
    "data":{"胶东":12, "洋河镇":32, "铺集":23},
    "msg": "操作成功"
}
```

### 7. 按照矛盾发生地统计每个街道的矛盾解决数量, 查询条件:时间段或选择的时间范围
- 请求地址

`GET` `/blade-business/report/getAppealFinishCountByLoc`

- 请求参数

|参数名称|参数类型|允许为空|参数说明|
| ---- | ---- | ---- | ---- |
| timeFrame | file | Y | 时段, 1:月, 2:季, 3:年 |
| startTime | string | Y | 查询开始时间 |
| endTime | string | Y | 查询结束时间 |


- 返回示例
```json
{
    "code": 200,
    "success": true,
    "data":{"胶东":12, "洋河镇":32, "铺集":23},
    "msg": "操作成功"
}
```

### 8. 矛盾热点排行(按照解决的矛盾数量, 返回排序后的列表), 查询条件: 部门(市, 镇)
- 请求地址

`GET` `/blade-business/report/getAppealHot`

- 请求参数

|参数名称|参数类型|允许为空|参数说明|
| ---- | ---- | ---- | ---- |
| addressType | String | Y | 上报地分类, 1:镇街, 2:部门, 传空统计全部上报地 |

- 返回示例
```json
{
    "code": 200,
    "success": true,
    "data": [
        {
            "streetName": "洋河镇",
            "num": 20
        },{
            "streetName": "胶东街道",
            "num": 13
        }
    ],
    "msg": "操作成功"
}
```

### 9. 矛盾严重程度占比统计
- 请求地址

`GET` `/blade-business/report/getAppealCountBySeverity`

- 请求参数

`无`

- 返回示例
```json
{
    "code": 200,
    "success": true,
    "data": [
        {
            "disputeLevelName": "简单",
            "percent": 0.58
        },{
            "disputeLevelName": "一般",
            "percent": 0.3
        }
    ],
    "msg": "操作成功"
}
```