# 积分申诉管理



本模块共 21 个接口。源文件：`api.json`。



## 快速索引



| 接口名称 | 方法 | 路径 | 用途 |
| --- | --- | --- | --- |
| 受理申诉 | POST | `/gd_dataserver/business/points/appeal/accept/{id}` | 将申诉状态从待受理(0)改为处理中(1)。返回 data 为 boolean。 |
| 新增 | POST | `/gd_dataserver/business/points/appeal/add` | 新增单条记录，请求体为实体类对象（字段说明见对应实体模型）。成功返回 data 为 null。 |
| 批量新增 | POST | `/gd_dataserver/business/points/appeal/addBatch` | 批量新增多条记录，请求体为实体类数组。成功返回 data 为 null。 |
| 新增并返回保存的数据 | POST | `/gd_dataserver/business/points/appeal/addReturn` | 新增单条记录并返回保存后的数据（含自增ID），请求体为实体类对象。成功返回 data 为保存的实体对象。 |
| 审批申诉流程 | POST | `/gd_dataserver/business/points/appeal/completeFlow` | 审批通过或驳回申诉流程节点。成功返回 data 为 null；失败返回 error 信息。 |
| 根据属性删除 | GET | `/gd_dataserver/business/points/appeal/delete` | 根据实体属性条件删除记录，请求体为实体类对象。成功返回 data 为 null。 |
| 主键删除 | GET | `/gd_dataserver/business/points/appeal/deleteById` | 根据主键ID删除单条记录，成功返回 data 为 null。 |
| 批量删除 | GET | `/gd_dataserver/business/points/appeal/deleteByIds` | 根据ID列表批量删除记录，成功返回 data 为 null。 |
| 获取申诉详情 | GET | `/gd_dataserver/business/points/appeal/detail/{id}` | 返回 data 为 PointsAppeal 对象，包含完整申诉字段及流程进度信息。 |
| 查询所有 | GET | `/gd_dataserver/business/points/appeal/getAll` | 查询所有记录（无分页、无条件）。成功返回 data 为实体类数组。 |
| 分页查询 | GET | `/gd_dataserver/business/points/appeal/getListByPage` | 分页查询记录列表，查询条件为实体类字段。成功返回 data 为 PageInfo 分页对象，其中 list 为实体类数组。 |
| 处理申诉 | POST | `/gd_dataserver/business/points/appeal/handle/{id}` | 通过或驳回申诉，可选调整积分。approved=true时状态改为已通过(2)，approved=false时改为已驳回(3)。adjustPoints为正数补发积分，负数扣减积分，不传则不调整。返回 data 为 boolean。 |
| 详情 | GET | `/gd_dataserver/business/points/appeal/info` | 根据主键ID查询单条记录详情。成功返回 data 为实体类对象，包含该实体所有字段。 |
| 条件查询 | GET | `/gd_dataserver/business/points/appeal/list` | 根据实体属性条件查询记录列表。成功返回 data 为实体类数组。 |
| 查询我的申诉记录（APP端） | GET | `/gd_dataserver/business/points/appeal/myList` | 返回 data 为 PageInfo 分页对象。list 中每条记录为 PointsAppeal 对象，主要字段：id、appealNo-申诉编号、appealType-申诉类型(REJECT/POINTS/OTHER)、status-状态(0待受理/1处理中/2已通过/3已驳回/4已撤回)、statusName-状态名称、handleRemark-处理意见、adjustPoints-调整积分、createTime。 |
| 逻辑删除 | GET | `/gd_dataserver/business/points/appeal/removeById` | 根据主键ID逻辑删除单条记录，成功返回 data 为 null。 |
| 提交申诉（APP端） | POST | `/gd_dataserver/business/points/appeal/submit` | 填写申诉类型、理由等信息，申诉人信息从登录用户获取。返回 data 为 PointsAppeal 对象，包含 id、appealNo-申诉编号、status-状态(0待受理)。 |
| 提交申诉并启动流程（APP端） | POST | `/gd_dataserver/business/points/appeal/submitFlow` | 提交申诉并自动启动 Flowable 审批流程。后端自动解析申诉人所属厂区，按 (厂区, biz_type=appeal) 从 qc_hazard_flow_config 匹配流程Key并带厂区tenantId启动；若该厂区未配置申诉流程则回退到全局默认 appeal.flow.key。申诉人信息、factoryDeptId/factoryDeptName 均由后端自动填充，无需前端传。成功返回 data 为流程实例ID字符串；失败返回 error 信息。 |
| 申诉流程待办列表 | GET | `/gd_dataserver/business/points/appeal/todoList` | 返回 data 为 PageInfo 分页对象。list 中每条记录为 PointsAppeal 对象，包含 id、appealNo、userName、appealType-申诉类型、appealReason-申诉理由、status-状态、createTime。 |
| 修改 | POST | `/gd_dataserver/business/points/appeal/updateById` | 根据主键ID修改记录，请求体为实体类对象（需包含id字段）。成功返回 data 为 null。 |
| 撤回申诉（APP端） | POST | `/gd_dataserver/business/points/appeal/withdraw/{id}` | 仅待受理状态(status=0)可撤回，撤回后状态改为已撤回(4)。返回 data 为 boolean。 |


