# 隐患流程模板配置



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



## 快速索引



| 接口名称 | 方法 | 路径 | 用途 |
| --- | --- | --- | --- |
| 修改流程模板配置 | PUT | `/gd_dataserver/flowable/hazardFlowConfig` | 修改流程Key、流程名称等信息。不可修改厂区ID和隐患等级。请求体字段：id-配置ID(必填)、flowKey-流程定义Key、flowName-流程名称、hazardLevelName-隐患等级名称等可修改字段。非超级管理员只能修改自己厂区的配置，否则返回错误。返回 data 为提示字符串，如"修改成功"。 |
| 新增流程模板配置 | POST | `/gd_dataserver/flowable/hazardFlowConfig` | 配置某个厂区、某业务类型、某隐患等级对应的Flowable流程Key。二级管理员无需传deptId/deptName，系统自动填充所属厂区。每个厂区的同一业务类型同一等级只能配置一条（唯一约束 dept_id+biz_type+hazard_level）。请求体字段：deptId-厂区部门ID(超级管理员必填，二级管理员自动填充)、deptName-厂区名称(同上)、bizType-业务类型(report/appeal/rectify/verify，不传默认report)、hazardLevel-隐患等级编码(report类型必填general/major/critical；非report类型无需传，后端会无条件强制置为default，传了也会被忽略)、hazardLevelName-隐患等级名称、flowKey-流程定义Key(必填)、flowName-流程名称。返回 data 为提示字符串，如"新增成功"。 |
| 查询流程模板配置列表 | GET | `/gd_dataserver/flowable/hazardFlowConfig/list` | 系统管理员返回所有配置；二级管理员自动过滤为所属厂区的配置。可选按厂区ID、业务类型、隐患等级、状态筛选。返回 data 为 PageInfo 分页对象，包含 total/list/pageNum/pageSize。list 中每条记录为 QcHazardFlowConfig 对象，主要字段：id-主键、deptId-厂区部门ID、deptName-厂区名称、bizType-业务类型(report/appeal/rectify/verify)、hazardLevel-隐患等级编码(report类型为general/major/critical，其余类型为default)、hazardLevelName-隐患等级名称、flowKey-流程定义Key、flowName-流程名称、status-状态(0停用/1正常)、createBy-创建者、createTime-创建时间。 |
| 获取当前厂区已配置的上报流程模板 | GET | `/gd_dataserver/flowable/hazardFlowConfig/myFactoryConfigs` | 前端上报隐患时调用，仅返回当前用户所属厂区 bizType=report 的配置（申诉/整改/验收不会返回），用于前端展示可选的隐患等级下拉。返回 data 为 QcHazardFlowConfig 数组，每条记录包含：id-主键、deptId-厂区部门ID、deptName-厂区名称、bizType-业务类型(固定report)、hazardLevel-隐患等级编码、hazardLevelName-隐患等级名称、flowKey-流程定义Key、flowName-流程名称。若当前用户未分配厂区部门则返回错误。 |
| 获取流程模板配置详情 | GET | `/gd_dataserver/flowable/hazardFlowConfig/{id}` | 根据ID查询单条流程模板配置的完整信息。返回 data 为 QcHazardFlowConfig 对象，字段：id-主键、deptId-厂区部门ID、deptName-厂区名称、bizType-业务类型(report/appeal/rectify/verify)、hazardLevel-隐患等级编码、hazardLevelName-隐患等级名称、flowKey-流程定义Key、flowName-流程名称、status-状态(0停用/1正常)、createBy-创建者、createTime-创建时间、updateBy-更新者、updateTime-更新时间。非超级管理员无权查看其他厂区的配置。 |
| 删除流程模板配置 | DELETE | `/gd_dataserver/flowable/hazardFlowConfig/{id}` | 逻辑删除（设置del_flag=1），不做物理删除。非超级管理员只能删除自己厂区的配置，否则返回错误。返回 data 为提示字符串，如"删除成功"。 |


## 接口详情



### 修改流程模板配置

- **用途：** 修改流程Key、流程名称等信息。不可修改厂区ID和隐患等级。请求体字段：id-配置ID(必填)、flowKey-流程定义Key、flowName-流程名称、hazardLevelName-隐患等级名称等可修改字段。非超级管理员只能修改自己厂区的配置，否则返回错误。返回 data 为提示字符串，如"修改成功"。
- **请求：** `PUT /gd_dataserver/flowable/hazardFlowConfig`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `editUsingPUT`

参数：

_无_

请求体：

- Content-Type：`application/json`
- 模型：`隐患流程模板配置`
- 必填：文档未标记

| 字段 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| bizType | 是 | string | 业务类型（report-上报/appeal-申诉/rectify-整改/verify-验收），不传默认report | report |
| createBy | 否 | string | - | - |
| createByName | 否 | string | - | - |
| createTime | 否 | string / date-time | - | - |
| deptId | 是 | string | 部门ID（厂区） | 100 |
| deptName | 否 | string | 部门名称 | 一厂 |
| flowKey | 是 | string | Flowable流程定义Key | hazard_general_flow |
| flowName | 否 | string | 流程名称 | 一般隐患奖励审批流程 |
| hazardLevel | 是 | string | 隐患等级编码（report类型：general-一般/major-较大/critical-重大；appeal/rectify/verify等非report类型固定为default，新增时后端会无条件强制置为default） | general |
| hazardLevelName | 否 | string | 隐患等级名称 | 一般隐患 |
| id | 否 | integer / int64 | 主键ID | - |
| params | 否 | object | - | - |
| status | 否 | string | 状态（0停用 1正常） | 1 |
| updateBy | 否 | string | - | - |
| updateByName | 否 | string | - | - |
| updateTime | 否 | string / date-time | - | - |


