# 隐患信息管理



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



## 快速索引



| 接口名称 | 方法 | 路径 | 用途 |
| --- | --- | --- | --- |
| 新增 | POST | `/gd_dataserver/gd_dataserver/business/hazard/add` | 新增单条记录，请求体为实体类对象（字段说明见对应实体模型）。成功返回 data 为 null。 |
| 批量新增 | POST | `/gd_dataserver/gd_dataserver/business/hazard/addBatch` | 批量新增多条记录，请求体为实体类数组。成功返回 data 为 null。 |
| 新增并返回保存的数据 | POST | `/gd_dataserver/gd_dataserver/business/hazard/addReturn` | 新增单条记录并返回保存后的数据（含自增ID），请求体为实体类对象。成功返回 data 为保存的实体对象。 |
| 删除附件 | DELETE | `/gd_dataserver/gd_dataserver/business/hazard/attachment/{ids}` | 返回 data 为 boolean，true-删除成功。 |
| 按隐患ID查附件列表 | GET | `/gd_dataserver/gd_dataserver/business/hazard/attachment/{reportId}` | 返回 data 为 HazardAttachment 数组。每个元素包含：id-附件ID、reportId-隐患ID、fileName-文件名、fileUrl-文件访问URL、fileType-文件类型、fileSize-文件大小。 |
| 根据属性删除 | GET | `/gd_dataserver/gd_dataserver/business/hazard/delete` | 根据实体属性条件删除记录，请求体为实体类对象。成功返回 data 为 null。 |
| 主键删除 | GET | `/gd_dataserver/gd_dataserver/business/hazard/deleteById` | 根据主键ID删除单条记录，成功返回 data 为 null。 |
| 批量删除 | GET | `/gd_dataserver/gd_dataserver/business/hazard/deleteByIds` | 根据ID列表批量删除记录，成功返回 data 为 null。 |
| 导出隐患列表Excel | POST | `/gd_dataserver/gd_dataserver/business/hazard/export` | 直接返回 Excel 文件流（Content-Type: application/octet-stream），前端需以 Blob 方式接收并下载。 |
| 生成隐患编号 | POST | `/gd_dataserver/gd_dataserver/business/hazard/generateReportNo` | 返回 data 为 String 类型的隐患编号，格式如 HR20260827001。 |
| 查询所有 | GET | `/gd_dataserver/gd_dataserver/business/hazard/getAll` | 查询所有记录（无分页、无条件）。成功返回 data 为实体类数组。 |
| 分页查询 | GET | `/gd_dataserver/gd_dataserver/business/hazard/getListByPage` | 分页查询记录列表，查询条件为实体类字段。成功返回 data 为 PageInfo 分页对象，其中 list 为实体类数组。 |
| 详情 | GET | `/gd_dataserver/gd_dataserver/business/hazard/info` | 根据主键ID查询单条记录详情。成功返回 data 为实体类对象，包含该实体所有字段。 |
| 查隐患详情 | GET | `/gd_dataserver/gd_dataserver/business/hazard/info/{id}` | 返回 data 为 HazardReport 对象。主要字段：id-主键、reportNo-隐患编号、hazardName-隐患名称、description-隐患描述、unitName-单位名称、departmentName-部门名称、hazardLevelName-隐患级别名称、hazardCategoryName-隐患分类名称、status-状态编码(0待提交/1审核中/2整改中/3已通过/4已驳回)、statusName-状态名称、reporterName-上报人姓名、chargePersonName-整改负责人姓名、pointsAwarded-奖励积分、flowStatus-流程状态(0未开始/1进行中/2已完成)、canApprove-当前用户是否可审批、isInitiator-当前用户是否为此流程发起人。 |
| 条件查询 | GET | `/gd_dataserver/gd_dataserver/business/hazard/list` | 根据实体属性条件查询记录列表。成功返回 data 为实体类数组。 |
| 查询我的上报记录（APP端） | GET | `/gd_dataserver/gd_dataserver/business/hazard/myList` | 分页查询当前登录用户已上报的隐患记录列表。返回 data 为 PageInfo 分页对象，包含 total/list/pageNum/pageSize 等。list 中每条记录为 HazardReport 对象，主要字段：id、reportNo、hazardName、status-状态编码、statusName-状态名称、hazardLevelName-级别名称、pointsAwarded-奖励积分、createTime-创建时间。 |
| 首页今日概览-我的隐患统计（APP端） | GET | `/gd_dataserver/gd_dataserver/business/hazard/myStats` | 按状态分类统计当前登录用户的隐患数量。返回字段说明：todayReportCount-今日上报数、pendingAuditCount-待审核数、rectifyingCount-整改中数、rejectedCount-已驳回数。 |
| 逻辑删除 | GET | `/gd_dataserver/gd_dataserver/business/hazard/removeById` | 根据主键ID逻辑删除单条记录，成功返回 data 为 null。 |
| 保存隐患信息（草稿，不启动流程） | POST | `/gd_dataserver/gd_dataserver/business/hazard/save` | 保存隐患记录及附件，不启动审批流程。返回 data 为 HazardReport 对象，包含 id、reportNo 等完整隐患字段。 |
| 修改 | POST | `/gd_dataserver/gd_dataserver/business/hazard/updateById` | 根据主键ID修改记录，请求体为实体类对象（需包含id字段）。成功返回 data 为 null。 |
| 删除隐患（级联删除附件） | DELETE | `/gd_dataserver/gd_dataserver/business/hazard/{ids}` | 返回 data 为 boolean，true-删除成功，false-删除失败。同时级联删除关联的附件记录。 |


## 接口详情



### 新增

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

参数：

_无_

请求体：

- Content-Type：`application/json`
- 模型：`隐患信息`
- 必填：文档未标记