## 接口详情



### 受理申诉

- **用途：** 将申诉状态从待受理(0)改为处理中(1)。返回 data 为 boolean。
- **请求：** `POST /gd_dataserver/business/points/appeal/accept/{id}`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `acceptAppealUsingPOST`

参数：

| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| id | path | 是 | integer / int64 | 申诉ID | - |

响应：

| 状态码 | 说明 | 响应模型 |
| --- | --- | --- |
| 200 | OK | */*: object<string, object> |
| 201 | Created | - |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |


### 新增

- **用途：** 新增单条记录，请求体为实体类对象（字段说明见对应实体模型）。成功返回 data 为 null。
- **请求：** `POST /gd_dataserver/business/points/appeal/add`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `addOneUsingPOST_9`

参数：

_无_

请求体：

- Content-Type：`application/json`
- 模型：`积分申诉`
- 必填：文档未标记

| 字段 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| adjustPoints | 否 | integer / int32 | 调整积分（正数补发，负数扣减） | - |
| appealNo | 否 | string | 申诉编号 | - |
| appealReason | 否 | string | 申诉理由 | - |
| appealType | 否 | string | 申诉类型：REJECT-审核驳回申诉 POINTS-积分异议 OTHER-其他 | - |
| attachmentUrls | 否 | string | 附件URL（JSON数组） | - |
| canApprove | 否 | boolean | 当前用户是否可审批此流程 | false |
| createTime | 否 | string / date-time | 创建时间 | - |
| factoryDeptId | 否 | string | 所属厂区部门ID | - |
| factoryDeptName | 否 | string | 所属厂区部门名称 | - |
| flowInstanceId | 否 | string | 流程实例ID（预留） | - |
| flowStatus | 否 | integer / int32 | 流程状态：0-无流程 1-进行中 2-已完成 | - |
| handleRemark | 否 | string | 处理意见/结果说明 | - |
| handleTime | 否 | string / date-time | 处理时间 | - |
| handleUserId | 否 | integer / int64 | 处理人用户ID | - |
| handleUserName | 否 | string | 处理人姓名 | - |
| id | 否 | integer / int64 | 主键ID | - |
| isInitiator | 否 | boolean | 当前用户是否为此流程发起人 | false |
| reportId | 否 | integer / int64 | 关联隐患上报ID | - |
| reportNo | 否 | string | 关联隐患编号 | - |
| status | 否 | string | 申诉状态：0-待受理 1-处理中 2-已通过 3-已驳回 4-已撤回 | - |
| statusName | 否 | string | 申诉状态名称 | - |
| updateTime | 否 | string / date-time | 更新时间 | - |
| userId | 否 | integer / int64 | 申诉人用户ID | - |
| userName | 否 | string | 申诉人姓名 | - |


响应：

| 状态码 | 说明 | 响应模型 |
| --- | --- | --- |
| 200 | OK | */*: object<string, object> |
| 201 | Created | - |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |


### 批量新增

- **用途：** 批量新增多条记录，请求体为实体类数组。成功返回 data 为 null。
- **请求：** `POST /gd_dataserver/business/points/appeal/addBatch`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `addBatchUsingPOST_9`

参数：

_无_

请求体：

- Content-Type：`application/json`
- 模型：`array<积分申诉>`
- 必填：文档未标记

响应：

