# 隐患流程模板配置



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



## 快速索引



| 接口名称 | 方法 | 路径 | 用途 |
| --- | --- | --- | --- |
| 修改流程模板配置 | PUT | `/gd_dataserver/gd_dataserver/flowable/hazardFlowConfig` | 修改流程Key、流程名称等信息。不可修改厂区ID和隐患等级。 |
| 新增流程模板配置 | POST | `/gd_dataserver/gd_dataserver/flowable/hazardFlowConfig` | 配置某个厂区的某个隐患等级对应的Flowable流程Key。二级管理员无需传deptId/deptName，系统自动填充所属厂区。每个厂区的每个等级只能配置一条（唯一约束）。 |
| 查询流程模板配置列表 | GET | `/gd_dataserver/gd_dataserver/flowable/hazardFlowConfig/list` | 系统管理员返回所有配置；二级管理员自动过滤为所属厂区的配置。可选按厂区ID、隐患等级筛选。 |
| 获取当前厂区已配置的流程模板 | GET | `/gd_dataserver/gd_dataserver/flowable/hazardFlowConfig/myFactoryConfigs` | 前端上报隐患时调用，返回当前用户所属厂区已配置的隐患等级和对应流程信息，用于前端展示可选的隐患等级下拉。 |
| 获取流程模板配置详情 | GET | `/gd_dataserver/gd_dataserver/flowable/hazardFlowConfig/{id}` | - |
| 删除流程模板配置 | DELETE | `/gd_dataserver/gd_dataserver/flowable/hazardFlowConfig/{id}` | 逻辑删除，将状态置为停用。 |


## 接口详情



### 修改流程模板配置

- **用途：** 修改流程Key、流程名称等信息。不可修改厂区ID和隐患等级。
- **请求：** `PUT /gd_dataserver/gd_dataserver/flowable/hazardFlowConfig`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `editUsingPUT`

参数：

_无_

请求体：

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

| 字段 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| 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 | 隐患等级编码（general-一般/major-较大/critical-重大） | 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，系统自动填充所属厂区。每个厂区的每个等级只能配置一条（唯一约束）。
- **请求：** `POST /gd_dataserver/gd_dataserver/flowable/hazardFlowConfig`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `addUsingPOST`

参数：

_无_

请求体：

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

| 字段 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| 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 | 隐患等级编码（general-一般/major-较大/critical-重大） | 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、隐患等级筛选。
- **请求：** `GET /gd_dataserver/gd_dataserver/flowable/hazardFlowConfig/list`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `listUsingGET_1`

参数：

| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- | --- |
| pageNum | query | 是 | integer / int32 | 当前页码 | - |
| pageSize | query | 是 | integer / int32 | 每页条数 | - |
| deptId | query | 否 | string | 厂区部门ID（不传则按当前用户权限自动过滤） | - |
| hazardLevel | query | 否 | string | 隐患等级编码（general/major/critical） | - |

响应：

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


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

- **用途：** 前端上报隐患时调用，返回当前用户所属厂区已配置的隐患等级和对应流程信息，用于前端展示可选的隐患等级下拉。
- **请求：** `GET /gd_dataserver/gd_dataserver/flowable/hazardFlowConfig/myFactoryConfigs`
- **鉴权：** `X-Access-Token`（以接口定义为准）
- **operationId：** `myFactoryConfigsUsingGET`

参数：

_无_

响应：

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


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

- **用途：** 接口文档未提供用途说明。
- **请求：** `GET /gd_dataserver/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 | - |


### 删除流程模板配置

- **用途：** 逻辑删除，将状态置为停用。
- **请求：** `DELETE /gd_dataserver/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 | - |