| 字段 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| actualCompleteTime | 否 | string / date-time | 实际完成时间 | - |
| auditRemark | 否 | string | 审核备注 | - |
| auditTime | 否 | string / date-time | 审核时间 | - |
| auditUserId | 否 | integer / int64 | 审核人用户ID | - |
| auditUserNameName | 否 | string | 审核人姓名 | - |
| auditUserUsername | 否 | string | 审核人账号 | - |
| canApprove | 否 | boolean | 当前用户是否可审批此流程 | false |
| causeAnalysis | 否 | string | 原因分析 | - |
| chargePersonId | 否 | integer / int64 | 整改负责人用户ID | - |
| chargePersonName | 否 | string | 整改负责人姓名 | - |
| chargePersonUsername | 否 | string | 整改负责人账号 | - |
| createBy | 否 | string | 创建者 | - |
| createTime | 否 | string / date-time | 创建时间 | - |
| currentFlowLevel | 否 | string | 当前流程等级编码（general/major/critical） | - |
| departmentId | 否 | integer / int64 | 部门ID | - |
| departmentName | 否 | string | 部门名称 | - |
| deployId | 否 | string | 流程模板id | - |
| description | 否 | string | 隐患描述 | - |
| discoverTime | 否 | string / date-time | 发现时间 | - |
| factoryDeptId | 否 | string | 所属厂区部门ID | - |
| factoryDeptName | 否 | string | 所属厂区部门名称 | - |
| flowInstanceId | 否 | string | 流程实例id | - |
| flowStatus | 否 | integer / int32 | 流程状态（0-未开始 1-进行中 2-已完成） | - |
| fundsSource | 否 | string | 资金来源编码 | - |
| fundsSourceId | 否 | integer / int64 | 资金来源字典ID | - |
| fundsSourceName | 否 | string | 资金来源名称 | - |
| governanceType | 否 | string | 治理类型编码 | - |
| governanceTypeId | 否 | integer / int64 | 治理类型字典ID | - |
| governanceTypeName | 否 | string | 治理类型名称 | - |
| hazardCategory | 否 | string | 隐患分类编码 | - |
| hazardCategoryId | 否 | integer / int64 | 隐患分类字典ID | - |
| hazardCategoryName | 否 | string | 隐患分类名称 | - |
| hazardLevel | 否 | string | 管理级别编码 | - |
| hazardLevelId | 否 | integer / int64 | 管理级别字典ID | - |
| hazardLevelName | 否 | string | 管理级别名称 | - |
| hazardName | 否 | string | 隐患名称 | - |
| hazardSourceDetail | 否 | string | 来源具体描述 | - |
| hazardType | 否 | string | 隐患类型编码 | - |
| hazardTypeId | 否 | integer / int64 | 隐患类型字典ID | - |
| hazardTypeName | 否 | string | 隐患类型名称 | - |
| id | 否 | integer / int64 | 主键ID | - |
| isInitiator | 否 | boolean | 当前用户是否为此流程发起人 | false |
| limitedCompleteTime | 否 | string / date-time | 限定完成时间 | - |
| major | 否 | string | 专业编码 | - |
| majorId | 否 | integer / int64 | 专业字典ID | - |
| majorName | 否 | string | 专业名称 | - |
| pointsAwarded | 否 | integer / int32 | 奖励积分 | - |
| pointsStatus | 否 | string | 积分发放状态编码 | - |
| pointsStatusId | 否 | integer / int64 | 积分发放状态字典ID | - |
| pointsStatusName | 否 | string | 积分发放状态名称 | - |
| preventiveMeasures | 否 | string | 防范措施 | - |
| pushResponse | 否 | string | 第三方返回结果 | - |
| pushStatus | 否 | string | 推送状态编码 | - |
| pushStatusId | 否 | integer / int64 | 推送状态字典ID | - |
| pushStatusName | 否 | string | 推送状态名称 | - |
| pushTime | 否 | string / date-time | 推送时间 | - |
| rectificationPlan | 否 | string | 整改方案 | - |
| remark | 否 | string | 备注 | - |
| reportNo | 否 | string | 隐患编号 | - |
| reporterId | 否 | integer / int64 | 上报人用户ID | - |
| reporterName | 否 | string | 上报人姓名 | - |
| reporterUsername | 否 | string | 上报人账号 | - |
| riskTarget | 否 | string | 风险分析对象 | - |
| riskUnit | 否 | string | 风险分析单元 | - |
| sourceType | 否 | string | 隐患来源编码 | - |
| sourceTypeId | 否 | integer / int64 | 隐患来源字典ID | - |
| sourceTypeName | 否 | string | 隐患来源名称 | - |
| status | 否 | string | 隐患状态编码 | - |
| statusId | 否 | integer / int64 | 隐患状态字典ID | - |
| statusName | 否 | string | 隐患状态名称 | - |
| supervisorId | 否 | integer / int64 | 监察人用户ID | - |
| supervisorName | 否 | string | 监察人姓名 | - |
| supervisorUsername | 否 | string | 监察人账号 | - |
| thirdPartyId | 否 | string | 第三方系统记录ID | - |
| unitId | 否 | integer / int64 | 单位ID | - |
| unitName | 否 | string | 单位名称 | - |
| updateBy | 否 | string | 更新者 | - |
| updateTime | 否 | string / date-time | 更新时间 | - |


响应：

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


### 批量新增

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

参数：

_无_

请求体：

- Content-Type：`application/json`
- 模型：`array<隐患信息>`
- 必填：文档未标记

响应：

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


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

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

参数：

_无_

请求体：

- Content-Type：`application/json`
- 模型：`隐患信息`
- 必填：文档未标记