| 状态码 | 说明 | 响应模型 |
| --- | --- | --- |
| 200 | OK | */*: object<string, object> |
| 201 | Created | - |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |


### 新增并返回保存的数据

- **用途：** 新增单条记录并返回保存后的数据（含自增ID），请求体为实体类对象。成功返回 data 为保存的实体对象。
- **请求：** `POST /gd_dataserver/business/points/appeal/addReturn`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `addReturnUsingPOST_9`

参数：

_无_

请求体：

- Content-Type：`application/json`
- 模型：`积分申诉`
- 必填：文档未标记

| 字段 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| adjustPoints | 否 | integer / int32 | 调整积分（正数补发，负数扣减） | - |
| appealNo | 否 | string | 申诉编号 | - |
| appealReason | 否 | string | 申诉理由 | - |
| appealType | 否 | string | 申诉类型：REJECT-审核驳回申诉 POINTS-积分异议 OTHER-其他 | - |
| attachmentUrls | 否 | string | 附件URL（JSON数组） | - |
| canApprove | 否 | boolean | 当前用户是否可审批此流程 | false |
| createTime | 否 | string / date-time | 创建时间 | - |
| factoryDeptId | 否 | string | 所属厂区部门ID | - |
| factoryDeptName | 否 | string | 所属厂区部门名称 | - |
| flowInstanceId | 否 | string | 流程实例ID（预留） | - |
| flowStatus | 否 | integer / int32 | 流程状态：0-无流程 1-进行中 2-已完成 | - |
| handleRemark | 否 | string | 处理意见/结果说明 | - |
| handleTime | 否 | string / date-time | 处理时间 | - |
| handleUserId | 否 | integer / int64 | 处理人用户ID | - |
| handleUserName | 否 | string | 处理人姓名 | - |
| id | 否 | integer / int64 | 主键ID | - |
| isInitiator | 否 | boolean | 当前用户是否为此流程发起人 | false |
| reportId | 否 | integer / int64 | 关联隐患上报ID | - |
| reportNo | 否 | string | 关联隐患编号 | - |
| status | 否 | string | 申诉状态：0-待受理 1-处理中 2-已通过 3-已驳回 4-已撤回 | - |
| statusName | 否 | string | 申诉状态名称 | - |
| updateTime | 否 | string / date-time | 更新时间 | - |
| userId | 否 | integer / int64 | 申诉人用户ID | - |
| userName | 否 | string | 申诉人姓名 | - |


响应：

| 状态码 | 说明 | 响应模型 |
| --- | --- | --- |
| 200 | OK | */*: object<string, object> |
| 201 | Created | - |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |


### 审批申诉流程

- **用途：** 审批通过或驳回申诉流程节点。成功返回 data 为 null；失败返回 error 信息。
- **请求：** `POST /gd_dataserver/business/points/appeal/completeFlow`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `completeFlowUsingPOST`

参数：

_无_

请求体：

- Content-Type：`application/json`
- 模型：`工作流签字任务相关--请求参数`
- 必填：文档未标记

| 字段 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| assignee | 否 | string | 审批人 | - |
| candidateGroups | 否 | array<string> | 审批组 | - |
| candidateUsers | 否 | array<string> | 候选人 | - |
| comment | 否 | string | 任务意见 | - |
| currentChildExecutionId | 否 | string | 子执行流ID | - |
| defId | 否 | string | 流程环节定义ID | - |
| deploymentId | 否 | string | 部署ID | - |
| file | 否 | string | 拍照 | - |
| flag | 否 | boolean | 子执行流是否已执行 | false |
| instanceId | 否 | string | 流程实例Id | - |
| qz | 否 | string | 任务签字 | - |
| result | 否 | string | 任务审批结果 1-同意 2-退回 | - |
| targetKey | 否 | string | 节点 | - |
| taskId | 否 | string | 任务Id | - |
| taskName | 否 | string | 任务名称 | - |
| type | 否 | string | 业务类型 | - |
| userId | 否 | string | 用户Id | - |
| userName | 否 | string | 用户名称 | - |
| variables | 否 | object | 流程变量信息 | - |
| zyxkid | 否 | string | 作业许可Id | - |


响应：

| 状态码 | 说明 | 响应模型 |
| --- | --- | --- |
| 200 | OK | */*: object<string, object> |
| 201 | Created | - |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |


### 根据属性删除

- **用途：** 根据实体属性条件删除记录，请求体为实体类对象。成功返回 data 为 null。
- **请求：** `GET /gd_dataserver/business/points/appeal/delete`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `deleteUsingGET_9`

参数：

| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| adjustPoints | query | 否 | integer / int32 | 调整积分（正数补发，负数扣减） | - |
| appealNo | query | 否 | string | 申诉编号 | - |
| appealReason | query | 否 | string | 申诉理由 | - |
| appealType | query | 否 | string | 申诉类型：REJECT-审核驳回申诉 POINTS-积分异议 OTHER-其他 | - |
| attachmentUrls | query | 否 | string | 附件URL（JSON数组） | - |
| canApprove | query | 否 | boolean | 当前用户是否可审批此流程 | - |
| createTime | query | 否 | string / date-time | 创建时间 | - |
| factoryDeptId | query | 否 | string | 所属厂区部门ID | - |
| factoryDeptName | query | 否 | string | 所属厂区部门名称 | - |
| flowInstanceId | query | 否 | string | 流程实例ID（预留） | - |
| flowStatus | query | 否 | integer / int32 | 流程状态：0-无流程 1-进行中 2-已完成 | - |
| handleRemark | query | 否 | string | 处理意见/结果说明 | - |
| handleTime | query | 否 | string / date-time | 处理时间 | - |
| handleUserId | query | 否 | integer / int64 | 处理人用户ID | - |
| handleUserName | query | 否 | string | 处理人姓名 | - |
| id | query | 否 | integer / int64 | 主键ID | - |
| isInitiator | query | 否 | boolean | 当前用户是否为此流程发起人 | - |
| reportId | query | 否 | integer / int64 | 关联隐患上报ID | - |
| reportNo | query | 否 | string | 关联隐患编号 | - |
| status | query | 否 | string | 申诉状态：0-待受理 1-处理中 2-已通过 3-已驳回 4-已撤回 | - |
| statusName | query | 否 | string | 申诉状态名称 | - |
| updateTime | query | 否 | string / date-time | 更新时间 | - |
| userId | query | 否 | integer / int64 | 申诉人用户ID | - |
| userName | query | 否 | string | 申诉人姓名 | - |

响应：

| 状态码 | 说明 | 响应模型 |
| --- | --- | --- |
| 200 | OK | */*: object<string, object> |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |


### 主键删除

- **用途：** 根据主键ID删除单条记录，成功返回 data 为 null。
- **请求：** `GET /gd_dataserver/business/points/appeal/deleteById`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `deleteOneUsingGET_9`

参数：

| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| id | query | 是 | string | 主键ID | - |

响应：

| 状态码 | 说明 | 响应模型 |
| --- | --- | --- |
| 200 | OK | */*: object<string, object> |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |


### 批量删除

- **用途：** 根据ID列表批量删除记录，成功返回 data 为 null。
- **请求：** `GET /gd_dataserver/business/points/appeal/deleteByIds`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `deleteListUsingGET_19`

参数：

| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| ids | query | 是 | string | ID列表(逗号分隔) | - |

响应：

| 状态码 | 说明 | 响应模型 |
| --- | --- | --- |
| 200 | OK | */*: object<string, object> |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |


### 获取申诉详情

- **用途：** 返回 data 为 PointsAppeal 对象，包含完整申诉字段及流程进度信息。
- **请求：** `GET /gd_dataserver/business/points/appeal/detail/{id}`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `getDetailUsingGET`

参数：

| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| id | path | 是 | integer / int64 | 申诉ID | - |

响应：

| 状态码 | 说明 | 响应模型 |
| --- | --- | --- |
| 200 | OK | */*: object<string, object> |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |


### 查询所有

- **用途：** 查询所有记录（无分页、无条件）。成功返回 data 为实体类数组。
- **请求：** `GET /gd_dataserver/business/points/appeal/getAll`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `getAllUsingGET_9`

参数：

_无_

响应：

| 状态码 | 说明 | 响应模型 |
| --- | --- | --- |
| 200 | OK | */*: object<string, object> |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |


### 分页查询

- **用途：** 分页查询记录列表，查询条件为实体类字段。成功返回 data 为 PageInfo 分页对象，其中 list 为实体类数组。
- **请求：** `GET /gd_dataserver/business/points/appeal/getListByPage`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `getListByPageUsingGET_9`

参数：

| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| adjustPoints | query | 否 | integer / int32 | 调整积分（正数补发，负数扣减） | - |
| appealNo | query | 否 | string | 申诉编号 | - |
| appealReason | query | 否 | string | 申诉理由 | - |
| appealType | query | 否 | string | 申诉类型：REJECT-审核驳回申诉 POINTS-积分异议 OTHER-其他 | - |
| attachmentUrls | query | 否 | string | 附件URL（JSON数组） | - |
| canApprove | query | 否 | boolean | 当前用户是否可审批此流程 | - |
| createTime | query | 否 | string / date-time | 创建时间 | - |
| factoryDeptId | query | 否 | string | 所属厂区部门ID | - |
| factoryDeptName | query | 否 | string | 所属厂区部门名称 | - |
| flowInstanceId | query | 否 | string | 流程实例ID（预留） | - |
| flowStatus | query | 否 | integer / int32 | 流程状态：0-无流程 1-进行中 2-已完成 | - |
| handleRemark | query | 否 | string | 处理意见/结果说明 | - |
| handleTime | query | 否 | string / date-time | 处理时间 | - |
| handleUserId | query | 否 | integer / int64 | 处理人用户ID | - |
| handleUserName | query | 否 | string | 处理人姓名 | - |
| id | query | 否 | integer / int64 | 主键ID | - |
| isInitiator | query | 否 | boolean | 当前用户是否为此流程发起人 | - |
| pageNum | query | 是 | integer / int32 | 页码 | - |
| reportId | query | 否 | integer / int64 | 关联隐患上报ID | - |
| reportNo | query | 否 | string | 关联隐患编号 | - |
| status | query | 否 | string | 申诉状态：0-待受理 1-处理中 2-已通过 3-已驳回 4-已撤回 | - |
| statusName | query | 否 | string | 申诉状态名称 | - |
| updateTime | query | 否 | string / date-time | 更新时间 | - |
| userId | query | 否 | integer / int64 | 申诉人用户ID | - |
| userName | query | 否 | string | 申诉人姓名 | - |
| pageSize | query | 是 | integer / int32 | 每页条数 | - |

响应：

| 状态码 | 说明 | 响应模型 |
| --- | --- | --- |
| 200 | OK | */*: object<string, object> |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |


### 处理申诉

- **用途：** 通过或驳回申诉，可选调整积分。approved=true时状态改为已通过(2)，approved=false时改为已驳回(3)。adjustPoints为正数补发积分，负数扣减积分，不传则不调整。返回 data 为 boolean。
- **请求：** `POST /gd_dataserver/business/points/appeal/handle/{id}`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `handleAppealUsingPOST`

参数：

| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| id | path | 是 | integer / int64 | 申诉ID | - |
| approved | query | 是 | boolean | 是否通过 | - |
| handleRemark | query | 是 | string | 处理意见 | - |
| adjustPoints | query | 否 | integer / int32 | 调整积分（正数补发，负数扣减，不传则不调整） | - |

响应：

| 状态码 | 说明 | 响应模型 |
| --- | --- | --- |
| 200 | OK | */*: object<string, object> |
| 201 | Created | - |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |


### 详情

- **用途：** 根据主键ID查询单条记录详情。成功返回 data 为实体类对象，包含该实体所有字段。
- **请求：** `GET /gd_dataserver/business/points/appeal/info`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `infoUsingGET_9`

参数：

| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| id | query | 是 | string | 主键ID | - |

响应：

| 状态码 | 说明 | 响应模型 |
| --- | --- | --- |
| 200 | OK | */*: object<string, object> |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |


### 条件查询

- **用途：** 根据实体属性条件查询记录列表。成功返回 data 为实体类数组。
- **请求：** `GET /gd_dataserver/business/points/appeal/list`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `getListUsingGET_9`

参数：

| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| adjustPoints | query | 否 | integer / int32 | 调整积分（正数补发，负数扣减） | - |
| appealNo | query | 否 | string | 申诉编号 | - |
| appealReason | query | 否 | string | 申诉理由 | - |
| appealType | query | 否 | string | 申诉类型：REJECT-审核驳回申诉 POINTS-积分异议 OTHER-其他 | - |
| attachmentUrls | query | 否 | string | 附件URL（JSON数组） | - |
| canApprove | query | 否 | boolean | 当前用户是否可审批此流程 | - |
| createTime | query | 否 | string / date-time | 创建时间 | - |
| factoryDeptId | query | 否 | string | 所属厂区部门ID | - |
| factoryDeptName | query | 否 | string | 所属厂区部门名称 | - |
| flowInstanceId | query | 否 | string | 流程实例ID（预留） | - |
| flowStatus | query | 否 | integer / int32 | 流程状态：0-无流程 1-进行中 2-已完成 | - |
| handleRemark | query | 否 | string | 处理意见/结果说明 | - |
| handleTime | query | 否 | string / date-time | 处理时间 | - |
| handleUserId | query | 否 | integer / int64 | 处理人用户ID | - |
| handleUserName | query | 否 | string | 处理人姓名 | - |
| id | query | 否 | integer / int64 | 主键ID | - |
| isInitiator | query | 否 | boolean | 当前用户是否为此流程发起人 | - |
| reportId | query | 否 | integer / int64 | 关联隐患上报ID | - |
| reportNo | query | 否 | string | 关联隐患编号 | - |
| status | query | 否 | string | 申诉状态：0-待受理 1-处理中 2-已通过 3-已驳回 4-已撤回 | - |
| statusName | query | 否 | string | 申诉状态名称 | - |
| updateTime | query | 否 | string / date-time | 更新时间 | - |
| userId | query | 否 | integer / int64 | 申诉人用户ID | - |
| userName | query | 否 | string | 申诉人姓名 | - |

响应：

| 状态码 | 说明 | 响应模型 |
| --- | --- | --- |
| 200 | OK | */*: object<string, object> |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |


### 查询我的申诉记录（APP端）

- **用途：** 返回 data 为 PageInfo 分页对象。list 中每条记录为 PointsAppeal 对象，主要字段：id、appealNo-申诉编号、appealType-申诉类型(REJECT/POINTS/OTHER)、status-状态(0待受理/1处理中/2已通过/3已驳回/4已撤回)、statusName-状态名称、handleRemark-处理意见、adjustPoints-调整积分、createTime。
- **请求：** `GET /gd_dataserver/business/points/appeal/myList`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `myListUsingGET_2`

参数：

| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| adjustPoints | query | 否 | integer / int32 | 调整积分（正数补发，负数扣减） | - |
| appealNo | query | 否 | string | 申诉编号 | - |
| appealReason | query | 否 | string | 申诉理由 | - |
| appealType | query | 否 | string | 申诉类型：REJECT-审核驳回申诉 POINTS-积分异议 OTHER-其他 | - |
| attachmentUrls | query | 否 | string | 附件URL（JSON数组） | - |
| canApprove | query | 否 | boolean | 当前用户是否可审批此流程 | - |
| createTime | query | 否 | string / date-time | 创建时间 | - |
| factoryDeptId | query | 否 | string | 所属厂区部门ID | - |
| factoryDeptName | query | 否 | string | 所属厂区部门名称 | - |
| flowInstanceId | query | 否 | string | 流程实例ID（预留） | - |
| flowStatus | query | 否 | integer / int32 | 流程状态：0-无流程 1-进行中 2-已完成 | - |
| handleRemark | query | 否 | string | 处理意见/结果说明 | - |
| handleTime | query | 否 | string / date-time | 处理时间 | - |
| handleUserId | query | 否 | integer / int64 | 处理人用户ID | - |
| handleUserName | query | 否 | string | 处理人姓名 | - |
| id | query | 否 | integer / int64 | 主键ID | - |
| isInitiator | query | 否 | boolean | 当前用户是否为此流程发起人 | - |
| pageNum | query | 否 | integer / int32 | 页码 | - |
| reportId | query | 否 | integer / int64 | 关联隐患上报ID | - |
| reportNo | query | 否 | string | 关联隐患编号 | - |
| status | query | 否 | string | 申诉状态：0-待受理 1-处理中 2-已通过 3-已驳回 4-已撤回 | - |
| statusName | query | 否 | string | 申诉状态名称 | - |
| updateTime | query | 否 | string / date-time | 更新时间 | - |
| userId | query | 否 | integer / int64 | 申诉人用户ID | - |
| userName | query | 否 | string | 申诉人姓名 | - |
| pageSize | query | 否 | integer / int32 | 每页数量 | - |

响应：

| 状态码 | 说明 | 响应模型 |
| --- | --- | --- |
| 200 | OK | */*: object<string, object> |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |


### 逻辑删除

- **用途：** 根据主键ID逻辑删除单条记录，成功返回 data 为 null。
- **请求：** `GET /gd_dataserver/business/points/appeal/removeById`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `deleteListUsingGET_18`

参数：

| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| id | query | 是 | string | 主键ID | - |

响应：

| 状态码 | 说明 | 响应模型 |
| --- | --- | --- |
| 200 | OK | */*: object<string, object> |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |


### 提交申诉（APP端）

