# 数据模型与字段字典

共 32 个模型。

## FlowCommentDto

| 字段 | 必填 | 类型 | 说明 | 示例/枚举 |
| --- | --- | --- | --- | --- |
| comment | 否 | string | - | - |
| type | 否 | string | - | - |

## FlowSaveXmlVo

| 字段 | 必填 | 类型 | 说明 | 示例/枚举 |
| --- | --- | --- | --- | --- |
| category | 否 | string | - | - |
| name | 否 | string | - | - |
| xml | 否 | string | - | - |

## R«List«UserEntity»»

| 字段 | 必填 | 类型 | 说明 | 示例/枚举 |
| --- | --- | --- | --- | --- |
| code | 否 | integer / int32 | - | - |
| data | 否 | array<UserEntity> | - | - |
| msg | 否 | string | - | - |

## R«UserEntity»

| 字段 | 必填 | 类型 | 说明 | 示例/枚举 |
| --- | --- | --- | --- | --- |
| code | 否 | integer / int32 | - | - |
| data | 否 | UserEntity | - | - |
| msg | 否 | string | - | - |

## R«string»

| 字段 | 必填 | 类型 | 说明 | 示例/枚举 |
| --- | --- | --- | --- | --- |
| code | 否 | integer / int32 | - | - |
| data | 否 | string | - | - |
| msg | 否 | string | - | - |

## UserEntity

用户实体

| 字段 | 必填 | 类型 | 说明 | 示例/枚举 |
| --- | --- | --- | --- | --- |
| mobile | 否 | string | 用户手机 | - |
| password | 否 | string | 用户密码 | - |
| userId | 否 | integer / int32 | 用户ID | - |
| username | 否 | string | 用户名称 | - |

## 兑换安全配置

| 字段 | 必填 | 类型 | 说明 | 示例/枚举 |
| --- | --- | --- | --- | --- |
| antiFarmEnabled | 否 | integer / int32 | 隐患上报防刷检测是否启用：1-启用 0-禁用 | - |
| configName | 否 | string | 配置名称 | - |
| createTime | 否 | string / date-time | 创建时间 | - |
| dailyLimitPerUser | 否 | integer / int32 | 每人每日兑换上限（积分） | - |
| dailyOrderCountLimit | 否 | integer / int32 | 每人每日兑换次数上限 | - |
| enabled | 否 | integer / int32 | 是否启用：1-启用 0-禁用 | - |
| id | 否 | integer / int64 | 主键ID | - |
| largeAmountNeedApproval | 否 | integer / int32 | 大额兑换是否需审批：1-是 0-否 | - |
| largeAmountThreshold | 否 | integer / int32 | 大额兑换预警阈值（积分） | - |
| monthlyLimitPerUser | 否 | integer / int32 | 每人每月上限（积分） | - |
| pointsRatio | 否 | integer / int32 | 积分比例（N积分=1元） | - |
| rapidExchangeThreshold | 否 | integer / int32 | 短时间内兑换次数阈值（触发预警） | - |
| rapidExchangeWindowMinutes | 否 | integer / int32 | 快速兑换检测时间窗口（分钟） | - |
| remark | 否 | string | 备注 | - |
| singleMaxPoints | 否 | integer / int32 | 单笔最大积分 | - |
| singleMinPoints | 否 | integer / int32 | 单笔最小积分 | - |
| updateTime | 否 | string / date-time | 更新时间 | - |
| yearlyLimitPerUser | 否 | integer / int32 | 每人每年上限（积分） | - |

## 兑换操作日志

