# 隐患上报流程 本模块共 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 | | 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 | | 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 | | 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 | | 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 | 查询参数（支持pageNum/pageSize等） | - | 响应： | 状态码 | 说明 | 响应模型 | | --- | --- | --- | | 200 | OK | */*: 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 | | 201 | Created | - | | 401 | Unauthorized | - | | 403 | Forbidden | - | | 404 | Not Found | - |