- **用途：** 填写申诉类型、理由等信息，申诉人信息从登录用户获取。返回 data 为 PointsAppeal 对象，包含 id、appealNo-申诉编号、status-状态(0待受理)。
- **请求：** `POST /gd_dataserver/business/points/appeal/submit`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `submitAppealUsingPOST`

参数：

_无_

请求体：

- Content-Type：`application/json`
- 模型：`积分申诉`
- 必填：文档未标记

| 字段 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| adjustPoints | 否 | integer / int32 | 调整积分（正数补发，负数扣减） | - |
| appealNo | 否 | string | 申诉编号 | - |
| appealReason | 否 | string | 申诉理由 | - |
| appealType | 否 | string | 申诉类型：REJECT-审核驳回申诉 POINTS-积分异议 OTHER-其他 | - |
| attachmentUrls | 否 | string | 附件URL（JSON数组） | - |
| canApprove | 否 | boolean | 当前用户是否可审批此流程 | false |
| createTime | 否 | string / date-time | 创建时间 | - |
| factoryDeptId | 否 | string | 所属厂区部门ID | - |
| factoryDeptName | 否 | string | 所属厂区部门名称 | - |
| flowInstanceId | 否 | string | 流程实例ID（预留） | - |
| flowStatus | 否 | integer / int32 | 流程状态：0-无流程 1-进行中 2-已完成 | - |
| handleRemark | 否 | string | 处理意见/结果说明 | - |
| handleTime | 否 | string / date-time | 处理时间 | - |
| handleUserId | 否 | integer / int64 | 处理人用户ID | - |
| handleUserName | 否 | string | 处理人姓名 | - |
| id | 否 | integer / int64 | 主键ID | - |
| isInitiator | 否 | boolean | 当前用户是否为此流程发起人 | false |
| reportId | 否 | integer / int64 | 关联隐患上报ID | - |
| reportNo | 否 | string | 关联隐患编号 | - |
| status | 否 | string | 申诉状态：0-待受理 1-处理中 2-已通过 3-已驳回 4-已撤回 | - |
| statusName | 否 | string | 申诉状态名称 | - |
| updateTime | 否 | string / date-time | 更新时间 | - |
| userId | 否 | integer / int64 | 申诉人用户ID | - |
| userName | 否 | string | 申诉人姓名 | - |


响应：

| 状态码 | 说明 | 响应模型 |
| --- | --- | --- |
| 200 | OK | */*: object<string, object> |
| 201 | Created | - |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |


### 提交申诉并启动流程（APP端）

- **用途：** 提交申诉并自动启动 Flowable 审批流程。后端自动解析申诉人所属厂区，按 (厂区, biz_type=appeal) 从 qc_hazard_flow_config 匹配流程Key并带厂区tenantId启动；若该厂区未配置申诉流程则回退到全局默认 appeal.flow.key。申诉人信息、factoryDeptId/factoryDeptName 均由后端自动填充，无需前端传。成功返回 data 为流程实例ID字符串；失败返回 error 信息。
- **请求：** `POST /gd_dataserver/business/points/appeal/submitFlow`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `submitAppealFlowUsingPOST`

参数：

_无_

请求体：

- Content-Type：`application/json`
- 模型：`积分申诉`
- 必填：文档未标记

| 字段 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| adjustPoints | 否 | integer / int32 | 调整积分（正数补发，负数扣减） | - |
| appealNo | 否 | string | 申诉编号 | - |
| appealReason | 否 | string | 申诉理由 | - |
| appealType | 否 | string | 申诉类型：REJECT-审核驳回申诉 POINTS-积分异议 OTHER-其他 | - |
| attachmentUrls | 否 | string | 附件URL（JSON数组） | - |
| canApprove | 否 | boolean | 当前用户是否可审批此流程 | false |
| createTime | 否 | string / date-time | 创建时间 | - |
| factoryDeptId | 否 | string | 所属厂区部门ID | - |
| factoryDeptName | 否 | string | 所属厂区部门名称 | - |
| flowInstanceId | 否 | string | 流程实例ID（预留） | - |
| flowStatus | 否 | integer / int32 | 流程状态：0-无流程 1-进行中 2-已完成 | - |
| handleRemark | 否 | string | 处理意见/结果说明 | - |
| handleTime | 否 | string / date-time | 处理时间 | - |
| handleUserId | 否 | integer / int64 | 处理人用户ID | - |
| handleUserName | 否 | string | 处理人姓名 | - |
| id | 否 | integer / int64 | 主键ID | - |
| isInitiator | 否 | boolean | 当前用户是否为此流程发起人 | false |
| reportId | 否 | integer / int64 | 关联隐患上报ID | - |
| reportNo | 否 | string | 关联隐患编号 | - |
| status | 否 | string | 申诉状态：0-待受理 1-处理中 2-已通过 3-已驳回 4-已撤回 | - |
| statusName | 否 | string | 申诉状态名称 | - |
| updateTime | 否 | string / date-time | 更新时间 | - |
| userId | 否 | integer / int64 | 申诉人用户ID | - |
| userName | 否 | string | 申诉人姓名 | - |


响应：

| 状态码 | 说明 | 响应模型 |
| --- | --- | --- |
| 200 | OK | */*: object<string, object> |
| 201 | Created | - |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |


### 申诉流程待办列表

- **用途：** 返回 data 为 PageInfo 分页对象。list 中每条记录为 PointsAppeal 对象，包含 id、appealNo、userName、appealType-申诉类型、appealReason-申诉理由、status-状态、createTime。
- **请求：** `GET /gd_dataserver/business/points/appeal/todoList`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `todoListUsingGET_2`

参数：

| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| params | query | 是 | object<string, string> | 查询参数（支持pageNum/pageSize等） | - |

响应：

| 状态码 | 说明 | 响应模型 |
| --- | --- | --- |
| 200 | OK | */*: object<string, object> |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |


### 修改

- **用途：** 根据主键ID修改记录，请求体为实体类对象（需包含id字段）。成功返回 data 为 null。
- **请求：** `POST /gd_dataserver/business/points/appeal/updateById`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `updateByIdUsingPOST_9`

参数：

_无_

请求体：

- Content-Type：`application/json`
- 模型：`积分申诉`
- 必填：文档未标记

| 字段 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| adjustPoints | 否 | integer / int32 | 调整积分（正数补发，负数扣减） | - |
| appealNo | 否 | string | 申诉编号 | - |
| appealReason | 否 | string | 申诉理由 | - |
| appealType | 否 | string | 申诉类型：REJECT-审核驳回申诉 POINTS-积分异议 OTHER-其他 | - |
| attachmentUrls | 否 | string | 附件URL（JSON数组） | - |
| canApprove | 否 | boolean | 当前用户是否可审批此流程 | false |
| createTime | 否 | string / date-time | 创建时间 | - |
| factoryDeptId | 否 | string | 所属厂区部门ID | - |
| factoryDeptName | 否 | string | 所属厂区部门名称 | - |
| flowInstanceId | 否 | string | 流程实例ID（预留） | - |
| flowStatus | 否 | integer / int32 | 流程状态：0-无流程 1-进行中 2-已完成 | - |
| handleRemark | 否 | string | 处理意见/结果说明 | - |
| handleTime | 否 | string / date-time | 处理时间 | - |
| handleUserId | 否 | integer / int64 | 处理人用户ID | - |
| handleUserName | 否 | string | 处理人姓名 | - |
| id | 否 | integer / int64 | 主键ID | - |
| isInitiator | 否 | boolean | 当前用户是否为此流程发起人 | false |
| reportId | 否 | integer / int64 | 关联隐患上报ID | - |
| reportNo | 否 | string | 关联隐患编号 | - |
| status | 否 | string | 申诉状态：0-待受理 1-处理中 2-已通过 3-已驳回 4-已撤回 | - |
| statusName | 否 | string | 申诉状态名称 | - |
| updateTime | 否 | string / date-time | 更新时间 | - |
| userId | 否 | integer / int64 | 申诉人用户ID | - |
| userName | 否 | string | 申诉人姓名 | - |


响应：

| 状态码 | 说明 | 响应模型 |
| --- | --- | --- |
| 200 | OK | */*: object<string, object> |
| 201 | Created | - |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |


### 撤回申诉（APP端）

- **用途：** 仅待受理状态(status=0)可撤回，撤回后状态改为已撤回(4)。返回 data 为 boolean。
- **请求：** `POST /gd_dataserver/business/points/appeal/withdraw/{id}`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `withdrawAppealUsingPOST`

参数：

| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| id | path | 是 | integer / int64 | 申诉ID | - |

响应：

| 状态码 | 说明 | 响应模型 |
| --- | --- | --- |
| 200 | OK | */*: object<string, object> |
| 201 | Created | - |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |