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

- 请求参数
`无`

- 返回示例
```json
{
    "code": 200,
    "success": true,
    "data": [
        {
            "id": "1666702140550336513",
            "account": "srmfy",
            "name": "市法院",
            "realName": "市法院"
        },
        {
            "id": "1666740731569688578",
            "account": "sjdl",
            "name": "市级导览员",
            "realName": "市级导览员"
        }
    ],
    "msg": "操作成功"
}
```

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

- 请求参数
`无`

- 返回示例
```json
{
    "code": 200,
    "success": true,
    "data": [
        {
            "id": "1666700063321280514",
            "dictValue": "其他事项",
            "isSealed": 0 // 是否被使用, 0:否, 1:是
        },
        {
            "id": "1666626705640546306",
            "dictValue": "婚恋家庭纠纷",
            "isSealed": 0
        }
    ],
    "msg": "操作成功"
}
```

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

- 请求参数
`无`

- 返回示例
```json
{
    "code": 200,
    "success": true,
    "data": [
        {
            "id": "1666632074840399874",
            "dictValue": "阜安街道"
        },
        {
            "id": "1666697016771792897",
            "dictValue": "洋河街道"
        }
    ],
    "msg": "操作成功"
}
```

# 诉求类型管理

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

- 请求参数

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

- 返回示例
```json
{
	"code": 200,
	"success": true,
	"data": [
		{
			"swId": "1666702666826436610",
			"swName": "市卫健局",
			"disputeIds": "1666699928344383490,1666629875083141122,1666697888226529282,1666697948918108162",
			"disputeNames": "残疾人权益保障,劳动、社保纠纷,房产物业纠纷,涉法涉诉纠纷",
			"status": 1
		}
	],
	"msg": "操作成功"
}
```

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

- 请求参数

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

- 返回示例
```json
{
	"code": 200,
	"success": true,
	"data": {
		"swId": "1666702666826436610",
		"swName": "市卫健局",
		"disputeIds": "1666699928344383490,1666629875083141122,1666697888226529282,1666697948918108162",
		"disputeNames": "残疾人权益保障,劳动、社保纠纷,房产物业纠纷,涉法涉诉纠纷",
		"status": 1
	},
	"msg": "操作成功"
}
```

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

- 请求参数

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

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

### 4. 删除
- 请求地址
`POST` `/blade-business/serverDisputeConf/delete`

- 请求参数

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

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

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

- 请求参数

|参数名称|参数类型|允许为空|参数说明|
| ---- | ---- | ---- | ---- |
| swId | long | N | 服务窗口ID |
| disputeIds | string | N | 纠纷id, 多个以逗号分割 |
| status | int | N | 启用状态, 0:禁用, 1:启用 |

- 请求示例
```json
{
	"swId": "1646019847",
	"disputeIds": "123321,12341,5345",
	"status": "1"
}
```

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

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

- 请求参数

|参数名称|参数类型|允许为空|参数说明|
| ---- | ---- | ---- | ---- |
| 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": 4,
            "username": "赵文婷",
            "cardno": "37234635323******",
            "disputeName": "婚恋家庭纠纷",
            "firstRegTime": "2023-04-27 00:00:00",
            "finishTime": "2023-04-27 00:00:00",
            "problemDesc": "咨询独生子女费相关问题。",
            "status": 3
        },
        {
            "id": 1,
            "username": "庄培燕",
            "cardno": "37234635323******",
            "disputeName": "损害赔偿纠纷",
            "firstRegTime": "2023-03-01 00:00:00",
            "finishTime": "",
            "problemDesc": "来访者为七旬赵大姨，因为村委长期拖欠农民征用口粮地补偿款前来信访，谈话过程中一度情绪崩溃大哭， 经调解员安抚至情绪缓和后离开咨询室。",
            "status": 1
        }
    ],
    "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": {
		"appealId": 1,
		"visitors": [
			{
				"id": "1",
				"createUser": -1,
				"createDept": -1,
				"createTime": "",
				"updateUser": -1,
				"updateTime": "",
				"status": -1,
				"isDeleted": 0,
				"appealId": 1,
				"appealRegId": 1,
				"username": "庄培燕",
				"gender": "女",
				"age": 25,
				"cardno": "37234635323451345",
				"address": "大相家村",
				"addressNow": "",
				"phone": "13566457424",
				"sort": 1
			}
		],
		"personNum": -1,
		"streetId": "1666697016771792897",
		"disputeId": "1666697784342007809",
		"disputeName": "损害赔偿纠纷",
		"disposeDept": "",
		"disposeDeptName": "",
		"protocol": "无",
		"opinion": "无",
		"reviewOpinion": "无",
		"legalPaper": "无",
		"firstRegTime": "2023-03-01 00:00:00",
		"problemDesc": "来访者为七旬赵大姨，因为村委长期拖欠农民征用口粮地补偿款前来信访，谈话过程中一度情绪崩溃大哭， 经调解员安抚至情绪缓和后离开咨询室。"
	},
	"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
{
	"appealId": null,
	"visitors": [
		{
			"appealId": 1,
			"appealRegId": 1,
			"username": "庄培燕",
			"gender": "女",
			"age": 25,
			"cardno": "37234635323451345",
			"address": "大相家村",
			"addressNow": "",
			"phone": "13566457424",
			"sort": 1
		}
	],
	"personNum": -1,
	"streetId": "1666697016771792897",
	"disputeId": "1666697784342007809",
	"disputeName": "损害赔偿纠纷",
	"disposeDept": "",
	"disposeDeptName": "",
	"protocol": "无",
	"opinion": "无",
	"reviewOpinion": "无",
	"legalPaper": "无",
	"firstRegTime": "2023-03-02 00:00:00",
	"problemDesc": "来访者为"
}
```

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

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

`GET` `/blade-business/appealMediate/getMediateList`

- 请求参数

|参数名称|参数类型|允许为空|参数说明|
| ---- | ---- | ---- | ---- |
| 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`

- 请求参数

`无`

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