| 字段 | 必填 | 类型 | 说明 | 示例/枚举 |
| --- | --- | --- | --- | --- |
| createTime | 否 | string / date-time | 创建时间 | - |
| durationMs | 否 | integer / int32 | 耗时（毫秒） | - |
| errorMsg | 否 | string | 错误信息 | - |
| id | 否 | integer / int64 | 主键ID | - |
| ipAddress | 否 | string | 操作IP | - |
| operationDesc | 否 | string | 操作描述 | - |
| operationType | 否 | string | 操作类型：VIEW/VALIDATE/CREATE/FREEZE/UNFREEZE/DEDUCT/SUBMIT/CANCEL/REFUND/RETRY | - |
| orderId | 否 | integer / int64 | 关联订单ID | - |
| orderNo | 否 | string | 关联订单号 | - |
| requestParams | 否 | string | 请求参数（JSON） | - |
| responseResult | 否 | string | 响应结果（JSON） | - |
| status | 否 | string | 操作结果：SUCCESS/FAIL | - |
| userAgent | 否 | string | 客户端UA | - |
| userId | 否 | integer / int64 | 操作用户ID | - |

## 兑换物品

| 字段 | 必填 | 类型 | 说明 | 示例/枚举 |
| --- | --- | --- | --- | --- |
| createTime | 否 | string / date-time | 创建时间 | - |
| dailyLimitPerUser | 否 | integer / int32 | 每人每日兑换上限（0表示无限制） | - |
| description | 否 | string | 物品描述 | - |
| externalLink | 否 | string | 第三方兑换链接 | - |
| id | 否 | integer / int64 | 主键ID | - |
| itemCode | 否 | string | 物品编码 | - |
| itemName | 否 | string | 物品名称 | - |
| pointsRequired | 否 | integer / int32 | 所需积分 | - |
| sortOrder | 否 | integer / int32 | 排序权重 | - |
| status | 否 | integer / int32 | 状态：0-下架 1-上架 | - |
| stock | 否 | integer / int32 | 库存数量（0表示无限） | - |
| thirdPartyCode | 否 | string | 第三方平台物品编码 | - |
| updateTime | 否 | string / date-time | 更新时间 | - |

## 兑换订单追踪

| 字段 | 必填 | 类型 | 说明 | 示例/枚举 |
| --- | --- | --- | --- | --- |
| createTime | 否 | string / date-time | 创建时间 | - |
| fromStatus | 否 | integer / int32 | 变更前状态 | - |
| id | 否 | integer / int64 | 主键ID | - |
| ipAddress | 否 | string | 操作IP | - |
| operateType | 否 | string | 操作类型：CREATE/FREEZE/UNFREEZE/DEDUCT/SUBMIT/CANCEL/REFUND/RETRY | - |
| operator | 否 | string | 操作人 | - |
| orderId | 否 | integer / int64 | 订单ID | - |
| orderNo | 否 | string | 订单号 | - |
| remark | 否 | string | 操作备注 | - |
| statusName | 否 | string | 状态名称 | - |
| toStatus | 否 | integer / int32 | 变更后状态 | - |

## 商城端-用户信息

商城端获取用户基本信息时的响应数据结构

| 字段 | 必填 | 类型 | 说明 | 示例/枚举 |
| --- | --- | --- | --- | --- |
| email | 否 | string | 用户邮箱 | zhangsan@example.com |
| id | 否 | string | 用户唯一标识ID | 1001 |
| phone | 否 | string | 用户手机号 | 13800138000 |
| sap | 否 | string | 用户SAP编号（商城端用户唯一标识） | SAP001 |
| sex | 否 | integer / int32 | 性别 1:男 2:女 | 1 |
| userName | 否 | string | 用户姓名 | 张三 |

## 商城端-用户积分信息

商城端获取用户积分余额时的响应数据结构

| 字段 | 必填 | 类型 | 说明 | 示例/枚举 |
| --- | --- | --- | --- | --- |
| id | 否 | string | 用户唯一标识ID | 1001 |
| integral | 否 | number / bigdecimal | 用户可用积分额度 | 5000 |
| phone | 否 | string | 用户手机号 | 13800138000 |
| sap | 否 | string | 用户SAP编号（商城端用户唯一标识） | SAP001 |
| userName | 否 | string | 用户姓名 | 张三 |

## 商城端-积分操作请求

商城端扣减或退还积分时的请求数据结构

| 字段 | 必填 | 类型 | 说明 | 示例/枚举 |
| --- | --- | --- | --- | --- |
| integralValue | 是 | number / bigdecimal | 积分数值（正整数） | 1000 |
| orderNum | 是 | string | 订单号（商城订单号，用于幂等校验） | ORDER202608210001 |
| sap | 是 | string | 用户SAP编号（从获取用户信息接口获得） | SAP001 |

## 商城端接口统一响应«Void»

商城端对接接口的统一响应格式，包含success/errorCode/message/data四个字段

| 字段 | 必填 | 类型 | 说明 | 示例/枚举 |
| --- | --- | --- | --- | --- |
| errorCode | 否 | string | 错误码（成功时为null） | 1001, 1002, 2001, 2002 |
| message | 否 | string | 提示信息 | 操作成功 |
| success | 否 | boolean | 请求是否成功 | true |

## 商城端接口统一响应«商城端-用户信息»

商城端对接接口的统一响应格式，包含success/errorCode/message/data四个字段

| 字段 | 必填 | 类型 | 说明 | 示例/枚举 |
| --- | --- | --- | --- | --- |
| data | 否 | 商城端-用户信息 | 业务数据体（无数据时为null） | - |
| errorCode | 否 | string | 错误码（成功时为null） | 1001, 1002, 2001, 2002 |
| message | 否 | string | 提示信息 | 操作成功 |
| success | 否 | boolean | 请求是否成功 | true |

## 商城端接口统一响应«商城端-用户积分信息»

商城端对接接口的统一响应格式，包含success/errorCode/message/data四个字段

| 字段 | 必填 | 类型 | 说明 | 示例/枚举 |
| --- | --- | --- | --- | --- |
| data | 否 | 商城端-用户积分信息 | 业务数据体（无数据时为null） | - |
| errorCode | 否 | string | 错误码（成功时为null） | 1001, 1002, 2001, 2002 |
| message | 否 | string | 提示信息 | 操作成功 |
| success | 否 | boolean | 请求是否成功 | true |

## 工作流任务相关--请求参数

| 字段 | 必填 | 类型 | 说明 | 示例/枚举 |
| --- | --- | --- | --- | --- |
| assignee | 否 | string | 审批人 | - |
| candidateGroups | 否 | array<string> | 审批组 | - |
| candidateUsers | 否 | array<string> | 候选人 | - |
| comment | 否 | string | 任务意见 | - |
| currentChildExecutionId | 否 | string | 子执行流ID | - |
| defId | 否 | string | 流程环节定义ID | - |
| deploymentId | 否 | string | - | - |
| flag | 否 | boolean | 子执行流是否已执行 | false |
| instanceId | 否 | string | 流程实例Id | - |
| result | 否 | string | 任务审批结果 1-同意 2-退回 | - |
| targetKey | 否 | string | 节点 | - |
| taskId | 否 | string | 任务Id | - |
| userId | 否 | string | 用户Id | - |
| variables | 否 | object | 流程变量信息 | - |

## 工作流任务相关-返回参数

