You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
60 KiB
60 KiB
隐患信息管理
本模块共 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 | - |