| 字段 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| actualCompleteTime | 否 | string / date-time | 实际完成时间 | - |
| auditRemark | 否 | string | 审核备注 | - |
| auditTime | 否 | string / date-time | 审核时间 | - |
| auditUserId | 否 | integer / int64 | 审核人用户ID | - |
| auditUserNameName | 否 | string | 审核人姓名 | - |
| auditUserUsername | 否 | string | 审核人账号 | - |
| canApprove | 否 | boolean | 当前用户是否可审批此流程 | false |
| causeAnalysis | 否 | string | 原因分析 | - |
| chargePersonId | 否 | integer / int64 | 整改负责人用户ID | - |
| chargePersonName | 否 | string | 整改负责人姓名 | - |
| chargePersonUsername | 否 | string | 整改负责人账号 | - |
| createBy | 否 | string | 创建者 | - |
| createTime | 否 | string / date-time | 创建时间 | - |
| currentFlowLevel | 否 | string | 当前流程等级编码（general/major/critical） | - |
| departmentId | 否 | integer / int64 | 部门ID | - |
| departmentName | 否 | string | 部门名称 | - |
| deployId | 否 | string | 流程模板id | - |
| description | 否 | string | 隐患描述 | - |
| discoverTime | 否 | string / date-time | 发现时间 | - |
| factoryDeptId | 否 | string | 所属厂区部门ID | - |
| factoryDeptName | 否 | string | 所属厂区部门名称 | - |
| flowInstanceId | 否 | string | 流程实例id | - |
| flowStatus | 否 | integer / int32 | 流程状态（0-未开始 1-进行中 2-已完成） | - |
| fundsSource | 否 | string | 资金来源编码 | - |
| fundsSourceId | 否 | integer / int64 | 资金来源字典ID | - |
| fundsSourceName | 否 | string | 资金来源名称 | - |
| governanceType | 否 | string | 治理类型编码 | - |
| governanceTypeId | 否 | integer / int64 | 治理类型字典ID | - |
| governanceTypeName | 否 | string | 治理类型名称 | - |
| hazardCategory | 否 | string | 隐患分类编码 | - |
| hazardCategoryId | 否 | integer / int64 | 隐患分类字典ID | - |
| hazardCategoryName | 否 | string | 隐患分类名称 | - |
| hazardLevel | 否 | string | 管理级别编码 | - |
| hazardLevelId | 否 | integer / int64 | 管理级别字典ID | - |
| hazardLevelName | 否 | string | 管理级别名称 | - |
| hazardName | 否 | string | 隐患名称 | - |
| hazardSourceDetail | 否 | string | 来源具体描述 | - |
| hazardType | 否 | string | 隐患类型编码 | - |
| hazardTypeId | 否 | integer / int64 | 隐患类型字典ID | - |
| hazardTypeName | 否 | string | 隐患类型名称 | - |
| id | 否 | integer / int64 | 主键ID | - |
| isInitiator | 否 | boolean | 当前用户是否为此流程发起人 | false |
| limitedCompleteTime | 否 | string / date-time | 限定完成时间 | - |
| major | 否 | string | 专业编码 | - |
| majorId | 否 | integer / int64 | 专业字典ID | - |
| majorName | 否 | string | 专业名称 | - |
| pointsAwarded | 否 | integer / int32 | 奖励积分 | - |
| pointsStatus | 否 | string | 积分发放状态编码 | - |
| pointsStatusId | 否 | integer / int64 | 积分发放状态字典ID | - |
| pointsStatusName | 否 | string | 积分发放状态名称 | - |
| preventiveMeasures | 否 | string | 防范措施 | - |
| pushResponse | 否 | string | 第三方返回结果 | - |
| pushStatus | 否 | string | 推送状态编码 | - |
| pushStatusId | 否 | integer / int64 | 推送状态字典ID | - |
| pushStatusName | 否 | string | 推送状态名称 | - |
| pushTime | 否 | string / date-time | 推送时间 | - |
| rectificationPlan | 否 | string | 整改方案 | - |
| remark | 否 | string | 备注 | - |
| reportNo | 否 | string | 隐患编号 | - |
| reporterId | 否 | integer / int64 | 上报人用户ID | - |
| reporterName | 否 | string | 上报人姓名 | - |
| reporterUsername | 否 | string | 上报人账号 | - |
| riskTarget | 否 | string | 风险分析对象 | - |
| riskUnit | 否 | string | 风险分析单元 | - |
| sourceType | 否 | string | 隐患来源编码 | - |
| sourceTypeId | 否 | integer / int64 | 隐患来源字典ID | - |
| sourceTypeName | 否 | string | 隐患来源名称 | - |
| status | 否 | string | 隐患状态编码 | - |
| statusId | 否 | integer / int64 | 隐患状态字典ID | - |
| statusName | 否 | string | 隐患状态名称 | - |
| supervisorId | 否 | integer / int64 | 监察人用户ID | - |
| supervisorName | 否 | string | 监察人姓名 | - |
| supervisorUsername | 否 | string | 监察人账号 | - |
| thirdPartyId | 否 | string | 第三方系统记录ID | - |
| unitId | 否 | integer / int64 | 单位ID | - |
| unitName | 否 | string | 单位名称 | - |
| updateBy | 否 | string | 更新者 | - |
| updateTime | 否 | string / date-time | 更新时间 | - |


响应：

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


### 删除附件

- **用途：** 返回 data 为 boolean，true-删除成功。
- **请求：** `DELETE /gd_dataserver/gd_dataserver/business/hazard/attachment/{ids}`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `removeAttachmentUsingDELETE`

参数：

| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| ids | path | 是 | string | 附件ID列表（逗号分隔） | - |

响应：

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


### 按隐患ID查附件列表

- **用途：** 返回 data 为 HazardAttachment 数组。每个元素包含：id-附件ID、reportId-隐患ID、fileName-文件名、fileUrl-文件访问URL、fileType-文件类型、fileSize-文件大小。
- **请求：** `GET /gd_dataserver/gd_dataserver/business/hazard/attachment/{reportId}`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `listAttachmentsUsingGET`

参数：

| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| reportId | path | 是 | integer / int64 | 隐患ID | - |

响应：

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


### 根据属性删除

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

参数：

| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| actualCompleteTime | query | 否 | string / date-time | 实际完成时间 | - |
| auditRemark | query | 否 | string | 审核备注 | - |
| auditTime | query | 否 | string / date-time | 审核时间 | - |
| auditUserId | query | 否 | integer / int64 | 审核人用户ID | - |
| auditUserNameName | query | 否 | string | 审核人姓名 | - |
| auditUserUsername | query | 否 | string | 审核人账号 | - |
| canApprove | query | 否 | boolean | 当前用户是否可审批此流程 | - |
| causeAnalysis | query | 否 | string | 原因分析 | - |
| chargePersonId | query | 否 | integer / int64 | 整改负责人用户ID | - |
| chargePersonName | query | 否 | string | 整改负责人姓名 | - |
| chargePersonUsername | query | 否 | string | 整改负责人账号 | - |
| createBy | query | 否 | string | 创建者 | - |
| createTime | query | 否 | string / date-time | 创建时间 | - |
| currentFlowLevel | query | 否 | string | 当前流程等级编码（general/major/critical） | - |
| departmentId | query | 否 | integer / int64 | 部门ID | - |
| departmentName | query | 否 | string | 部门名称 | - |
| deployId | query | 否 | string | 流程模板id | - |
| description | query | 否 | string | 隐患描述 | - |
| discoverTime | query | 否 | string / date-time | 发现时间 | - |
| factoryDeptId | query | 否 | string | 所属厂区部门ID | - |
| factoryDeptName | query | 否 | string | 所属厂区部门名称 | - |
| flowInstanceId | query | 否 | string | 流程实例id | - |
| flowStatus | query | 否 | integer / int32 | 流程状态（0-未开始 1-进行中 2-已完成） | - |
| fundsSource | query | 否 | string | 资金来源编码 | - |
| fundsSourceId | query | 否 | integer / int64 | 资金来源字典ID | - |
| fundsSourceName | query | 否 | string | 资金来源名称 | - |
| governanceType | query | 否 | string | 治理类型编码 | - |
| governanceTypeId | query | 否 | integer / int64 | 治理类型字典ID | - |
| governanceTypeName | query | 否 | string | 治理类型名称 | - |
| hazardCategory | query | 否 | string | 隐患分类编码 | - |
| hazardCategoryId | query | 否 | integer / int64 | 隐患分类字典ID | - |
| hazardCategoryName | query | 否 | string | 隐患分类名称 | - |
| hazardLevel | query | 否 | string | 管理级别编码 | - |
| hazardLevelId | query | 否 | integer / int64 | 管理级别字典ID | - |
| hazardLevelName | query | 否 | string | 管理级别名称 | - |
| hazardName | query | 否 | string | 隐患名称 | - |
| hazardSourceDetail | query | 否 | string | 来源具体描述 | - |
| hazardType | query | 否 | string | 隐患类型编码 | - |
| hazardTypeId | query | 否 | integer / int64 | 隐患类型字典ID | - |
| hazardTypeName | query | 否 | string | 隐患类型名称 | - |
| id | query | 否 | integer / int64 | 主键ID | - |
| isInitiator | query | 否 | boolean | 当前用户是否为此流程发起人 | - |
| limitedCompleteTime | query | 否 | string / date-time | 限定完成时间 | - |
| major | query | 否 | string | 专业编码 | - |
| majorId | query | 否 | integer / int64 | 专业字典ID | - |
| majorName | query | 否 | string | 专业名称 | - |
| pointsAwarded | query | 否 | integer / int32 | 奖励积分 | - |
| pointsStatus | query | 否 | string | 积分发放状态编码 | - |
| pointsStatusId | query | 否 | integer / int64 | 积分发放状态字典ID | - |
| pointsStatusName | query | 否 | string | 积分发放状态名称 | - |
| preventiveMeasures | query | 否 | string | 防范措施 | - |
| pushResponse | query | 否 | string | 第三方返回结果 | - |
| pushStatus | query | 否 | string | 推送状态编码 | - |
| pushStatusId | query | 否 | integer / int64 | 推送状态字典ID | - |
| pushStatusName | query | 否 | string | 推送状态名称 | - |
| pushTime | query | 否 | string / date-time | 推送时间 | - |
| rectificationPlan | query | 否 | string | 整改方案 | - |
| remark | query | 否 | string | 备注 | - |
| reportNo | query | 否 | string | 隐患编号 | - |
| reporterId | query | 否 | integer / int64 | 上报人用户ID | - |
| reporterName | query | 否 | string | 上报人姓名 | - |
| reporterUsername | query | 否 | string | 上报人账号 | - |
| riskTarget | query | 否 | string | 风险分析对象 | - |
| riskUnit | query | 否 | string | 风险分析单元 | - |
| sourceType | query | 否 | string | 隐患来源编码 | - |
| sourceTypeId | query | 否 | integer / int64 | 隐患来源字典ID | - |
| sourceTypeName | query | 否 | string | 隐患来源名称 | - |
| status | query | 否 | string | 隐患状态编码 | - |
| statusId | query | 否 | integer / int64 | 隐患状态字典ID | - |
| statusName | query | 否 | string | 隐患状态名称 | - |
| supervisorId | query | 否 | integer / int64 | 监察人用户ID | - |
| supervisorName | query | 否 | string | 监察人姓名 | - |
| supervisorUsername | query | 否 | string | 监察人账号 | - |
| thirdPartyId | query | 否 | string | 第三方系统记录ID | - |
| unitId | query | 否 | integer / int64 | 单位ID | - |
| unitName | query | 否 | string | 单位名称 | - |
| updateBy | query | 否 | string | 更新者 | - |
| updateTime | query | 否 | string / date-time | 更新时间 | - |