| 字段 | 必填 | 类型 | 说明 | 示例/枚举 |
| --- | --- | --- | --- | --- |
| assigneeDeptName | 否 | string | 任务执行人部门 | - |
| assigneeId | 否 | string | 任务执行人Id | - |
| assigneeName | 否 | string | 任务执行人名称 | - |
| businessKey | 否 | string | 流程业务ID | - |
| candidate | 否 | string | 候选执行人 | - |
| candidateGroup | 否 | string | 候选执行组 | - |
| category | 否 | string | 流程类型 | - |
| comment | 否 | FlowCommentDto | 任务意见 | - |
| createTime | 否 | string / date-time | 任务创建时间 | - |
| deployId | 否 | string | 流程部署编号 | - |
| deptName | 否 | string | 部门名称 | - |
| duration | 否 | string | 任务耗时 | - |
| endTime | 否 | string / date-time | 流程完成时间 | - |
| executionId | 否 | string | 任务执行编号 | - |
| finishTime | 否 | string / date-time | 任务完成时间 | - |
| hisProcInsId | 否 | string | 历史流程实例ID | - |
| ishq | 否 | boolean | 是否会签 | false |
| procDefId | 否 | string | 流程ID | - |
| procDefKey | 否 | string | 流程key | - |
| procDefName | 否 | string | 流程定义名称 | - |
| procDefVersion | 否 | integer / int32 | 流程定义内置使用版本 | - |
| procInsId | 否 | string | 流程实例ID | - |
| procVars | 否 | object | 流程变量信息 | - |
| startDeptName | 否 | string | 流程发起人部门名称 | - |
| startUserId | 否 | string | 流程发起人Id | - |
| startUserName | 否 | string | 流程发起人名称 | - |
| taskDefKey | 否 | string | 任务Key | - |
| taskId | 否 | string | 任务编号 | - |
| taskLocalVars | 否 | object | 局部变量信息 | - |
| taskName | 否 | string | 任务名称 | - |
| taskNum | 否 | string | 开始节点/结束节点 start--开始节点  end--结束节点  | - |

## 工作流签字任务相关--请求参数

| 字段 | 必填 | 类型 | 说明 | 示例/枚举 |
| --- | --- | --- | --- | --- |
| assignee | 否 | string | 审批人 | - |
| candidateGroups | 否 | array<string> | 审批组 | - |
| candidateUsers | 否 | array<string> | 候选人 | - |
| 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 | - |

## 操作审计日志

| 字段 | 必填 | 类型 | 说明 | 示例/枚举 |
| --- | --- | --- | --- | --- |
| afterData | 否 | string | 操作后数据（JSON） | - |
| beforeData | 否 | string | 操作前数据（JSON） | - |
| bizId | 否 | string | 业务单号 | - |
| createTime | 否 | string / date-time | 操作时间 | - |
| id | 否 | integer / int64 | 主键ID | - |
| operationType | 否 | string | 操作类型：AUDIT_PASS-审核通过 POINTS_ADJUST-积分调整 EXCHANGE_REFUND-兑换退款 | - |
| operator | 否 | string | 操作人 | - |
| operatorIp | 否 | string | 操作人IP地址 | - |
| remark | 否 | string | 操作备注 | - |

## 流程定义

| 字段 | 必填 | 类型 | 说明 | 示例/枚举 |
| --- | --- | --- | --- | --- |
| category | 否 | string | 流程分类 | - |
| deploymentId | 否 | string | 部署ID | - |
| deploymentTime | 否 | string / date-time | 部署时间 | - |
| deptId | 否 | string | 所属机构ID | - |
| deptName | 否 | string | 所属机构名称 | - |
| flowKey | 否 | string | 流程key | - |
| formId | 否 | integer / int64 | 配置表单id | - |
| formName | 否 | string | 配置表单名称 | - |
| id | 否 | string | 流程id | - |
| name | 否 | string | 流程名称 | - |
| suspensionState | 否 | integer / int32 | 流程定义状态: 1:激活 , 2:中止 | - |
| version | 否 | integer / int32 | 版本 | - |

## 用户积分账户

| 字段 | 必填 | 类型 | 说明 | 示例/枚举 |
| --- | --- | --- | --- | --- |
| availableBalance | 否 | integer / int32 | 可用积分余额 | - |
| createTime | 否 | string / date-time | 创建时间 | - |
| frozenBalance | 否 | integer / int32 | 冻结积分余额 | - |
| id | 否 | integer / int64 | 主键ID | - |
| totalIncome | 否 | integer / int32 | 历史总入账积分 | - |
| totalOutcome | 否 | integer / int32 | 历史总出账积分 | - |
| updateTime | 否 | string / date-time | 更新时间 | - |
| userId | 否 | integer / int64 | 用户ID | - |
| version | 否 | integer / int32 | 乐观锁版本号 | - |