响应：

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


### 新增流程模板配置

- **用途：** 配置某个厂区、某业务类型、某隐患等级对应的Flowable流程Key。二级管理员无需传deptId/deptName，系统自动填充所属厂区。每个厂区的同一业务类型同一等级只能配置一条（唯一约束 dept_id+biz_type+hazard_level）。请求体字段：deptId-厂区部门ID(超级管理员必填，二级管理员自动填充)、deptName-厂区名称(同上)、bizType-业务类型(report/appeal/rectify/verify，不传默认report)、hazardLevel-隐患等级编码(report类型必填general/major/critical；非report类型无需传，后端会无条件强制置为default，传了也会被忽略)、hazardLevelName-隐患等级名称、flowKey-流程定义Key(必填)、flowName-流程名称。返回 data 为提示字符串，如"新增成功"。
- **请求：** `POST /gd_dataserver/flowable/hazardFlowConfig`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `addUsingPOST_1`

参数：

_无_

请求体：

- Content-Type：`application/json`
- 模型：`隐患流程模板配置`
- 必填：文档未标记

| 字段 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| bizType | 是 | string | 业务类型（report-上报/appeal-申诉/rectify-整改/verify-验收），不传默认report | report |
| createBy | 否 | string | - | - |
| createByName | 否 | string | - | - |
| createTime | 否 | string / date-time | - | - |
| deptId | 是 | string | 部门ID（厂区） | 100 |
| deptName | 否 | string | 部门名称 | 一厂 |
| flowKey | 是 | string | Flowable流程定义Key | hazard_general_flow |
| flowName | 否 | string | 流程名称 | 一般隐患奖励审批流程 |
| hazardLevel | 是 | string | 隐患等级编码（report类型：general-一般/major-较大/critical-重大；appeal/rectify/verify等非report类型固定为default，新增时后端会无条件强制置为default） | general |
| hazardLevelName | 否 | string | 隐患等级名称 | 一般隐患 |
| id | 否 | integer / int64 | 主键ID | - |
| params | 否 | object | - | - |
| status | 否 | string | 状态（0停用 1正常） | 1 |
| updateBy | 否 | string | - | - |
| updateByName | 否 | string | - | - |
| updateTime | 否 | string / date-time | - | - |


响应：

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


### 查询流程模板配置列表

- **用途：** 系统管理员返回所有配置；二级管理员自动过滤为所属厂区的配置。可选按厂区ID、业务类型、隐患等级、状态筛选。返回 data 为 PageInfo 分页对象，包含 total/list/pageNum/pageSize。list 中每条记录为 QcHazardFlowConfig 对象，主要字段：id-主键、deptId-厂区部门ID、deptName-厂区名称、bizType-业务类型(report/appeal/rectify/verify)、hazardLevel-隐患等级编码(report类型为general/major/critical，其余类型为default)、hazardLevelName-隐患等级名称、flowKey-流程定义Key、flowName-流程名称、status-状态(0停用/1正常)、createBy-创建者、createTime-创建时间。
- **请求：** `GET /gd_dataserver/flowable/hazardFlowConfig/list`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `listUsingGET_2`

参数：

| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| pageNum | query | 是 | integer / int32 | 当前页码 | - |
| pageSize | query | 是 | integer / int32 | 每页条数 | - |
| deptId | query | 否 | string | 厂区部门ID（不传则按当前用户权限自动过滤，超级管理员不传返回全部） | - |
| bizType | query | 否 | string | 业务类型（report-上报/appeal-申诉/rectify-整改/verify-验收，不传则不过滤） | - |
| hazardLevel | query | 否 | string | 隐患等级编码（general-一般/major-较大/critical-重大，不传则不过滤） | - |
| status | query | 否 | string | 状态（0-停用/1-正常，不传则查全部状态） | - |

响应：

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


### 获取当前厂区已配置的上报流程模板

- **用途：** 前端上报隐患时调用，仅返回当前用户所属厂区 bizType=report 的配置（申诉/整改/验收不会返回），用于前端展示可选的隐患等级下拉。返回 data 为 QcHazardFlowConfig 数组，每条记录包含：id-主键、deptId-厂区部门ID、deptName-厂区名称、bizType-业务类型(固定report)、hazardLevel-隐患等级编码、hazardLevelName-隐患等级名称、flowKey-流程定义Key、flowName-流程名称。若当前用户未分配厂区部门则返回错误。
- **请求：** `GET /gd_dataserver/flowable/hazardFlowConfig/myFactoryConfigs`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `myFactoryConfigsUsingGET`

参数：

_无_

响应：

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


### 获取流程模板配置详情

- **用途：** 根据ID查询单条流程模板配置的完整信息。返回 data 为 QcHazardFlowConfig 对象，字段：id-主键、deptId-厂区部门ID、deptName-厂区名称、bizType-业务类型(report/appeal/rectify/verify)、hazardLevel-隐患等级编码、hazardLevelName-隐患等级名称、flowKey-流程定义Key、flowName-流程名称、status-状态(0停用/1正常)、createBy-创建者、createTime-创建时间、updateBy-更新者、updateTime-更新时间。非超级管理员无权查看其他厂区的配置。
- **请求：** `GET /gd_dataserver/flowable/hazardFlowConfig/{id}`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `getInfoUsingGET_1`

参数：

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

响应：

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


### 删除流程模板配置

- **用途：** 逻辑删除（设置del_flag=1），不做物理删除。非超级管理员只能删除自己厂区的配置，否则返回错误。返回 data 为提示字符串，如"删除成功"。
- **请求：** `DELETE /gd_dataserver/flowable/hazardFlowConfig/{id}`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `removeUsingDELETE_1`

参数：

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

响应：

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