响应：

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


### 主键删除

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

参数：

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

响应：

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


### 批量删除

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

参数：

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

响应：

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


### 导出隐患列表Excel

- **用途：** 直接返回 Excel 文件流（Content-Type: application/octet-stream），前端需以 Blob 方式接收并下载。
- **请求：** `POST /gd_dataserver/gd_dataserver/business/hazard/export`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `exportUsingPOST`

参数：

| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| actualCompleteTime | query | 否 | string / date-time | 实际完成时间 | - |
| auditRemark | query | 否 | string | 审核备注 | - |
| auditTime | query | 否 | string / date-time | 审核时间 | - |
| auditUserId | query | 否 | integer / int64 | 审核人用户ID | - |
| auditUserNameName | query | 否 | string | 审核人姓名 | - |
| auditUserUsername | query | 否 | string | 审核人账号 | - |
| canApprove | query | 否 | boolean | 当前用户是否可审批此流程 | - |
| causeAnalysis | query | 否 | string | 原因分析 | - |
| chargePersonId | query | 否 | integer / int64 | 整改负责人用户ID | - |
| chargePersonName | query | 否 | string | 整改负责人姓名 | - |
| chargePersonUsername | query | 否 | string | 整改负责人账号 | - |
| createBy | query | 否 | string | 创建者 | - |
| createTime | query | 否 | string / date-time | 创建时间 | - |
| currentFlowLevel | query | 否 | string | 当前流程等级编码（general/major/critical） | - |
| departmentId | query | 否 | integer / int64 | 部门ID | - |
| departmentName | query | 否 | string | 部门名称 | - |
| deployId | query | 否 | string | 流程模板id | - |
| description | query | 否 | string | 隐患描述 | - |
| discoverTime | query | 否 | string / date-time | 发现时间 | - |
| factoryDeptId | query | 否 | string | 所属厂区部门ID | - |
| factoryDeptName | query | 否 | string | 所属厂区部门名称 | - |
| flowInstanceId | query | 否 | string | 流程实例id | - |
| flowStatus | query | 否 | integer / int32 | 流程状态（0-未开始 1-进行中 2-已完成） | - |
| fundsSource | query | 否 | string | 资金来源编码 | - |
| fundsSourceId | query | 否 | integer / int64 | 资金来源字典ID | - |
| fundsSourceName | query | 否 | string | 资金来源名称 | - |
| governanceType | query | 否 | string | 治理类型编码 | - |
| governanceTypeId | query | 否 | integer / int64 | 治理类型字典ID | - |
| governanceTypeName | query | 否 | string | 治理类型名称 | - |
| hazardCategory | query | 否 | string | 隐患分类编码 | - |
| hazardCategoryId | query | 否 | integer / int64 | 隐患分类字典ID | - |
| hazardCategoryName | query | 否 | string | 隐患分类名称 | - |
| hazardLevel | query | 否 | string | 管理级别编码 | - |
| hazardLevelId | query | 否 | integer / int64 | 管理级别字典ID | - |
| hazardLevelName | query | 否 | string | 管理级别名称 | - |
| hazardName | query | 否 | string | 隐患名称 | - |
| hazardSourceDetail | query | 否 | string | 来源具体描述 | - |
| hazardType | query | 否 | string | 隐患类型编码 | - |
| hazardTypeId | query | 否 | integer / int64 | 隐患类型字典ID | - |
| hazardTypeName | query | 否 | string | 隐患类型名称 | - |
| id | query | 否 | integer / int64 | 主键ID | - |
| isInitiator | query | 否 | boolean | 当前用户是否为此流程发起人 | - |
| limitedCompleteTime | query | 否 | string / date-time | 限定完成时间 | - |
| major | query | 否 | string | 专业编码 | - |
| majorId | query | 否 | integer / int64 | 专业字典ID | - |
| majorName | query | 否 | string | 专业名称 | - |
| pointsAwarded | query | 否 | integer / int32 | 奖励积分 | - |
| pointsStatus | query | 否 | string | 积分发放状态编码 | - |
| pointsStatusId | query | 否 | integer / int64 | 积分发放状态字典ID | - |
| pointsStatusName | query | 否 | string | 积分发放状态名称 | - |
| preventiveMeasures | query | 否 | string | 防范措施 | - |
| pushResponse | query | 否 | string | 第三方返回结果 | - |
| pushStatus | query | 否 | string | 推送状态编码 | - |
| pushStatusId | query | 否 | integer / int64 | 推送状态字典ID | - |
| pushStatusName | query | 否 | string | 推送状态名称 | - |
| pushTime | query | 否 | string / date-time | 推送时间 | - |
| rectificationPlan | query | 否 | string | 整改方案 | - |
| remark | query | 否 | string | 备注 | - |
| reportNo | query | 否 | string | 隐患编号 | - |
| reporterId | query | 否 | integer / int64 | 上报人用户ID | - |
| reporterName | query | 否 | string | 上报人姓名 | - |
| reporterUsername | query | 否 | string | 上报人账号 | - |
| riskTarget | query | 否 | string | 风险分析对象 | - |
| riskUnit | query | 否 | string | 风险分析单元 | - |
| sourceType | query | 否 | string | 隐患来源编码 | - |
| sourceTypeId | query | 否 | integer / int64 | 隐患来源字典ID | - |
| sourceTypeName | query | 否 | string | 隐患来源名称 | - |
| status | query | 否 | string | 隐患状态编码 | - |
| statusId | query | 否 | integer / int64 | 隐患状态字典ID | - |
| statusName | query | 否 | string | 隐患状态名称 | - |
| supervisorId | query | 否 | integer / int64 | 监察人用户ID | - |
| supervisorName | query | 否 | string | 监察人姓名 | - |
| supervisorUsername | query | 否 | string | 监察人账号 | - |
| thirdPartyId | query | 否 | string | 第三方系统记录ID | - |
| unitId | query | 否 | integer / int64 | 单位ID | - |
| unitName | query | 否 | string | 单位名称 | - |
| updateBy | query | 否 | string | 更新者 | - |
| updateTime | query | 否 | string / date-time | 更新时间 | - |

响应：

| 状态码 | 说明 | 响应模型 |
| --- | --- | --- |
| 200 | OK | - |
| 201 | Created | - |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |


### 生成隐患编号

- **用途：** 返回 data 为 String 类型的隐患编号，格式如 HR20260827001。
- **请求：** `POST /gd_dataserver/gd_dataserver/business/hazard/generateReportNo`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `generateReportNoUsingPOST`

参数：

_无_

响应：

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


### 查询所有

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

参数：

_无_

响应：

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


### 分页查询

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

参数：

| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| actualCompleteTime | query | 否 | string / date-time | 实际完成时间 | - |
| auditRemark | query | 否 | string | 审核备注 | - |
| auditTime | query | 否 | string / date-time | 审核时间 | - |
| auditUserId | query | 否 | integer / int64 | 审核人用户ID | - |
| auditUserNameName | query | 否 | string | 审核人姓名 | - |
| auditUserUsername | query | 否 | string | 审核人账号 | - |
| canApprove | query | 否 | boolean | 当前用户是否可审批此流程 | - |
| causeAnalysis | query | 否 | string | 原因分析 | - |
| chargePersonId | query | 否 | integer / int64 | 整改负责人用户ID | - |
| chargePersonName | query | 否 | string | 整改负责人姓名 | - |
| chargePersonUsername | query | 否 | string | 整改负责人账号 | - |
| createBy | query | 否 | string | 创建者 | - |
| createTime | query | 否 | string / date-time | 创建时间 | - |
| currentFlowLevel | query | 否 | string | 当前流程等级编码（general/major/critical） | - |
| departmentId | query | 否 | integer / int64 | 部门ID | - |
| departmentName | query | 否 | string | 部门名称 | - |
| deployId | query | 否 | string | 流程模板id | - |
| description | query | 否 | string | 隐患描述 | - |
| discoverTime | query | 否 | string / date-time | 发现时间 | - |
| factoryDeptId | query | 否 | string | 所属厂区部门ID | - |
| factoryDeptName | query | 否 | string | 所属厂区部门名称 | - |
| flowInstanceId | query | 否 | string | 流程实例id | - |
| flowStatus | query | 否 | integer / int32 | 流程状态（0-未开始 1-进行中 2-已完成） | - |
| fundsSource | query | 否 | string | 资金来源编码 | - |
| fundsSourceId | query | 否 | integer / int64 | 资金来源字典ID | - |
| fundsSourceName | query | 否 | string | 资金来源名称 | - |
| governanceType | query | 否 | string | 治理类型编码 | - |
| governanceTypeId | query | 否 | integer / int64 | 治理类型字典ID | - |
| governanceTypeName | query | 否 | string | 治理类型名称 | - |
| hazardCategory | query | 否 | string | 隐患分类编码 | - |
| hazardCategoryId | query | 否 | integer / int64 | 隐患分类字典ID | - |
| hazardCategoryName | query | 否 | string | 隐患分类名称 | - |
| hazardLevel | query | 否 | string | 管理级别编码 | - |
| hazardLevelId | query | 否 | integer / int64 | 管理级别字典ID | - |
| hazardLevelName | query | 否 | string | 管理级别名称 | - |
| hazardName | query | 否 | string | 隐患名称 | - |
| hazardSourceDetail | query | 否 | string | 来源具体描述 | - |
| hazardType | query | 否 | string | 隐患类型编码 | - |
| hazardTypeId | query | 否 | integer / int64 | 隐患类型字典ID | - |
| hazardTypeName | query | 否 | string | 隐患类型名称 | - |
| id | query | 否 | integer / int64 | 主键ID | - |
| isInitiator | query | 否 | boolean | 当前用户是否为此流程发起人 | - |
| limitedCompleteTime | query | 否 | string / date-time | 限定完成时间 | - |
| major | query | 否 | string | 专业编码 | - |
| majorId | query | 否 | integer / int64 | 专业字典ID | - |
| majorName | query | 否 | string | 专业名称 | - |
| pageNum | query | 是 | integer / int32 | 页码 | - |
| pointsAwarded | query | 否 | integer / int32 | 奖励积分 | - |
| pointsStatus | query | 否 | string | 积分发放状态编码 | - |
| pointsStatusId | query | 否 | integer / int64 | 积分发放状态字典ID | - |
| pointsStatusName | query | 否 | string | 积分发放状态名称 | - |
| preventiveMeasures | query | 否 | string | 防范措施 | - |
| pushResponse | query | 否 | string | 第三方返回结果 | - |
| pushStatus | query | 否 | string | 推送状态编码 | - |
| pushStatusId | query | 否 | integer / int64 | 推送状态字典ID | - |
| pushStatusName | query | 否 | string | 推送状态名称 | - |
| pushTime | query | 否 | string / date-time | 推送时间 | - |
| rectificationPlan | query | 否 | string | 整改方案 | - |
| remark | query | 否 | string | 备注 | - |
| reportNo | query | 否 | string | 隐患编号 | - |
| reporterId | query | 否 | integer / int64 | 上报人用户ID | - |
| reporterName | query | 否 | string | 上报人姓名 | - |
| reporterUsername | query | 否 | string | 上报人账号 | - |
| riskTarget | query | 否 | string | 风险分析对象 | - |
| riskUnit | query | 否 | string | 风险分析单元 | - |
| sourceType | query | 否 | string | 隐患来源编码 | - |
| sourceTypeId | query | 否 | integer / int64 | 隐患来源字典ID | - |
| sourceTypeName | query | 否 | string | 隐患来源名称 | - |
| status | query | 否 | string | 隐患状态编码 | - |
| statusId | query | 否 | integer / int64 | 隐患状态字典ID | - |
| statusName | query | 否 | string | 隐患状态名称 | - |
| supervisorId | query | 否 | integer / int64 | 监察人用户ID | - |
| supervisorName | query | 否 | string | 监察人姓名 | - |
| supervisorUsername | query | 否 | string | 监察人账号 | - |
| thirdPartyId | query | 否 | string | 第三方系统记录ID | - |
| unitId | query | 否 | integer / int64 | 单位ID | - |
| unitName | query | 否 | string | 单位名称 | - |
| updateBy | query | 否 | string | 更新者 | - |
| updateTime | query | 否 | string / date-time | 更新时间 | - |
| pageSize | query | 是 | integer / int32 | 每页条数 | - |