## 积分兑换订单

| 字段 | 必填 | 类型 | 说明 | 示例/枚举 |
| --- | --- | --- | --- | --- |
| createTime | 否 | string / date-time | - | - |
| factoryDeptId | 否 | string | 所属厂区部门ID | - |
| finishTime | 否 | string / date-time | 完成时间 | - |
| id | 否 | integer / int64 | 主键ID | - |
| itemId | 否 | integer / int64 | 兑换物品ID | - |
| itemName | 否 | string | 物品名称 | - |
| itemPrice | 否 | integer / int32 | 兑换所需积分 | - |
| orderNo | 否 | string | 订单号 | - |
| quantity | 否 | integer / int32 | 兑换数量 | - |
| status | 否 | integer / int32 | 订单状态：0-待处理 1-处理中 2-兑换成功 3-兑换失败 4-已退款 5-已关闭 | - |
| thirdPartyOrderId | 否 | string | 第三方平台订单号 | - |
| thirdPartyResponse | 否 | string | 第三方回调原始数据 | - |
| totalPoints | 否 | integer / int32 | 总消耗积分 | - |
| updateTime | 否 | string / date-time | 更新时间 | - |
| userId | 否 | integer / int64 | 用户ID | - |

## 积分流水明细

| 字段 | 必填 | 类型 | 说明 | 示例/枚举 |
| --- | --- | --- | --- | --- |
| afterBalance | 否 | integer / int32 | 变动后可用余额 | - |
| afterFrozen | 否 | integer / int32 | 变动后冻结余额 | - |
| amount | 否 | integer / int32 | 变动积分（正数=入账，负数=出账） | - |
| beforeBalance | 否 | integer / int32 | 变动前可用余额 | - |
| beforeFrozen | 否 | integer / int32 | 变动前冻结余额 | - |
| bizId | 否 | string | 业务单号 | - |
| bizType | 否 | string | 业务类型：REPORT-隐患上报奖励 EXCHANGE-兑换扣减 REFUND-退款回滚 FREEZE-冻结 UNFREEZE-解冻 | - |
| createTime | 否 | string / date-time | 创建时间 | - |
| factoryDeptId | 否 | string | 所属厂区部门ID | - |
| id | 否 | integer / int64 | 主键ID | - |
| operator | 否 | string | 操作人 | - |
| remark | 否 | string | 备注 | - |
| status | 否 | integer / int32 | 状态：1-有效 2-已冲正 | - |
| txnNo | 否 | string | 流水号 | - |
| userId | 否 | integer / int64 | 用户ID | - |

## 积分申诉

| 字段 | 必填 | 类型 | 说明 | 示例/枚举 |
| --- | --- | --- | --- | --- |
| adjustPoints | 否 | integer / int32 | 调整积分（正数补发，负数扣减） | - |
| appealNo | 否 | string | 申诉编号 | - |
| appealReason | 否 | string | 申诉理由 | - |
| appealType | 否 | string | 申诉类型：REJECT-审核驳回申诉 POINTS-积分异议 OTHER-其他 | - |
| attachmentUrls | 否 | string | 附件URL（JSON数组） | - |
| canApprove | 否 | boolean | 当前用户是否可审批此流程 | false |
| createTime | 否 | string / date-time | 创建时间 | - |
| factoryDeptId | 否 | string | 所属厂区部门ID | - |
| factoryDeptName | 否 | string | 所属厂区部门名称 | - |
| flowInstanceId | 否 | string | 流程实例ID（预留） | - |
| flowStatus | 否 | integer / int32 | 流程状态：0-无流程 1-进行中 2-已完成 | - |
| handleRemark | 否 | string | 处理意见/结果说明 | - |
| handleTime | 否 | string / date-time | 处理时间 | - |
| handleUserId | 否 | integer / int64 | 处理人用户ID | - |
| handleUserName | 否 | string | 处理人姓名 | - |
| id | 否 | integer / int64 | 主键ID | - |
| isInitiator | 否 | boolean | 当前用户是否为此流程发起人 | false |
| reportId | 否 | integer / int64 | 关联隐患上报ID | - |
| reportNo | 否 | string | 关联隐患编号 | - |
| status | 否 | string | 申诉状态：0-待受理 1-处理中 2-已通过 3-已驳回 4-已撤回 | - |
| statusName | 否 | string | 申诉状态名称 | - |
| updateTime | 否 | string / date-time | 更新时间 | - |
| userId | 否 | integer / int64 | 申诉人用户ID | - |
| userName | 否 | string | 申诉人姓名 | - |

## 积分规则配置

| 字段 | 必填 | 类型 | 说明 | 示例/枚举 |
| --- | --- | --- | --- | --- |
| createTime | 否 | string / date-time | 创建时间 | - |
| deptId | 否 | string | 所属厂区部门ID（NULL表示全局兜底规则，二级管理员新增时自动填充） | 100 |
| deptName | 否 | string | 所属厂区部门名称 | 一厂 |
| enabled | 否 | integer / int32 | 是否启用：0-禁用 1-启用 | - |
| hazardCategory | 否 | string | 隐患类别 | - |
| hazardLevel | 否 | string | 隐患等级编码（general/major/critical） | - |
| id | 否 | integer / int64 | 主键ID | - |
| points | 否 | integer / int32 | 奖励积分 | - |
| priority | 否 | integer / int32 | 优先级（数字越大优先级越高） | - |
| remark | 否 | string | 备注 | - |
| ruleCode | 否 | string | 规则编码 | - |
| ruleName | 否 | string | 规则名称 | - |
| updateTime | 否 | string / date-time | 更新时间 | - |

## 防刷分管控配置

| 字段 | 必填 | 类型 | 说明 | 示例/枚举 |
| --- | --- | --- | --- | --- |
| configName | 否 | string | 配置名称 | - |
| createTime | 否 | string / date-time | 创建时间 | - |
| dailyPointsEarnLimit | 否 | integer / int32 | 每人每日积分获取上限 | - |
| dailyReportLimit | 否 | integer / int32 | 每人每日上报次数上限 | - |
| enabled | 否 | integer / int32 | 是否启用：1-启用 0-禁用 | - |
| id | 否 | integer / int64 | 主键ID | - |
| ipExchangeDailyLimit | 否 | integer / int32 | 同一IP每日兑换上限 | - |
| remark | 否 | string | 备注 | - |
| reportIntervalMinutes | 否 | integer / int32 | 两次上报最小间隔（分钟） | - |
| sameItemDailyLimit | 否 | integer / int32 | 同一商品每人每日兑换上限 | - |
| sameLocationReportLimit | 否 | integer / int32 | 同一地点上报次数上限（每日） | - |
| sameReporterAuditLimit | 否 | integer / int32 | 同一上报人每日通过审核次数上限 | - |
| selfReportCheckEnabled | 否 | integer / int32 | 是否启用自报自审检测：1-是 0-否 | - |
| updateTime | 否 | string / date-time | 更新时间 | - |

## 隐患上报流程提交请求

| 字段 | 必填 | 类型 | 说明 | 示例/枚举 |
| --- | --- | --- | --- | --- |
| attachments | 否 | array<隐患附件> | 附件列表（先调用uploadAttachment接口获取） | - |
| report | 是 | 隐患信息 | 隐患信息 | - |

## 隐患上报请求

| 字段 | 必填 | 类型 | 说明 | 示例/枚举 |
| --- | --- | --- | --- | --- |
| attachments | 否 | array<隐患附件> | 附件列表 | - |
| report | 否 | 隐患信息 | 隐患信息 | - |

