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

隐患流程模板配置

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