响应：

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


### 详情

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

参数：

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

响应：

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


### 查隐患详情

- **用途：** 返回 data 为 HazardReport 对象。主要字段：id-主键、reportNo-隐患编号、hazardName-隐患名称、description-隐患描述、unitName-单位名称、departmentName-部门名称、hazardLevelName-隐患级别名称、hazardCategoryName-隐患分类名称、status-状态编码(0待提交/1审核中/2整改中/3已通过/4已驳回)、statusName-状态名称、reporterName-上报人姓名、chargePersonName-整改负责人姓名、pointsAwarded-奖励积分、flowStatus-流程状态(0未开始/1进行中/2已完成)、canApprove-当前用户是否可审批、isInitiator-当前用户是否为此流程发起人。
- **请求：** `GET /gd_dataserver/gd_dataserver/business/hazard/info/{id}`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `getInfoUsingGET`

参数：

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

响应：

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


### 条件查询

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

参数：

| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| actualCompleteTime | query | 否 | string / date-time | 实际完成时间 | - |
| auditRemark | query | 否 | string | 审核备注 | - |
| auditTime | query | 否 | string / date-time | 审核时间 | - |
| auditUserId | query | 否 | integer / int64 | 审核人用户ID | - |
| auditUserNameName | query | 否 | string | 审核人姓名 | - |
| auditUserUsername | query | 否 | string | 审核人账号 | - |
| canApprove | query | 否 | boolean | 当前用户是否可审批此流程 | - |
| causeAnalysis | query | 否 | string | 原因分析 | - |
| chargePersonId | query | 否 | integer / int64 | 整改负责人用户ID | - |
| chargePersonName | query | 否 | string | 整改负责人姓名 | - |
| chargePersonUsername | query | 否 | string | 整改负责人账号 | - |
| createBy | query | 否 | string | 创建者 | - |
| createTime | query | 否 | string / date-time | 创建时间 | - |
| currentFlowLevel | query | 否 | string | 当前流程等级编码（general/major/critical） | - |
| departmentId | query | 否 | integer / int64 | 部门ID | - |
| departmentName | query | 否 | string | 部门名称 | - |
| deployId | query | 否 | string | 流程模板id | - |
| description | query | 否 | string | 隐患描述 | - |
| discoverTime | query | 否 | string / date-time | 发现时间 | - |
| factoryDeptId | query | 否 | string | 所属厂区部门ID | - |
| factoryDeptName | query | 否 | string | 所属厂区部门名称 | - |
| flowInstanceId | query | 否 | string | 流程实例id | - |
| flowStatus | query | 否 | integer / int32 | 流程状态（0-未开始 1-进行中 2-已完成） | - |
| fundsSource | query | 否 | string | 资金来源编码 | - |
| fundsSourceId | query | 否 | integer / int64 | 资金来源字典ID | - |
| fundsSourceName | query | 否 | string | 资金来源名称 | - |
| governanceType | query | 否 | string | 治理类型编码 | - |
| governanceTypeId | query | 否 | integer / int64 | 治理类型字典ID | - |
| governanceTypeName | query | 否 | string | 治理类型名称 | - |
| hazardCategory | query | 否 | string | 隐患分类编码 | - |
| hazardCategoryId | query | 否 | integer / int64 | 隐患分类字典ID | - |
| hazardCategoryName | query | 否 | string | 隐患分类名称 | - |
| hazardLevel | query | 否 | string | 管理级别编码 | - |
| hazardLevelId | query | 否 | integer / int64 | 管理级别字典ID | - |
| hazardLevelName | query | 否 | string | 管理级别名称 | - |
| hazardName | query | 否 | string | 隐患名称 | - |
| hazardSourceDetail | query | 否 | string | 来源具体描述 | - |
| hazardType | query | 否 | string | 隐患类型编码 | - |
| hazardTypeId | query | 否 | integer / int64 | 隐患类型字典ID | - |
| hazardTypeName | query | 否 | string | 隐患类型名称 | - |
| id | query | 否 | integer / int64 | 主键ID | - |
| isInitiator | query | 否 | boolean | 当前用户是否为此流程发起人 | - |
| limitedCompleteTime | query | 否 | string / date-time | 限定完成时间 | - |
| major | query | 否 | string | 专业编码 | - |
| majorId | query | 否 | integer / int64 | 专业字典ID | - |
| majorName | query | 否 | string | 专业名称 | - |
| pointsAwarded | query | 否 | integer / int32 | 奖励积分 | - |
| pointsStatus | query | 否 | string | 积分发放状态编码 | - |
| pointsStatusId | query | 否 | integer / int64 | 积分发放状态字典ID | - |
| pointsStatusName | query | 否 | string | 积分发放状态名称 | - |
| preventiveMeasures | query | 否 | string | 防范措施 | - |
| pushResponse | query | 否 | string | 第三方返回结果 | - |
| pushStatus | query | 否 | string | 推送状态编码 | - |
| pushStatusId | query | 否 | integer / int64 | 推送状态字典ID | - |
| pushStatusName | query | 否 | string | 推送状态名称 | - |
| pushTime | query | 否 | string / date-time | 推送时间 | - |
| rectificationPlan | query | 否 | string | 整改方案 | - |
| remark | query | 否 | string | 备注 | - |
| reportNo | query | 否 | string | 隐患编号 | - |
| reporterId | query | 否 | integer / int64 | 上报人用户ID | - |
| reporterName | query | 否 | string | 上报人姓名 | - |
| reporterUsername | query | 否 | string | 上报人账号 | - |
| riskTarget | query | 否 | string | 风险分析对象 | - |
| riskUnit | query | 否 | string | 风险分析单元 | - |
| sourceType | query | 否 | string | 隐患来源编码 | - |
| sourceTypeId | query | 否 | integer / int64 | 隐患来源字典ID | - |
| sourceTypeName | query | 否 | string | 隐患来源名称 | - |
| status | query | 否 | string | 隐患状态编码 | - |
| statusId | query | 否 | integer / int64 | 隐患状态字典ID | - |
| statusName | query | 否 | string | 隐患状态名称 | - |
| supervisorId | query | 否 | integer / int64 | 监察人用户ID | - |
| supervisorName | query | 否 | string | 监察人姓名 | - |
| supervisorUsername | query | 否 | string | 监察人账号 | - |
| thirdPartyId | query | 否 | string | 第三方系统记录ID | - |
| unitId | query | 否 | integer / int64 | 单位ID | - |
| unitName | query | 否 | string | 单位名称 | - |
| updateBy | query | 否 | string | 更新者 | - |
| updateTime | query | 否 | string / date-time | 更新时间 | - |