## 隐患信息

| 字段 | 必填 | 类型 | 说明 | 示例/枚举 |
| --- | --- | --- | --- | --- |
| actualCompleteTime | 否 | string / date-time | 实际完成时间 | - |
| attachments | 否 | array<隐患附件> | 附件列表 | - |
| auditRemark | 否 | string | 审核备注 | - |
| auditTime | 否 | string / date-time | 审核时间 | - |
| auditUserId | 否 | integer / int64 | 审核人用户ID | - |
| auditUserName | 否 | string | 审核人姓名 | - |
| auditUserUsername | 否 | string | 审核人账号 | - |
| canApprove | 否 | boolean | 当前用户是否可审批此流程 | false |
| causeAnalysis | 否 | string | 原因分析 | - |
| chargePersonId | 否 | integer / int64 | 整改负责人用户ID | - |
| chargePersonName | 否 | string | 整改负责人姓名 | - |
| chargePersonUsername | 否 | string | 整改负责人账号 | - |
| createBy | 否 | string | 创建者 | - |
| createTime | 否 | string / date-time | 创建时间 | - |
| criteriaIds | 否 | string | 判定标准ID（多选，逗号分隔） | - |
| criteriaNames | 否 | string | 判定标准名称 | - |
| currentFlowLevel | 否 | string | 当前流程等级编码（general/major/critical） | - |
| departmentId | 否 | integer / int64 | 部门ID | - |
| departmentName | 否 | string | 部门名称 | - |
| deployId | 否 | string | 流程模板id | - |
| description | 否 | string | 隐患描述 | - |
| discoverTime | 否 | string / date-time | 发现时间 | - |
| factoryDeptId | 否 | string | 所属厂区部门ID | - |
| factoryDeptName | 否 | string | 所属厂区部门名称 | - |
| factoryManagerId | 否 | integer / int64 | 厂区管理员用户ID | - |
| factoryManagerName | 否 | string | 厂区管理员姓名 | - |
| finalFlowLevel | 否 | string | 审批最终等级名称（如一般-A档） | - |
| finalFlowLevelId | 否 | integer / int64 | 审批最终积分规则ID（关联积分规则表） | - |
| flowInstanceId | 否 | string | 流程实例id | - |
| flowStatus | 否 | integer / int32 | 流程状态（0-未开始 1-进行中 2-已完成） | - |
| fundsSource | 否 | string | 资金来源编码 | - |
| fundsSourceId | 否 | integer / int64 | 资金来源字典ID | - |
| fundsSourceName | 否 | string | 资金来源名称 | - |
| governanceType | 否 | string | 治理类型编码 | - |
| governanceTypeId | 否 | integer / int64 | 治理类型字典ID | - |
| governanceTypeName | 否 | string | 治理类型名称 | - |
| hazardCategory | 否 | string | 隐患分类编码（general/major/critical） | - |
| hazardCategoryId | 否 | integer / int64 | 隐患分类根规则ID（关联积分规则表） | - |
| hazardCategoryName | 否 | string | 隐患分类名称 | - |
| hazardClassificationStandard | 否 | string | 隐患分类标准（文本说明，用于隐患分类的说明） | - |
| hazardLevel | 否 | string | 管理级别编码 | - |
| hazardLevelId | 否 | integer / int64 | 管理级别字典ID | - |
| hazardLevelName | 否 | string | 管理级别名称 | - |
| hazardName | 否 | string | 隐患名称 | - |
| hazardSourceDetail | 否 | string | 来源具体描述 | - |
| hazardType | 否 | string | 隐患类型编码 | - |
| hazardTypeId | 否 | integer / int64 | 隐患类型字典ID | - |
| hazardTypeName | 否 | string | 隐患类型名称 | - |
| id | 否 | integer / int64 | 主键ID | - |
| isInitiator | 否 | boolean | 当前用户是否为此流程发起人 | false |
| limitedCompleteTime | 否 | string / date-time | 限定完成时间 | - |
| major | 否 | string | 专业编码 | - |
| majorId | 否 | integer / int64 | 专业字典ID | - |
| majorName | 否 | string | 专业名称 | - |
| pointsAwarded | 否 | integer / int32 | 奖励积分 | - |
| pointsStatus | 否 | string | 积分发放状态编码 | - |
| pointsStatusId | 否 | integer / int64 | 积分发放状态字典ID | - |
| pointsStatusName | 否 | string | 积分发放状态名称 | - |
| preventiveMeasures | 否 | string | 防范措施 | - |
| pushResponse | 否 | string | 第三方返回结果 | - |
| pushStatus | 否 | string | 推送状态编码 | - |
| pushStatusId | 否 | integer / int64 | 推送状态字典ID | - |
| pushStatusName | 否 | string | 推送状态名称 | - |
| pushTime | 否 | string / date-time | 推送时间 | - |
| rectificationPlan | 否 | string | 整改方案 | - |
| remark | 否 | string | 备注 | - |
| reportNo | 否 | string | 隐患编号 | - |
| reporterId | 否 | integer / int64 | 上报人用户ID | - |
| reporterName | 否 | string | 上报人姓名 | - |
| reporterUsername | 否 | string | 上报人账号 | - |
| riskTarget | 否 | string | 风险分析对象 | - |
| riskUnit | 否 | string | 风险分析单元 | - |
| sourceType | 否 | string | 隐患来源编码 | - |
| sourceTypeId | 否 | integer / int64 | 隐患来源字典ID | - |
| sourceTypeName | 否 | string | 隐患来源名称 | - |
| status | 否 | string | 隐患状态编码 | - |
| statusId | 否 | integer / int64 | 隐患状态字典ID | - |
| statusName | 否 | string | 隐患状态名称 | - |
| supervisorId | 否 | integer / int64 | 监察人用户ID | - |
| supervisorName | 否 | string | 监察人姓名 | - |
| supervisorUsername | 否 | string | 监察人账号 | - |
| thirdPartyId | 否 | string | 第三方系统记录ID | - |
| unitId | 否 | integer / int64 | 单位ID | - |
| unitName | 否 | string | 单位名称 | - |
| updateBy | 否 | string | 更新者 | - |
| updateTime | 否 | string / date-time | 更新时间 | - |

