zhongyouweb/docs/api/modules/03-hazard-flow-config.md

隐患流程模板配置

本模块共 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	-