响应：

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


### 查询我的上报记录（APP端）

- **用途：** 分页查询当前登录用户已上报的隐患记录列表。返回 data 为 PageInfo 分页对象，包含 total/list/pageNum/pageSize 等。list 中每条记录为 HazardReport 对象，主要字段：id、reportNo、hazardName、status-状态编码、statusName-状态名称、hazardLevelName-级别名称、pointsAwarded-奖励积分、createTime-创建时间。
- **请求：** `GET /gd_dataserver/gd_dataserver/business/hazard/myList`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `myListUsingGET_1`

参数：

| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| actualCompleteTime | query | 否 | string / date-time | 实际完成时间 | - |
| auditRemark | query | 否 | string | 审核备注 | - |
| auditTime | query | 否 | string / date-time | 审核时间 | - |
| auditUserId | query | 否 | integer / int64 | 审核人用户ID | - |
| auditUserNameName | query | 否 | string | 审核人姓名 | - |
| auditUserUsername | query | 否 | string | 审核人账号 | - |
| canApprove | query | 否 | boolean | 当前用户是否可审批此流程 | - |
| causeAnalysis | query | 否 | string | 原因分析 | - |
| chargePersonId | query | 否 | integer / int64 | 整改负责人用户ID | - |
| chargePersonName | query | 否 | string | 整改负责人姓名 | - |
| chargePersonUsername | query | 否 | string | 整改负责人账号 | - |
| createBy | query | 否 | string | 创建者 | - |
| createTime | query | 否 | string / date-time | 创建时间 | - |
| currentFlowLevel | query | 否 | string | 当前流程等级编码（general/major/critical） | - |
| departmentId | query | 否 | integer / int64 | 部门ID | - |
| departmentName | query | 否 | string | 部门名称 | - |
| deployId | query | 否 | string | 流程模板id | - |
| description | query | 否 | string | 隐患描述 | - |
| discoverTime | query | 否 | string / date-time | 发现时间 | - |
| factoryDeptId | query | 否 | string | 所属厂区部门ID | - |
| factoryDeptName | query | 否 | string | 所属厂区部门名称 | - |
| flowInstanceId | query | 否 | string | 流程实例id | - |
| flowStatus | query | 否 | integer / int32 | 流程状态（0-未开始 1-进行中 2-已完成） | - |
| fundsSource | query | 否 | string | 资金来源编码 | - |
| fundsSourceId | query | 否 | integer / int64 | 资金来源字典ID | - |
| fundsSourceName | query | 否 | string | 资金来源名称 | - |
| governanceType | query | 否 | string | 治理类型编码 | - |
| governanceTypeId | query | 否 | integer / int64 | 治理类型字典ID | - |
| governanceTypeName | query | 否 | string | 治理类型名称 | - |
| hazardCategory | query | 否 | string | 隐患分类编码 | - |
| hazardCategoryId | query | 否 | integer / int64 | 隐患分类字典ID | - |
| hazardCategoryName | query | 否 | string | 隐患分类名称 | - |
| hazardLevel | query | 否 | string | 管理级别编码 | - |
| hazardLevelId | query | 否 | integer / int64 | 管理级别字典ID | - |
| hazardLevelName | query | 否 | string | 管理级别名称 | - |
| hazardName | query | 否 | string | 隐患名称 | - |
| hazardSourceDetail | query | 否 | string | 来源具体描述 | - |
| hazardType | query | 否 | string | 隐患类型编码 | - |
| hazardTypeId | query | 否 | integer / int64 | 隐患类型字典ID | - |
| hazardTypeName | query | 否 | string | 隐患类型名称 | - |
| id | query | 否 | integer / int64 | 主键ID | - |
| isInitiator | query | 否 | boolean | 当前用户是否为此流程发起人 | - |
| limitedCompleteTime | query | 否 | string / date-time | 限定完成时间 | - |
| major | query | 否 | string | 专业编码 | - |
| majorId | query | 否 | integer / int64 | 专业字典ID | - |
| majorName | query | 否 | string | 专业名称 | - |
| pageNum | query | 否 | integer / int32 | 页码 | - |
| pointsAwarded | query | 否 | integer / int32 | 奖励积分 | - |
| pointsStatus | query | 否 | string | 积分发放状态编码 | - |
| pointsStatusId | query | 否 | integer / int64 | 积分发放状态字典ID | - |
| pointsStatusName | query | 否 | string | 积分发放状态名称 | - |
| preventiveMeasures | query | 否 | string | 防范措施 | - |
| pushResponse | query | 否 | string | 第三方返回结果 | - |
| pushStatus | query | 否 | string | 推送状态编码 | - |
| pushStatusId | query | 否 | integer / int64 | 推送状态字典ID | - |
| pushStatusName | query | 否 | string | 推送状态名称 | - |
| pushTime | query | 否 | string / date-time | 推送时间 | - |
| rectificationPlan | query | 否 | string | 整改方案 | - |
| remark | query | 否 | string | 备注 | - |
| reportNo | query | 否 | string | 隐患编号 | - |
| reporterId | query | 否 | integer / int64 | 上报人用户ID | - |
| reporterName | query | 否 | string | 上报人姓名 | - |
| reporterUsername | query | 否 | string | 上报人账号 | - |
| riskTarget | query | 否 | string | 风险分析对象 | - |
| riskUnit | query | 否 | string | 风险分析单元 | - |
| sourceType | query | 否 | string | 隐患来源编码 | - |
| sourceTypeId | query | 否 | integer / int64 | 隐患来源字典ID | - |
| sourceTypeName | query | 否 | string | 隐患来源名称 | - |
| status | query | 否 | string | 隐患状态编码 | - |
| statusId | query | 否 | integer / int64 | 隐患状态字典ID | - |
| statusName | query | 否 | string | 隐患状态名称 | - |
| supervisorId | query | 否 | integer / int64 | 监察人用户ID | - |
| supervisorName | query | 否 | string | 监察人姓名 | - |
| supervisorUsername | query | 否 | string | 监察人账号 | - |
| thirdPartyId | query | 否 | string | 第三方系统记录ID | - |
| unitId | query | 否 | integer / int64 | 单位ID | - |
| unitName | query | 否 | string | 单位名称 | - |
| updateBy | query | 否 | string | 更新者 | - |
| updateTime | query | 否 | string / date-time | 更新时间 | - |
| pageSize | query | 否 | integer / int32 | 每页数量 | - |

响应：

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


### 首页今日概览-我的隐患统计（APP端）

- **用途：** 按状态分类统计当前登录用户的隐患数量。返回字段说明：todayReportCount-今日上报数、pendingAuditCount-待审核数、rectifyingCount-整改中数、rejectedCount-已驳回数。
- **请求：** `GET /gd_dataserver/gd_dataserver/business/hazard/myStats`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `myStatsUsingGET`

参数：

_无_

响应：

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


### 逻辑删除

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

参数：

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

响应：

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


### 保存隐患信息（草稿，不启动流程）

- **用途：** 保存隐患记录及附件，不启动审批流程。返回 data 为 HazardReport 对象，包含 id、reportNo 等完整隐患字段。
- **请求：** `POST /gd_dataserver/gd_dataserver/business/hazard/save`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `saveUsingPOST_1`

参数：

_无_

请求体：

- Content-Type：`application/json`
- 模型：`隐患上报请求`
- 必填：文档未标记

| 字段 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| attachments | 否 | array<隐患附件> | 附件列表 | - |
| report | 否 | 隐患信息 | 隐患信息 | - |


响应：

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


### 修改

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

参数：

_无_

请求体：

- Content-Type：`application/json`
- 模型：`隐患信息`
- 必填：文档未标记

| 字段 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| actualCompleteTime | 否 | string / date-time | 实际完成时间 | - |
| auditRemark | 否 | string | 审核备注 | - |
| auditTime | 否 | string / date-time | 审核时间 | - |
| auditUserId | 否 | integer / int64 | 审核人用户ID | - |
| auditUserNameName | 否 | string | 审核人姓名 | - |
| auditUserUsername | 否 | string | 审核人账号 | - |
| canApprove | 否 | boolean | 当前用户是否可审批此流程 | false |
| causeAnalysis | 否 | string | 原因分析 | - |
| chargePersonId | 否 | integer / int64 | 整改负责人用户ID | - |
| chargePersonName | 否 | string | 整改负责人姓名 | - |
| chargePersonUsername | 否 | string | 整改负责人账号 | - |
| createBy | 否 | string | 创建者 | - |
| createTime | 否 | string / date-time | 创建时间 | - |
| currentFlowLevel | 否 | string | 当前流程等级编码（general/major/critical） | - |
| departmentId | 否 | integer / int64 | 部门ID | - |
| departmentName | 否 | string | 部门名称 | - |
| deployId | 否 | string | 流程模板id | - |
| description | 否 | string | 隐患描述 | - |
| discoverTime | 否 | string / date-time | 发现时间 | - |
| factoryDeptId | 否 | string | 所属厂区部门ID | - |
| factoryDeptName | 否 | string | 所属厂区部门名称 | - |
| flowInstanceId | 否 | string | 流程实例id | - |
| flowStatus | 否 | integer / int32 | 流程状态（0-未开始 1-进行中 2-已完成） | - |
| fundsSource | 否 | string | 资金来源编码 | - |
| fundsSourceId | 否 | integer / int64 | 资金来源字典ID | - |
| fundsSourceName | 否 | string | 资金来源名称 | - |
| governanceType | 否 | string | 治理类型编码 | - |
| governanceTypeId | 否 | integer / int64 | 治理类型字典ID | - |
| governanceTypeName | 否 | string | 治理类型名称 | - |
| hazardCategory | 否 | string | 隐患分类编码 | - |
| hazardCategoryId | 否 | integer / int64 | 隐患分类字典ID | - |
| hazardCategoryName | 否 | string | 隐患分类名称 | - |
| hazardLevel | 否 | string | 管理级别编码 | - |
| hazardLevelId | 否 | integer / int64 | 管理级别字典ID | - |
| hazardLevelName | 否 | string | 管理级别名称 | - |
| hazardName | 否 | string | 隐患名称 | - |
| hazardSourceDetail | 否 | string | 来源具体描述 | - |
| hazardType | 否 | string | 隐患类型编码 | - |
| hazardTypeId | 否 | integer / int64 | 隐患类型字典ID | - |
| hazardTypeName | 否 | string | 隐患类型名称 | - |
| id | 否 | integer / int64 | 主键ID | - |
| isInitiator | 否 | boolean | 当前用户是否为此流程发起人 | false |
| limitedCompleteTime | 否 | string / date-time | 限定完成时间 | - |
| major | 否 | string | 专业编码 | - |
| majorId | 否 | integer / int64 | 专业字典ID | - |
| majorName | 否 | string | 专业名称 | - |
| pointsAwarded | 否 | integer / int32 | 奖励积分 | - |
| pointsStatus | 否 | string | 积分发放状态编码 | - |
| pointsStatusId | 否 | integer / int64 | 积分发放状态字典ID | - |
| pointsStatusName | 否 | string | 积分发放状态名称 | - |
| preventiveMeasures | 否 | string | 防范措施 | - |
| pushResponse | 否 | string | 第三方返回结果 | - |
| pushStatus | 否 | string | 推送状态编码 | - |
| pushStatusId | 否 | integer / int64 | 推送状态字典ID | - |
| pushStatusName | 否 | string | 推送状态名称 | - |
| pushTime | 否 | string / date-time | 推送时间 | - |
| rectificationPlan | 否 | string | 整改方案 | - |
| remark | 否 | string | 备注 | - |
| reportNo | 否 | string | 隐患编号 | - |
| reporterId | 否 | integer / int64 | 上报人用户ID | - |
| reporterName | 否 | string | 上报人姓名 | - |
| reporterUsername | 否 | string | 上报人账号 | - |
| riskTarget | 否 | string | 风险分析对象 | - |
| riskUnit | 否 | string | 风险分析单元 | - |
| sourceType | 否 | string | 隐患来源编码 | - |
| sourceTypeId | 否 | integer / int64 | 隐患来源字典ID | - |
| sourceTypeName | 否 | string | 隐患来源名称 | - |
| status | 否 | string | 隐患状态编码 | - |
| statusId | 否 | integer / int64 | 隐患状态字典ID | - |
| statusName | 否 | string | 隐患状态名称 | - |
| supervisorId | 否 | integer / int64 | 监察人用户ID | - |
| supervisorName | 否 | string | 监察人姓名 | - |
| supervisorUsername | 否 | string | 监察人账号 | - |
| thirdPartyId | 否 | string | 第三方系统记录ID | - |
| unitId | 否 | integer / int64 | 单位ID | - |
| unitName | 否 | string | 单位名称 | - |
| updateBy | 否 | string | 更新者 | - |
| updateTime | 否 | string / date-time | 更新时间 | - |


响应：

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


### 删除隐患（级联删除附件）

- **用途：** 返回 data 为 boolean，true-删除成功，false-删除失败。同时级联删除关联的附件记录。
- **请求：** `DELETE /gd_dataserver/gd_dataserver/business/hazard/{ids}`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `removeUsingDELETE`

参数：

| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| ids | path | 是 | string | 隐患ID列表（逗号分隔） | - |

响应：

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