## 隐患流程模板配置

| 字段 | 必填 | 类型 | 说明 | 示例/枚举 |
| --- | --- | --- | --- | --- |
| 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 | - | - |

## 隐患附件

| 字段 | 必填 | 类型 | 说明 | 示例/枚举 |
| --- | --- | --- | --- | --- |
| attachmentType | 否 | string | 附件类型：IMAGE-图片 VIDEO-视频 DOCUMENT-文档 OTHER-其他 | - |
| createBy | 否 | string | 创建者 | - |
| createTime | 否 | string / date-time | 创建时间 | - |
| fileName | 否 | string | 文件原始名称 | - |
| filePath | 否 | string | 文件存储路径 | - |
| fileSize | 否 | integer / int64 | 文件大小（字节） | - |
| fileType | 否 | string | 文件MIME类型 | - |
| fileUrl | 否 | string | 文件访问URL | - |
| id | 否 | integer / int64 | 主键ID | - |
| remark | 否 | string | 备注 | - |
| reportId | 否 | integer / int64 | 关联隐患ID | - |
| sortOrder | 否 | integer / int32 | 排序 | - |
| suffix | 否 | string | 文件后缀 | - |
| updateBy | 否 | string | 更新者 | - |
| updateTime | 否 | string / date-time | 更新时间 | - |
| uploadUserId | 否 | string | 上传人用户ID | - |
| uploadUserName | 否 | string | 上传人姓名 | - |