zhongyouweb/docs/api/modules/02-hazard-flow.md

隐患上报流程

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

快速索引

接口名称	方法	路径	用途
审批隐患流程	POST	/gd_dataserver/gd_dataserver/flowable/hazard/complete	审批通过或驳回，需携带taskId、comment、result等信息。成功返回 data 为 null；失败返回 error 信息。
隐患流程详情	GET	/gd_dataserver/gd_dataserver/flowable/hazard/detail/{id}	返回 data 为 HazardReport 对象，包含完整隐患字段及流程状态信息。主要字段：id、reportNo、hazardName、status-状态编码、flowStatus-流程状态、canApprove-是否可审批。
上报隐患并提交流程	POST	/gd_dataserver/gd_dataserver/flowable/hazard/submitFlow	先调用uploadAttachment上传附件，再将report和attachments一起提交。成功返回 data 为流程实例ID字符串；失败返回 error 信息。
切换隐患流程等级	POST	/gd_dataserver/gd_dataserver/flowable/hazard/switchLevel	审批过程中重新评估隐患等级，作废当前流程并以新等级重新启动审批。等级编码：general-一般隐患 / major-较大隐患 / critical-重大隐患。返回新流程实例ID。
隐患流程待办/已办列表	GET	/gd_dataserver/gd_dataserver/flowable/hazard/todoList	返回 data 为 PageInfo 分页对象。list 中每条记录为 HazardReport 对象，包含 id、reportNo、hazardName、status、createTime 等字段。支持 pageNum、pageSize 等筛选参数。
上传隐患附件文件	POST	/gd_dataserver/gd_dataserver/flowable/hazard/uploadAttachment	上传文件到服务器，返回 data 为 HazardAttachment 数组，每个元素包含：id、fileName-文件名、filePath-文件路径、fileSize-文件大小、fileType-MIME类型、attachmentType-附件类型。前端在调用submitFlow时将附件数据传入

接口详情

审批隐患流程

• 用途： 审批通过或驳回，需携带taskId、comment、result等信息。成功返回 data 为 null；失败返回 error 信息。
• 请求： POST /gd_dataserver/gd_dataserver/flowable/hazard/complete
• 鉴权： X-Access-Token（以接口定义为准）
• operationId： completeUsingPOST_2

参数：

无

请求体：

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

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

响应：

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

隐患流程详情

• 用途： 返回 data 为 HazardReport 对象，包含完整隐患字段及流程状态信息。主要字段：id、reportNo、hazardName、status-状态编码、flowStatus-流程状态、canApprove-是否可审批。
• 请求： GET /gd_dataserver/gd_dataserver/flowable/hazard/detail/{id}
• 鉴权： X-Access-Token（以接口定义为准）
• operationId： detailUsingGET

参数：

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

响应：

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

上报隐患并提交流程

• 用途： 先调用uploadAttachment上传附件，再将report和attachments一起提交。成功返回 data 为流程实例ID字符串；失败返回 error 信息。
• 请求： POST /gd_dataserver/gd_dataserver/flowable/hazard/submitFlow
• 鉴权： X-Access-Token（以接口定义为准）
• operationId： submitFlowUsingPOST

参数：

无

请求体：

• Content-Type：application/json
• 模型：隐患上报流程提交请求
• 必填：文档未标记

字段	必填	类型	说明	示例
attachments	否	array<隐患附件>	附件列表（先调用uploadAttachment接口获取）	-
report	是	隐患信息	隐患信息	-

响应：

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

切换隐患流程等级

• 用途： 审批过程中重新评估隐患等级，作废当前流程并以新等级重新启动审批。等级编码：general-一般隐患 / major-较大隐患 / critical-重大隐患。返回新流程实例ID。
• 请求： POST /gd_dataserver/gd_dataserver/flowable/hazard/switchLevel
• 鉴权： X-Access-Token（以接口定义为准）
• operationId： switchLevelUsingPOST

参数：

字段	位置	必填	类型	说明	示例
reportId	query	是	integer / int64	隐患记录ID	-
newHazardLevel	query	是	string	目标等级编码（general/major/critical）	-
switchReason	query	否	string	切换原因	-

响应：

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

隐患流程待办/已办列表

• 用途： 返回 data 为 PageInfo 分页对象。list 中每条记录为 HazardReport 对象，包含 id、reportNo、hazardName、status、createTime 等字段。支持 pageNum、pageSize 等筛选参数。
• 请求： GET /gd_dataserver/gd_dataserver/flowable/hazard/todoList
• 鉴权： X-Access-Token（以接口定义为准）
• operationId： todoListUsingGET_1

参数：

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

响应：

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

上传隐患附件文件

• 用途： 上传文件到服务器，返回 data 为 HazardAttachment 数组，每个元素包含：id、fileName-文件名、filePath-文件路径、fileSize-文件大小、fileType-MIME类型、attachmentType-附件类型。前端在调用submitFlow时将附件数据传入
• 请求： POST /gd_dataserver/gd_dataserver/flowable/hazard/uploadAttachment
• 鉴权： X-Access-Token（以接口定义为准）
• operationId： uploadAttachmentUsingPOST

参数：

字段	位置	必填	类型	说明	示例
attachmentType	query	否	string	附件类型：IMAGE-图片 VIDEO-视频 DOCUMENT-文档 OTHER-其他	-

请求体：

• Content-Type：application/json
• 模型：string / binary
• 必填：文档未标记
• Content-Type：application/octet-stream
• 模型：string / binary
• 必填：文档未标记

响应：

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