You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
17 KiB
17 KiB
积分规则配置
本模块共 13 个接口。源文件：api.json。
快速索引
| 接口名称 | 方法 | 路径 | 用途 |
|---|---|---|---|
| 新增积分规则 | POST | /gd_dataserver/business/points/rule/add |
二级管理员自动填充厂区信息，且不可创建全局兜底规则；超级管理员可指定 deptId（为空表示全局兜底规则）。 |
| 计算积分 | GET | /gd_dataserver/business/points/rule/calculatePoints |
根据厂区、隐患等级和类别查询对应奖励积分。二级管理员调用时 deptId 自动填充为所属厂区，超管可传任意厂区（不传则匹配全局兜底）。返回 data 为 Integer 类型的积分数值。 |
| 删除积分规则 | GET | /gd_dataserver/business/points/rule/deleteById |
根据主键ID物理删除。二级管理员只能删除本厂区规则；全局兜底规则仅超级管理员可删除。 |
| 分页查询积分规则（兼容旧路径） | GET | /gd_dataserver/business/points/rule/getListByPage |
同 /list 接口，保留用于前端旧路径兼容。二级管理员自动过滤本厂区。 |
| 获取积分规则详情 | GET | /gd_dataserver/business/points/rule/info |
根据主键ID查询规则详情。二级管理员访问非本厂区规则或全局兜底规则时返回错误。 |
| 分页查询积分规则列表 | GET | /gd_dataserver/business/points/rule/list |
超级管理员返回所有厂区规则（可按deptId筛选，传global表示查询全局兜底规则）；二级管理员自动过滤为所属厂区规则。返回 data 为 PageInfo 分页对象。 |
| 查询当前厂区所有积分规则 | GET | /gd_dataserver/business/points/rule/myFactoryRules |
返回当前登录用户所属厂区的规则列表，同时包含全局兜底规则（dept_id 为 NULL）。返回 data 为 PointsRuleConfig 数组。 |
| 获取隐患分类根规则列表 | GET | /gd_dataserver/business/points/rule/rootRules |
返回当前用户厂区每个大类（一般/较大/重大）的最高优先级根规则，用于 APP 上报时隐患分类下拉选择。返回 data 为 PointsRuleConfig 数组（最多3条）。 |
| 获取积分规则树形结构 | GET | /gd_dataserver/business/points/rule/ruleTree |
返回当前用户厂区的积分规则树形结构，按大类（一般/较大/重大）分组，每个大类下包含子规则列表，用于审批时选择具体档次。返回 data 为数组，每项含 id/hazardLevel/hazardLevelName/ruleName/points/children。 |
| 获取指定等级下的积分规则列表 | GET | /gd_dataserver/business/points/rule/rulesByLevel |
根据隐患等级编码（general/major/critical）返回当前厂区该等级下的根规则和子档位列表，用于审批人在当前等级内选择具体档次。返回 data 为对象，包含 hazardLevel-等级编码、hazardLevelName-等级名称、root-根规则对象（可为null）、children-子档位规则数组。 |
| 启用/禁用积分规则 | POST | /gd_dataserver/business/points/rule/toggleEnabled |
enabled=1 启用，enabled=0 禁用。二级管理员只能操作本厂区规则。 |
| 积分规则试算 | GET | /gd_dataserver/business/points/rule/trialCalculate |
模拟积分计算过程，返回匹配的规则详情和计算结果。返回 data 为对象：deptId-生效厂区、hazardLevel-输入的隐患等级、hazardCategory-输入的隐患类别、matchedRule-匹配到的规则对象或null、calculatedPoints-计算得到的积分数值(无匹配时为0)、matchScope-命中范围(FACTORY-厂区专属/GLOBAL-全局兜底/NONE-未命中)。 |
| 修改积分规则 | POST | /gd_dataserver/business/points/rule/updateById |
二级管理员只能修改本厂区规则，不可变更所属厂区；超级管理员可任意修改。 |
接口详情
新增积分规则
- 用途： 二级管理员自动填充厂区信息，且不可创建全局兜底规则；超级管理员可指定 deptId（为空表示全局兜底规则）。
- 请求：
POST /gd_dataserver/business/points/rule/add - 鉴权：
X-Access-Token（以接口定义为准） - operationId：
addUsingPOST
参数：
无
请求体：
- Content-Type：
application/json - 模型：
积分规则配置 - 必填：文档未标记
| 字段 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
| 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 | 更新时间 | - |
响应：
| 状态码 | 说明 | 响应模型 |
|---|---|---|
| 200 | OK | /: object<string, object> |
| 201 | Created | - |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
计算积分
- 用途： 根据厂区、隐患等级和类别查询对应奖励积分。二级管理员调用时 deptId 自动填充为所属厂区，超管可传任意厂区（不传则匹配全局兜底）。返回 data 为 Integer 类型的积分数值。
- 请求：
GET /gd_dataserver/business/points/rule/calculatePoints - 鉴权：
X-Access-Token（以接口定义为准） - operationId：
calculatePointsUsingGET
参数：
| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|---|
| deptId | query | 否 | string | 厂区部门ID（二级管理员忽略此参数） | - |
| hazardLevel | query | 是 | string | 隐患等级编码 | - |
| hazardCategory | query | 是 | string | 隐患类别编码 | - |
响应：
| 状态码 | 说明 | 响应模型 |
|---|---|---|
| 200 | OK | /: object<string, object> |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
删除积分规则
- 用途： 根据主键ID物理删除。二级管理员只能删除本厂区规则；全局兜底规则仅超级管理员可删除。
- 请求：
GET /gd_dataserver/business/points/rule/deleteById - 鉴权：
X-Access-Token（以接口定义为准） - operationId：
deleteByIdUsingGET
参数：
| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|---|
| id | query | 是 | string | 主键ID | - |
响应：
| 状态码 | 说明 | 响应模型 |
|---|---|---|
| 200 | OK | /: object<string, object> |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
分页查询积分规则（兼容旧路径）
- 用途： 同 /list 接口，保留用于前端旧路径兼容。二级管理员自动过滤本厂区。
- 请求：
GET /gd_dataserver/business/points/rule/getListByPage - 鉴权：
X-Access-Token（以接口定义为准） - operationId：
getListByPageUsingGET_10
参数：
| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|---|
| createTime | query | 否 | string / date-time | 创建时间 | - |
| deptId | query | 否 | string | 所属厂区部门ID（NULL表示全局兜底规则，二级管理员新增时自动填充） | - |
| deptName | query | 否 | string | 所属厂区部门名称 | - |
| enabled | query | 否 | integer / int32 | 是否启用：0-禁用 1-启用 | - |
| hazardCategory | query | 否 | string | 隐患类别 | - |
| hazardLevel | query | 否 | string | 隐患等级编码（general/major/critical） | - |
| id | query | 否 | integer / int64 | 主键ID | - |
| pageNum | query | 否 | integer / int32 | 页码 | - |
| points | query | 否 | integer / int32 | 奖励积分 | - |
| priority | query | 否 | integer / int32 | 优先级（数字越大优先级越高） | - |
| remark | query | 否 | string | 备注 | - |
| ruleCode | query | 否 | string | 规则编码 | - |
| ruleName | query | 否 | string | 规则名称 | - |
| updateTime | query | 否 | string / date-time | 更新时间 | - |
| pageSize | query | 否 | integer / int32 | 每页条数 | - |
响应：
| 状态码 | 说明 | 响应模型 |
|---|---|---|
| 200 | OK | /: object<string, object> |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
获取积分规则详情
- 用途： 根据主键ID查询规则详情。二级管理员访问非本厂区规则或全局兜底规则时返回错误。
- 请求：
GET /gd_dataserver/business/points/rule/info - 鉴权：
X-Access-Token（以接口定义为准） - operationId：
infoUsingGET_10
参数：
| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|---|
| id | query | 是 | string | 主键ID | - |
响应：
| 状态码 | 说明 | 响应模型 |
|---|---|---|
| 200 | OK | /: object<string, object> |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
分页查询积分规则列表
- 用途： 超级管理员返回所有厂区规则（可按deptId筛选，传global表示查询全局兜底规则）；二级管理员自动过滤为所属厂区规则。返回 data 为 PageInfo 分页对象。
- 请求：
GET /gd_dataserver/business/points/rule/list - 鉴权：
X-Access-Token（以接口定义为准） - operationId：
listUsingGET_1
参数：
| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|---|
| pageNum | query | 是 | integer / int32 | 页码 | - |
| pageSize | query | 是 | integer / int32 | 每页条数 | - |
| deptId | query | 否 | string | 厂区部门ID（超管可传，二级管理员忽略；传 global 表示查询全局兜底规则） | - |
| hazardLevel | query | 否 | string | 隐患等级编码（general/major/critical） | - |
| hazardCategory | query | 否 | string | 隐患类别 | - |
| enabled | query | 否 | integer / int32 | 是否启用：0-禁用 1-启用 | - |
| ruleName | query | 否 | string | 规则名称（模糊匹配） | - |
响应：
| 状态码 | 说明 | 响应模型 |
|---|---|---|
| 200 | OK | /: object<string, object> |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
查询当前厂区所有积分规则
- 用途： 返回当前登录用户所属厂区的规则列表，同时包含全局兜底规则（dept_id 为 NULL）。返回 data 为 PointsRuleConfig 数组。
- 请求：
GET /gd_dataserver/business/points/rule/myFactoryRules - 鉴权：
X-Access-Token（以接口定义为准） - operationId：
myFactoryRulesUsingGET
参数：
无
响应：
| 状态码 | 说明 | 响应模型 |
|---|---|---|
| 200 | OK | /: object<string, object> |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
获取隐患分类根规则列表
- 用途： 返回当前用户厂区每个大类（一般/较大/重大）的最高优先级根规则，用于 APP 上报时隐患分类下拉选择。返回 data 为 PointsRuleConfig 数组（最多3条）。
- 请求：
GET /gd_dataserver/business/points/rule/rootRules - 鉴权：
X-Access-Token（以接口定义为准） - operationId：
rootRulesUsingGET
参数：
无
响应：
| 状态码 | 说明 | 响应模型 |
|---|---|---|
| 200 | OK | /: object<string, object> |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
获取积分规则树形结构
- 用途： 返回当前用户厂区的积分规则树形结构，按大类（一般/较大/重大）分组，每个大类下包含子规则列表，用于审批时选择具体档次。返回 data 为数组，每项含 id/hazardLevel/hazardLevelName/ruleName/points/children。
- 请求：
GET /gd_dataserver/business/points/rule/ruleTree - 鉴权：
X-Access-Token（以接口定义为准） - operationId：
ruleTreeUsingGET
参数：
无
响应：
| 状态码 | 说明 | 响应模型 |
|---|---|---|
| 200 | OK | /: object<string, object> |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
获取指定等级下的积分规则列表
- 用途： 根据隐患等级编码（general/major/critical）返回当前厂区该等级下的根规则和子档位列表，用于审批人在当前等级内选择具体档次。返回 data 为对象，包含 hazardLevel-等级编码、hazardLevelName-等级名称、root-根规则对象（可为null）、children-子档位规则数组。
- 请求：
GET /gd_dataserver/business/points/rule/rulesByLevel - 鉴权：
X-Access-Token（以接口定义为准） - operationId：
rulesByLevelUsingGET
参数：
| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|---|
| hazardLevel | query | 是 | string | 隐患等级编码（general/major/critical） | - |
| deptId | query | 否 | string | 厂区部门ID（仅超级管理员生效：传具体ID查看该厂区+全局，传global仅查看全局兜底，不传查看全部厂区） | - |
响应：
| 状态码 | 说明 | 响应模型 |
|---|---|---|
| 200 | OK | /: object<string, object> |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
启用/禁用积分规则
- 用途： enabled=1 启用，enabled=0 禁用。二级管理员只能操作本厂区规则。
- 请求：
POST /gd_dataserver/business/points/rule/toggleEnabled - 鉴权：
X-Access-Token（以接口定义为准） - operationId：
toggleEnabledUsingPOST
参数：
| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|---|
| id | query | 是 | integer / int64 | 规则ID | - |
| enabled | query | 是 | integer / int32 | 启用状态：0-禁用 1-启用 | - |
响应：
| 状态码 | 说明 | 响应模型 |
|---|---|---|
| 200 | OK | /: object<string, object> |
| 201 | Created | - |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
积分规则试算
- 用途： 模拟积分计算过程，返回匹配的规则详情和计算结果。返回 data 为对象：deptId-生效厂区、hazardLevel-输入的隐患等级、hazardCategory-输入的隐患类别、matchedRule-匹配到的规则对象或null、calculatedPoints-计算得到的积分数值(无匹配时为0)、matchScope-命中范围(FACTORY-厂区专属/GLOBAL-全局兜底/NONE-未命中)。
- 请求：
GET /gd_dataserver/business/points/rule/trialCalculate - 鉴权：
X-Access-Token（以接口定义为准） - operationId：
trialCalculateUsingGET
参数：
| 字段 | 位置 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|---|
| deptId | query | 否 | string | 厂区部门ID（二级管理员忽略此参数） | - |
| hazardLevel | query | 是 | string | 隐患等级编码 | - |
| hazardCategory | query | 是 | string | 隐患类别编码 | - |
响应：
| 状态码 | 说明 | 响应模型 |
|---|---|---|
| 200 | OK | /: object<string, object> |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
修改积分规则
- 用途： 二级管理员只能修改本厂区规则，不可变更所属厂区；超级管理员可任意修改。
- 请求：
POST /gd_dataserver/business/points/rule/updateById - 鉴权：
X-Access-Token（以接口定义为准） - operationId：
updateByIdUsingPOST_10
参数：
无
请求体：
- Content-Type：
application/json - 模型：
积分规则配置 - 必填：文档未标记
| 字段 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
| 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 | 更新时间 | - |
响应：
| 状态码 | 说明 | 响应模型 |
|---|---|---|
| 200 | OK | /: object<string, object> |
| 201 | Created | - |
| 401 | Unauthorized | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |