[ { "tag": "用户积分账户", "name": "新增", "usage": "新增单条记录，请求体为实体类对象（字段说明见对应实体模型）。成功返回 data 为 null。", "method": "POST", "path": "/gd_dataserver/business/points/balance/add", "operationId": "addOneUsingPOST", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "用户积分账户" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "用户积分账户", "name": "批量新增", "usage": "批量新增多条记录，请求体为实体类数组。成功返回 data 为 null。", "method": "POST", "path": "/gd_dataserver/business/points/balance/addBatch", "operationId": "addBatchUsingPOST", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "array<用户积分账户>" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "用户积分账户", "name": "新增并返回保存的数据", "usage": "新增单条记录并返回保存后的数据（含自增ID），请求体为实体类对象。成功返回 data 为保存的实体对象。", "method": "POST", "path": "/gd_dataserver/business/points/balance/addReturn", "operationId": "addReturnUsingPOST", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "用户积分账户" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "用户积分账户", "name": "手动调整积分（PC管理端）", "usage": "管理员手动补发或扣减指定用户的积分。points为正数补发，为负数扣减。操作会同时生成积分流水（bizType=MANUAL_ADD/MANUAL_DEDUCT）和审计日志。返回 data 为 boolean，true-调整成功。", "method": "POST", "path": "/gd_dataserver/business/points/balance/adjust", "operationId": "adjustPointsUsingPOST", "parameters": [], "requestBodies": [ { "contentType": "application/x-www-form-urlencoded", "schema": "integer / int32" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "用户积分账户", "name": "根据属性删除", "usage": "根据实体属性条件删除记录，请求体为实体类对象。成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/points/balance/delete", "operationId": "deleteUsingGET", "parameters": [ { "name": "availableBalance", "in": "query", "required": false, "type": "integer / int32", "description": "可用积分余额" }, { "name": "createTime", "in": "query", "required": false, "type": "string / date-time", "description": "创建时间" }, { "name": "frozenBalance", "in": "query", "required": false, "type": "integer / int32", "description": "冻结积分余额" }, { "name": "id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "totalIncome", "in": "query", "required": false, "type": "integer / int32", "description": "历史总入账积分" }, { "name": "totalOutcome", "in": "query", "required": false, "type": "integer / int32", "description": "历史总出账积分" }, { "name": "updateTime", "in": "query", "required": false, "type": "string / date-time", "description": "更新时间" }, { "name": "userId", "in": "query", "required": false, "type": "integer / int64", "description": "用户ID" }, { "name": "version", "in": "query", "required": false, "type": "integer / int32", "description": "乐观锁版本号" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "用户积分账户", "name": "主键删除", "usage": "根据主键ID删除单条记录，成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/points/balance/deleteById", "operationId": "deleteOneUsingGET", "parameters": [ { "name": "id", "in": "query", "required": true, "type": "string", "description": "主键ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "用户积分账户", "name": "批量删除", "usage": "根据ID列表批量删除记录，成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/points/balance/deleteByIds", "operationId": "deleteListUsingGET_1", "parameters": [ { "name": "ids", "in": "query", "required": true, "type": "string", "description": "ID列表(逗号分隔)" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "用户积分账户", "name": "查询所有", "usage": "查询所有记录（无分页、无条件）。成功返回 data 为实体类数组。", "method": "GET", "path": "/gd_dataserver/business/points/balance/getAll", "operationId": "getAllUsingGET", "parameters": [], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "用户积分账户", "name": "查询用户积分账户", "usage": "返回 data 为 AccountBalance 对象。字段：userId-用户ID、availableBalance-可用积分余额、frozenBalance-冻结积分、totalIncome-历史总入账、totalOutcome-历史总出账。", "method": "GET", "path": "/gd_dataserver/business/points/balance/getByUserId/{userId}", "operationId": "getByUserIdUsingGET", "parameters": [ { "name": "userId", "in": "path", "required": true, "type": "integer / int64", "description": "用户ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "用户积分账户", "name": "分页查询", "usage": "分页查询记录列表，查询条件为实体类字段。成功返回 data 为 PageInfo 分页对象，其中 list 为实体类数组。", "method": "GET", "path": "/gd_dataserver/business/points/balance/getListByPage", "operationId": "getListByPageUsingGET", "parameters": [ { "name": "availableBalance", "in": "query", "required": false, "type": "integer / int32", "description": "可用积分余额" }, { "name": "createTime", "in": "query", "required": false, "type": "string / date-time", "description": "创建时间" }, { "name": "frozenBalance", "in": "query", "required": false, "type": "integer / int32", "description": "冻结积分余额" }, { "name": "id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "pageNum", "in": "query", "required": true, "type": "integer / int32", "description": "页码" }, { "name": "totalIncome", "in": "query", "required": false, "type": "integer / int32", "description": "历史总入账积分" }, { "name": "totalOutcome", "in": "query", "required": false, "type": "integer / int32", "description": "历史总出账积分" }, { "name": "updateTime", "in": "query", "required": false, "type": "string / date-time", "description": "更新时间" }, { "name": "userId", "in": "query", "required": false, "type": "integer / int64", "description": "用户ID" }, { "name": "version", "in": "query", "required": false, "type": "integer / int32", "description": "乐观锁版本号" }, { "name": "pageSize", "in": "query", "required": true, "type": "integer / int32", "description": "每页条数" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "用户积分账户", "name": "详情", "usage": "根据主键ID查询单条记录详情。成功返回 data 为实体类对象，包含该实体所有字段。", "method": "GET", "path": "/gd_dataserver/business/points/balance/info", "operationId": "infoUsingGET", "parameters": [ { "name": "id", "in": "query", "required": true, "type": "string", "description": "主键ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "用户积分账户", "name": "条件查询", "usage": "根据实体属性条件查询记录列表。成功返回 data 为实体类数组。", "method": "GET", "path": "/gd_dataserver/business/points/balance/list", "operationId": "getListUsingGET", "parameters": [ { "name": "availableBalance", "in": "query", "required": false, "type": "integer / int32", "description": "可用积分余额" }, { "name": "createTime", "in": "query", "required": false, "type": "string / date-time", "description": "创建时间" }, { "name": "frozenBalance", "in": "query", "required": false, "type": "integer / int32", "description": "冻结积分余额" }, { "name": "id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "totalIncome", "in": "query", "required": false, "type": "integer / int32", "description": "历史总入账积分" }, { "name": "totalOutcome", "in": "query", "required": false, "type": "integer / int32", "description": "历史总出账积分" }, { "name": "updateTime", "in": "query", "required": false, "type": "string / date-time", "description": "更新时间" }, { "name": "userId", "in": "query", "required": false, "type": "integer / int64", "description": "用户ID" }, { "name": "version", "in": "query", "required": false, "type": "integer / int32", "description": "乐观锁版本号" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "用户积分账户", "name": "查询当前用户积分账户（APP端）", "usage": "返回 data 为 AccountBalance 对象。字段：userId-用户ID、availableBalance-可用积分余额、frozenBalance-冻结积分、totalIncome-历史总入账、totalOutcome-历史总出账。", "method": "GET", "path": "/gd_dataserver/business/points/balance/my", "operationId": "myBalanceUsingGET", "parameters": [], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "用户积分账户", "name": "逻辑删除", "usage": "根据主键ID逻辑删除单条记录，成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/points/balance/removeById", "operationId": "deleteListUsingGET", "parameters": [ { "name": "id", "in": "query", "required": true, "type": "string", "description": "主键ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "用户积分账户", "name": "修改", "usage": "根据主键ID修改记录，请求体为实体类对象（需包含id字段）。成功返回 data 为 null。", "method": "POST", "path": "/gd_dataserver/business/points/balance/updateById", "operationId": "updateByIdUsingPOST", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "用户积分账户" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "防刷分管控配置", "name": "获取启用的防刷配置", "usage": "返回 data 为 AntiFarmConfig 对象，包含当前生效的防刷规则配置。", "method": "GET", "path": "/gd_dataserver/business/points/anti/farm/active", "operationId": "getActiveConfigUsingGET", "parameters": [], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "防刷分管控配置", "name": "新增", "usage": "新增单条记录，请求体为实体类对象（字段说明见对应实体模型）。成功返回 data 为 null。", "method": "POST", "path": "/gd_dataserver/business/points/anti/farm/add", "operationId": "addOneUsingPOST_1", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "防刷分管控配置" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "防刷分管控配置", "name": "批量新增", "usage": "批量新增多条记录，请求体为实体类数组。成功返回 data 为 null。", "method": "POST", "path": "/gd_dataserver/business/points/anti/farm/addBatch", "operationId": "addBatchUsingPOST_1", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "array<防刷分管控配置>" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "防刷分管控配置", "name": "新增并返回保存的数据", "usage": "新增单条记录并返回保存后的数据（含自增ID），请求体为实体类对象。成功返回 data 为保存的实体对象。", "method": "POST", "path": "/gd_dataserver/business/points/anti/farm/addReturn", "operationId": "addReturnUsingPOST_1", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "防刷分管控配置" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "防刷分管控配置", "name": "根据属性删除", "usage": "根据实体属性条件删除记录，请求体为实体类对象。成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/points/anti/farm/delete", "operationId": "deleteUsingGET_1", "parameters": [ { "name": "configName", "in": "query", "required": false, "type": "string", "description": "配置名称" }, { "name": "createTime", "in": "query", "required": false, "type": "string / date-time", "description": "创建时间" }, { "name": "dailyPointsEarnLimit", "in": "query", "required": false, "type": "integer / int32", "description": "每人每日积分获取上限" }, { "name": "dailyReportLimit", "in": "query", "required": false, "type": "integer / int32", "description": "每人每日上报次数上限" }, { "name": "enabled", "in": "query", "required": false, "type": "integer / int32", "description": "是否启用：1-启用 0-禁用" }, { "name": "id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "ipExchangeDailyLimit", "in": "query", "required": false, "type": "integer / int32", "description": "同一IP每日兑换上限" }, { "name": "remark", "in": "query", "required": false, "type": "string", "description": "备注" }, { "name": "reportIntervalMinutes", "in": "query", "required": false, "type": "integer / int32", "description": "两次上报最小间隔（分钟）" }, { "name": "sameItemDailyLimit", "in": "query", "required": false, "type": "integer / int32", "description": "同一商品每人每日兑换上限" }, { "name": "sameLocationReportLimit", "in": "query", "required": false, "type": "integer / int32", "description": "同一地点上报次数上限（每日）" }, { "name": "sameReporterAuditLimit", "in": "query", "required": false, "type": "integer / int32", "description": "同一上报人每日通过审核次数上限" }, { "name": "selfReportCheckEnabled", "in": "query", "required": false, "type": "integer / int32", "description": "是否启用自报自审检测：1-是 0-否" }, { "name": "updateTime", "in": "query", "required": false, "type": "string / date-time", "description": "更新时间" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "防刷分管控配置", "name": "主键删除", "usage": "根据主键ID删除单条记录，成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/points/anti/farm/deleteById", "operationId": "deleteOneUsingGET_1", "parameters": [ { "name": "id", "in": "query", "required": true, "type": "string", "description": "主键ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "防刷分管控配置", "name": "批量删除", "usage": "根据ID列表批量删除记录，成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/points/anti/farm/deleteByIds", "operationId": "deleteListUsingGET_3", "parameters": [ { "name": "ids", "in": "query", "required": true, "type": "string", "description": "ID列表(逗号分隔)" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "防刷分管控配置", "name": "异常行为一键检测", "usage": "对指定用户执行全维度异常行为检测，聚合4类防刷校验（上报/积分获取/兑换）。返回 data 为对象，包含：userId-被检测用户ID、reportCheck-上报检测结果{passed-是否通过,reason-原因}、pointsEarnCheck-积分获取检测结果{passed,reason}、exchangeCheck-兑换检测结果{passed,reason}、overallPassed-综合是否通过(boolean)。", "method": "GET", "path": "/gd_dataserver/business/points/anti/farm/detectAll", "operationId": "detectAllUsingGET", "parameters": [ { "name": "userId", "in": "query", "required": true, "type": "integer / int64", "description": "被检测用户ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "防刷分管控配置", "name": "检测自报自审行为", "usage": "检测上报人和审核人是否为同一人。返回 data 为字符串，检测到异常时返回'检测到自报自审行为'，正常时返回'未检测到异常'。", "method": "GET", "path": "/gd_dataserver/business/points/anti/farm/detectSelfAudit", "operationId": "detectSelfAuditUsingGET", "parameters": [ { "name": "reporterId", "in": "query", "required": true, "type": "integer / int64", "description": "上报人ID" }, { "name": "auditorId", "in": "query", "required": true, "type": "integer / int64", "description": "审核人ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "防刷分管控配置", "name": "查询所有", "usage": "查询所有记录（无分页、无条件）。成功返回 data 为实体类数组。", "method": "GET", "path": "/gd_dataserver/business/points/anti/farm/getAll", "operationId": "getAllUsingGET_1", "parameters": [], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "防刷分管控配置", "name": "分页查询", "usage": "分页查询记录列表，查询条件为实体类字段。成功返回 data 为 PageInfo 分页对象，其中 list 为实体类数组。", "method": "GET", "path": "/gd_dataserver/business/points/anti/farm/getListByPage", "operationId": "getListByPageUsingGET_1", "parameters": [ { "name": "configName", "in": "query", "required": false, "type": "string", "description": "配置名称" }, { "name": "createTime", "in": "query", "required": false, "type": "string / date-time", "description": "创建时间" }, { "name": "dailyPointsEarnLimit", "in": "query", "required": false, "type": "integer / int32", "description": "每人每日积分获取上限" }, { "name": "dailyReportLimit", "in": "query", "required": false, "type": "integer / int32", "description": "每人每日上报次数上限" }, { "name": "enabled", "in": "query", "required": false, "type": "integer / int32", "description": "是否启用：1-启用 0-禁用" }, { "name": "id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "ipExchangeDailyLimit", "in": "query", "required": false, "type": "integer / int32", "description": "同一IP每日兑换上限" }, { "name": "pageNum", "in": "query", "required": true, "type": "integer / int32", "description": "页码" }, { "name": "remark", "in": "query", "required": false, "type": "string", "description": "备注" }, { "name": "reportIntervalMinutes", "in": "query", "required": false, "type": "integer / int32", "description": "两次上报最小间隔（分钟）" }, { "name": "sameItemDailyLimit", "in": "query", "required": false, "type": "integer / int32", "description": "同一商品每人每日兑换上限" }, { "name": "sameLocationReportLimit", "in": "query", "required": false, "type": "integer / int32", "description": "同一地点上报次数上限（每日）" }, { "name": "sameReporterAuditLimit", "in": "query", "required": false, "type": "integer / int32", "description": "同一上报人每日通过审核次数上限" }, { "name": "selfReportCheckEnabled", "in": "query", "required": false, "type": "integer / int32", "description": "是否启用自报自审检测：1-是 0-否" }, { "name": "updateTime", "in": "query", "required": false, "type": "string / date-time", "description": "更新时间" }, { "name": "pageSize", "in": "query", "required": true, "type": "integer / int32", "description": "每页条数" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "防刷分管控配置", "name": "详情", "usage": "根据主键ID查询单条记录详情。成功返回 data 为实体类对象，包含该实体所有字段。", "method": "GET", "path": "/gd_dataserver/business/points/anti/farm/info", "operationId": "infoUsingGET_1", "parameters": [ { "name": "id", "in": "query", "required": true, "type": "string", "description": "主键ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "防刷分管控配置", "name": "条件查询", "usage": "根据实体属性条件查询记录列表。成功返回 data 为实体类数组。", "method": "GET", "path": "/gd_dataserver/business/points/anti/farm/list", "operationId": "getListUsingGET_1", "parameters": [ { "name": "configName", "in": "query", "required": false, "type": "string", "description": "配置名称" }, { "name": "createTime", "in": "query", "required": false, "type": "string / date-time", "description": "创建时间" }, { "name": "dailyPointsEarnLimit", "in": "query", "required": false, "type": "integer / int32", "description": "每人每日积分获取上限" }, { "name": "dailyReportLimit", "in": "query", "required": false, "type": "integer / int32", "description": "每人每日上报次数上限" }, { "name": "enabled", "in": "query", "required": false, "type": "integer / int32", "description": "是否启用：1-启用 0-禁用" }, { "name": "id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "ipExchangeDailyLimit", "in": "query", "required": false, "type": "integer / int32", "description": "同一IP每日兑换上限" }, { "name": "remark", "in": "query", "required": false, "type": "string", "description": "备注" }, { "name": "reportIntervalMinutes", "in": "query", "required": false, "type": "integer / int32", "description": "两次上报最小间隔（分钟）" }, { "name": "sameItemDailyLimit", "in": "query", "required": false, "type": "integer / int32", "description": "同一商品每人每日兑换上限" }, { "name": "sameLocationReportLimit", "in": "query", "required": false, "type": "integer / int32", "description": "同一地点上报次数上限（每日）" }, { "name": "sameReporterAuditLimit", "in": "query", "required": false, "type": "integer / int32", "description": "同一上报人每日通过审核次数上限" }, { "name": "selfReportCheckEnabled", "in": "query", "required": false, "type": "integer / int32", "description": "是否启用自报自审检测：1-是 0-否" }, { "name": "updateTime", "in": "query", "required": false, "type": "string / date-time", "description": "更新时间" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "防刷分管控配置", "name": "逻辑删除", "usage": "根据主键ID逻辑删除单条记录，成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/points/anti/farm/removeById", "operationId": "deleteListUsingGET_2", "parameters": [ { "name": "id", "in": "query", "required": true, "type": "string", "description": "主键ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "防刷分管控配置", "name": "修改", "usage": "根据主键ID修改记录，请求体为实体类对象（需包含id字段）。成功返回 data 为 null。", "method": "POST", "path": "/gd_dataserver/business/points/anti/farm/updateById", "operationId": "updateByIdUsingPOST_1", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "防刷分管控配置" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "防刷分管控配置", "name": "校验兑换是否触发防刷", "usage": "返回 data 为对象，包含：triggered-是否触发、reason-触发原因。", "method": "GET", "path": "/gd_dataserver/business/points/anti/farm/validateExchange", "operationId": "validateExchangeUsingGET", "parameters": [ { "name": "userId", "in": "query", "required": true, "type": "integer / int64", "description": "用户ID" }, { "name": "itemId", "in": "query", "required": true, "type": "integer / int64", "description": "物品ID" }, { "name": "ip", "in": "query", "required": false, "type": "string", "description": "IP地址" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "防刷分管控配置", "name": "校验积分获取是否触发防刷", "usage": "返回 data 为对象，包含：triggered-是否触发、reason-触发原因。", "method": "GET", "path": "/gd_dataserver/business/points/anti/farm/validatePointsEarn", "operationId": "validatePointsEarnUsingGET", "parameters": [ { "name": "reporterId", "in": "query", "required": true, "type": "integer / int64", "description": "上报人ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "防刷分管控配置", "name": "校验上报是否触发防刷", "usage": "返回 data 为对象，包含：triggered-是否触发(boolean)、reason-触发原因。前端在上报前调用，若 triggered=true 则提示用户。", "method": "GET", "path": "/gd_dataserver/business/points/anti/farm/validateReport", "operationId": "validateReportUsingGET", "parameters": [ { "name": "userId", "in": "query", "required": true, "type": "integer / int64", "description": "用户ID" }, { "name": "location", "in": "query", "required": false, "type": "string", "description": "上报地点" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "操作审计日志", "name": "新增", "usage": "新增单条记录，请求体为实体类对象（字段说明见对应实体模型）。成功返回 data 为 null。", "method": "POST", "path": "/gd_dataserver/business/audit/log/add", "operationId": "addOneUsingPOST_2", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "操作审计日志" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "操作审计日志", "name": "批量新增", "usage": "批量新增多条记录，请求体为实体类数组。成功返回 data 为 null。", "method": "POST", "path": "/gd_dataserver/business/audit/log/addBatch", "operationId": "addBatchUsingPOST_2", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "array<操作审计日志>" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "操作审计日志", "name": "新增并返回保存的数据", "usage": "新增单条记录并返回保存后的数据（含自增ID），请求体为实体类对象。成功返回 data 为保存的实体对象。", "method": "POST", "path": "/gd_dataserver/business/audit/log/addReturn", "operationId": "addReturnUsingPOST_2", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "操作审计日志" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "操作审计日志", "name": "按业务单号查询审计日志", "usage": "根据业务单号（如隐患ID、订单ID）查询关联的所有审计日志，按时间倒序。返回 data 为 AuditLog 数组，每个元素包含：id、operator-操作人、operatorIp-操作人IP、operationType-操作类型(AUDIT_PASS/POINTS_ADJUST/EXCHANGE_REFUND)、bizId-业务单号、beforeData-操作前数据(JSON)、afterData-操作后数据(JSON)、remark-备注、createTime-操作时间。", "method": "GET", "path": "/gd_dataserver/business/audit/log/biz/{bizId}", "operationId": "listByBizIdUsingGET", "parameters": [ { "name": "bizId", "in": "path", "required": true, "type": "string", "description": "业务单号" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "操作审计日志", "name": "根据属性删除", "usage": "根据实体属性条件删除记录，请求体为实体类对象。成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/audit/log/delete", "operationId": "deleteUsingGET_2", "parameters": [ { "name": "afterData", "in": "query", "required": false, "type": "string", "description": "操作后数据（JSON）" }, { "name": "beforeData", "in": "query", "required": false, "type": "string", "description": "操作前数据（JSON）" }, { "name": "bizId", "in": "query", "required": false, "type": "string", "description": "业务单号" }, { "name": "createTime", "in": "query", "required": false, "type": "string / date-time", "description": "操作时间" }, { "name": "id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "operationType", "in": "query", "required": false, "type": "string", "description": "操作类型：AUDIT_PASS-审核通过 POINTS_ADJUST-积分调整 EXCHANGE_REFUND-兑换退款" }, { "name": "operator", "in": "query", "required": false, "type": "string", "description": "操作人" }, { "name": "operatorIp", "in": "query", "required": false, "type": "string", "description": "操作人IP地址" }, { "name": "remark", "in": "query", "required": false, "type": "string", "description": "操作备注" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "操作审计日志", "name": "主键删除", "usage": "根据主键ID删除单条记录，成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/audit/log/deleteById", "operationId": "deleteOneUsingGET_2", "parameters": [ { "name": "id", "in": "query", "required": true, "type": "string", "description": "主键ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "操作审计日志", "name": "批量删除", "usage": "根据ID列表批量删除记录，成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/audit/log/deleteByIds", "operationId": "deleteListUsingGET_5", "parameters": [ { "name": "ids", "in": "query", "required": true, "type": "string", "description": "ID列表(逗号分隔)" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "操作审计日志", "name": "查询所有", "usage": "查询所有记录（无分页、无条件）。成功返回 data 为实体类数组。", "method": "GET", "path": "/gd_dataserver/business/audit/log/getAll", "operationId": "getAllUsingGET_2", "parameters": [], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "操作审计日志", "name": "分页查询", "usage": "分页查询记录列表，查询条件为实体类字段。成功返回 data 为 PageInfo 分页对象，其中 list 为实体类数组。", "method": "GET", "path": "/gd_dataserver/business/audit/log/getListByPage", "operationId": "getListByPageUsingGET_2", "parameters": [ { "name": "afterData", "in": "query", "required": false, "type": "string", "description": "操作后数据（JSON）" }, { "name": "beforeData", "in": "query", "required": false, "type": "string", "description": "操作前数据（JSON）" }, { "name": "bizId", "in": "query", "required": false, "type": "string", "description": "业务单号" }, { "name": "createTime", "in": "query", "required": false, "type": "string / date-time", "description": "操作时间" }, { "name": "id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "operationType", "in": "query", "required": false, "type": "string", "description": "操作类型：AUDIT_PASS-审核通过 POINTS_ADJUST-积分调整 EXCHANGE_REFUND-兑换退款" }, { "name": "operator", "in": "query", "required": false, "type": "string", "description": "操作人" }, { "name": "operatorIp", "in": "query", "required": false, "type": "string", "description": "操作人IP地址" }, { "name": "pageNum", "in": "query", "required": true, "type": "integer / int32", "description": "页码" }, { "name": "remark", "in": "query", "required": false, "type": "string", "description": "操作备注" }, { "name": "pageSize", "in": "query", "required": true, "type": "integer / int32", "description": "每页条数" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "操作审计日志", "name": "详情", "usage": "根据主键ID查询单条记录详情。成功返回 data 为实体类对象，包含该实体所有字段。", "method": "GET", "path": "/gd_dataserver/business/audit/log/info", "operationId": "infoUsingGET_2", "parameters": [ { "name": "id", "in": "query", "required": true, "type": "string", "description": "主键ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "操作审计日志", "name": "条件查询", "usage": "根据实体属性条件查询记录列表。成功返回 data 为实体类数组。", "method": "GET", "path": "/gd_dataserver/business/audit/log/list", "operationId": "getListUsingGET_2", "parameters": [ { "name": "afterData", "in": "query", "required": false, "type": "string", "description": "操作后数据（JSON）" }, { "name": "beforeData", "in": "query", "required": false, "type": "string", "description": "操作前数据（JSON）" }, { "name": "bizId", "in": "query", "required": false, "type": "string", "description": "业务单号" }, { "name": "createTime", "in": "query", "required": false, "type": "string / date-time", "description": "操作时间" }, { "name": "id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "operationType", "in": "query", "required": false, "type": "string", "description": "操作类型：AUDIT_PASS-审核通过 POINTS_ADJUST-积分调整 EXCHANGE_REFUND-兑换退款" }, { "name": "operator", "in": "query", "required": false, "type": "string", "description": "操作人" }, { "name": "operatorIp", "in": "query", "required": false, "type": "string", "description": "操作人IP地址" }, { "name": "remark", "in": "query", "required": false, "type": "string", "description": "操作备注" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "操作审计日志", "name": "逻辑删除", "usage": "根据主键ID逻辑删除单条记录，成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/audit/log/removeById", "operationId": "deleteListUsingGET_4", "parameters": [ { "name": "id", "in": "query", "required": true, "type": "string", "description": "主键ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "操作审计日志", "name": "修改", "usage": "根据主键ID修改记录，请求体为实体类对象（需包含id字段）。成功返回 data 为 null。", "method": "POST", "path": "/gd_dataserver/business/audit/log/updateById", "operationId": "updateByIdUsingPOST_2", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "操作审计日志" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "工作流流程_公用信息", "name": "获取流程详情", "usage": "根据流程实例ID查询流程详细信息，返回 data 包含流程节点、审批记录、当前状态等。", "method": "GET", "path": "/gd_dataserver/flowable/busiInfo/getProcessDetail", "operationId": "getProcessDetailUsingGET", "parameters": [ { "name": "id", "in": "query", "required": true, "type": "string", "description": "流程实例ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "工作流流程_签字审批", "name": "审批任务", "usage": "审批通过或驳回，需携带taskId、result、comment等信息。成功返回 data 为 null；失败返回 error 信息。", "method": "POST", "path": "/gd_dataserver/flowable/busiTask/complete", "operationId": "completeUsingPOST", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "工作流签字任务相关--请求参数" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "工作流流程_签字审批", "name": "获取当前节点信息", "usage": "根据任务ID查询当前节点详情，返回 data 为节点信息字符串。", "method": "GET", "path": "/gd_dataserver/flowable/busiTask/getCurrentNode", "operationId": "getCurrentNodeUsingGET", "parameters": [ { "name": "taskId", "in": "query", "required": true, "type": "string", "description": "任务ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "common-controller", "name": "文件删除接口", "usage": "", "method": "POST", "path": "/gd_dataserver/common/deletefile", "operationId": "deletefileUsingPOST", "parameters": [ { "name": "fileName", "in": "query", "required": true, "type": "string", "description": "fileName" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "common-controller", "name": "文件删除接口", "usage": "", "method": "POST", "path": "/gd_dataserver/common/deletefilelist", "operationId": "deletefilelistUsingPOST", "parameters": [ { "name": "fileNamelist", "in": "query", "required": true, "type": "string", "description": "fileNamelist" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "数据分析", "name": "首页数据看板", "usage": "返回 data 为对象，包含：totalHazard-隐患总数、monthHazard-本月新增隐患、pendingHazard-待处理隐患、totalPoints-积分总量、monthPoints-本月发放积分、onTimeRate-准时率(%)、todayExchangeCount-今日兑换单数、todayPointsIssued-今日发放积分数。", "method": "GET", "path": "/gd_dataserver/business/points/analysis/dashboard", "operationId": "dashboardUsingGET", "parameters": [], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "数据分析", "name": "隐患热力图-按部门统计", "usage": "返回 data 为数组，每个元素包含：departmentId-部门ID、departmentName-部门名称、hazardCount-隐患数量。", "method": "GET", "path": "/gd_dataserver/business/points/analysis/heatmap/department", "operationId": "heatmapByDepartmentUsingGET", "parameters": [ { "name": "unitId", "in": "query", "required": false, "type": "integer / int64", "description": "单位ID" }, { "name": "startTime", "in": "query", "required": false, "type": "string / date-time", "description": "开始时间(yyyy-MM-dd)" }, { "name": "endTime", "in": "query", "required": false, "type": "string / date-time", "description": "结束时间(yyyy-MM-dd)" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "数据分析", "name": "隐患热力图-按单位统计", "usage": "返回 data 为数组，每个元素包含：unitId-单位ID、unitName-单位名称、hazardCount-隐患数量。", "method": "GET", "path": "/gd_dataserver/business/points/analysis/heatmap/unit", "operationId": "heatmapByUnitUsingGET", "parameters": [ { "name": "startTime", "in": "query", "required": false, "type": "string / date-time", "description": "开始时间(yyyy-MM-dd)" }, { "name": "endTime", "in": "query", "required": false, "type": "string / date-time", "description": "结束时间(yyyy-MM-dd)" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "数据分析", "name": "首页-核心指标概览", "usage": "按账户权限统计（管理员全部、其它账户仅本厂区）。返回 data 为对象，包含：pendingAuditCount-待审核数、monthClosedCount-本月已闭环数、todayReportCount-今日新增上报数、todayExchangeCount-今日兑换单数、todayPointsIssued-今日发放积分数。", "method": "GET", "path": "/gd_dataserver/business/points/analysis/home/overview", "operationId": "homeOverviewUsingGET", "parameters": [], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "数据分析", "name": "首页-待办与预警", "usage": "按账户权限统计（管理员全部、其它账户仅本厂区）。返回 data 为对象，包含：pendingAuditOver24hCount-待审核超24h条数、riskWarningCount-风控预警(集中兑换)条数、pendingAppealCount-申诉待处理条数。", "method": "GET", "path": "/gd_dataserver/business/points/analysis/home/todo-warning", "operationId": "homeTodoWarningUsingGET", "parameters": [], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "数据分析", "name": "首页-近7日趋势与最新上报", "usage": "按账户权限统计（管理员全部、其它账户仅本厂区）。返回 data 为对象，trend7d-近7日每日上报数组(元素含date、count)，latestReports-最新上报前5条(含id、reportNo、hazardName、hazardLevelName、status、statusName、reporterName、factoryDeptName、createTime)。", "method": "GET", "path": "/gd_dataserver/business/points/analysis/home/trend-latest", "operationId": "homeTrendAndLatestUsingGET", "parameters": [], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "数据分析", "name": "兑换排行统计（按单位）", "usage": "按单位统计兑换数据，仅统计兑换成功(status=2)的订单。返回 data 为数组，每个元素包含：unitId-单位ID、unitName-单位名称、orderCount-兑换单数、totalPoints-消耗积分总量、userCount-兑换人数。", "method": "GET", "path": "/gd_dataserver/business/points/analysis/ranking/exchange", "operationId": "exchangeRankingByUnitUsingGET", "parameters": [ { "name": "startTime", "in": "query", "required": false, "type": "string / date-time", "description": "开始时间(yyyy-MM-dd)" }, { "name": "endTime", "in": "query", "required": false, "type": "string / date-time", "description": "结束时间(yyyy-MM-dd)" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "数据分析", "name": "积分排行榜-本月获取", "usage": "返回 data 为数组，每个元素包含：userId-用户ID、userName-用户姓名、monthIncome-本月获取积分、rank-排名。", "method": "GET", "path": "/gd_dataserver/business/points/analysis/ranking/monthlyPoints", "operationId": "monthlyPointsRankingUsingGET", "parameters": [ { "name": "topN", "in": "query", "required": false, "type": "integer / int32", "description": "前N名" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "数据分析", "name": "我的积分排名（APP端）", "usage": "查询当前登录用户的积分排名，返回userId、totalIncome、rank", "method": "GET", "path": "/gd_dataserver/business/points/analysis/ranking/myRank", "operationId": "myRankUsingGET", "parameters": [], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "数据分析", "name": "积分排行榜-总入账", "usage": "返回 data 为数组，每个元素包含：userId-用户ID、userName-用户姓名、totalIncome-总入账积分、rank-排名。按 totalIncome 降序排列。", "method": "GET", "path": "/gd_dataserver/business/points/analysis/ranking/points", "operationId": "pointsRankingUsingGET", "parameters": [ { "name": "topN", "in": "query", "required": false, "type": "integer / int32", "description": "前N名" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "数据分析", "name": "上报积分排行", "usage": "返回 data 为数组，每个元素包含：userId-用户ID、userName-用户姓名、reportCount-上报次数、rank-排名。按上报次数降序。", "method": "GET", "path": "/gd_dataserver/business/points/analysis/ranking/report", "operationId": "reportPointsRankingUsingGET", "parameters": [ { "name": "topN", "in": "query", "required": false, "type": "integer / int32", "description": "前N名" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "数据分析", "name": "月度安全运营报告（JSON）", "usage": "查询指定月份的运营数据，支持查询全年或单月。month=0 表示查询全年各月数据，month=1~12 表示查询指定月份。返回 data 为 MonthlyReportVO 数组，每个元素包含：month-月份、hazardCount-隐患总数、approvedCount-已通过数、rejectedCount-已驳回数、pointsIssued-发放积分、avgProcessHours-平均处理时长(小时)、onTimeRate-准时率(%)、exchangeOrderCount-兑换单数、exchangePoints-兑换消耗积分。", "method": "GET", "path": "/gd_dataserver/business/points/analysis/report/monthly", "operationId": "monthlyReportUsingGET", "parameters": [ { "name": "year", "in": "query", "required": true, "type": "integer / int32", "description": "年份" }, { "name": "month", "in": "query", "required": false, "type": "integer / int32", "description": "月份(0=全年,1-12=指定月)" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "数据分析", "name": "月度安全运营报告导出（Excel）", "usage": "导出指定月份的运营数据为 Excel 文件。month=0 表示导出全年各月数据，month=1~12 表示导出指定月份。直接下载 Excel 文件，无需解析返回数据。", "method": "GET", "path": "/gd_dataserver/business/points/analysis/report/monthly/export", "operationId": "exportMonthlyReportUsingGET", "parameters": [ { "name": "year", "in": "query", "required": true, "type": "integer / int32", "description": "年份" }, { "name": "month", "in": "query", "required": false, "type": "integer / int32", "description": "月份(0=全年,1-12=指定月)" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "数据分析", "name": "隐患统计-按分类", "usage": "返回 data 为数组，每个元素包含：categoryName-隐患分类名称、count-数量。用于饼图展示。", "method": "GET", "path": "/gd_dataserver/business/points/analysis/stats/category", "operationId": "statsByCategoryUsingGET", "parameters": [ { "name": "startTime", "in": "query", "required": false, "type": "string / date-time", "description": "开始时间(yyyy-MM-dd)" }, { "name": "endTime", "in": "query", "required": false, "type": "string / date-time", "description": "结束时间(yyyy-MM-dd)" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "数据分析", "name": "隐患统计-按级别", "usage": "返回 data 为数组，每个元素包含：levelName-隐患级别名称、count-数量。用于饼图展示。", "method": "GET", "path": "/gd_dataserver/business/points/analysis/stats/level", "operationId": "statsByLevelUsingGET", "parameters": [ { "name": "startTime", "in": "query", "required": false, "type": "string / date-time", "description": "开始时间(yyyy-MM-dd)" }, { "name": "endTime", "in": "query", "required": false, "type": "string / date-time", "description": "结束时间(yyyy-MM-dd)" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "数据分析", "name": "处理时效-按级别", "usage": "返回 data 为数组，每个元素包含：levelName-级别名称、avgHours-平均处理时长、completedCount-已完成数。", "method": "GET", "path": "/gd_dataserver/business/points/analysis/timeliness/level", "operationId": "timelinessByLevelUsingGET", "parameters": [ { "name": "startTime", "in": "query", "required": false, "type": "string / date-time", "description": "开始时间(yyyy-MM-dd)" }, { "name": "endTime", "in": "query", "required": false, "type": "string / date-time", "description": "结束时间(yyyy-MM-dd)" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "数据分析", "name": "超期未处理列表", "usage": "返回 data 为 HazardReport 数组，每条记录包含 id、reportNo、hazardName、unitName、hazardLevelName、limitedCompleteTime-限定完成时间、status-状态 等字段。", "method": "GET", "path": "/gd_dataserver/business/points/analysis/timeliness/overdue", "operationId": "overdueListUsingGET", "parameters": [], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "数据分析", "name": "处理时效总览", "usage": "返回 data 为对象，包含：avgHours-平均处理时长(小时)、maxHours-最大处理时长、minHours-最小处理时长、onTimeRate-准时率(%)、totalCount-总隐患数、completedCount-已完成数、pendingCount-待处理数。", "method": "GET", "path": "/gd_dataserver/business/points/analysis/timeliness/overview", "operationId": "timelinessOverviewUsingGET", "parameters": [ { "name": "startTime", "in": "query", "required": false, "type": "string / date-time", "description": "开始时间(yyyy-MM-dd)" }, { "name": "endTime", "in": "query", "required": false, "type": "string / date-time", "description": "结束时间(yyyy-MM-dd)" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "数据分析", "name": "处理时效-按单位", "usage": "返回 data 为数组，每个元素包含：unitName-单位名称、avgHours-平均处理时长、completedCount-已完成数。", "method": "GET", "path": "/gd_dataserver/business/points/analysis/timeliness/unit", "operationId": "timelinessByUnitUsingGET", "parameters": [ { "name": "startTime", "in": "query", "required": false, "type": "string / date-time", "description": "开始时间(yyyy-MM-dd)" }, { "name": "endTime", "in": "query", "required": false, "type": "string / date-time", "description": "结束时间(yyyy-MM-dd)" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "数据分析", "name": "隐患趋势-按月份", "usage": "返回 data 为数组，每个元素包含：month-月份(如'2026-01')、count-当月隐患数量。用于折线图展示。", "method": "GET", "path": "/gd_dataserver/business/points/analysis/trend/month", "operationId": "trendByMonthUsingGET", "parameters": [ { "name": "year", "in": "query", "required": false, "type": "integer / int32", "description": "年份" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换安全配置", "name": "获取当前启用的兑换配置", "usage": "无请求参数。返回 data 为 ExchangeConfig 对象（数据库无记录时返回默认配置）。字段：pointsRatio-积分比例(N积分=1元)、singleMaxPoints-单笔最大积分、singleMinPoints-单笔最小积分、dailyLimitPerUser-每人每日兑换上限、monthlyLimitPerUser-每月上限、yearlyLimitPerUser-每年上限、dailyOrderCountLimit-每日兑换次数上限、rapidExchangeThreshold-短时间兑换次数阈值、rapidExchangeWindowMinutes-快速兑换检测窗口(分钟)、largeAmountThreshold-大额预警阈值、largeAmountNeedApproval-大额是否需审批(1是/0否)、antiFarmEnabled-隐患上报防刷检测开关(1启用/0禁用)。当安全开关关闭(enabled=0)时返回 null。", "method": "GET", "path": "/gd_dataserver/business/points/exchange/config/active", "operationId": "getActiveConfigUsingGET_1", "parameters": [], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换安全配置", "name": "新增", "usage": "新增单条记录，请求体为实体类对象（字段说明见对应实体模型）。成功返回 data 为 null。", "method": "POST", "path": "/gd_dataserver/business/points/exchange/config/add", "operationId": "addOneUsingPOST_3", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "兑换安全配置" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换安全配置", "name": "批量新增", "usage": "批量新增多条记录，请求体为实体类数组。成功返回 data 为 null。", "method": "POST", "path": "/gd_dataserver/business/points/exchange/config/addBatch", "operationId": "addBatchUsingPOST_3", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "array<兑换安全配置>" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换安全配置", "name": "新增并返回保存的数据", "usage": "新增单条记录并返回保存后的数据（含自增ID），请求体为实体类对象。成功返回 data 为保存的实体对象。", "method": "POST", "path": "/gd_dataserver/business/points/exchange/config/addReturn", "operationId": "addReturnUsingPOST_3", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "兑换安全配置" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换安全配置", "name": "根据属性删除", "usage": "根据实体属性条件删除记录，请求体为实体类对象。成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/points/exchange/config/delete", "operationId": "deleteUsingGET_3", "parameters": [ { "name": "antiFarmEnabled", "in": "query", "required": false, "type": "integer / int32", "description": "隐患上报防刷检测是否启用：1-启用 0-禁用" }, { "name": "configName", "in": "query", "required": false, "type": "string", "description": "配置名称" }, { "name": "createTime", "in": "query", "required": false, "type": "string / date-time", "description": "创建时间" }, { "name": "dailyLimitPerUser", "in": "query", "required": false, "type": "integer / int32", "description": "每人每日兑换上限（积分）" }, { "name": "dailyOrderCountLimit", "in": "query", "required": false, "type": "integer / int32", "description": "每人每日兑换次数上限" }, { "name": "enabled", "in": "query", "required": false, "type": "integer / int32", "description": "是否启用：1-启用 0-禁用" }, { "name": "id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "largeAmountNeedApproval", "in": "query", "required": false, "type": "integer / int32", "description": "大额兑换是否需审批：1-是 0-否" }, { "name": "largeAmountThreshold", "in": "query", "required": false, "type": "integer / int32", "description": "大额兑换预警阈值（积分）" }, { "name": "monthlyLimitPerUser", "in": "query", "required": false, "type": "integer / int32", "description": "每人每月上限（积分）" }, { "name": "pointsRatio", "in": "query", "required": false, "type": "integer / int32", "description": "积分比例（N积分=1元）" }, { "name": "rapidExchangeThreshold", "in": "query", "required": false, "type": "integer / int32", "description": "短时间内兑换次数阈值（触发预警）" }, { "name": "rapidExchangeWindowMinutes", "in": "query", "required": false, "type": "integer / int32", "description": "快速兑换检测时间窗口（分钟）" }, { "name": "remark", "in": "query", "required": false, "type": "string", "description": "备注" }, { "name": "singleMaxPoints", "in": "query", "required": false, "type": "integer / int32", "description": "单笔最大积分" }, { "name": "singleMinPoints", "in": "query", "required": false, "type": "integer / int32", "description": "单笔最小积分" }, { "name": "updateTime", "in": "query", "required": false, "type": "string / date-time", "description": "更新时间" }, { "name": "yearlyLimitPerUser", "in": "query", "required": false, "type": "integer / int32", "description": "每人每年上限（积分）" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换安全配置", "name": "主键删除", "usage": "根据主键ID删除单条记录，成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/points/exchange/config/deleteById", "operationId": "deleteOneUsingGET_3", "parameters": [ { "name": "id", "in": "query", "required": true, "type": "string", "description": "主键ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换安全配置", "name": "批量删除", "usage": "根据ID列表批量删除记录，成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/points/exchange/config/deleteByIds", "operationId": "deleteListUsingGET_7", "parameters": [ { "name": "ids", "in": "query", "required": true, "type": "string", "description": "ID列表(逗号分隔)" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换安全配置", "name": "查询所有", "usage": "查询所有记录（无分页、无条件）。成功返回 data 为实体类数组。", "method": "GET", "path": "/gd_dataserver/business/points/exchange/config/getAll", "operationId": "getAllUsingGET_3", "parameters": [], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换安全配置", "name": "分页查询", "usage": "分页查询记录列表，查询条件为实体类字段。成功返回 data 为 PageInfo 分页对象，其中 list 为实体类数组。", "method": "GET", "path": "/gd_dataserver/business/points/exchange/config/getListByPage", "operationId": "getListByPageUsingGET_3", "parameters": [ { "name": "antiFarmEnabled", "in": "query", "required": false, "type": "integer / int32", "description": "隐患上报防刷检测是否启用：1-启用 0-禁用" }, { "name": "configName", "in": "query", "required": false, "type": "string", "description": "配置名称" }, { "name": "createTime", "in": "query", "required": false, "type": "string / date-time", "description": "创建时间" }, { "name": "dailyLimitPerUser", "in": "query", "required": false, "type": "integer / int32", "description": "每人每日兑换上限（积分）" }, { "name": "dailyOrderCountLimit", "in": "query", "required": false, "type": "integer / int32", "description": "每人每日兑换次数上限" }, { "name": "enabled", "in": "query", "required": false, "type": "integer / int32", "description": "是否启用：1-启用 0-禁用" }, { "name": "id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "largeAmountNeedApproval", "in": "query", "required": false, "type": "integer / int32", "description": "大额兑换是否需审批：1-是 0-否" }, { "name": "largeAmountThreshold", "in": "query", "required": false, "type": "integer / int32", "description": "大额兑换预警阈值（积分）" }, { "name": "monthlyLimitPerUser", "in": "query", "required": false, "type": "integer / int32", "description": "每人每月上限（积分）" }, { "name": "pageNum", "in": "query", "required": true, "type": "integer / int32", "description": "页码" }, { "name": "pointsRatio", "in": "query", "required": false, "type": "integer / int32", "description": "积分比例（N积分=1元）" }, { "name": "rapidExchangeThreshold", "in": "query", "required": false, "type": "integer / int32", "description": "短时间内兑换次数阈值（触发预警）" }, { "name": "rapidExchangeWindowMinutes", "in": "query", "required": false, "type": "integer / int32", "description": "快速兑换检测时间窗口（分钟）" }, { "name": "remark", "in": "query", "required": false, "type": "string", "description": "备注" }, { "name": "singleMaxPoints", "in": "query", "required": false, "type": "integer / int32", "description": "单笔最大积分" }, { "name": "singleMinPoints", "in": "query", "required": false, "type": "integer / int32", "description": "单笔最小积分" }, { "name": "updateTime", "in": "query", "required": false, "type": "string / date-time", "description": "更新时间" }, { "name": "yearlyLimitPerUser", "in": "query", "required": false, "type": "integer / int32", "description": "每人每年上限（积分）" }, { "name": "pageSize", "in": "query", "required": true, "type": "integer / int32", "description": "每页条数" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换安全配置", "name": "详情", "usage": "根据主键ID查询单条记录详情。成功返回 data 为实体类对象，包含该实体所有字段。", "method": "GET", "path": "/gd_dataserver/business/points/exchange/config/info", "operationId": "infoUsingGET_3", "parameters": [ { "name": "id", "in": "query", "required": true, "type": "string", "description": "主键ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换安全配置", "name": "条件查询", "usage": "根据实体属性条件查询记录列表。成功返回 data 为实体类数组。", "method": "GET", "path": "/gd_dataserver/business/points/exchange/config/list", "operationId": "getListUsingGET_3", "parameters": [ { "name": "antiFarmEnabled", "in": "query", "required": false, "type": "integer / int32", "description": "隐患上报防刷检测是否启用：1-启用 0-禁用" }, { "name": "configName", "in": "query", "required": false, "type": "string", "description": "配置名称" }, { "name": "createTime", "in": "query", "required": false, "type": "string / date-time", "description": "创建时间" }, { "name": "dailyLimitPerUser", "in": "query", "required": false, "type": "integer / int32", "description": "每人每日兑换上限（积分）" }, { "name": "dailyOrderCountLimit", "in": "query", "required": false, "type": "integer / int32", "description": "每人每日兑换次数上限" }, { "name": "enabled", "in": "query", "required": false, "type": "integer / int32", "description": "是否启用：1-启用 0-禁用" }, { "name": "id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "largeAmountNeedApproval", "in": "query", "required": false, "type": "integer / int32", "description": "大额兑换是否需审批：1-是 0-否" }, { "name": "largeAmountThreshold", "in": "query", "required": false, "type": "integer / int32", "description": "大额兑换预警阈值（积分）" }, { "name": "monthlyLimitPerUser", "in": "query", "required": false, "type": "integer / int32", "description": "每人每月上限（积分）" }, { "name": "pointsRatio", "in": "query", "required": false, "type": "integer / int32", "description": "积分比例（N积分=1元）" }, { "name": "rapidExchangeThreshold", "in": "query", "required": false, "type": "integer / int32", "description": "短时间内兑换次数阈值（触发预警）" }, { "name": "rapidExchangeWindowMinutes", "in": "query", "required": false, "type": "integer / int32", "description": "快速兑换检测时间窗口（分钟）" }, { "name": "remark", "in": "query", "required": false, "type": "string", "description": "备注" }, { "name": "singleMaxPoints", "in": "query", "required": false, "type": "integer / int32", "description": "单笔最大积分" }, { "name": "singleMinPoints", "in": "query", "required": false, "type": "integer / int32", "description": "单笔最小积分" }, { "name": "updateTime", "in": "query", "required": false, "type": "string / date-time", "description": "更新时间" }, { "name": "yearlyLimitPerUser", "in": "query", "required": false, "type": "integer / int32", "description": "每人每年上限（积分）" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换安全配置", "name": "逻辑删除", "usage": "根据主键ID逻辑删除单条记录，成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/points/exchange/config/removeById", "operationId": "deleteListUsingGET_6", "parameters": [ { "name": "id", "in": "query", "required": true, "type": "string", "description": "主键ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换安全配置", "name": "查询兑换安全开关状态", "usage": "无请求参数。返回 data 为 boolean，true-启用安全校验，false-已关闭。判断逻辑：数据库无配置记录时默认启用；有记录时根据 enabled 字段(1启用/0禁用)决定。", "method": "GET", "path": "/gd_dataserver/business/points/exchange/config/switch/status", "operationId": "getSwitchStatusUsingGET", "parameters": [], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换安全配置", "name": "切换兑换安全开关（管理端）", "usage": "请求参数：enabled-true启用/false禁用(Boolean，必填)。返回 data 为 boolean，true-切换成功，false-切换失败。若数据库无配置记录且传入true，会自动创建默认配置。", "method": "POST", "path": "/gd_dataserver/business/points/exchange/config/switch/toggle", "operationId": "toggleSwitchUsingPOST", "parameters": [ { "name": "enabled", "in": "query", "required": true, "type": "boolean", "description": "true-启用安全校验，false-禁用" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换安全配置", "name": "修改", "usage": "根据主键ID修改记录，请求体为实体类对象（需包含id字段）。成功返回 data 为 null。", "method": "POST", "path": "/gd_dataserver/business/points/exchange/config/updateById", "operationId": "updateByIdUsingPOST_3", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "兑换安全配置" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换安全配置", "name": "校验兑换请求（APP端）", "usage": "在下单前调用，校验是否满足安全规则。请求参数：totalPoints-兑换总积分(int，必填)。返回 data 为对象，包含：passed-是否通过(boolean)、errors-错误信息数组(如'单笔兑换不能超过5000积分')、warnings-警告信息数组、securityEnabled-安全开关是否启用(boolean)、config-当前启用的兑换配置对象(开关关闭时为null)。前端根据 passed 判断能否兑换，errors 为空表示校验通过。当安全开关关闭时，passed=true、securityEnabled=false。", "method": "POST", "path": "/gd_dataserver/business/points/exchange/config/validate", "operationId": "validateExchangeUsingPOST", "parameters": [ { "name": "totalPoints", "in": "query", "required": true, "type": "integer / int32", "description": "兑换总积分" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换物品管理", "name": "新增", "usage": "新增单条记录，请求体为实体类对象（字段说明见对应实体模型）。成功返回 data 为 null。", "method": "POST", "path": "/gd_dataserver/business/exchange/item/add", "operationId": "addOneUsingPOST_4", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "兑换物品" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换物品管理", "name": "批量新增", "usage": "批量新增多条记录，请求体为实体类数组。成功返回 data 为 null。", "method": "POST", "path": "/gd_dataserver/business/exchange/item/addBatch", "operationId": "addBatchUsingPOST_4", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "array<兑换物品>" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换物品管理", "name": "新增并返回保存的数据", "usage": "新增单条记录并返回保存后的数据（含自增ID），请求体为实体类对象。成功返回 data 为保存的实体对象。", "method": "POST", "path": "/gd_dataserver/business/exchange/item/addReturn", "operationId": "addReturnUsingPOST_4", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "兑换物品" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换物品管理", "name": "根据属性删除", "usage": "根据实体属性条件删除记录，请求体为实体类对象。成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/exchange/item/delete", "operationId": "deleteUsingGET_4", "parameters": [ { "name": "createTime", "in": "query", "required": false, "type": "string / date-time", "description": "创建时间" }, { "name": "dailyLimitPerUser", "in": "query", "required": false, "type": "integer / int32", "description": "每人每日兑换上限（0表示无限制）" }, { "name": "description", "in": "query", "required": false, "type": "string", "description": "物品描述" }, { "name": "externalLink", "in": "query", "required": false, "type": "string", "description": "第三方兑换链接" }, { "name": "id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "itemCode", "in": "query", "required": false, "type": "string", "description": "物品编码" }, { "name": "itemName", "in": "query", "required": false, "type": "string", "description": "物品名称" }, { "name": "pointsRequired", "in": "query", "required": false, "type": "integer / int32", "description": "所需积分" }, { "name": "sortOrder", "in": "query", "required": false, "type": "integer / int32", "description": "排序权重" }, { "name": "status", "in": "query", "required": false, "type": "integer / int32", "description": "状态：0-下架 1-上架" }, { "name": "stock", "in": "query", "required": false, "type": "integer / int32", "description": "库存数量（0表示无限）" }, { "name": "thirdPartyCode", "in": "query", "required": false, "type": "string", "description": "第三方平台物品编码" }, { "name": "updateTime", "in": "query", "required": false, "type": "string / date-time", "description": "更新时间" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换物品管理", "name": "主键删除", "usage": "根据主键ID删除单条记录，成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/exchange/item/deleteById", "operationId": "deleteOneUsingGET_4", "parameters": [ { "name": "id", "in": "query", "required": true, "type": "string", "description": "主键ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换物品管理", "name": "批量删除", "usage": "根据ID列表批量删除记录，成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/exchange/item/deleteByIds", "operationId": "deleteListUsingGET_9", "parameters": [ { "name": "ids", "in": "query", "required": true, "type": "string", "description": "ID列表(逗号分隔)" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换物品管理", "name": "查询所有", "usage": "查询所有记录（无分页、无条件）。成功返回 data 为实体类数组。", "method": "GET", "path": "/gd_dataserver/business/exchange/item/getAll", "operationId": "getAllUsingGET_4", "parameters": [], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换物品管理", "name": "分页查询", "usage": "分页查询记录列表，查询条件为实体类字段。成功返回 data 为 PageInfo 分页对象，其中 list 为实体类数组。", "method": "GET", "path": "/gd_dataserver/business/exchange/item/getListByPage", "operationId": "getListByPageUsingGET_4", "parameters": [ { "name": "createTime", "in": "query", "required": false, "type": "string / date-time", "description": "创建时间" }, { "name": "dailyLimitPerUser", "in": "query", "required": false, "type": "integer / int32", "description": "每人每日兑换上限（0表示无限制）" }, { "name": "description", "in": "query", "required": false, "type": "string", "description": "物品描述" }, { "name": "externalLink", "in": "query", "required": false, "type": "string", "description": "第三方兑换链接" }, { "name": "id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "itemCode", "in": "query", "required": false, "type": "string", "description": "物品编码" }, { "name": "itemName", "in": "query", "required": false, "type": "string", "description": "物品名称" }, { "name": "pageNum", "in": "query", "required": true, "type": "integer / int32", "description": "页码" }, { "name": "pointsRequired", "in": "query", "required": false, "type": "integer / int32", "description": "所需积分" }, { "name": "sortOrder", "in": "query", "required": false, "type": "integer / int32", "description": "排序权重" }, { "name": "status", "in": "query", "required": false, "type": "integer / int32", "description": "状态：0-下架 1-上架" }, { "name": "stock", "in": "query", "required": false, "type": "integer / int32", "description": "库存数量（0表示无限）" }, { "name": "thirdPartyCode", "in": "query", "required": false, "type": "string", "description": "第三方平台物品编码" }, { "name": "updateTime", "in": "query", "required": false, "type": "string / date-time", "description": "更新时间" }, { "name": "pageSize", "in": "query", "required": true, "type": "integer / int32", "description": "每页条数" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换物品管理", "name": "详情", "usage": "根据主键ID查询单条记录详情。成功返回 data 为实体类对象，包含该实体所有字段。", "method": "GET", "path": "/gd_dataserver/business/exchange/item/info", "operationId": "infoUsingGET_4", "parameters": [ { "name": "id", "in": "query", "required": true, "type": "string", "description": "主键ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换物品管理", "name": "条件查询", "usage": "根据实体属性条件查询记录列表。成功返回 data 为实体类数组。", "method": "GET", "path": "/gd_dataserver/business/exchange/item/list", "operationId": "getListUsingGET_4", "parameters": [ { "name": "createTime", "in": "query", "required": false, "type": "string / date-time", "description": "创建时间" }, { "name": "dailyLimitPerUser", "in": "query", "required": false, "type": "integer / int32", "description": "每人每日兑换上限（0表示无限制）" }, { "name": "description", "in": "query", "required": false, "type": "string", "description": "物品描述" }, { "name": "externalLink", "in": "query", "required": false, "type": "string", "description": "第三方兑换链接" }, { "name": "id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "itemCode", "in": "query", "required": false, "type": "string", "description": "物品编码" }, { "name": "itemName", "in": "query", "required": false, "type": "string", "description": "物品名称" }, { "name": "pointsRequired", "in": "query", "required": false, "type": "integer / int32", "description": "所需积分" }, { "name": "sortOrder", "in": "query", "required": false, "type": "integer / int32", "description": "排序权重" }, { "name": "status", "in": "query", "required": false, "type": "integer / int32", "description": "状态：0-下架 1-上架" }, { "name": "stock", "in": "query", "required": false, "type": "integer / int32", "description": "库存数量（0表示无限）" }, { "name": "thirdPartyCode", "in": "query", "required": false, "type": "string", "description": "第三方平台物品编码" }, { "name": "updateTime", "in": "query", "required": false, "type": "string / date-time", "description": "更新时间" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换物品管理", "name": "查询上架物品列表", "usage": "前端展示用，返回 status=1 的物品，按 sortOrder 降序。返回 data 为 ExchangeItem 数组，每个元素包含：id、itemName-物品名称、itemPrice-所需积分、itemImage-物品图片URL、description-描述、stock-库存。", "method": "GET", "path": "/gd_dataserver/business/exchange/item/listOnShelf", "operationId": "listOnShelfUsingGET", "parameters": [], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换物品管理", "name": "逻辑删除", "usage": "根据主键ID逻辑删除单条记录，成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/exchange/item/removeById", "operationId": "deleteListUsingGET_8", "parameters": [ { "name": "id", "in": "query", "required": true, "type": "string", "description": "主键ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换物品管理", "name": "修改", "usage": "根据主键ID修改记录，请求体为实体类对象（需包含id字段）。成功返回 data 为 null。", "method": "POST", "path": "/gd_dataserver/business/exchange/item/updateById", "operationId": "updateByIdUsingPOST_4", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "兑换物品" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换物品管理", "name": "上下架操作", "usage": "status=0 下架，status=1 上架。返回 data 为 boolean。", "method": "POST", "path": "/gd_dataserver/business/exchange/item/updateStatus", "operationId": "updateStatusUsingPOST", "parameters": [ { "name": "itemId", "in": "query", "required": true, "type": "integer / int64", "description": "物品ID" }, { "name": "status", "in": "query", "required": true, "type": "integer / int32", "description": "状态：0-下架 1-上架" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换操作日志", "name": "新增", "usage": "新增单条记录，请求体为实体类对象（字段说明见对应实体模型）。成功返回 data 为 null。", "method": "POST", "path": "/gd_dataserver/business/points/operation/log/add", "operationId": "addOneUsingPOST_5", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "兑换操作日志" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换操作日志", "name": "批量新增", "usage": "批量新增多条记录，请求体为实体类数组。成功返回 data 为 null。", "method": "POST", "path": "/gd_dataserver/business/points/operation/log/addBatch", "operationId": "addBatchUsingPOST_5", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "array<兑换操作日志>" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换操作日志", "name": "新增并返回保存的数据", "usage": "新增单条记录并返回保存后的数据（含自增ID），请求体为实体类对象。成功返回 data 为保存的实体对象。", "method": "POST", "path": "/gd_dataserver/business/points/operation/log/addReturn", "operationId": "addReturnUsingPOST_5", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "兑换操作日志" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换操作日志", "name": "根据属性删除", "usage": "根据实体属性条件删除记录，请求体为实体类对象。成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/points/operation/log/delete", "operationId": "deleteUsingGET_5", "parameters": [ { "name": "createTime", "in": "query", "required": false, "type": "string / date-time", "description": "创建时间" }, { "name": "durationMs", "in": "query", "required": false, "type": "integer / int32", "description": "耗时（毫秒）" }, { "name": "errorMsg", "in": "query", "required": false, "type": "string", "description": "错误信息" }, { "name": "id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "ipAddress", "in": "query", "required": false, "type": "string", "description": "操作IP" }, { "name": "operationDesc", "in": "query", "required": false, "type": "string", "description": "操作描述" }, { "name": "operationType", "in": "query", "required": false, "type": "string", "description": "操作类型：VIEW/VALIDATE/CREATE/FREEZE/UNFREEZE/DEDUCT/SUBMIT/CANCEL/REFUND/RETRY" }, { "name": "orderId", "in": "query", "required": false, "type": "integer / int64", "description": "关联订单ID" }, { "name": "orderNo", "in": "query", "required": false, "type": "string", "description": "关联订单号" }, { "name": "requestParams", "in": "query", "required": false, "type": "string", "description": "请求参数（JSON）" }, { "name": "responseResult", "in": "query", "required": false, "type": "string", "description": "响应结果（JSON）" }, { "name": "status", "in": "query", "required": false, "type": "string", "description": "操作结果：SUCCESS/FAIL" }, { "name": "userAgent", "in": "query", "required": false, "type": "string", "description": "客户端UA" }, { "name": "userId", "in": "query", "required": false, "type": "integer / int64", "description": "操作用户ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换操作日志", "name": "主键删除", "usage": "根据主键ID删除单条记录，成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/points/operation/log/deleteById", "operationId": "deleteOneUsingGET_5", "parameters": [ { "name": "id", "in": "query", "required": true, "type": "string", "description": "主键ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换操作日志", "name": "批量删除", "usage": "根据ID列表批量删除记录，成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/points/operation/log/deleteByIds", "operationId": "deleteListUsingGET_11", "parameters": [ { "name": "ids", "in": "query", "required": true, "type": "string", "description": "ID列表(逗号分隔)" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换操作日志", "name": "查询所有", "usage": "查询所有记录（无分页、无条件）。成功返回 data 为实体类数组。", "method": "GET", "path": "/gd_dataserver/business/points/operation/log/getAll", "operationId": "getAllUsingGET_5", "parameters": [], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换操作日志", "name": "分页查询", "usage": "分页查询记录列表，查询条件为实体类字段。成功返回 data 为 PageInfo 分页对象，其中 list 为实体类数组。", "method": "GET", "path": "/gd_dataserver/business/points/operation/log/getListByPage", "operationId": "getListByPageUsingGET_5", "parameters": [ { "name": "createTime", "in": "query", "required": false, "type": "string / date-time", "description": "创建时间" }, { "name": "durationMs", "in": "query", "required": false, "type": "integer / int32", "description": "耗时（毫秒）" }, { "name": "errorMsg", "in": "query", "required": false, "type": "string", "description": "错误信息" }, { "name": "id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "ipAddress", "in": "query", "required": false, "type": "string", "description": "操作IP" }, { "name": "operationDesc", "in": "query", "required": false, "type": "string", "description": "操作描述" }, { "name": "operationType", "in": "query", "required": false, "type": "string", "description": "操作类型：VIEW/VALIDATE/CREATE/FREEZE/UNFREEZE/DEDUCT/SUBMIT/CANCEL/REFUND/RETRY" }, { "name": "orderId", "in": "query", "required": false, "type": "integer / int64", "description": "关联订单ID" }, { "name": "orderNo", "in": "query", "required": false, "type": "string", "description": "关联订单号" }, { "name": "pageNum", "in": "query", "required": true, "type": "integer / int32", "description": "页码" }, { "name": "requestParams", "in": "query", "required": false, "type": "string", "description": "请求参数（JSON）" }, { "name": "responseResult", "in": "query", "required": false, "type": "string", "description": "响应结果（JSON）" }, { "name": "status", "in": "query", "required": false, "type": "string", "description": "操作结果：SUCCESS/FAIL" }, { "name": "userAgent", "in": "query", "required": false, "type": "string", "description": "客户端UA" }, { "name": "userId", "in": "query", "required": false, "type": "integer / int64", "description": "操作用户ID" }, { "name": "pageSize", "in": "query", "required": true, "type": "integer / int32", "description": "每页条数" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换操作日志", "name": "详情", "usage": "根据主键ID查询单条记录详情。成功返回 data 为实体类对象，包含该实体所有字段。", "method": "GET", "path": "/gd_dataserver/business/points/operation/log/info", "operationId": "infoUsingGET_5", "parameters": [ { "name": "id", "in": "query", "required": true, "type": "string", "description": "主键ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换操作日志", "name": "条件查询", "usage": "根据实体属性条件查询记录列表。成功返回 data 为实体类数组。", "method": "GET", "path": "/gd_dataserver/business/points/operation/log/list", "operationId": "getListUsingGET_5", "parameters": [ { "name": "createTime", "in": "query", "required": false, "type": "string / date-time", "description": "创建时间" }, { "name": "durationMs", "in": "query", "required": false, "type": "integer / int32", "description": "耗时（毫秒）" }, { "name": "errorMsg", "in": "query", "required": false, "type": "string", "description": "错误信息" }, { "name": "id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "ipAddress", "in": "query", "required": false, "type": "string", "description": "操作IP" }, { "name": "operationDesc", "in": "query", "required": false, "type": "string", "description": "操作描述" }, { "name": "operationType", "in": "query", "required": false, "type": "string", "description": "操作类型：VIEW/VALIDATE/CREATE/FREEZE/UNFREEZE/DEDUCT/SUBMIT/CANCEL/REFUND/RETRY" }, { "name": "orderId", "in": "query", "required": false, "type": "integer / int64", "description": "关联订单ID" }, { "name": "orderNo", "in": "query", "required": false, "type": "string", "description": "关联订单号" }, { "name": "requestParams", "in": "query", "required": false, "type": "string", "description": "请求参数（JSON）" }, { "name": "responseResult", "in": "query", "required": false, "type": "string", "description": "响应结果（JSON）" }, { "name": "status", "in": "query", "required": false, "type": "string", "description": "操作结果：SUCCESS/FAIL" }, { "name": "userAgent", "in": "query", "required": false, "type": "string", "description": "客户端UA" }, { "name": "userId", "in": "query", "required": false, "type": "integer / int64", "description": "操作用户ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换操作日志", "name": "查询订单操作日志", "usage": "返回 data 为 ExchangeOperationLog 数组，字段同上。", "method": "GET", "path": "/gd_dataserver/business/points/operation/log/order/{orderId}", "operationId": "getLogsByOrderIdUsingGET", "parameters": [ { "name": "orderId", "in": "path", "required": true, "type": "integer / int64", "description": "订单ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换操作日志", "name": "逻辑删除", "usage": "根据主键ID逻辑删除单条记录，成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/points/operation/log/removeById", "operationId": "deleteListUsingGET_10", "parameters": [ { "name": "id", "in": "query", "required": true, "type": "string", "description": "主键ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换操作日志", "name": "修改", "usage": "根据主键ID修改记录，请求体为实体类对象（需包含id字段）。成功返回 data 为 null。", "method": "POST", "path": "/gd_dataserver/business/points/operation/log/updateById", "operationId": "updateByIdUsingPOST_5", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "兑换操作日志" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换操作日志", "name": "查询用户操作日志", "usage": "返回 data 为 ExchangeOperationLog 数组，每个元素包含：id、userId-用户ID、orderId-订单ID、orderNo-订单号、operationType-操作类型、operationDetail-操作详情、result-结果、createTime。", "method": "GET", "path": "/gd_dataserver/business/points/operation/log/user/{userId}", "operationId": "getLogsByUserIdUsingGET", "parameters": [ { "name": "userId", "in": "path", "required": true, "type": "integer / int64", "description": "用户ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分兑换订单管理", "name": "新增", "usage": "新增单条记录，请求体为实体类对象（字段说明见对应实体模型）。成功返回 data 为 null。", "method": "POST", "path": "/gd_dataserver/business/exchange/order/add", "operationId": "addOneUsingPOST_6", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "积分兑换订单" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分兑换订单管理", "name": "批量新增", "usage": "批量新增多条记录，请求体为实体类数组。成功返回 data 为 null。", "method": "POST", "path": "/gd_dataserver/business/exchange/order/addBatch", "operationId": "addBatchUsingPOST_6", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "array<积分兑换订单>" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分兑换订单管理", "name": "新增并返回保存的数据", "usage": "新增单条记录并返回保存后的数据（含自增ID），请求体为实体类对象。成功返回 data 为保存的实体对象。", "method": "POST", "path": "/gd_dataserver/business/exchange/order/addReturn", "operationId": "addReturnUsingPOST_6", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "积分兑换订单" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分兑换订单管理", "name": "根据属性删除", "usage": "根据实体属性条件删除记录，请求体为实体类对象。成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/exchange/order/delete", "operationId": "deleteUsingGET_6", "parameters": [ { "name": "createTime", "in": "query", "required": false, "type": "string / date-time", "description": "" }, { "name": "factoryDeptId", "in": "query", "required": false, "type": "string", "description": "所属厂区部门ID" }, { "name": "finishTime", "in": "query", "required": false, "type": "string / date-time", "description": "完成时间" }, { "name": "id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "itemId", "in": "query", "required": false, "type": "integer / int64", "description": "兑换物品ID" }, { "name": "itemName", "in": "query", "required": false, "type": "string", "description": "物品名称" }, { "name": "itemPrice", "in": "query", "required": false, "type": "integer / int32", "description": "兑换所需积分" }, { "name": "orderNo", "in": "query", "required": false, "type": "string", "description": "订单号" }, { "name": "quantity", "in": "query", "required": false, "type": "integer / int32", "description": "兑换数量" }, { "name": "status", "in": "query", "required": false, "type": "integer / int32", "description": "订单状态：0-待处理 1-处理中 2-兑换成功 3-兑换失败 4-已退款 5-已关闭" }, { "name": "thirdPartyOrderId", "in": "query", "required": false, "type": "string", "description": "第三方平台订单号" }, { "name": "thirdPartyResponse", "in": "query", "required": false, "type": "string", "description": "第三方回调原始数据" }, { "name": "totalPoints", "in": "query", "required": false, "type": "integer / int32", "description": "总消耗积分" }, { "name": "updateTime", "in": "query", "required": false, "type": "string / date-time", "description": "更新时间" }, { "name": "userId", "in": "query", "required": false, "type": "integer / int64", "description": "用户ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分兑换订单管理", "name": "主键删除", "usage": "根据主键ID删除单条记录，成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/exchange/order/deleteById", "operationId": "deleteOneUsingGET_6", "parameters": [ { "name": "id", "in": "query", "required": true, "type": "string", "description": "主键ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分兑换订单管理", "name": "批量删除", "usage": "根据ID列表批量删除记录，成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/exchange/order/deleteByIds", "operationId": "deleteListUsingGET_13", "parameters": [ { "name": "ids", "in": "query", "required": true, "type": "string", "description": "ID列表(逗号分隔)" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分兑换订单管理", "name": "查询所有", "usage": "查询所有记录（无分页、无条件）。成功返回 data 为实体类数组。", "method": "GET", "path": "/gd_dataserver/business/exchange/order/getAll", "operationId": "getAllUsingGET_6", "parameters": [], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分兑换订单管理", "name": "分页查询", "usage": "分页查询记录列表，查询条件为实体类字段。成功返回 data 为 PageInfo 分页对象，其中 list 为实体类数组。", "method": "GET", "path": "/gd_dataserver/business/exchange/order/getListByPage", "operationId": "getListByPageUsingGET_6", "parameters": [ { "name": "createTime", "in": "query", "required": false, "type": "string / date-time", "description": "" }, { "name": "factoryDeptId", "in": "query", "required": false, "type": "string", "description": "所属厂区部门ID" }, { "name": "finishTime", "in": "query", "required": false, "type": "string / date-time", "description": "完成时间" }, { "name": "id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "itemId", "in": "query", "required": false, "type": "integer / int64", "description": "兑换物品ID" }, { "name": "itemName", "in": "query", "required": false, "type": "string", "description": "物品名称" }, { "name": "itemPrice", "in": "query", "required": false, "type": "integer / int32", "description": "兑换所需积分" }, { "name": "orderNo", "in": "query", "required": false, "type": "string", "description": "订单号" }, { "name": "pageNum", "in": "query", "required": true, "type": "integer / int32", "description": "页码" }, { "name": "quantity", "in": "query", "required": false, "type": "integer / int32", "description": "兑换数量" }, { "name": "status", "in": "query", "required": false, "type": "integer / int32", "description": "订单状态：0-待处理 1-处理中 2-兑换成功 3-兑换失败 4-已退款 5-已关闭" }, { "name": "thirdPartyOrderId", "in": "query", "required": false, "type": "string", "description": "第三方平台订单号" }, { "name": "thirdPartyResponse", "in": "query", "required": false, "type": "string", "description": "第三方回调原始数据" }, { "name": "totalPoints", "in": "query", "required": false, "type": "integer / int32", "description": "总消耗积分" }, { "name": "updateTime", "in": "query", "required": false, "type": "string / date-time", "description": "更新时间" }, { "name": "userId", "in": "query", "required": false, "type": "integer / int64", "description": "用户ID" }, { "name": "pageSize", "in": "query", "required": true, "type": "integer / int32", "description": "每页条数" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分兑换订单管理", "name": "详情", "usage": "根据主键ID查询单条记录详情。成功返回 data 为实体类对象，包含该实体所有字段。", "method": "GET", "path": "/gd_dataserver/business/exchange/order/info", "operationId": "infoUsingGET_6", "parameters": [ { "name": "id", "in": "query", "required": true, "type": "string", "description": "主键ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分兑换订单管理", "name": "条件查询", "usage": "根据实体属性条件查询记录列表。成功返回 data 为实体类数组。", "method": "GET", "path": "/gd_dataserver/business/exchange/order/list", "operationId": "getListUsingGET_6", "parameters": [ { "name": "createTime", "in": "query", "required": false, "type": "string / date-time", "description": "" }, { "name": "factoryDeptId", "in": "query", "required": false, "type": "string", "description": "所属厂区部门ID" }, { "name": "finishTime", "in": "query", "required": false, "type": "string / date-time", "description": "完成时间" }, { "name": "id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "itemId", "in": "query", "required": false, "type": "integer / int64", "description": "兑换物品ID" }, { "name": "itemName", "in": "query", "required": false, "type": "string", "description": "物品名称" }, { "name": "itemPrice", "in": "query", "required": false, "type": "integer / int32", "description": "兑换所需积分" }, { "name": "orderNo", "in": "query", "required": false, "type": "string", "description": "订单号" }, { "name": "quantity", "in": "query", "required": false, "type": "integer / int32", "description": "兑换数量" }, { "name": "status", "in": "query", "required": false, "type": "integer / int32", "description": "订单状态：0-待处理 1-处理中 2-兑换成功 3-兑换失败 4-已退款 5-已关闭" }, { "name": "thirdPartyOrderId", "in": "query", "required": false, "type": "string", "description": "第三方平台订单号" }, { "name": "thirdPartyResponse", "in": "query", "required": false, "type": "string", "description": "第三方回调原始数据" }, { "name": "totalPoints", "in": "query", "required": false, "type": "integer / int32", "description": "总消耗积分" }, { "name": "updateTime", "in": "query", "required": false, "type": "string / date-time", "description": "更新时间" }, { "name": "userId", "in": "query", "required": false, "type": "integer / int64", "description": "用户ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分兑换订单管理", "name": "查询我的兑换记录（APP端）", "usage": "返回 data 为 PageInfo 分页对象。list 中每条记录为 ExchangeOrder 对象，主要字段：id、orderNo-订单号、userId-用户ID、itemName-物品名称、itemPrice-单价积分、quantity-数量、totalPoints-总消耗积分、status-订单状态(0待处理/1处理中/2兑换成功/3兑换失败/4已退款/5已关闭)、createTime-创建时间、finishTime-完成时间。", "method": "GET", "path": "/gd_dataserver/business/exchange/order/myList", "operationId": "myListUsingGET", "parameters": [ { "name": "createTime", "in": "query", "required": false, "type": "string / date-time", "description": "" }, { "name": "factoryDeptId", "in": "query", "required": false, "type": "string", "description": "所属厂区部门ID" }, { "name": "finishTime", "in": "query", "required": false, "type": "string / date-time", "description": "完成时间" }, { "name": "id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "itemId", "in": "query", "required": false, "type": "integer / int64", "description": "兑换物品ID" }, { "name": "itemName", "in": "query", "required": false, "type": "string", "description": "物品名称" }, { "name": "itemPrice", "in": "query", "required": false, "type": "integer / int32", "description": "兑换所需积分" }, { "name": "orderNo", "in": "query", "required": false, "type": "string", "description": "订单号" }, { "name": "pageNum", "in": "query", "required": false, "type": "integer / int32", "description": "页码" }, { "name": "quantity", "in": "query", "required": false, "type": "integer / int32", "description": "兑换数量" }, { "name": "status", "in": "query", "required": false, "type": "integer / int32", "description": "订单状态：0-待处理 1-处理中 2-兑换成功 3-兑换失败 4-已退款 5-已关闭" }, { "name": "thirdPartyOrderId", "in": "query", "required": false, "type": "string", "description": "第三方平台订单号" }, { "name": "thirdPartyResponse", "in": "query", "required": false, "type": "string", "description": "第三方回调原始数据" }, { "name": "totalPoints", "in": "query", "required": false, "type": "integer / int32", "description": "总消耗积分" }, { "name": "updateTime", "in": "query", "required": false, "type": "string / date-time", "description": "更新时间" }, { "name": "userId", "in": "query", "required": false, "type": "integer / int64", "description": "用户ID" }, { "name": "pageSize", "in": "query", "required": false, "type": "integer / int32", "description": "每页数量" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分兑换订单管理", "name": "退款（管理端操作）", "usage": "将订单状态改为已退款(4)，并退回积分到用户账户。返回 data 为 boolean。", "method": "POST", "path": "/gd_dataserver/business/exchange/order/refund/{orderId}", "operationId": "refundOrderUsingPOST", "parameters": [ { "name": "orderId", "in": "path", "required": true, "type": "integer / int64", "description": "订单ID" }, { "name": "operator", "in": "query", "required": true, "type": "string", "description": "操作人" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分兑换订单管理", "name": "逻辑删除", "usage": "根据主键ID逻辑删除单条记录，成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/exchange/order/removeById", "operationId": "deleteListUsingGET_12", "parameters": [ { "name": "id", "in": "query", "required": true, "type": "string", "description": "主键ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分兑换订单管理", "name": "修改", "usage": "根据主键ID修改记录，请求体为实体类对象（需包含id字段）。成功返回 data 为 null。", "method": "POST", "path": "/gd_dataserver/business/exchange/order/updateById", "operationId": "updateByIdUsingPOST_6", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "积分兑换订单" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换订单追踪", "name": "新增", "usage": "新增单条记录，请求体为实体类对象（字段说明见对应实体模型）。成功返回 data 为 null。", "method": "POST", "path": "/gd_dataserver/business/points/order/track/add", "operationId": "addOneUsingPOST_7", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "兑换订单追踪" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换订单追踪", "name": "批量新增", "usage": "批量新增多条记录，请求体为实体类数组。成功返回 data 为 null。", "method": "POST", "path": "/gd_dataserver/business/points/order/track/addBatch", "operationId": "addBatchUsingPOST_7", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "array<兑换订单追踪>" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换订单追踪", "name": "新增并返回保存的数据", "usage": "新增单条记录并返回保存后的数据（含自增ID），请求体为实体类对象。成功返回 data 为保存的实体对象。", "method": "POST", "path": "/gd_dataserver/business/points/order/track/addReturn", "operationId": "addReturnUsingPOST_7", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "兑换订单追踪" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换订单追踪", "name": "根据属性删除", "usage": "根据实体属性条件删除记录，请求体为实体类对象。成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/points/order/track/delete", "operationId": "deleteUsingGET_7", "parameters": [ { "name": "createTime", "in": "query", "required": false, "type": "string / date-time", "description": "创建时间" }, { "name": "fromStatus", "in": "query", "required": false, "type": "integer / int32", "description": "变更前状态" }, { "name": "id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "ipAddress", "in": "query", "required": false, "type": "string", "description": "操作IP" }, { "name": "operateType", "in": "query", "required": false, "type": "string", "description": "操作类型：CREATE/FREEZE/UNFREEZE/DEDUCT/SUBMIT/CANCEL/REFUND/RETRY" }, { "name": "operator", "in": "query", "required": false, "type": "string", "description": "操作人" }, { "name": "orderId", "in": "query", "required": false, "type": "integer / int64", "description": "订单ID" }, { "name": "orderNo", "in": "query", "required": false, "type": "string", "description": "订单号" }, { "name": "remark", "in": "query", "required": false, "type": "string", "description": "操作备注" }, { "name": "statusName", "in": "query", "required": false, "type": "string", "description": "状态名称" }, { "name": "toStatus", "in": "query", "required": false, "type": "integer / int32", "description": "变更后状态" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换订单追踪", "name": "主键删除", "usage": "根据主键ID删除单条记录，成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/points/order/track/deleteById", "operationId": "deleteOneUsingGET_7", "parameters": [ { "name": "id", "in": "query", "required": true, "type": "string", "description": "主键ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换订单追踪", "name": "批量删除", "usage": "根据ID列表批量删除记录，成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/points/order/track/deleteByIds", "operationId": "deleteListUsingGET_15", "parameters": [ { "name": "ids", "in": "query", "required": true, "type": "string", "description": "ID列表(逗号分隔)" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换订单追踪", "name": "查询所有", "usage": "查询所有记录（无分页、无条件）。成功返回 data 为实体类数组。", "method": "GET", "path": "/gd_dataserver/business/points/order/track/getAll", "operationId": "getAllUsingGET_7", "parameters": [], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换订单追踪", "name": "分页查询", "usage": "分页查询记录列表，查询条件为实体类字段。成功返回 data 为 PageInfo 分页对象，其中 list 为实体类数组。", "method": "GET", "path": "/gd_dataserver/business/points/order/track/getListByPage", "operationId": "getListByPageUsingGET_7", "parameters": [ { "name": "createTime", "in": "query", "required": false, "type": "string / date-time", "description": "创建时间" }, { "name": "fromStatus", "in": "query", "required": false, "type": "integer / int32", "description": "变更前状态" }, { "name": "id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "ipAddress", "in": "query", "required": false, "type": "string", "description": "操作IP" }, { "name": "operateType", "in": "query", "required": false, "type": "string", "description": "操作类型：CREATE/FREEZE/UNFREEZE/DEDUCT/SUBMIT/CANCEL/REFUND/RETRY" }, { "name": "operator", "in": "query", "required": false, "type": "string", "description": "操作人" }, { "name": "orderId", "in": "query", "required": false, "type": "integer / int64", "description": "订单ID" }, { "name": "orderNo", "in": "query", "required": false, "type": "string", "description": "订单号" }, { "name": "pageNum", "in": "query", "required": true, "type": "integer / int32", "description": "页码" }, { "name": "remark", "in": "query", "required": false, "type": "string", "description": "操作备注" }, { "name": "statusName", "in": "query", "required": false, "type": "string", "description": "状态名称" }, { "name": "toStatus", "in": "query", "required": false, "type": "integer / int32", "description": "变更后状态" }, { "name": "pageSize", "in": "query", "required": true, "type": "integer / int32", "description": "每页条数" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换订单追踪", "name": "详情", "usage": "根据主键ID查询单条记录详情。成功返回 data 为实体类对象，包含该实体所有字段。", "method": "GET", "path": "/gd_dataserver/business/points/order/track/info", "operationId": "infoUsingGET_7", "parameters": [ { "name": "id", "in": "query", "required": true, "type": "string", "description": "主键ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换订单追踪", "name": "条件查询", "usage": "根据实体属性条件查询记录列表。成功返回 data 为实体类数组。", "method": "GET", "path": "/gd_dataserver/business/points/order/track/list", "operationId": "getListUsingGET_7", "parameters": [ { "name": "createTime", "in": "query", "required": false, "type": "string / date-time", "description": "创建时间" }, { "name": "fromStatus", "in": "query", "required": false, "type": "integer / int32", "description": "变更前状态" }, { "name": "id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "ipAddress", "in": "query", "required": false, "type": "string", "description": "操作IP" }, { "name": "operateType", "in": "query", "required": false, "type": "string", "description": "操作类型：CREATE/FREEZE/UNFREEZE/DEDUCT/SUBMIT/CANCEL/REFUND/RETRY" }, { "name": "operator", "in": "query", "required": false, "type": "string", "description": "操作人" }, { "name": "orderId", "in": "query", "required": false, "type": "integer / int64", "description": "订单ID" }, { "name": "orderNo", "in": "query", "required": false, "type": "string", "description": "订单号" }, { "name": "remark", "in": "query", "required": false, "type": "string", "description": "操作备注" }, { "name": "statusName", "in": "query", "required": false, "type": "string", "description": "状态名称" }, { "name": "toStatus", "in": "query", "required": false, "type": "integer / int32", "description": "变更后状态" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换订单追踪", "name": "查询订单追踪记录（按订单ID）", "usage": "返回 data 为 ExchangeOrderTrack 数组，每个元素包含：id、orderId-订单ID、orderNo-订单号、fromStatus-原状态、toStatus-新状态、trackType-追踪类型、remark-备注、operator-操作人、createTime-操作时间。", "method": "GET", "path": "/gd_dataserver/business/points/order/track/list/{orderId}", "operationId": "getTracksByOrderIdUsingGET", "parameters": [ { "name": "orderId", "in": "path", "required": true, "type": "integer / int64", "description": "订单ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换订单追踪", "name": "查询订单追踪记录（按订单号）", "usage": "返回 data 为 ExchangeOrderTrack 数组，字段同上。", "method": "GET", "path": "/gd_dataserver/business/points/order/track/listByNo/{orderNo}", "operationId": "getTracksByOrderNoUsingGET", "parameters": [ { "name": "orderNo", "in": "path", "required": true, "type": "string", "description": "订单号" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换订单追踪", "name": "逻辑删除", "usage": "根据主键ID逻辑删除单条记录，成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/points/order/track/removeById", "operationId": "deleteListUsingGET_14", "parameters": [ { "name": "id", "in": "query", "required": true, "type": "string", "description": "主键ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "兑换订单追踪", "name": "修改", "usage": "根据主键ID修改记录，请求体为实体类对象（需包含id字段）。成功返回 data 为 null。", "method": "POST", "path": "/gd_dataserver/business/points/order/track/updateById", "operationId": "updateByIdUsingPOST_7", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "兑换订单追踪" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "流程定义", "name": "指定流程达式列表", "usage": "", "method": "GET", "path": "/gd_dataserver/flowable/definition/expList", "operationId": "expListUsingGET", "parameters": [ { "name": "createBy", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "createByName", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "createTime", "in": "query", "required": false, "type": "string / date-time", "description": "" }, { "name": "expression", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "id", "in": "query", "required": false, "type": "integer / int64", "description": "" }, { "name": "name", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "params", "in": "query", "required": false, "type": "object", "description": "" }, { "name": "remark", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "searchValue", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "status", "in": "query", "required": false, "type": "integer / int32", "description": "" }, { "name": "updateBy", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "updateByName", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "updateTime", "in": "query", "required": false, "type": "string / date-time", "description": "" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "流程定义", "name": "导入流程文件", "usage": "上传bpmn20的xml文件", "method": "POST", "path": "/gd_dataserver/flowable/definition/import", "operationId": "importFileUsingPOST", "parameters": [ { "name": "name", "in": "query", "required": false, "type": "string", "description": "name" }, { "name": "category", "in": "query", "required": false, "type": "string", "description": "category" } ], "requestBodies": [ { "contentType": "application/json", "schema": "string / binary" }, { "contentType": "application/octet-stream", "schema": "string / binary" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "流程定义", "name": "流程定义列表", "usage": "", "method": "GET", "path": "/gd_dataserver/flowable/definition/list", "operationId": "listUsingGET", "parameters": [ { "name": "pageNum", "in": "query", "required": true, "type": "integer / int32", "description": "当前页码" }, { "name": "pageSize", "in": "query", "required": true, "type": "integer / int32", "description": "每页条数" }, { "name": "name", "in": "query", "required": false, "type": "string", "description": "流程名称" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "流程定义", "name": "读取图片文件", "usage": "", "method": "GET", "path": "/gd_dataserver/flowable/definition/readImage/{deployId}", "operationId": "readImageUsingGET", "parameters": [ { "name": "deployId", "in": "path", "required": true, "type": "string", "description": "流程定义id" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "流程定义", "name": "读取xml文件", "usage": "", "method": "GET", "path": "/gd_dataserver/flowable/definition/readXml/{deployId}", "operationId": "readXmlUsingGET", "parameters": [ { "name": "deployId", "in": "path", "required": true, "type": "string", "description": "流程定义id" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "流程定义", "name": "指定流程办理组列表", "usage": "", "method": "GET", "path": "/gd_dataserver/flowable/definition/roleList", "operationId": "roleListUsingGET", "parameters": [ { "name": "admin", "in": "query", "required": false, "type": "boolean", "description": "" }, { "name": "createBy", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "createByName", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "createTime", "in": "query", "required": false, "type": "string / date-time", "description": "" }, { "name": "dataScope", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "delFlag", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "deptCheckStrictly", "in": "query", "required": false, "type": "boolean", "description": "" }, { "name": "deptIds", "in": "query", "required": false, "type": "array", "description": "" }, { "name": "flag", "in": "query", "required": false, "type": "boolean", "description": "" }, { "name": "menuCheckStrictly", "in": "query", "required": false, "type": "boolean", "description": "" }, { "name": "menuIds", "in": "query", "required": false, "type": "array", "description": "" }, { "name": "params", "in": "query", "required": false, "type": "object", "description": "" }, { "name": "permissions", "in": "query", "required": false, "type": "array", "description": "" }, { "name": "remark", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "roleId", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "roleKey", "in": "query", "required": true, "type": "string", "description": "" }, { "name": "roleName", "in": "query", "required": true, "type": "string", "description": "" }, { "name": "roleSort", "in": "query", "required": true, "type": "integer / int32", "description": "" }, { "name": "searchValue", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "status", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "updateBy", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "updateByName", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "updateTime", "in": "query", "required": false, "type": "string / date-time", "description": "" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "流程定义", "name": "保存流程设计器内的xml文件", "usage": "", "method": "POST", "path": "/gd_dataserver/flowable/definition/save", "operationId": "saveUsingPOST", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "FlowSaveXmlVo" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "流程定义", "name": "发起流程", "usage": "", "method": "POST", "path": "/gd_dataserver/flowable/definition/start/{procDefId}", "operationId": "startUsingPOST", "parameters": [ { "name": "procDefId", "in": "path", "required": true, "type": "string", "description": "流程定义id" } ], "requestBodies": [ { "contentType": "application/json", "schema": "object" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "流程定义", "name": "激活或挂起流程定义", "usage": "", "method": "PUT", "path": "/gd_dataserver/flowable/definition/updateState", "operationId": "updateStateUsingPUT", "parameters": [ { "name": "state", "in": "query", "required": true, "type": "integer / int32", "description": "1:激活,2:挂起" }, { "name": "deployId", "in": "query", "required": true, "type": "string", "description": "流程部署ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "流程定义", "name": "指定流程办理人员列表", "usage": "", "method": "GET", "path": "/gd_dataserver/flowable/definition/userList", "operationId": "userListUsingGET", "parameters": [ { "name": "admin", "in": "query", "required": false, "type": "boolean", "description": "" }, { "name": "avatar", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "createBy", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "createByName", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "createTime", "in": "query", "required": false, "type": "string / date-time", "description": "" }, { "name": "delFlag", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "dept.ancestors", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "dept.createBy", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "dept.createByName", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "dept.createTime", "in": "query", "required": false, "type": "string / date-time", "description": "" }, { "name": "dept.delFlag", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "dept.deptId", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "dept.deptName", "in": "query", "required": true, "type": "string", "description": "" }, { "name": "dept.email", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "dept.leader", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "dept.orderNum", "in": "query", "required": true, "type": "integer / int32", "description": "" }, { "name": "dept.params", "in": "query", "required": false, "type": "object", "description": "" }, { "name": "dept.parentId", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "dept.parentName", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "dept.phone", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "dept.searchValue", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "dept.status", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "dept.updateBy", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "dept.updateByName", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "dept.updateTime", "in": "query", "required": false, "type": "string / date-time", "description": "" }, { "name": "deptId", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "email", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "loginDate", "in": "query", "required": false, "type": "string / date-time", "description": "" }, { "name": "loginIp", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "nickName", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "params", "in": "query", "required": false, "type": "object", "description": "" }, { "name": "password", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "phonenumber", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "postIds", "in": "query", "required": false, "type": "array", "description": "" }, { "name": "postNames", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "remark", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "roleId", "in": "query", "required": false, "type": "integer / int64", "description": "" }, { "name": "roleIds", "in": "query", "required": false, "type": "array", "description": "" }, { "name": "roles[0].admin", "in": "query", "required": false, "type": "boolean", "description": "" }, { "name": "roles[0].createBy", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "roles[0].createByName", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "roles[0].createTime", "in": "query", "required": false, "type": "string / date-time", "description": "" }, { "name": "roles[0].dataScope", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "roles[0].delFlag", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "roles[0].deptCheckStrictly", "in": "query", "required": false, "type": "boolean", "description": "" }, { "name": "roles[0].deptIds", "in": "query", "required": false, "type": "array", "description": "" }, { "name": "roles[0].flag", "in": "query", "required": false, "type": "boolean", "description": "" }, { "name": "roles[0].menuCheckStrictly", "in": "query", "required": false, "type": "boolean", "description": "" }, { "name": "roles[0].menuIds", "in": "query", "required": false, "type": "array", "description": "" }, { "name": "roles[0].params", "in": "query", "required": false, "type": "object", "description": "" }, { "name": "roles[0].permissions", "in": "query", "required": false, "type": "array", "description": "" }, { "name": "roles[0].remark", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "roles[0].roleId", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "roles[0].roleKey", "in": "query", "required": true, "type": "string", "description": "" }, { "name": "roles[0].roleName", "in": "query", "required": true, "type": "string", "description": "" }, { "name": "roles[0].roleSort", "in": "query", "required": true, "type": "integer / int32", "description": "" }, { "name": "roles[0].searchValue", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "roles[0].status", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "roles[0].updateBy", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "roles[0].updateByName", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "roles[0].updateTime", "in": "query", "required": false, "type": "string / date-time", "description": "" }, { "name": "sapCode", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "searchValue", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "sex", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "status", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "updateBy", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "updateByName", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "updateTime", "in": "query", "required": false, "type": "string / date-time", "description": "" }, { "name": "userId", "in": "query", "required": false, "type": "string", "description": "" }, { "name": "userName", "in": "query", "required": true, "type": "string", "description": "" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "流程定义", "name": "删除流程", "usage": "", "method": "DELETE", "path": "/gd_dataserver/flowable/definition/{deployIds}", "operationId": "deleteUsingDELETE", "parameters": [ { "name": "deployIds", "in": "path", "required": true, "type": "string", "description": "deployIds" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "204", "description": "No Content", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] } ] }, { "tag": "工作流流程实例管理", "name": "删除流程实例", "usage": "", "method": "DELETE", "path": "/gd_dataserver/flowable/instance/delete/{instanceIds}", "operationId": "deleteUsingDELETE_1", "parameters": [ { "name": "instanceIds", "in": "path", "required": true, "type": "string", "description": "流程实例ID" }, { "name": "deleteReason", "in": "query", "required": false, "type": "string", "description": "删除原因" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "204", "description": "No Content", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] } ] }, { "tag": "工作流流程实例管理", "name": "根据流程定义id启动流程实例", "usage": "", "method": "POST", "path": "/gd_dataserver/flowable/instance/startBy/{procDefId}", "operationId": "startByIdUsingPOST", "parameters": [ { "name": "procDefId", "in": "path", "required": true, "type": "string", "description": "流程定义id" } ], "requestBodies": [ { "contentType": "application/json", "schema": "object" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "工作流流程实例管理", "name": "结束流程实例", "usage": "", "method": "POST", "path": "/gd_dataserver/flowable/instance/stopProcessInstance", "operationId": "stopProcessInstanceUsingPOST", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "工作流任务相关--请求参数" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "工作流流程实例管理", "name": "激活或挂起流程实例", "usage": "", "method": "POST", "path": "/gd_dataserver/flowable/instance/updateState", "operationId": "updateStateUsingPOST", "parameters": [ { "name": "state", "in": "query", "required": true, "type": "integer / int32", "description": "1:激活,2:挂起" }, { "name": "instanceId", "in": "query", "required": true, "type": "string", "description": "流程实例ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "工作流流程任务管理", "name": "多实例加签", "usage": "", "method": "POST", "path": "/gd_dataserver/flowable/task/addMultiInstanceExecution", "operationId": "addMultiInstanceExecutionUsingPOST", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "工作流任务相关--请求参数" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "工作流流程任务管理", "name": "转办任务", "usage": "", "method": "POST", "path": "/gd_dataserver/flowable/task/assignTask", "operationId": "assignUsingPOST", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "工作流任务相关--请求参数" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "工作流流程任务管理", "name": "认领/签收任务", "usage": "", "method": "POST", "path": "/gd_dataserver/flowable/task/claim", "operationId": "claimUsingPOST", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "工作流任务相关--请求参数" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "工作流流程任务管理", "name": "审批任务", "usage": "", "method": "POST", "path": "/gd_dataserver/flowable/task/complete", "operationId": "completeUsingPOST_1", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "工作流任务相关--请求参数" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "工作流流程任务管理", "name": "委派任务", "usage": "", "method": "POST", "path": "/gd_dataserver/flowable/task/delegateTask", "operationId": "delegateUsingPOST", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "工作流任务相关--请求参数" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "工作流流程任务管理", "name": "删除任务", "usage": "", "method": "POST", "path": "/gd_dataserver/flowable/task/delete", "operationId": "deleteUsingPOST", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "工作流任务相关--请求参数" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "工作流流程任务管理", "name": "清空任务", "usage": "", "method": "GET", "path": "/gd_dataserver/flowable/task/deleteAll", "operationId": "deleteAllUsingGET", "parameters": [], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "工作流流程任务管理", "name": "多实例减签", "usage": "", "method": "POST", "path": "/gd_dataserver/flowable/task/deleteMultiInstanceExecution", "operationId": "deleteMultiInstanceExecutionUsingPOST", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "工作流任务相关--请求参数" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "工作流流程任务管理", "name": "获取已办任务", "usage": "", "method": "GET", "path": "/gd_dataserver/flowable/task/finishedList", "operationId": "finishedListUsingGET", "parameters": [ { "name": "businessId", "in": "query", "required": false, "type": "string", "description": "业务id" }, { "name": "businessType", "in": "query", "required": false, "type": "string", "description": "业务类型" }, { "name": "endTime", "in": "query", "required": false, "type": "string", "description": "结束时间" }, { "name": "name", "in": "query", "required": false, "type": "string", "description": "流程名称" }, { "name": "pageNum", "in": "query", "required": false, "type": "integer / int32", "description": "当前页码" }, { "name": "pageSize", "in": "query", "required": false, "type": "integer / int32", "description": "每页条数" }, { "name": "procInsId", "in": "query", "required": false, "type": "string", "description": "流程编码" }, { "name": "startTime", "in": "query", "required": false, "type": "string", "description": "开始时间" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "工作流流程任务管理", "name": "流程初始化表单", "usage": "", "method": "GET", "path": "/gd_dataserver/flowable/task/flowFormData", "operationId": "flowFormDataUsingGET", "parameters": [ { "name": "deployId", "in": "query", "required": false, "type": "string", "description": "deployId" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "工作流流程任务管理", "name": "流程历史流转记录", "usage": "", "method": "GET", "path": "/gd_dataserver/flowable/task/flowRecord", "operationId": "flowRecordUsingGET", "parameters": [ { "name": "procInsId", "in": "query", "required": false, "type": "string", "description": "procInsId" }, { "name": "deployId", "in": "query", "required": false, "type": "string", "description": "deployId" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "工作流流程任务管理", "name": "我发起的流程", "usage": "", "method": "GET", "path": "/gd_dataserver/flowable/task/myProcess", "operationId": "myProcessUsingGET", "parameters": [ { "name": "businessId", "in": "query", "required": false, "type": "string", "description": "业务id" }, { "name": "businessType", "in": "query", "required": false, "type": "string", "description": "业务类型" }, { "name": "endTime", "in": "query", "required": false, "type": "string", "description": "结束时间" }, { "name": "name", "in": "query", "required": false, "type": "string", "description": "流程名称" }, { "name": "pageNum", "in": "query", "required": false, "type": "integer / int32", "description": "当前页码" }, { "name": "pageSize", "in": "query", "required": false, "type": "integer / int32", "description": "每页条数" }, { "name": "procInsId", "in": "query", "required": false, "type": "string", "description": "流程编码" }, { "name": "startTime", "in": "query", "required": false, "type": "string", "description": "开始时间" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "工作流流程任务管理", "name": "获取下一节点", "usage": "", "method": "POST", "path": "/gd_dataserver/flowable/task/nextFlowNode", "operationId": "getNextFlowNodeUsingPOST", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "工作流任务相关--请求参数" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "工作流流程任务管理", "name": "流程发起时获取下一节点", "usage": "", "method": "POST", "path": "/gd_dataserver/flowable/task/nextFlowNodeByStart", "operationId": "getNextFlowNodeByStartUsingPOST", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "工作流任务相关--请求参数" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "工作流流程任务管理", "name": "获取流程变量", "usage": "", "method": "GET", "path": "/gd_dataserver/flowable/task/processVariables/{taskId}", "operationId": "processVariablesUsingGET", "parameters": [ { "name": "taskId", "in": "path", "required": true, "type": "string", "description": "流程任务Id" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "工作流流程任务管理", "name": "驳回任务", "usage": "", "method": "POST", "path": "/gd_dataserver/flowable/task/reject", "operationId": "taskRejectUsingPOST", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "工作流任务相关--请求参数" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "工作流流程任务管理", "name": "任务归还", "usage": "", "method": "POST", "path": "/gd_dataserver/flowable/task/resolveTask", "operationId": "resolveTaskUsingPOST", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "工作流任务相关--请求参数" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "工作流流程任务管理", "name": "退回任务", "usage": "", "method": "POST", "path": "/gd_dataserver/flowable/task/return", "operationId": "taskReturnUsingPOST", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "工作流任务相关--请求参数" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "工作流流程任务管理", "name": "获取所有可回退的节点", "usage": "", "method": "POST", "path": "/gd_dataserver/flowable/task/returnList", "operationId": "findReturnTaskListUsingPOST", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "工作流任务相关--请求参数" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "工作流流程任务管理", "name": "撤回流程", "usage": "", "method": "POST", "path": "/gd_dataserver/flowable/task/revokeProcess", "operationId": "revokeProcessUsingPOST", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "工作流任务相关--请求参数" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "工作流流程任务管理", "name": "取消申请", "usage": "", "method": "POST", "path": "/gd_dataserver/flowable/task/stopProcess", "operationId": "stopProcessUsingPOST", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "工作流任务相关--请求参数" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "工作流流程任务管理", "name": "获取待办列表", "usage": "", "method": "GET", "path": "/gd_dataserver/flowable/task/todoList", "operationId": "todoListUsingGET", "parameters": [ { "name": "businessId", "in": "query", "required": false, "type": "string", "description": "业务id" }, { "name": "businessType", "in": "query", "required": false, "type": "string", "description": "业务类型" }, { "name": "endTime", "in": "query", "required": false, "type": "string", "description": "结束时间" }, { "name": "name", "in": "query", "required": false, "type": "string", "description": "流程名称" }, { "name": "pageNum", "in": "query", "required": false, "type": "integer / int32", "description": "当前页码" }, { "name": "pageSize", "in": "query", "required": false, "type": "integer / int32", "description": "每页条数" }, { "name": "procInsId", "in": "query", "required": false, "type": "string", "description": "流程编码" }, { "name": "startTime", "in": "query", "required": false, "type": "string", "description": "开始时间" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "工作流流程任务管理", "name": "取消认领/签收任务", "usage": "", "method": "POST", "path": "/gd_dataserver/flowable/task/unClaim", "operationId": "unClaimUsingPOST", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "工作流任务相关--请求参数" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "隐患上报流程", "name": "审批隐患流程", "usage": "审批通过或驳回，需携带taskId、comment、result等信息。成功返回 data 为 null；失败返回 error 信息。", "method": "POST", "path": "/gd_dataserver/flowable/hazard/complete", "operationId": "completeUsingPOST_2", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "工作流签字任务相关--请求参数" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "隐患上报流程", "name": "隐患流程详情", "usage": "返回 data 为 HazardReport 对象，包含完整隐患字段及流程状态信息。主要字段：id、reportNo、hazardName、status-状态编码、flowStatus-流程状态、canApprove-是否可审批。", "method": "GET", "path": "/gd_dataserver/flowable/hazard/detail/{id}", "operationId": "detailUsingGET", "parameters": [ { "name": "id", "in": "path", "required": true, "type": "integer / int64", "description": "隐患ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "隐患上报流程", "name": "上报隐患并提交流程", "usage": "先调用uploadAttachment上传附件，再将report和attachments一起提交。成功返回 data 为对象，包含：reportId-隐患记录ID、reportNo-隐患编号、flowInstanceId-流程实例ID、message-提示信息。失败返回 error 字段含错误原因。", "method": "POST", "path": "/gd_dataserver/flowable/hazard/submitFlow", "operationId": "submitFlowUsingPOST", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "隐患上报流程提交请求" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "隐患上报流程", "name": "切换隐患流程等级", "usage": "审批过程中重新评估隐患等级，作废当前流程并以新等级重新启动审批。等级编码：general-一般隐患 / major-较大隐患 / critical-重大隐患。返回新流程实例ID。", "method": "POST", "path": "/gd_dataserver/flowable/hazard/switchLevel", "operationId": "switchLevelUsingPOST", "parameters": [ { "name": "reportId", "in": "query", "required": true, "type": "integer / int64", "description": "隐患记录ID" }, { "name": "newHazardLevel", "in": "query", "required": true, "type": "string", "description": "目标等级编码（general/major/critical）" }, { "name": "switchReason", "in": "query", "required": false, "type": "string", "description": "切换原因" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "隐患上报流程", "name": "隐患流程待办/已办列表", "usage": "返回 data 为 PageInfo 分页对象。list 中每条记录为 HazardReport 对象，包含 id、reportNo、hazardName、status、createTime 等字段。支持 pageNum、pageSize 等筛选参数。", "method": "GET", "path": "/gd_dataserver/flowable/hazard/todoList", "operationId": "todoListUsingGET_1", "parameters": [ { "name": "params", "in": "query", "required": true, "type": "object", "description": "查询参数（支持pageNum/pageSize等）" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "隐患信息管理", "name": "新增", "usage": "新增单条记录，请求体为实体类对象（字段说明见对应实体模型）。成功返回 data 为 null。", "method": "POST", "path": "/gd_dataserver/business/hazard/add", "operationId": "addOneUsingPOST_8", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "隐患信息" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "隐患信息管理", "name": "批量新增", "usage": "批量新增多条记录，请求体为实体类数组。成功返回 data 为 null。", "method": "POST", "path": "/gd_dataserver/business/hazard/addBatch", "operationId": "addBatchUsingPOST_8", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "array<隐患信息>" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "隐患信息管理", "name": "新增并返回保存的数据", "usage": "新增单条记录并返回保存后的数据（含自增ID），请求体为实体类对象。成功返回 data 为保存的实体对象。", "method": "POST", "path": "/gd_dataserver/business/hazard/addReturn", "operationId": "addReturnUsingPOST_8", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "隐患信息" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "隐患信息管理", "name": "删除附件", "usage": "返回 data 为 boolean，true-删除成功。", "method": "DELETE", "path": "/gd_dataserver/business/hazard/attachment/{ids}", "operationId": "removeAttachmentUsingDELETE", "parameters": [ { "name": "ids", "in": "path", "required": true, "type": "string", "description": "附件ID列表（逗号分隔）" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "204", "description": "No Content", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] } ] }, { "tag": "隐患信息管理", "name": "按隐患ID查附件列表", "usage": "返回 data 为 HazardAttachment 数组。每个元素包含：id-附件ID、reportId-隐患ID、fileName-文件名、fileUrl-文件访问URL、fileType-文件类型、fileSize-文件大小。", "method": "GET", "path": "/gd_dataserver/business/hazard/attachment/{reportId}", "operationId": "listAttachmentsUsingGET", "parameters": [ { "name": "reportId", "in": "path", "required": true, "type": "integer / int64", "description": "隐患ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "隐患信息管理", "name": "根据属性删除", "usage": "根据实体属性条件删除记录，请求体为实体类对象。成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/hazard/delete", "operationId": "deleteUsingGET_8", "parameters": [ { "name": "actualCompleteTime", "in": "query", "required": false, "type": "string / date-time", "description": "实际完成时间" }, { "name": "attachments[0].attachmentType", "in": "query", "required": false, "type": "string", "description": "附件类型：IMAGE-图片 VIDEO-视频 DOCUMENT-文档 OTHER-其他" }, { "name": "attachments[0].createBy", "in": "query", "required": false, "type": "string", "description": "创建者" }, { "name": "attachments[0].createTime", "in": "query", "required": false, "type": "string / date-time", "description": "创建时间" }, { "name": "attachments[0].fileName", "in": "query", "required": false, "type": "string", "description": "文件原始名称" }, { "name": "attachments[0].filePath", "in": "query", "required": false, "type": "string", "description": "文件存储路径" }, { "name": "attachments[0].fileSize", "in": "query", "required": false, "type": "integer / int64", "description": "文件大小（字节）" }, { "name": "attachments[0].fileType", "in": "query", "required": false, "type": "string", "description": "文件MIME类型" }, { "name": "attachments[0].fileUrl", "in": "query", "required": false, "type": "string", "description": "文件访问URL" }, { "name": "attachments[0].id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "attachments[0].remark", "in": "query", "required": false, "type": "string", "description": "备注" }, { "name": "attachments[0].reportId", "in": "query", "required": false, "type": "integer / int64", "description": "关联隐患ID" }, { "name": "attachments[0].sortOrder", "in": "query", "required": false, "type": "integer / int32", "description": "排序" }, { "name": "attachments[0].suffix", "in": "query", "required": false, "type": "string", "description": "文件后缀" }, { "name": "attachments[0].updateBy", "in": "query", "required": false, "type": "string", "description": "更新者" }, { "name": "attachments[0].updateTime", "in": "query", "required": false, "type": "string / date-time", "description": "更新时间" }, { "name": "attachments[0].uploadUserId", "in": "query", "required": false, "type": "string", "description": "上传人用户ID" }, { "name": "attachments[0].uploadUserName", "in": "query", "required": false, "type": "string", "description": "上传人姓名" }, { "name": "auditRemark", "in": "query", "required": false, "type": "string", "description": "审核备注" }, { "name": "auditTime", "in": "query", "required": false, "type": "string / date-time", "description": "审核时间" }, { "name": "auditUserId", "in": "query", "required": false, "type": "integer / int64", "description": "审核人用户ID" }, { "name": "auditUserName", "in": "query", "required": false, "type": "string", "description": "审核人姓名" }, { "name": "auditUserUsername", "in": "query", "required": false, "type": "string", "description": "审核人账号" }, { "name": "canApprove", "in": "query", "required": false, "type": "boolean", "description": "当前用户是否可审批此流程" }, { "name": "causeAnalysis", "in": "query", "required": false, "type": "string", "description": "原因分析" }, { "name": "chargePersonId", "in": "query", "required": false, "type": "integer / int64", "description": "整改负责人用户ID" }, { "name": "chargePersonName", "in": "query", "required": false, "type": "string", "description": "整改负责人姓名" }, { "name": "chargePersonUsername", "in": "query", "required": false, "type": "string", "description": "整改负责人账号" }, { "name": "createBy", "in": "query", "required": false, "type": "string", "description": "创建者" }, { "name": "createTime", "in": "query", "required": false, "type": "string / date-time", "description": "创建时间" }, { "name": "criteriaIds", "in": "query", "required": false, "type": "string", "description": "判定标准ID（多选，逗号分隔）" }, { "name": "criteriaNames", "in": "query", "required": false, "type": "string", "description": "判定标准名称" }, { "name": "currentFlowLevel", "in": "query", "required": false, "type": "string", "description": "当前流程等级编码（general/major/critical）" }, { "name": "departmentId", "in": "query", "required": false, "type": "integer / int64", "description": "部门ID" }, { "name": "departmentName", "in": "query", "required": false, "type": "string", "description": "部门名称" }, { "name": "deployId", "in": "query", "required": false, "type": "string", "description": "流程模板id" }, { "name": "description", "in": "query", "required": false, "type": "string", "description": "隐患描述" }, { "name": "discoverTime", "in": "query", "required": false, "type": "string / date-time", "description": "发现时间" }, { "name": "factoryDeptId", "in": "query", "required": false, "type": "string", "description": "所属厂区部门ID" }, { "name": "factoryDeptName", "in": "query", "required": false, "type": "string", "description": "所属厂区部门名称" }, { "name": "factoryManagerId", "in": "query", "required": false, "type": "integer / int64", "description": "厂区管理员用户ID" }, { "name": "factoryManagerName", "in": "query", "required": false, "type": "string", "description": "厂区管理员姓名" }, { "name": "finalFlowLevel", "in": "query", "required": false, "type": "string", "description": "审批最终等级名称（如一般-A档）" }, { "name": "finalFlowLevelId", "in": "query", "required": false, "type": "integer / int64", "description": "审批最终积分规则ID（关联积分规则表）" }, { "name": "flowInstanceId", "in": "query", "required": false, "type": "string", "description": "流程实例id" }, { "name": "flowStatus", "in": "query", "required": false, "type": "integer / int32", "description": "流程状态（0-未开始 1-进行中 2-已完成）" }, { "name": "fundsSource", "in": "query", "required": false, "type": "string", "description": "资金来源编码" }, { "name": "fundsSourceId", "in": "query", "required": false, "type": "integer / int64", "description": "资金来源字典ID" }, { "name": "fundsSourceName", "in": "query", "required": false, "type": "string", "description": "资金来源名称" }, { "name": "governanceType", "in": "query", "required": false, "type": "string", "description": "治理类型编码" }, { "name": "governanceTypeId", "in": "query", "required": false, "type": "integer / int64", "description": "治理类型字典ID" }, { "name": "governanceTypeName", "in": "query", "required": false, "type": "string", "description": "治理类型名称" }, { "name": "hazardCategory", "in": "query", "required": false, "type": "string", "description": "隐患分类编码（general/major/critical）" }, { "name": "hazardCategoryId", "in": "query", "required": false, "type": "integer / int64", "description": "隐患分类根规则ID（关联积分规则表）" }, { "name": "hazardCategoryName", "in": "query", "required": false, "type": "string", "description": "隐患分类名称" }, { "name": "hazardClassificationStandard", "in": "query", "required": false, "type": "string", "description": "隐患分类标准（文本说明，用于隐患分类的说明）" }, { "name": "hazardLevel", "in": "query", "required": false, "type": "string", "description": "管理级别编码" }, { "name": "hazardLevelId", "in": "query", "required": false, "type": "integer / int64", "description": "管理级别字典ID" }, { "name": "hazardLevelName", "in": "query", "required": false, "type": "string", "description": "管理级别名称" }, { "name": "hazardName", "in": "query", "required": false, "type": "string", "description": "隐患名称" }, { "name": "hazardSourceDetail", "in": "query", "required": false, "type": "string", "description": "来源具体描述" }, { "name": "hazardType", "in": "query", "required": false, "type": "string", "description": "隐患类型编码" }, { "name": "hazardTypeId", "in": "query", "required": false, "type": "integer / int64", "description": "隐患类型字典ID" }, { "name": "hazardTypeName", "in": "query", "required": false, "type": "string", "description": "隐患类型名称" }, { "name": "id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "isInitiator", "in": "query", "required": false, "type": "boolean", "description": "当前用户是否为此流程发起人" }, { "name": "limitedCompleteTime", "in": "query", "required": false, "type": "string / date-time", "description": "限定完成时间" }, { "name": "major", "in": "query", "required": false, "type": "string", "description": "专业编码" }, { "name": "majorId", "in": "query", "required": false, "type": "integer / int64", "description": "专业字典ID" }, { "name": "majorName", "in": "query", "required": false, "type": "string", "description": "专业名称" }, { "name": "pointsAwarded", "in": "query", "required": false, "type": "integer / int32", "description": "奖励积分" }, { "name": "pointsStatus", "in": "query", "required": false, "type": "string", "description": "积分发放状态编码" }, { "name": "pointsStatusId", "in": "query", "required": false, "type": "integer / int64", "description": "积分发放状态字典ID" }, { "name": "pointsStatusName", "in": "query", "required": false, "type": "string", "description": "积分发放状态名称" }, { "name": "preventiveMeasures", "in": "query", "required": false, "type": "string", "description": "防范措施" }, { "name": "pushResponse", "in": "query", "required": false, "type": "string", "description": "第三方返回结果" }, { "name": "pushStatus", "in": "query", "required": false, "type": "string", "description": "推送状态编码" }, { "name": "pushStatusId", "in": "query", "required": false, "type": "integer / int64", "description": "推送状态字典ID" }, { "name": "pushStatusName", "in": "query", "required": false, "type": "string", "description": "推送状态名称" }, { "name": "pushTime", "in": "query", "required": false, "type": "string / date-time", "description": "推送时间" }, { "name": "rectificationPlan", "in": "query", "required": false, "type": "string", "description": "整改方案" }, { "name": "remark", "in": "query", "required": false, "type": "string", "description": "备注" }, { "name": "reportNo", "in": "query", "required": false, "type": "string", "description": "隐患编号" }, { "name": "reporterId", "in": "query", "required": false, "type": "integer / int64", "description": "上报人用户ID" }, { "name": "reporterName", "in": "query", "required": false, "type": "string", "description": "上报人姓名" }, { "name": "reporterUsername", "in": "query", "required": false, "type": "string", "description": "上报人账号" }, { "name": "riskTarget", "in": "query", "required": false, "type": "string", "description": "风险分析对象" }, { "name": "riskUnit", "in": "query", "required": false, "type": "string", "description": "风险分析单元" }, { "name": "sourceType", "in": "query", "required": false, "type": "string", "description": "隐患来源编码" }, { "name": "sourceTypeId", "in": "query", "required": false, "type": "integer / int64", "description": "隐患来源字典ID" }, { "name": "sourceTypeName", "in": "query", "required": false, "type": "string", "description": "隐患来源名称" }, { "name": "status", "in": "query", "required": false, "type": "string", "description": "隐患状态编码" }, { "name": "statusId", "in": "query", "required": false, "type": "integer / int64", "description": "隐患状态字典ID" }, { "name": "statusName", "in": "query", "required": false, "type": "string", "description": "隐患状态名称" }, { "name": "supervisorId", "in": "query", "required": false, "type": "integer / int64", "description": "监察人用户ID" }, { "name": "supervisorName", "in": "query", "required": false, "type": "string", "description": "监察人姓名" }, { "name": "supervisorUsername", "in": "query", "required": false, "type": "string", "description": "监察人账号" }, { "name": "thirdPartyId", "in": "query", "required": false, "type": "string", "description": "第三方系统记录ID" }, { "name": "unitId", "in": "query", "required": false, "type": "integer / int64", "description": "单位ID" }, { "name": "unitName", "in": "query", "required": false, "type": "string", "description": "单位名称" }, { "name": "updateBy", "in": "query", "required": false, "type": "string", "description": "更新者" }, { "name": "updateTime", "in": "query", "required": false, "type": "string / date-time", "description": "更新时间" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "隐患信息管理", "name": "主键删除", "usage": "根据主键ID删除单条记录，成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/hazard/deleteById", "operationId": "deleteOneUsingGET_8", "parameters": [ { "name": "id", "in": "query", "required": true, "type": "string", "description": "主键ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "隐患信息管理", "name": "批量删除", "usage": "根据ID列表批量删除记录，成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/hazard/deleteByIds", "operationId": "deleteListUsingGET_17", "parameters": [ { "name": "ids", "in": "query", "required": true, "type": "string", "description": "ID列表(逗号分隔)" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "隐患信息管理", "name": "导出隐患列表Excel", "usage": "超级管理员导出所有厂区；非超级管理员仅导出本厂区。直接返回 Excel 文件流，前端以 Blob 方式接收下载。", "method": "POST", "path": "/gd_dataserver/business/hazard/export", "operationId": "exportUsingPOST", "parameters": [ { "name": "actualCompleteTime", "in": "query", "required": false, "type": "string / date-time", "description": "实际完成时间" }, { "name": "attachments[0].attachmentType", "in": "query", "required": false, "type": "string", "description": "附件类型：IMAGE-图片 VIDEO-视频 DOCUMENT-文档 OTHER-其他" }, { "name": "attachments[0].createBy", "in": "query", "required": false, "type": "string", "description": "创建者" }, { "name": "attachments[0].createTime", "in": "query", "required": false, "type": "string / date-time", "description": "创建时间" }, { "name": "attachments[0].fileName", "in": "query", "required": false, "type": "string", "description": "文件原始名称" }, { "name": "attachments[0].filePath", "in": "query", "required": false, "type": "string", "description": "文件存储路径" }, { "name": "attachments[0].fileSize", "in": "query", "required": false, "type": "integer / int64", "description": "文件大小（字节）" }, { "name": "attachments[0].fileType", "in": "query", "required": false, "type": "string", "description": "文件MIME类型" }, { "name": "attachments[0].fileUrl", "in": "query", "required": false, "type": "string", "description": "文件访问URL" }, { "name": "attachments[0].id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "attachments[0].remark", "in": "query", "required": false, "type": "string", "description": "备注" }, { "name": "attachments[0].reportId", "in": "query", "required": false, "type": "integer / int64", "description": "关联隐患ID" }, { "name": "attachments[0].sortOrder", "in": "query", "required": false, "type": "integer / int32", "description": "排序" }, { "name": "attachments[0].suffix", "in": "query", "required": false, "type": "string", "description": "文件后缀" }, { "name": "attachments[0].updateBy", "in": "query", "required": false, "type": "string", "description": "更新者" }, { "name": "attachments[0].updateTime", "in": "query", "required": false, "type": "string / date-time", "description": "更新时间" }, { "name": "attachments[0].uploadUserId", "in": "query", "required": false, "type": "string", "description": "上传人用户ID" }, { "name": "attachments[0].uploadUserName", "in": "query", "required": false, "type": "string", "description": "上传人姓名" }, { "name": "auditRemark", "in": "query", "required": false, "type": "string", "description": "审核备注" }, { "name": "auditTime", "in": "query", "required": false, "type": "string / date-time", "description": "审核时间" }, { "name": "auditUserId", "in": "query", "required": false, "type": "integer / int64", "description": "审核人用户ID" }, { "name": "auditUserName", "in": "query", "required": false, "type": "string", "description": "审核人姓名" }, { "name": "auditUserUsername", "in": "query", "required": false, "type": "string", "description": "审核人账号" }, { "name": "canApprove", "in": "query", "required": false, "type": "boolean", "description": "当前用户是否可审批此流程" }, { "name": "causeAnalysis", "in": "query", "required": false, "type": "string", "description": "原因分析" }, { "name": "chargePersonId", "in": "query", "required": false, "type": "integer / int64", "description": "整改负责人用户ID" }, { "name": "chargePersonName", "in": "query", "required": false, "type": "string", "description": "整改负责人姓名" }, { "name": "chargePersonUsername", "in": "query", "required": false, "type": "string", "description": "整改负责人账号" }, { "name": "createBy", "in": "query", "required": false, "type": "string", "description": "创建者" }, { "name": "createTime", "in": "query", "required": false, "type": "string / date-time", "description": "创建时间" }, { "name": "criteriaIds", "in": "query", "required": false, "type": "string", "description": "判定标准ID（多选，逗号分隔）" }, { "name": "criteriaNames", "in": "query", "required": false, "type": "string", "description": "判定标准名称" }, { "name": "currentFlowLevel", "in": "query", "required": false, "type": "string", "description": "当前流程等级编码（general/major/critical）" }, { "name": "departmentId", "in": "query", "required": false, "type": "integer / int64", "description": "部门ID" }, { "name": "departmentName", "in": "query", "required": false, "type": "string", "description": "部门名称" }, { "name": "deployId", "in": "query", "required": false, "type": "string", "description": "流程模板id" }, { "name": "description", "in": "query", "required": false, "type": "string", "description": "隐患描述" }, { "name": "discoverTime", "in": "query", "required": false, "type": "string / date-time", "description": "发现时间" }, { "name": "factoryDeptId", "in": "query", "required": false, "type": "string", "description": "所属厂区部门ID" }, { "name": "factoryDeptName", "in": "query", "required": false, "type": "string", "description": "所属厂区部门名称" }, { "name": "factoryManagerId", "in": "query", "required": false, "type": "integer / int64", "description": "厂区管理员用户ID" }, { "name": "factoryManagerName", "in": "query", "required": false, "type": "string", "description": "厂区管理员姓名" }, { "name": "finalFlowLevel", "in": "query", "required": false, "type": "string", "description": "审批最终等级名称（如一般-A档）" }, { "name": "finalFlowLevelId", "in": "query", "required": false, "type": "integer / int64", "description": "审批最终积分规则ID（关联积分规则表）" }, { "name": "flowInstanceId", "in": "query", "required": false, "type": "string", "description": "流程实例id" }, { "name": "flowStatus", "in": "query", "required": false, "type": "integer / int32", "description": "流程状态（0-未开始 1-进行中 2-已完成）" }, { "name": "fundsSource", "in": "query", "required": false, "type": "string", "description": "资金来源编码" }, { "name": "fundsSourceId", "in": "query", "required": false, "type": "integer / int64", "description": "资金来源字典ID" }, { "name": "fundsSourceName", "in": "query", "required": false, "type": "string", "description": "资金来源名称" }, { "name": "governanceType", "in": "query", "required": false, "type": "string", "description": "治理类型编码" }, { "name": "governanceTypeId", "in": "query", "required": false, "type": "integer / int64", "description": "治理类型字典ID" }, { "name": "governanceTypeName", "in": "query", "required": false, "type": "string", "description": "治理类型名称" }, { "name": "hazardCategory", "in": "query", "required": false, "type": "string", "description": "隐患分类编码（general/major/critical）" }, { "name": "hazardCategoryId", "in": "query", "required": false, "type": "integer / int64", "description": "隐患分类根规则ID（关联积分规则表）" }, { "name": "hazardCategoryName", "in": "query", "required": false, "type": "string", "description": "隐患分类名称" }, { "name": "hazardClassificationStandard", "in": "query", "required": false, "type": "string", "description": "隐患分类标准（文本说明，用于隐患分类的说明）" }, { "name": "hazardLevel", "in": "query", "required": false, "type": "string", "description": "管理级别编码" }, { "name": "hazardLevelId", "in": "query", "required": false, "type": "integer / int64", "description": "管理级别字典ID" }, { "name": "hazardLevelName", "in": "query", "required": false, "type": "string", "description": "管理级别名称" }, { "name": "hazardName", "in": "query", "required": false, "type": "string", "description": "隐患名称" }, { "name": "hazardSourceDetail", "in": "query", "required": false, "type": "string", "description": "来源具体描述" }, { "name": "hazardType", "in": "query", "required": false, "type": "string", "description": "隐患类型编码" }, { "name": "hazardTypeId", "in": "query", "required": false, "type": "integer / int64", "description": "隐患类型字典ID" }, { "name": "hazardTypeName", "in": "query", "required": false, "type": "string", "description": "隐患类型名称" }, { "name": "id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "isInitiator", "in": "query", "required": false, "type": "boolean", "description": "当前用户是否为此流程发起人" }, { "name": "limitedCompleteTime", "in": "query", "required": false, "type": "string / date-time", "description": "限定完成时间" }, { "name": "major", "in": "query", "required": false, "type": "string", "description": "专业编码" }, { "name": "majorId", "in": "query", "required": false, "type": "integer / int64", "description": "专业字典ID" }, { "name": "majorName", "in": "query", "required": false, "type": "string", "description": "专业名称" }, { "name": "pointsAwarded", "in": "query", "required": false, "type": "integer / int32", "description": "奖励积分" }, { "name": "pointsStatus", "in": "query", "required": false, "type": "string", "description": "积分发放状态编码" }, { "name": "pointsStatusId", "in": "query", "required": false, "type": "integer / int64", "description": "积分发放状态字典ID" }, { "name": "pointsStatusName", "in": "query", "required": false, "type": "string", "description": "积分发放状态名称" }, { "name": "preventiveMeasures", "in": "query", "required": false, "type": "string", "description": "防范措施" }, { "name": "pushResponse", "in": "query", "required": false, "type": "string", "description": "第三方返回结果" }, { "name": "pushStatus", "in": "query", "required": false, "type": "string", "description": "推送状态编码" }, { "name": "pushStatusId", "in": "query", "required": false, "type": "integer / int64", "description": "推送状态字典ID" }, { "name": "pushStatusName", "in": "query", "required": false, "type": "string", "description": "推送状态名称" }, { "name": "pushTime", "in": "query", "required": false, "type": "string / date-time", "description": "推送时间" }, { "name": "rectificationPlan", "in": "query", "required": false, "type": "string", "description": "整改方案" }, { "name": "remark", "in": "query", "required": false, "type": "string", "description": "备注" }, { "name": "reportNo", "in": "query", "required": false, "type": "string", "description": "隐患编号" }, { "name": "reporterId", "in": "query", "required": false, "type": "integer / int64", "description": "上报人用户ID" }, { "name": "reporterName", "in": "query", "required": false, "type": "string", "description": "上报人姓名" }, { "name": "reporterUsername", "in": "query", "required": false, "type": "string", "description": "上报人账号" }, { "name": "riskTarget", "in": "query", "required": false, "type": "string", "description": "风险分析对象" }, { "name": "riskUnit", "in": "query", "required": false, "type": "string", "description": "风险分析单元" }, { "name": "sourceType", "in": "query", "required": false, "type": "string", "description": "隐患来源编码" }, { "name": "sourceTypeId", "in": "query", "required": false, "type": "integer / int64", "description": "隐患来源字典ID" }, { "name": "sourceTypeName", "in": "query", "required": false, "type": "string", "description": "隐患来源名称" }, { "name": "status", "in": "query", "required": false, "type": "string", "description": "隐患状态编码" }, { "name": "statusId", "in": "query", "required": false, "type": "integer / int64", "description": "隐患状态字典ID" }, { "name": "statusName", "in": "query", "required": false, "type": "string", "description": "隐患状态名称" }, { "name": "supervisorId", "in": "query", "required": false, "type": "integer / int64", "description": "监察人用户ID" }, { "name": "supervisorName", "in": "query", "required": false, "type": "string", "description": "监察人姓名" }, { "name": "supervisorUsername", "in": "query", "required": false, "type": "string", "description": "监察人账号" }, { "name": "thirdPartyId", "in": "query", "required": false, "type": "string", "description": "第三方系统记录ID" }, { "name": "unitId", "in": "query", "required": false, "type": "integer / int64", "description": "单位ID" }, { "name": "unitName", "in": "query", "required": false, "type": "string", "description": "单位名称" }, { "name": "updateBy", "in": "query", "required": false, "type": "string", "description": "更新者" }, { "name": "updateTime", "in": "query", "required": false, "type": "string / date-time", "description": "更新时间" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "隐患信息管理", "name": "生成隐患编号", "usage": "返回 data 为 String 类型的隐患编号，格式如 HR20260827001。", "method": "POST", "path": "/gd_dataserver/business/hazard/generateReportNo", "operationId": "generateReportNoUsingPOST", "parameters": [], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "隐患信息管理", "name": "查询所有", "usage": "查询所有记录（无分页、无条件）。成功返回 data 为实体类数组。", "method": "GET", "path": "/gd_dataserver/business/hazard/getAll", "operationId": "getAllUsingGET_8", "parameters": [], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "隐患信息管理", "name": "隐患台账分页查询", "usage": "超级管理员返回所有厂区隐患；非超级管理员自动过滤为所属厂区的隐患。返回 data 为 PageInfo 分页对象，其中 list 为 HazardReport 数组。", "method": "GET", "path": "/gd_dataserver/business/hazard/getListByPage", "operationId": "getListByPageUsingGET_8", "parameters": [ { "name": "actualCompleteTime", "in": "query", "required": false, "type": "string / date-time", "description": "实际完成时间" }, { "name": "attachments[0].attachmentType", "in": "query", "required": false, "type": "string", "description": "附件类型：IMAGE-图片 VIDEO-视频 DOCUMENT-文档 OTHER-其他" }, { "name": "attachments[0].createBy", "in": "query", "required": false, "type": "string", "description": "创建者" }, { "name": "attachments[0].createTime", "in": "query", "required": false, "type": "string / date-time", "description": "创建时间" }, { "name": "attachments[0].fileName", "in": "query", "required": false, "type": "string", "description": "文件原始名称" }, { "name": "attachments[0].filePath", "in": "query", "required": false, "type": "string", "description": "文件存储路径" }, { "name": "attachments[0].fileSize", "in": "query", "required": false, "type": "integer / int64", "description": "文件大小（字节）" }, { "name": "attachments[0].fileType", "in": "query", "required": false, "type": "string", "description": "文件MIME类型" }, { "name": "attachments[0].fileUrl", "in": "query", "required": false, "type": "string", "description": "文件访问URL" }, { "name": "attachments[0].id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "attachments[0].remark", "in": "query", "required": false, "type": "string", "description": "备注" }, { "name": "attachments[0].reportId", "in": "query", "required": false, "type": "integer / int64", "description": "关联隐患ID" }, { "name": "attachments[0].sortOrder", "in": "query", "required": false, "type": "integer / int32", "description": "排序" }, { "name": "attachments[0].suffix", "in": "query", "required": false, "type": "string", "description": "文件后缀" }, { "name": "attachments[0].updateBy", "in": "query", "required": false, "type": "string", "description": "更新者" }, { "name": "attachments[0].updateTime", "in": "query", "required": false, "type": "string / date-time", "description": "更新时间" }, { "name": "attachments[0].uploadUserId", "in": "query", "required": false, "type": "string", "description": "上传人用户ID" }, { "name": "attachments[0].uploadUserName", "in": "query", "required": false, "type": "string", "description": "上传人姓名" }, { "name": "auditRemark", "in": "query", "required": false, "type": "string", "description": "审核备注" }, { "name": "auditTime", "in": "query", "required": false, "type": "string / date-time", "description": "审核时间" }, { "name": "auditUserId", "in": "query", "required": false, "type": "integer / int64", "description": "审核人用户ID" }, { "name": "auditUserName", "in": "query", "required": false, "type": "string", "description": "审核人姓名" }, { "name": "auditUserUsername", "in": "query", "required": false, "type": "string", "description": "审核人账号" }, { "name": "canApprove", "in": "query", "required": false, "type": "boolean", "description": "当前用户是否可审批此流程" }, { "name": "causeAnalysis", "in": "query", "required": false, "type": "string", "description": "原因分析" }, { "name": "chargePersonId", "in": "query", "required": false, "type": "integer / int64", "description": "整改负责人用户ID" }, { "name": "chargePersonName", "in": "query", "required": false, "type": "string", "description": "整改负责人姓名" }, { "name": "chargePersonUsername", "in": "query", "required": false, "type": "string", "description": "整改负责人账号" }, { "name": "createBy", "in": "query", "required": false, "type": "string", "description": "创建者" }, { "name": "createTime", "in": "query", "required": false, "type": "string / date-time", "description": "创建时间" }, { "name": "criteriaIds", "in": "query", "required": false, "type": "string", "description": "判定标准ID（多选，逗号分隔）" }, { "name": "criteriaNames", "in": "query", "required": false, "type": "string", "description": "判定标准名称" }, { "name": "currentFlowLevel", "in": "query", "required": false, "type": "string", "description": "当前流程等级编码（general/major/critical）" }, { "name": "departmentId", "in": "query", "required": false, "type": "integer / int64", "description": "部门ID" }, { "name": "departmentName", "in": "query", "required": false, "type": "string", "description": "部门名称" }, { "name": "deployId", "in": "query", "required": false, "type": "string", "description": "流程模板id" }, { "name": "description", "in": "query", "required": false, "type": "string", "description": "隐患描述" }, { "name": "discoverTime", "in": "query", "required": false, "type": "string / date-time", "description": "发现时间" }, { "name": "factoryDeptId", "in": "query", "required": false, "type": "string", "description": "所属厂区部门ID" }, { "name": "factoryDeptName", "in": "query", "required": false, "type": "string", "description": "所属厂区部门名称" }, { "name": "factoryManagerId", "in": "query", "required": false, "type": "integer / int64", "description": "厂区管理员用户ID" }, { "name": "factoryManagerName", "in": "query", "required": false, "type": "string", "description": "厂区管理员姓名" }, { "name": "finalFlowLevel", "in": "query", "required": false, "type": "string", "description": "审批最终等级名称（如一般-A档）" }, { "name": "finalFlowLevelId", "in": "query", "required": false, "type": "integer / int64", "description": "审批最终积分规则ID（关联积分规则表）" }, { "name": "flowInstanceId", "in": "query", "required": false, "type": "string", "description": "流程实例id" }, { "name": "flowStatus", "in": "query", "required": false, "type": "integer / int32", "description": "流程状态（0-未开始 1-进行中 2-已完成）" }, { "name": "fundsSource", "in": "query", "required": false, "type": "string", "description": "资金来源编码" }, { "name": "fundsSourceId", "in": "query", "required": false, "type": "integer / int64", "description": "资金来源字典ID" }, { "name": "fundsSourceName", "in": "query", "required": false, "type": "string", "description": "资金来源名称" }, { "name": "governanceType", "in": "query", "required": false, "type": "string", "description": "治理类型编码" }, { "name": "governanceTypeId", "in": "query", "required": false, "type": "integer / int64", "description": "治理类型字典ID" }, { "name": "governanceTypeName", "in": "query", "required": false, "type": "string", "description": "治理类型名称" }, { "name": "hazardCategory", "in": "query", "required": false, "type": "string", "description": "隐患分类编码（general/major/critical）" }, { "name": "hazardCategoryId", "in": "query", "required": false, "type": "integer / int64", "description": "隐患分类根规则ID（关联积分规则表）" }, { "name": "hazardCategoryName", "in": "query", "required": false, "type": "string", "description": "隐患分类名称" }, { "name": "hazardClassificationStandard", "in": "query", "required": false, "type": "string", "description": "隐患分类标准（文本说明，用于隐患分类的说明）" }, { "name": "hazardLevel", "in": "query", "required": false, "type": "string", "description": "管理级别编码" }, { "name": "hazardLevelId", "in": "query", "required": false, "type": "integer / int64", "description": "管理级别字典ID" }, { "name": "hazardLevelName", "in": "query", "required": false, "type": "string", "description": "管理级别名称" }, { "name": "hazardName", "in": "query", "required": false, "type": "string", "description": "隐患名称" }, { "name": "hazardSourceDetail", "in": "query", "required": false, "type": "string", "description": "来源具体描述" }, { "name": "hazardType", "in": "query", "required": false, "type": "string", "description": "隐患类型编码" }, { "name": "hazardTypeId", "in": "query", "required": false, "type": "integer / int64", "description": "隐患类型字典ID" }, { "name": "hazardTypeName", "in": "query", "required": false, "type": "string", "description": "隐患类型名称" }, { "name": "id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "isInitiator", "in": "query", "required": false, "type": "boolean", "description": "当前用户是否为此流程发起人" }, { "name": "limitedCompleteTime", "in": "query", "required": false, "type": "string / date-time", "description": "限定完成时间" }, { "name": "major", "in": "query", "required": false, "type": "string", "description": "专业编码" }, { "name": "majorId", "in": "query", "required": false, "type": "integer / int64", "description": "专业字典ID" }, { "name": "majorName", "in": "query", "required": false, "type": "string", "description": "专业名称" }, { "name": "pageNum", "in": "query", "required": true, "type": "integer / int32", "description": "页码" }, { "name": "pointsAwarded", "in": "query", "required": false, "type": "integer / int32", "description": "奖励积分" }, { "name": "pointsStatus", "in": "query", "required": false, "type": "string", "description": "积分发放状态编码" }, { "name": "pointsStatusId", "in": "query", "required": false, "type": "integer / int64", "description": "积分发放状态字典ID" }, { "name": "pointsStatusName", "in": "query", "required": false, "type": "string", "description": "积分发放状态名称" }, { "name": "preventiveMeasures", "in": "query", "required": false, "type": "string", "description": "防范措施" }, { "name": "pushResponse", "in": "query", "required": false, "type": "string", "description": "第三方返回结果" }, { "name": "pushStatus", "in": "query", "required": false, "type": "string", "description": "推送状态编码" }, { "name": "pushStatusId", "in": "query", "required": false, "type": "integer / int64", "description": "推送状态字典ID" }, { "name": "pushStatusName", "in": "query", "required": false, "type": "string", "description": "推送状态名称" }, { "name": "pushTime", "in": "query", "required": false, "type": "string / date-time", "description": "推送时间" }, { "name": "rectificationPlan", "in": "query", "required": false, "type": "string", "description": "整改方案" }, { "name": "remark", "in": "query", "required": false, "type": "string", "description": "备注" }, { "name": "reportNo", "in": "query", "required": false, "type": "string", "description": "隐患编号" }, { "name": "reporterId", "in": "query", "required": false, "type": "integer / int64", "description": "上报人用户ID" }, { "name": "reporterName", "in": "query", "required": false, "type": "string", "description": "上报人姓名" }, { "name": "reporterUsername", "in": "query", "required": false, "type": "string", "description": "上报人账号" }, { "name": "riskTarget", "in": "query", "required": false, "type": "string", "description": "风险分析对象" }, { "name": "riskUnit", "in": "query", "required": false, "type": "string", "description": "风险分析单元" }, { "name": "sourceType", "in": "query", "required": false, "type": "string", "description": "隐患来源编码" }, { "name": "sourceTypeId", "in": "query", "required": false, "type": "integer / int64", "description": "隐患来源字典ID" }, { "name": "sourceTypeName", "in": "query", "required": false, "type": "string", "description": "隐患来源名称" }, { "name": "status", "in": "query", "required": false, "type": "string", "description": "隐患状态编码" }, { "name": "statusId", "in": "query", "required": false, "type": "integer / int64", "description": "隐患状态字典ID" }, { "name": "statusName", "in": "query", "required": false, "type": "string", "description": "隐患状态名称" }, { "name": "supervisorId", "in": "query", "required": false, "type": "integer / int64", "description": "监察人用户ID" }, { "name": "supervisorName", "in": "query", "required": false, "type": "string", "description": "监察人姓名" }, { "name": "supervisorUsername", "in": "query", "required": false, "type": "string", "description": "监察人账号" }, { "name": "thirdPartyId", "in": "query", "required": false, "type": "string", "description": "第三方系统记录ID" }, { "name": "unitId", "in": "query", "required": false, "type": "integer / int64", "description": "单位ID" }, { "name": "unitName", "in": "query", "required": false, "type": "string", "description": "单位名称" }, { "name": "updateBy", "in": "query", "required": false, "type": "string", "description": "更新者" }, { "name": "updateTime", "in": "query", "required": false, "type": "string / date-time", "description": "更新时间" }, { "name": "pageSize", "in": "query", "required": true, "type": "integer / int32", "description": "每页条数" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "隐患信息管理", "name": "详情", "usage": "根据主键ID查询单条记录详情。成功返回 data 为实体类对象，包含该实体所有字段。", "method": "GET", "path": "/gd_dataserver/business/hazard/info", "operationId": "infoUsingGET_8", "parameters": [ { "name": "id", "in": "query", "required": true, "type": "string", "description": "主键ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "隐患信息管理", "name": "查隐患详情", "usage": "返回 data 为 HazardReport 对象。主要字段：id-主键、reportNo-隐患编号、hazardName-隐患名称、description-隐患描述、unitName-单位名称、departmentName-部门名称、hazardLevelName-隐患级别名称、hazardCategoryName-隐患分类名称、status-状态编码(draft待提交/reviewing审核中/rectifying整改中/approved已通过/rejected已驳回)、statusName-状态名称、reporterName-上报人姓名、chargePersonName-整改负责人姓名、pointsAwarded-奖励积分、flowStatus-流程状态(0未开始/1进行中/2已完成)、canApprove-当前用户是否可审批、isInitiator-当前用户是否为此流程发起人。", "method": "GET", "path": "/gd_dataserver/business/hazard/info/{id}", "operationId": "getInfoUsingGET", "parameters": [ { "name": "id", "in": "path", "required": true, "type": "integer / int64", "description": "隐患ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "隐患信息管理", "name": "条件查询", "usage": "根据实体属性条件查询记录列表。成功返回 data 为实体类数组。", "method": "GET", "path": "/gd_dataserver/business/hazard/list", "operationId": "getListUsingGET_8", "parameters": [ { "name": "actualCompleteTime", "in": "query", "required": false, "type": "string / date-time", "description": "实际完成时间" }, { "name": "attachments[0].attachmentType", "in": "query", "required": false, "type": "string", "description": "附件类型：IMAGE-图片 VIDEO-视频 DOCUMENT-文档 OTHER-其他" }, { "name": "attachments[0].createBy", "in": "query", "required": false, "type": "string", "description": "创建者" }, { "name": "attachments[0].createTime", "in": "query", "required": false, "type": "string / date-time", "description": "创建时间" }, { "name": "attachments[0].fileName", "in": "query", "required": false, "type": "string", "description": "文件原始名称" }, { "name": "attachments[0].filePath", "in": "query", "required": false, "type": "string", "description": "文件存储路径" }, { "name": "attachments[0].fileSize", "in": "query", "required": false, "type": "integer / int64", "description": "文件大小（字节）" }, { "name": "attachments[0].fileType", "in": "query", "required": false, "type": "string", "description": "文件MIME类型" }, { "name": "attachments[0].fileUrl", "in": "query", "required": false, "type": "string", "description": "文件访问URL" }, { "name": "attachments[0].id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "attachments[0].remark", "in": "query", "required": false, "type": "string", "description": "备注" }, { "name": "attachments[0].reportId", "in": "query", "required": false, "type": "integer / int64", "description": "关联隐患ID" }, { "name": "attachments[0].sortOrder", "in": "query", "required": false, "type": "integer / int32", "description": "排序" }, { "name": "attachments[0].suffix", "in": "query", "required": false, "type": "string", "description": "文件后缀" }, { "name": "attachments[0].updateBy", "in": "query", "required": false, "type": "string", "description": "更新者" }, { "name": "attachments[0].updateTime", "in": "query", "required": false, "type": "string / date-time", "description": "更新时间" }, { "name": "attachments[0].uploadUserId", "in": "query", "required": false, "type": "string", "description": "上传人用户ID" }, { "name": "attachments[0].uploadUserName", "in": "query", "required": false, "type": "string", "description": "上传人姓名" }, { "name": "auditRemark", "in": "query", "required": false, "type": "string", "description": "审核备注" }, { "name": "auditTime", "in": "query", "required": false, "type": "string / date-time", "description": "审核时间" }, { "name": "auditUserId", "in": "query", "required": false, "type": "integer / int64", "description": "审核人用户ID" }, { "name": "auditUserName", "in": "query", "required": false, "type": "string", "description": "审核人姓名" }, { "name": "auditUserUsername", "in": "query", "required": false, "type": "string", "description": "审核人账号" }, { "name": "canApprove", "in": "query", "required": false, "type": "boolean", "description": "当前用户是否可审批此流程" }, { "name": "causeAnalysis", "in": "query", "required": false, "type": "string", "description": "原因分析" }, { "name": "chargePersonId", "in": "query", "required": false, "type": "integer / int64", "description": "整改负责人用户ID" }, { "name": "chargePersonName", "in": "query", "required": false, "type": "string", "description": "整改负责人姓名" }, { "name": "chargePersonUsername", "in": "query", "required": false, "type": "string", "description": "整改负责人账号" }, { "name": "createBy", "in": "query", "required": false, "type": "string", "description": "创建者" }, { "name": "createTime", "in": "query", "required": false, "type": "string / date-time", "description": "创建时间" }, { "name": "criteriaIds", "in": "query", "required": false, "type": "string", "description": "判定标准ID（多选，逗号分隔）" }, { "name": "criteriaNames", "in": "query", "required": false, "type": "string", "description": "判定标准名称" }, { "name": "currentFlowLevel", "in": "query", "required": false, "type": "string", "description": "当前流程等级编码（general/major/critical）" }, { "name": "departmentId", "in": "query", "required": false, "type": "integer / int64", "description": "部门ID" }, { "name": "departmentName", "in": "query", "required": false, "type": "string", "description": "部门名称" }, { "name": "deployId", "in": "query", "required": false, "type": "string", "description": "流程模板id" }, { "name": "description", "in": "query", "required": false, "type": "string", "description": "隐患描述" }, { "name": "discoverTime", "in": "query", "required": false, "type": "string / date-time", "description": "发现时间" }, { "name": "factoryDeptId", "in": "query", "required": false, "type": "string", "description": "所属厂区部门ID" }, { "name": "factoryDeptName", "in": "query", "required": false, "type": "string", "description": "所属厂区部门名称" }, { "name": "factoryManagerId", "in": "query", "required": false, "type": "integer / int64", "description": "厂区管理员用户ID" }, { "name": "factoryManagerName", "in": "query", "required": false, "type": "string", "description": "厂区管理员姓名" }, { "name": "finalFlowLevel", "in": "query", "required": false, "type": "string", "description": "审批最终等级名称（如一般-A档）" }, { "name": "finalFlowLevelId", "in": "query", "required": false, "type": "integer / int64", "description": "审批最终积分规则ID（关联积分规则表）" }, { "name": "flowInstanceId", "in": "query", "required": false, "type": "string", "description": "流程实例id" }, { "name": "flowStatus", "in": "query", "required": false, "type": "integer / int32", "description": "流程状态（0-未开始 1-进行中 2-已完成）" }, { "name": "fundsSource", "in": "query", "required": false, "type": "string", "description": "资金来源编码" }, { "name": "fundsSourceId", "in": "query", "required": false, "type": "integer / int64", "description": "资金来源字典ID" }, { "name": "fundsSourceName", "in": "query", "required": false, "type": "string", "description": "资金来源名称" }, { "name": "governanceType", "in": "query", "required": false, "type": "string", "description": "治理类型编码" }, { "name": "governanceTypeId", "in": "query", "required": false, "type": "integer / int64", "description": "治理类型字典ID" }, { "name": "governanceTypeName", "in": "query", "required": false, "type": "string", "description": "治理类型名称" }, { "name": "hazardCategory", "in": "query", "required": false, "type": "string", "description": "隐患分类编码（general/major/critical）" }, { "name": "hazardCategoryId", "in": "query", "required": false, "type": "integer / int64", "description": "隐患分类根规则ID（关联积分规则表）" }, { "name": "hazardCategoryName", "in": "query", "required": false, "type": "string", "description": "隐患分类名称" }, { "name": "hazardClassificationStandard", "in": "query", "required": false, "type": "string", "description": "隐患分类标准（文本说明，用于隐患分类的说明）" }, { "name": "hazardLevel", "in": "query", "required": false, "type": "string", "description": "管理级别编码" }, { "name": "hazardLevelId", "in": "query", "required": false, "type": "integer / int64", "description": "管理级别字典ID" }, { "name": "hazardLevelName", "in": "query", "required": false, "type": "string", "description": "管理级别名称" }, { "name": "hazardName", "in": "query", "required": false, "type": "string", "description": "隐患名称" }, { "name": "hazardSourceDetail", "in": "query", "required": false, "type": "string", "description": "来源具体描述" }, { "name": "hazardType", "in": "query", "required": false, "type": "string", "description": "隐患类型编码" }, { "name": "hazardTypeId", "in": "query", "required": false, "type": "integer / int64", "description": "隐患类型字典ID" }, { "name": "hazardTypeName", "in": "query", "required": false, "type": "string", "description": "隐患类型名称" }, { "name": "id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "isInitiator", "in": "query", "required": false, "type": "boolean", "description": "当前用户是否为此流程发起人" }, { "name": "limitedCompleteTime", "in": "query", "required": false, "type": "string / date-time", "description": "限定完成时间" }, { "name": "major", "in": "query", "required": false, "type": "string", "description": "专业编码" }, { "name": "majorId", "in": "query", "required": false, "type": "integer / int64", "description": "专业字典ID" }, { "name": "majorName", "in": "query", "required": false, "type": "string", "description": "专业名称" }, { "name": "pointsAwarded", "in": "query", "required": false, "type": "integer / int32", "description": "奖励积分" }, { "name": "pointsStatus", "in": "query", "required": false, "type": "string", "description": "积分发放状态编码" }, { "name": "pointsStatusId", "in": "query", "required": false, "type": "integer / int64", "description": "积分发放状态字典ID" }, { "name": "pointsStatusName", "in": "query", "required": false, "type": "string", "description": "积分发放状态名称" }, { "name": "preventiveMeasures", "in": "query", "required": false, "type": "string", "description": "防范措施" }, { "name": "pushResponse", "in": "query", "required": false, "type": "string", "description": "第三方返回结果" }, { "name": "pushStatus", "in": "query", "required": false, "type": "string", "description": "推送状态编码" }, { "name": "pushStatusId", "in": "query", "required": false, "type": "integer / int64", "description": "推送状态字典ID" }, { "name": "pushStatusName", "in": "query", "required": false, "type": "string", "description": "推送状态名称" }, { "name": "pushTime", "in": "query", "required": false, "type": "string / date-time", "description": "推送时间" }, { "name": "rectificationPlan", "in": "query", "required": false, "type": "string", "description": "整改方案" }, { "name": "remark", "in": "query", "required": false, "type": "string", "description": "备注" }, { "name": "reportNo", "in": "query", "required": false, "type": "string", "description": "隐患编号" }, { "name": "reporterId", "in": "query", "required": false, "type": "integer / int64", "description": "上报人用户ID" }, { "name": "reporterName", "in": "query", "required": false, "type": "string", "description": "上报人姓名" }, { "name": "reporterUsername", "in": "query", "required": false, "type": "string", "description": "上报人账号" }, { "name": "riskTarget", "in": "query", "required": false, "type": "string", "description": "风险分析对象" }, { "name": "riskUnit", "in": "query", "required": false, "type": "string", "description": "风险分析单元" }, { "name": "sourceType", "in": "query", "required": false, "type": "string", "description": "隐患来源编码" }, { "name": "sourceTypeId", "in": "query", "required": false, "type": "integer / int64", "description": "隐患来源字典ID" }, { "name": "sourceTypeName", "in": "query", "required": false, "type": "string", "description": "隐患来源名称" }, { "name": "status", "in": "query", "required": false, "type": "string", "description": "隐患状态编码" }, { "name": "statusId", "in": "query", "required": false, "type": "integer / int64", "description": "隐患状态字典ID" }, { "name": "statusName", "in": "query", "required": false, "type": "string", "description": "隐患状态名称" }, { "name": "supervisorId", "in": "query", "required": false, "type": "integer / int64", "description": "监察人用户ID" }, { "name": "supervisorName", "in": "query", "required": false, "type": "string", "description": "监察人姓名" }, { "name": "supervisorUsername", "in": "query", "required": false, "type": "string", "description": "监察人账号" }, { "name": "thirdPartyId", "in": "query", "required": false, "type": "string", "description": "第三方系统记录ID" }, { "name": "unitId", "in": "query", "required": false, "type": "integer / int64", "description": "单位ID" }, { "name": "unitName", "in": "query", "required": false, "type": "string", "description": "单位名称" }, { "name": "updateBy", "in": "query", "required": false, "type": "string", "description": "更新者" }, { "name": "updateTime", "in": "query", "required": false, "type": "string / date-time", "description": "更新时间" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "隐患信息管理", "name": "查询我的上报记录（APP端）", "usage": "分页查询当前登录用户已上报的隐患记录列表。返回 data 为 PageInfo 分页对象，包含 total/list/pageNum/pageSize 等。list 中每条记录为 HazardReport 对象，主要字段：id、reportNo、hazardName、status-状态编码、statusName-状态名称、hazardLevelName-级别名称、pointsAwarded-奖励积分、createTime-创建时间。", "method": "GET", "path": "/gd_dataserver/business/hazard/myList", "operationId": "myListUsingGET_1", "parameters": [ { "name": "actualCompleteTime", "in": "query", "required": false, "type": "string / date-time", "description": "实际完成时间" }, { "name": "attachments[0].attachmentType", "in": "query", "required": false, "type": "string", "description": "附件类型：IMAGE-图片 VIDEO-视频 DOCUMENT-文档 OTHER-其他" }, { "name": "attachments[0].createBy", "in": "query", "required": false, "type": "string", "description": "创建者" }, { "name": "attachments[0].createTime", "in": "query", "required": false, "type": "string / date-time", "description": "创建时间" }, { "name": "attachments[0].fileName", "in": "query", "required": false, "type": "string", "description": "文件原始名称" }, { "name": "attachments[0].filePath", "in": "query", "required": false, "type": "string", "description": "文件存储路径" }, { "name": "attachments[0].fileSize", "in": "query", "required": false, "type": "integer / int64", "description": "文件大小（字节）" }, { "name": "attachments[0].fileType", "in": "query", "required": false, "type": "string", "description": "文件MIME类型" }, { "name": "attachments[0].fileUrl", "in": "query", "required": false, "type": "string", "description": "文件访问URL" }, { "name": "attachments[0].id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "attachments[0].remark", "in": "query", "required": false, "type": "string", "description": "备注" }, { "name": "attachments[0].reportId", "in": "query", "required": false, "type": "integer / int64", "description": "关联隐患ID" }, { "name": "attachments[0].sortOrder", "in": "query", "required": false, "type": "integer / int32", "description": "排序" }, { "name": "attachments[0].suffix", "in": "query", "required": false, "type": "string", "description": "文件后缀" }, { "name": "attachments[0].updateBy", "in": "query", "required": false, "type": "string", "description": "更新者" }, { "name": "attachments[0].updateTime", "in": "query", "required": false, "type": "string / date-time", "description": "更新时间" }, { "name": "attachments[0].uploadUserId", "in": "query", "required": false, "type": "string", "description": "上传人用户ID" }, { "name": "attachments[0].uploadUserName", "in": "query", "required": false, "type": "string", "description": "上传人姓名" }, { "name": "auditRemark", "in": "query", "required": false, "type": "string", "description": "审核备注" }, { "name": "auditTime", "in": "query", "required": false, "type": "string / date-time", "description": "审核时间" }, { "name": "auditUserId", "in": "query", "required": false, "type": "integer / int64", "description": "审核人用户ID" }, { "name": "auditUserName", "in": "query", "required": false, "type": "string", "description": "审核人姓名" }, { "name": "auditUserUsername", "in": "query", "required": false, "type": "string", "description": "审核人账号" }, { "name": "canApprove", "in": "query", "required": false, "type": "boolean", "description": "当前用户是否可审批此流程" }, { "name": "causeAnalysis", "in": "query", "required": false, "type": "string", "description": "原因分析" }, { "name": "chargePersonId", "in": "query", "required": false, "type": "integer / int64", "description": "整改负责人用户ID" }, { "name": "chargePersonName", "in": "query", "required": false, "type": "string", "description": "整改负责人姓名" }, { "name": "chargePersonUsername", "in": "query", "required": false, "type": "string", "description": "整改负责人账号" }, { "name": "createBy", "in": "query", "required": false, "type": "string", "description": "创建者" }, { "name": "createTime", "in": "query", "required": false, "type": "string / date-time", "description": "创建时间" }, { "name": "criteriaIds", "in": "query", "required": false, "type": "string", "description": "判定标准ID（多选，逗号分隔）" }, { "name": "criteriaNames", "in": "query", "required": false, "type": "string", "description": "判定标准名称" }, { "name": "currentFlowLevel", "in": "query", "required": false, "type": "string", "description": "当前流程等级编码（general/major/critical）" }, { "name": "departmentId", "in": "query", "required": false, "type": "integer / int64", "description": "部门ID" }, { "name": "departmentName", "in": "query", "required": false, "type": "string", "description": "部门名称" }, { "name": "deployId", "in": "query", "required": false, "type": "string", "description": "流程模板id" }, { "name": "description", "in": "query", "required": false, "type": "string", "description": "隐患描述" }, { "name": "discoverTime", "in": "query", "required": false, "type": "string / date-time", "description": "发现时间" }, { "name": "factoryDeptId", "in": "query", "required": false, "type": "string", "description": "所属厂区部门ID" }, { "name": "factoryDeptName", "in": "query", "required": false, "type": "string", "description": "所属厂区部门名称" }, { "name": "factoryManagerId", "in": "query", "required": false, "type": "integer / int64", "description": "厂区管理员用户ID" }, { "name": "factoryManagerName", "in": "query", "required": false, "type": "string", "description": "厂区管理员姓名" }, { "name": "finalFlowLevel", "in": "query", "required": false, "type": "string", "description": "审批最终等级名称（如一般-A档）" }, { "name": "finalFlowLevelId", "in": "query", "required": false, "type": "integer / int64", "description": "审批最终积分规则ID（关联积分规则表）" }, { "name": "flowInstanceId", "in": "query", "required": false, "type": "string", "description": "流程实例id" }, { "name": "flowStatus", "in": "query", "required": false, "type": "integer / int32", "description": "流程状态（0-未开始 1-进行中 2-已完成）" }, { "name": "fundsSource", "in": "query", "required": false, "type": "string", "description": "资金来源编码" }, { "name": "fundsSourceId", "in": "query", "required": false, "type": "integer / int64", "description": "资金来源字典ID" }, { "name": "fundsSourceName", "in": "query", "required": false, "type": "string", "description": "资金来源名称" }, { "name": "governanceType", "in": "query", "required": false, "type": "string", "description": "治理类型编码" }, { "name": "governanceTypeId", "in": "query", "required": false, "type": "integer / int64", "description": "治理类型字典ID" }, { "name": "governanceTypeName", "in": "query", "required": false, "type": "string", "description": "治理类型名称" }, { "name": "hazardCategory", "in": "query", "required": false, "type": "string", "description": "隐患分类编码（general/major/critical）" }, { "name": "hazardCategoryId", "in": "query", "required": false, "type": "integer / int64", "description": "隐患分类根规则ID（关联积分规则表）" }, { "name": "hazardCategoryName", "in": "query", "required": false, "type": "string", "description": "隐患分类名称" }, { "name": "hazardClassificationStandard", "in": "query", "required": false, "type": "string", "description": "隐患分类标准（文本说明，用于隐患分类的说明）" }, { "name": "hazardLevel", "in": "query", "required": false, "type": "string", "description": "管理级别编码" }, { "name": "hazardLevelId", "in": "query", "required": false, "type": "integer / int64", "description": "管理级别字典ID" }, { "name": "hazardLevelName", "in": "query", "required": false, "type": "string", "description": "管理级别名称" }, { "name": "hazardName", "in": "query", "required": false, "type": "string", "description": "隐患名称" }, { "name": "hazardSourceDetail", "in": "query", "required": false, "type": "string", "description": "来源具体描述" }, { "name": "hazardType", "in": "query", "required": false, "type": "string", "description": "隐患类型编码" }, { "name": "hazardTypeId", "in": "query", "required": false, "type": "integer / int64", "description": "隐患类型字典ID" }, { "name": "hazardTypeName", "in": "query", "required": false, "type": "string", "description": "隐患类型名称" }, { "name": "id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "isInitiator", "in": "query", "required": false, "type": "boolean", "description": "当前用户是否为此流程发起人" }, { "name": "limitedCompleteTime", "in": "query", "required": false, "type": "string / date-time", "description": "限定完成时间" }, { "name": "major", "in": "query", "required": false, "type": "string", "description": "专业编码" }, { "name": "majorId", "in": "query", "required": false, "type": "integer / int64", "description": "专业字典ID" }, { "name": "majorName", "in": "query", "required": false, "type": "string", "description": "专业名称" }, { "name": "pageNum", "in": "query", "required": false, "type": "integer / int32", "description": "页码" }, { "name": "pointsAwarded", "in": "query", "required": false, "type": "integer / int32", "description": "奖励积分" }, { "name": "pointsStatus", "in": "query", "required": false, "type": "string", "description": "积分发放状态编码" }, { "name": "pointsStatusId", "in": "query", "required": false, "type": "integer / int64", "description": "积分发放状态字典ID" }, { "name": "pointsStatusName", "in": "query", "required": false, "type": "string", "description": "积分发放状态名称" }, { "name": "preventiveMeasures", "in": "query", "required": false, "type": "string", "description": "防范措施" }, { "name": "pushResponse", "in": "query", "required": false, "type": "string", "description": "第三方返回结果" }, { "name": "pushStatus", "in": "query", "required": false, "type": "string", "description": "推送状态编码" }, { "name": "pushStatusId", "in": "query", "required": false, "type": "integer / int64", "description": "推送状态字典ID" }, { "name": "pushStatusName", "in": "query", "required": false, "type": "string", "description": "推送状态名称" }, { "name": "pushTime", "in": "query", "required": false, "type": "string / date-time", "description": "推送时间" }, { "name": "rectificationPlan", "in": "query", "required": false, "type": "string", "description": "整改方案" }, { "name": "remark", "in": "query", "required": false, "type": "string", "description": "备注" }, { "name": "reportNo", "in": "query", "required": false, "type": "string", "description": "隐患编号" }, { "name": "reporterId", "in": "query", "required": false, "type": "integer / int64", "description": "上报人用户ID" }, { "name": "reporterName", "in": "query", "required": false, "type": "string", "description": "上报人姓名" }, { "name": "reporterUsername", "in": "query", "required": false, "type": "string", "description": "上报人账号" }, { "name": "riskTarget", "in": "query", "required": false, "type": "string", "description": "风险分析对象" }, { "name": "riskUnit", "in": "query", "required": false, "type": "string", "description": "风险分析单元" }, { "name": "sourceType", "in": "query", "required": false, "type": "string", "description": "隐患来源编码" }, { "name": "sourceTypeId", "in": "query", "required": false, "type": "integer / int64", "description": "隐患来源字典ID" }, { "name": "sourceTypeName", "in": "query", "required": false, "type": "string", "description": "隐患来源名称" }, { "name": "status", "in": "query", "required": false, "type": "string", "description": "隐患状态编码" }, { "name": "statusId", "in": "query", "required": false, "type": "integer / int64", "description": "隐患状态字典ID" }, { "name": "statusName", "in": "query", "required": false, "type": "string", "description": "隐患状态名称" }, { "name": "supervisorId", "in": "query", "required": false, "type": "integer / int64", "description": "监察人用户ID" }, { "name": "supervisorName", "in": "query", "required": false, "type": "string", "description": "监察人姓名" }, { "name": "supervisorUsername", "in": "query", "required": false, "type": "string", "description": "监察人账号" }, { "name": "thirdPartyId", "in": "query", "required": false, "type": "string", "description": "第三方系统记录ID" }, { "name": "unitId", "in": "query", "required": false, "type": "integer / int64", "description": "单位ID" }, { "name": "unitName", "in": "query", "required": false, "type": "string", "description": "单位名称" }, { "name": "updateBy", "in": "query", "required": false, "type": "string", "description": "更新者" }, { "name": "updateTime", "in": "query", "required": false, "type": "string / date-time", "description": "更新时间" }, { "name": "pageSize", "in": "query", "required": false, "type": "integer / int32", "description": "每页数量" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "隐患信息管理", "name": "首页今日概览-我的隐患统计（APP端）", "usage": "按状态分类统计当前登录用户的隐患数量。返回字段说明：todayReportCount-今日上报数、pendingAuditCount-待审核数、rectifyingCount-整改中数、rejectedCount-已驳回数。", "method": "GET", "path": "/gd_dataserver/business/hazard/myStats", "operationId": "myStatsUsingGET", "parameters": [], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "隐患信息管理", "name": "逻辑删除", "usage": "根据主键ID逻辑删除单条记录，成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/hazard/removeById", "operationId": "deleteListUsingGET_16", "parameters": [ { "name": "id", "in": "query", "required": true, "type": "string", "description": "主键ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "隐患信息管理", "name": "保存隐患信息（草稿，不启动流程）", "usage": "保存隐患记录及附件，不启动审批流程。返回 data 为 HazardReport 对象，包含 id、reportNo 等完整隐患字段。", "method": "POST", "path": "/gd_dataserver/business/hazard/save", "operationId": "saveUsingPOST_1", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "隐患上报请求" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "隐患信息管理", "name": "修改", "usage": "根据主键ID修改记录，请求体为实体类对象（需包含id字段）。成功返回 data 为 null。", "method": "POST", "path": "/gd_dataserver/business/hazard/updateById", "operationId": "updateByIdUsingPOST_8", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "隐患信息" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "隐患信息管理", "name": "上传隐患附件文件", "usage": "上传文件到服务器，返回 data 为 HazardAttachment 数组，每个元素包含：id、fileName-文件名、filePath-文件路径、fileSize-文件大小、fileType-MIME类型、attachmentType-附件类型。前端在调用 save 或 submitFlow 时将附件数据传入", "method": "POST", "path": "/gd_dataserver/business/hazard/uploadAttachment", "operationId": "uploadAttachmentUsingPOST", "parameters": [ { "name": "attachmentType", "in": "query", "required": false, "type": "string", "description": "附件类型：IMAGE-图片 VIDEO-视频 DOCUMENT-文档 OTHER-其他" } ], "requestBodies": [ { "contentType": "application/json", "schema": "string / binary" }, { "contentType": "application/octet-stream", "schema": "string / binary" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "隐患信息管理", "name": "删除隐患（级联删除附件）", "usage": "返回 data 为 boolean，true-删除成功，false-删除失败。同时级联删除关联的附件记录。", "method": "DELETE", "path": "/gd_dataserver/business/hazard/{ids}", "operationId": "removeUsingDELETE", "parameters": [ { "name": "ids", "in": "path", "required": true, "type": "string", "description": "隐患ID列表（逗号分隔）" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "204", "description": "No Content", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] } ] }, { "tag": "商城端接口对接", "name": "扣减积分", "usage": "商城端在用户下单成功后调用此接口扣减积分，具有幂等性，同一orderNum多次调用只扣减一次", "method": "POST", "path": "/gd_dataserver/mall/api/points/deduct", "operationId": "deductPointsUsingPOST", "parameters": [ { "name": "token", "in": "header", "required": true, "type": "-", "description": "用户身份令牌" } ], "requestBodies": [ { "contentType": "application/json", "schema": "商城端-积分操作请求" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "商城端接口统一响应«Void»" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "商城端接口对接", "name": "退还积分", "usage": "商城端在用户退款时调用此接口退还积分，具有幂等性，同一orderNum多次调用只退还一次", "method": "POST", "path": "/gd_dataserver/mall/api/points/refund", "operationId": "refundPointsUsingPOST", "parameters": [ { "name": "token", "in": "header", "required": true, "type": "-", "description": "用户身份令牌" } ], "requestBodies": [ { "contentType": "application/json", "schema": "商城端-积分操作请求" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "商城端接口统一响应«Void»" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "商城端接口对接", "name": "根据Token获取用户信息", "usage": "商城端通过请求头中的Token获取用户基本信息，包括姓名、手机号、SAP编号等", "method": "POST", "path": "/gd_dataserver/mall/api/user/info", "operationId": "getUserInfoUsingPOST", "parameters": [ { "name": "token", "in": "header", "required": true, "type": "-", "description": "用户身份令牌" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "商城端接口统一响应«商城端-用户信息»" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "商城端接口对接", "name": "根据Token获取用户积分信息", "usage": "商城端通过请求头中的Token及Body中的sap获取用户积分余额，包括可用积分、冻结积分等", "method": "POST", "path": "/gd_dataserver/mall/api/user/points", "operationId": "getUserPointsUsingPOST", "parameters": [ { "name": "token", "in": "header", "required": true, "type": "-", "description": "用户身份令牌" } ], "requestBodies": [ { "contentType": "application/json", "schema": "商城端-积分操作请求" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "商城端接口统一响应«商城端-用户积分信息»" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "消息处理接口", "name": "MQTT消息发送", "usage": "向指定主题发送MQTT消息", "method": "GET", "path": "/gd_dataserver/business/mqtt/sendMqttMsg", "operationId": "sendMqttMsgUsingGET", "parameters": [ { "name": "topic", "in": "query", "required": true, "type": "string", "description": "MQTT主题" }, { "name": "data", "in": "query", "required": true, "type": "string", "description": "消息内容（JSON格式）" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分申诉管理", "name": "受理申诉", "usage": "将申诉状态从待受理(0)改为处理中(1)。返回 data 为 boolean。", "method": "POST", "path": "/gd_dataserver/business/points/appeal/accept/{id}", "operationId": "acceptAppealUsingPOST", "parameters": [ { "name": "id", "in": "path", "required": true, "type": "integer / int64", "description": "申诉ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分申诉管理", "name": "新增", "usage": "新增单条记录，请求体为实体类对象（字段说明见对应实体模型）。成功返回 data 为 null。", "method": "POST", "path": "/gd_dataserver/business/points/appeal/add", "operationId": "addOneUsingPOST_9", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "积分申诉" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分申诉管理", "name": "批量新增", "usage": "批量新增多条记录，请求体为实体类数组。成功返回 data 为 null。", "method": "POST", "path": "/gd_dataserver/business/points/appeal/addBatch", "operationId": "addBatchUsingPOST_9", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "array<积分申诉>" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分申诉管理", "name": "新增并返回保存的数据", "usage": "新增单条记录并返回保存后的数据（含自增ID），请求体为实体类对象。成功返回 data 为保存的实体对象。", "method": "POST", "path": "/gd_dataserver/business/points/appeal/addReturn", "operationId": "addReturnUsingPOST_9", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "积分申诉" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分申诉管理", "name": "审批申诉流程", "usage": "审批通过或驳回申诉流程节点。成功返回 data 为 null；失败返回 error 信息。", "method": "POST", "path": "/gd_dataserver/business/points/appeal/completeFlow", "operationId": "completeFlowUsingPOST", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "工作流签字任务相关--请求参数" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分申诉管理", "name": "根据属性删除", "usage": "根据实体属性条件删除记录，请求体为实体类对象。成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/points/appeal/delete", "operationId": "deleteUsingGET_9", "parameters": [ { "name": "adjustPoints", "in": "query", "required": false, "type": "integer / int32", "description": "调整积分（正数补发，负数扣减）" }, { "name": "appealNo", "in": "query", "required": false, "type": "string", "description": "申诉编号" }, { "name": "appealReason", "in": "query", "required": false, "type": "string", "description": "申诉理由" }, { "name": "appealType", "in": "query", "required": false, "type": "string", "description": "申诉类型：REJECT-审核驳回申诉 POINTS-积分异议 OTHER-其他" }, { "name": "attachmentUrls", "in": "query", "required": false, "type": "string", "description": "附件URL（JSON数组）" }, { "name": "canApprove", "in": "query", "required": false, "type": "boolean", "description": "当前用户是否可审批此流程" }, { "name": "createTime", "in": "query", "required": false, "type": "string / date-time", "description": "创建时间" }, { "name": "factoryDeptId", "in": "query", "required": false, "type": "string", "description": "所属厂区部门ID" }, { "name": "factoryDeptName", "in": "query", "required": false, "type": "string", "description": "所属厂区部门名称" }, { "name": "flowInstanceId", "in": "query", "required": false, "type": "string", "description": "流程实例ID（预留）" }, { "name": "flowStatus", "in": "query", "required": false, "type": "integer / int32", "description": "流程状态：0-无流程 1-进行中 2-已完成" }, { "name": "handleRemark", "in": "query", "required": false, "type": "string", "description": "处理意见/结果说明" }, { "name": "handleTime", "in": "query", "required": false, "type": "string / date-time", "description": "处理时间" }, { "name": "handleUserId", "in": "query", "required": false, "type": "integer / int64", "description": "处理人用户ID" }, { "name": "handleUserName", "in": "query", "required": false, "type": "string", "description": "处理人姓名" }, { "name": "id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "isInitiator", "in": "query", "required": false, "type": "boolean", "description": "当前用户是否为此流程发起人" }, { "name": "reportId", "in": "query", "required": false, "type": "integer / int64", "description": "关联隐患上报ID" }, { "name": "reportNo", "in": "query", "required": false, "type": "string", "description": "关联隐患编号" }, { "name": "status", "in": "query", "required": false, "type": "string", "description": "申诉状态：0-待受理 1-处理中 2-已通过 3-已驳回 4-已撤回" }, { "name": "statusName", "in": "query", "required": false, "type": "string", "description": "申诉状态名称" }, { "name": "updateTime", "in": "query", "required": false, "type": "string / date-time", "description": "更新时间" }, { "name": "userId", "in": "query", "required": false, "type": "integer / int64", "description": "申诉人用户ID" }, { "name": "userName", "in": "query", "required": false, "type": "string", "description": "申诉人姓名" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分申诉管理", "name": "主键删除", "usage": "根据主键ID删除单条记录，成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/points/appeal/deleteById", "operationId": "deleteOneUsingGET_9", "parameters": [ { "name": "id", "in": "query", "required": true, "type": "string", "description": "主键ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分申诉管理", "name": "批量删除", "usage": "根据ID列表批量删除记录，成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/points/appeal/deleteByIds", "operationId": "deleteListUsingGET_19", "parameters": [ { "name": "ids", "in": "query", "required": true, "type": "string", "description": "ID列表(逗号分隔)" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分申诉管理", "name": "获取申诉详情", "usage": "返回 data 为 PointsAppeal 对象，包含完整申诉字段及流程进度信息。", "method": "GET", "path": "/gd_dataserver/business/points/appeal/detail/{id}", "operationId": "getDetailUsingGET", "parameters": [ { "name": "id", "in": "path", "required": true, "type": "integer / int64", "description": "申诉ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分申诉管理", "name": "查询所有", "usage": "查询所有记录（无分页、无条件）。成功返回 data 为实体类数组。", "method": "GET", "path": "/gd_dataserver/business/points/appeal/getAll", "operationId": "getAllUsingGET_9", "parameters": [], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分申诉管理", "name": "分页查询", "usage": "分页查询记录列表，查询条件为实体类字段。成功返回 data 为 PageInfo 分页对象，其中 list 为实体类数组。", "method": "GET", "path": "/gd_dataserver/business/points/appeal/getListByPage", "operationId": "getListByPageUsingGET_9", "parameters": [ { "name": "adjustPoints", "in": "query", "required": false, "type": "integer / int32", "description": "调整积分（正数补发，负数扣减）" }, { "name": "appealNo", "in": "query", "required": false, "type": "string", "description": "申诉编号" }, { "name": "appealReason", "in": "query", "required": false, "type": "string", "description": "申诉理由" }, { "name": "appealType", "in": "query", "required": false, "type": "string", "description": "申诉类型：REJECT-审核驳回申诉 POINTS-积分异议 OTHER-其他" }, { "name": "attachmentUrls", "in": "query", "required": false, "type": "string", "description": "附件URL（JSON数组）" }, { "name": "canApprove", "in": "query", "required": false, "type": "boolean", "description": "当前用户是否可审批此流程" }, { "name": "createTime", "in": "query", "required": false, "type": "string / date-time", "description": "创建时间" }, { "name": "factoryDeptId", "in": "query", "required": false, "type": "string", "description": "所属厂区部门ID" }, { "name": "factoryDeptName", "in": "query", "required": false, "type": "string", "description": "所属厂区部门名称" }, { "name": "flowInstanceId", "in": "query", "required": false, "type": "string", "description": "流程实例ID（预留）" }, { "name": "flowStatus", "in": "query", "required": false, "type": "integer / int32", "description": "流程状态：0-无流程 1-进行中 2-已完成" }, { "name": "handleRemark", "in": "query", "required": false, "type": "string", "description": "处理意见/结果说明" }, { "name": "handleTime", "in": "query", "required": false, "type": "string / date-time", "description": "处理时间" }, { "name": "handleUserId", "in": "query", "required": false, "type": "integer / int64", "description": "处理人用户ID" }, { "name": "handleUserName", "in": "query", "required": false, "type": "string", "description": "处理人姓名" }, { "name": "id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "isInitiator", "in": "query", "required": false, "type": "boolean", "description": "当前用户是否为此流程发起人" }, { "name": "pageNum", "in": "query", "required": true, "type": "integer / int32", "description": "页码" }, { "name": "reportId", "in": "query", "required": false, "type": "integer / int64", "description": "关联隐患上报ID" }, { "name": "reportNo", "in": "query", "required": false, "type": "string", "description": "关联隐患编号" }, { "name": "status", "in": "query", "required": false, "type": "string", "description": "申诉状态：0-待受理 1-处理中 2-已通过 3-已驳回 4-已撤回" }, { "name": "statusName", "in": "query", "required": false, "type": "string", "description": "申诉状态名称" }, { "name": "updateTime", "in": "query", "required": false, "type": "string / date-time", "description": "更新时间" }, { "name": "userId", "in": "query", "required": false, "type": "integer / int64", "description": "申诉人用户ID" }, { "name": "userName", "in": "query", "required": false, "type": "string", "description": "申诉人姓名" }, { "name": "pageSize", "in": "query", "required": true, "type": "integer / int32", "description": "每页条数" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分申诉管理", "name": "处理申诉", "usage": "通过或驳回申诉，可选调整积分。approved=true时状态改为已通过(2)，approved=false时改为已驳回(3)。adjustPoints为正数补发积分，负数扣减积分，不传则不调整。返回 data 为 boolean。", "method": "POST", "path": "/gd_dataserver/business/points/appeal/handle/{id}", "operationId": "handleAppealUsingPOST", "parameters": [ { "name": "id", "in": "path", "required": true, "type": "integer / int64", "description": "申诉ID" }, { "name": "approved", "in": "query", "required": true, "type": "boolean", "description": "是否通过" }, { "name": "handleRemark", "in": "query", "required": true, "type": "string", "description": "处理意见" }, { "name": "adjustPoints", "in": "query", "required": false, "type": "integer / int32", "description": "调整积分（正数补发，负数扣减，不传则不调整）" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分申诉管理", "name": "详情", "usage": "根据主键ID查询单条记录详情。成功返回 data 为实体类对象，包含该实体所有字段。", "method": "GET", "path": "/gd_dataserver/business/points/appeal/info", "operationId": "infoUsingGET_9", "parameters": [ { "name": "id", "in": "query", "required": true, "type": "string", "description": "主键ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分申诉管理", "name": "条件查询", "usage": "根据实体属性条件查询记录列表。成功返回 data 为实体类数组。", "method": "GET", "path": "/gd_dataserver/business/points/appeal/list", "operationId": "getListUsingGET_9", "parameters": [ { "name": "adjustPoints", "in": "query", "required": false, "type": "integer / int32", "description": "调整积分（正数补发，负数扣减）" }, { "name": "appealNo", "in": "query", "required": false, "type": "string", "description": "申诉编号" }, { "name": "appealReason", "in": "query", "required": false, "type": "string", "description": "申诉理由" }, { "name": "appealType", "in": "query", "required": false, "type": "string", "description": "申诉类型：REJECT-审核驳回申诉 POINTS-积分异议 OTHER-其他" }, { "name": "attachmentUrls", "in": "query", "required": false, "type": "string", "description": "附件URL（JSON数组）" }, { "name": "canApprove", "in": "query", "required": false, "type": "boolean", "description": "当前用户是否可审批此流程" }, { "name": "createTime", "in": "query", "required": false, "type": "string / date-time", "description": "创建时间" }, { "name": "factoryDeptId", "in": "query", "required": false, "type": "string", "description": "所属厂区部门ID" }, { "name": "factoryDeptName", "in": "query", "required": false, "type": "string", "description": "所属厂区部门名称" }, { "name": "flowInstanceId", "in": "query", "required": false, "type": "string", "description": "流程实例ID（预留）" }, { "name": "flowStatus", "in": "query", "required": false, "type": "integer / int32", "description": "流程状态：0-无流程 1-进行中 2-已完成" }, { "name": "handleRemark", "in": "query", "required": false, "type": "string", "description": "处理意见/结果说明" }, { "name": "handleTime", "in": "query", "required": false, "type": "string / date-time", "description": "处理时间" }, { "name": "handleUserId", "in": "query", "required": false, "type": "integer / int64", "description": "处理人用户ID" }, { "name": "handleUserName", "in": "query", "required": false, "type": "string", "description": "处理人姓名" }, { "name": "id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "isInitiator", "in": "query", "required": false, "type": "boolean", "description": "当前用户是否为此流程发起人" }, { "name": "reportId", "in": "query", "required": false, "type": "integer / int64", "description": "关联隐患上报ID" }, { "name": "reportNo", "in": "query", "required": false, "type": "string", "description": "关联隐患编号" }, { "name": "status", "in": "query", "required": false, "type": "string", "description": "申诉状态：0-待受理 1-处理中 2-已通过 3-已驳回 4-已撤回" }, { "name": "statusName", "in": "query", "required": false, "type": "string", "description": "申诉状态名称" }, { "name": "updateTime", "in": "query", "required": false, "type": "string / date-time", "description": "更新时间" }, { "name": "userId", "in": "query", "required": false, "type": "integer / int64", "description": "申诉人用户ID" }, { "name": "userName", "in": "query", "required": false, "type": "string", "description": "申诉人姓名" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分申诉管理", "name": "查询我的申诉记录（APP端）", "usage": "返回 data 为 PageInfo 分页对象。list 中每条记录为 PointsAppeal 对象，主要字段：id、appealNo-申诉编号、appealType-申诉类型(REJECT/POINTS/OTHER)、status-状态(0待受理/1处理中/2已通过/3已驳回/4已撤回)、statusName-状态名称、handleRemark-处理意见、adjustPoints-调整积分、createTime。", "method": "GET", "path": "/gd_dataserver/business/points/appeal/myList", "operationId": "myListUsingGET_2", "parameters": [ { "name": "adjustPoints", "in": "query", "required": false, "type": "integer / int32", "description": "调整积分（正数补发，负数扣减）" }, { "name": "appealNo", "in": "query", "required": false, "type": "string", "description": "申诉编号" }, { "name": "appealReason", "in": "query", "required": false, "type": "string", "description": "申诉理由" }, { "name": "appealType", "in": "query", "required": false, "type": "string", "description": "申诉类型：REJECT-审核驳回申诉 POINTS-积分异议 OTHER-其他" }, { "name": "attachmentUrls", "in": "query", "required": false, "type": "string", "description": "附件URL（JSON数组）" }, { "name": "canApprove", "in": "query", "required": false, "type": "boolean", "description": "当前用户是否可审批此流程" }, { "name": "createTime", "in": "query", "required": false, "type": "string / date-time", "description": "创建时间" }, { "name": "factoryDeptId", "in": "query", "required": false, "type": "string", "description": "所属厂区部门ID" }, { "name": "factoryDeptName", "in": "query", "required": false, "type": "string", "description": "所属厂区部门名称" }, { "name": "flowInstanceId", "in": "query", "required": false, "type": "string", "description": "流程实例ID（预留）" }, { "name": "flowStatus", "in": "query", "required": false, "type": "integer / int32", "description": "流程状态：0-无流程 1-进行中 2-已完成" }, { "name": "handleRemark", "in": "query", "required": false, "type": "string", "description": "处理意见/结果说明" }, { "name": "handleTime", "in": "query", "required": false, "type": "string / date-time", "description": "处理时间" }, { "name": "handleUserId", "in": "query", "required": false, "type": "integer / int64", "description": "处理人用户ID" }, { "name": "handleUserName", "in": "query", "required": false, "type": "string", "description": "处理人姓名" }, { "name": "id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "isInitiator", "in": "query", "required": false, "type": "boolean", "description": "当前用户是否为此流程发起人" }, { "name": "pageNum", "in": "query", "required": false, "type": "integer / int32", "description": "页码" }, { "name": "reportId", "in": "query", "required": false, "type": "integer / int64", "description": "关联隐患上报ID" }, { "name": "reportNo", "in": "query", "required": false, "type": "string", "description": "关联隐患编号" }, { "name": "status", "in": "query", "required": false, "type": "string", "description": "申诉状态：0-待受理 1-处理中 2-已通过 3-已驳回 4-已撤回" }, { "name": "statusName", "in": "query", "required": false, "type": "string", "description": "申诉状态名称" }, { "name": "updateTime", "in": "query", "required": false, "type": "string / date-time", "description": "更新时间" }, { "name": "userId", "in": "query", "required": false, "type": "integer / int64", "description": "申诉人用户ID" }, { "name": "userName", "in": "query", "required": false, "type": "string", "description": "申诉人姓名" }, { "name": "pageSize", "in": "query", "required": false, "type": "integer / int32", "description": "每页数量" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分申诉管理", "name": "逻辑删除", "usage": "根据主键ID逻辑删除单条记录，成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/points/appeal/removeById", "operationId": "deleteListUsingGET_18", "parameters": [ { "name": "id", "in": "query", "required": true, "type": "string", "description": "主键ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分申诉管理", "name": "提交申诉（APP端）", "usage": "填写申诉类型、理由等信息，申诉人信息从登录用户获取。返回 data 为 PointsAppeal 对象，包含 id、appealNo-申诉编号、status-状态(0待受理)。", "method": "POST", "path": "/gd_dataserver/business/points/appeal/submit", "operationId": "submitAppealUsingPOST", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "积分申诉" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分申诉管理", "name": "提交申诉并启动流程（APP端）", "usage": "提交申诉并自动启动 Flowable 审批流程。后端自动解析申诉人所属厂区，按 (厂区, biz_type=appeal) 从 qc_hazard_flow_config 匹配流程Key并带厂区tenantId启动；若该厂区未配置申诉流程则回退到全局默认 appeal.flow.key。申诉人信息、factoryDeptId/factoryDeptName 均由后端自动填充，无需前端传。成功返回 data 为流程实例ID字符串；失败返回 error 信息。", "method": "POST", "path": "/gd_dataserver/business/points/appeal/submitFlow", "operationId": "submitAppealFlowUsingPOST", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "积分申诉" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分申诉管理", "name": "申诉流程待办列表", "usage": "返回 data 为 PageInfo 分页对象。list 中每条记录为 PointsAppeal 对象，包含 id、appealNo、userName、appealType-申诉类型、appealReason-申诉理由、status-状态、createTime。", "method": "GET", "path": "/gd_dataserver/business/points/appeal/todoList", "operationId": "todoListUsingGET_2", "parameters": [ { "name": "params", "in": "query", "required": true, "type": "object", "description": "查询参数（支持pageNum/pageSize等）" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分申诉管理", "name": "修改", "usage": "根据主键ID修改记录，请求体为实体类对象（需包含id字段）。成功返回 data 为 null。", "method": "POST", "path": "/gd_dataserver/business/points/appeal/updateById", "operationId": "updateByIdUsingPOST_9", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "积分申诉" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分申诉管理", "name": "撤回申诉（APP端）", "usage": "仅待受理状态(status=0)可撤回，撤回后状态改为已撤回(4)。返回 data 为 boolean。", "method": "POST", "path": "/gd_dataserver/business/points/appeal/withdraw/{id}", "operationId": "withdrawAppealUsingPOST", "parameters": [ { "name": "id", "in": "path", "required": true, "type": "integer / int64", "description": "申诉ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分规则配置", "name": "新增积分规则", "usage": "二级管理员自动填充厂区信息，且不可创建全局兜底规则；超级管理员可指定 deptId（为空表示全局兜底规则）。", "method": "POST", "path": "/gd_dataserver/business/points/rule/add", "operationId": "addUsingPOST", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "积分规则配置" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分规则配置", "name": "计算积分", "usage": "根据厂区、隐患等级和类别查询对应奖励积分。二级管理员调用时 deptId 自动填充为所属厂区，超管可传任意厂区（不传则匹配全局兜底）。返回 data 为 Integer 类型的积分数值。", "method": "GET", "path": "/gd_dataserver/business/points/rule/calculatePoints", "operationId": "calculatePointsUsingGET", "parameters": [ { "name": "deptId", "in": "query", "required": false, "type": "string", "description": "厂区部门ID（二级管理员忽略此参数）" }, { "name": "hazardLevel", "in": "query", "required": true, "type": "string", "description": "隐患等级编码" }, { "name": "hazardCategory", "in": "query", "required": true, "type": "string", "description": "隐患类别编码" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分规则配置", "name": "删除积分规则", "usage": "根据主键ID物理删除。二级管理员只能删除本厂区规则；全局兜底规则仅超级管理员可删除。", "method": "GET", "path": "/gd_dataserver/business/points/rule/deleteById", "operationId": "deleteByIdUsingGET", "parameters": [ { "name": "id", "in": "query", "required": true, "type": "string", "description": "主键ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分规则配置", "name": "分页查询积分规则（兼容旧路径）", "usage": "同 /list 接口，保留用于前端旧路径兼容。二级管理员自动过滤本厂区。", "method": "GET", "path": "/gd_dataserver/business/points/rule/getListByPage", "operationId": "getListByPageUsingGET_10", "parameters": [ { "name": "createTime", "in": "query", "required": false, "type": "string / date-time", "description": "创建时间" }, { "name": "deptId", "in": "query", "required": false, "type": "string", "description": "所属厂区部门ID（NULL表示全局兜底规则，二级管理员新增时自动填充）" }, { "name": "deptName", "in": "query", "required": false, "type": "string", "description": "所属厂区部门名称" }, { "name": "enabled", "in": "query", "required": false, "type": "integer / int32", "description": "是否启用：0-禁用 1-启用" }, { "name": "hazardCategory", "in": "query", "required": false, "type": "string", "description": "隐患类别" }, { "name": "hazardLevel", "in": "query", "required": false, "type": "string", "description": "隐患等级编码（general/major/critical）" }, { "name": "id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "pageNum", "in": "query", "required": false, "type": "integer / int32", "description": "页码" }, { "name": "points", "in": "query", "required": false, "type": "integer / int32", "description": "奖励积分" }, { "name": "priority", "in": "query", "required": false, "type": "integer / int32", "description": "优先级（数字越大优先级越高）" }, { "name": "remark", "in": "query", "required": false, "type": "string", "description": "备注" }, { "name": "ruleCode", "in": "query", "required": false, "type": "string", "description": "规则编码" }, { "name": "ruleName", "in": "query", "required": false, "type": "string", "description": "规则名称" }, { "name": "updateTime", "in": "query", "required": false, "type": "string / date-time", "description": "更新时间" }, { "name": "pageSize", "in": "query", "required": false, "type": "integer / int32", "description": "每页条数" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分规则配置", "name": "获取积分规则详情", "usage": "根据主键ID查询规则详情。二级管理员访问非本厂区规则或全局兜底规则时返回错误。", "method": "GET", "path": "/gd_dataserver/business/points/rule/info", "operationId": "infoUsingGET_10", "parameters": [ { "name": "id", "in": "query", "required": true, "type": "string", "description": "主键ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分规则配置", "name": "分页查询积分规则列表", "usage": "超级管理员返回所有厂区规则（可按deptId筛选，传global表示查询全局兜底规则）；二级管理员自动过滤为所属厂区规则。返回 data 为 PageInfo 分页对象。", "method": "GET", "path": "/gd_dataserver/business/points/rule/list", "operationId": "listUsingGET_1", "parameters": [ { "name": "pageNum", "in": "query", "required": true, "type": "integer / int32", "description": "页码" }, { "name": "pageSize", "in": "query", "required": true, "type": "integer / int32", "description": "每页条数" }, { "name": "deptId", "in": "query", "required": false, "type": "string", "description": "厂区部门ID（超管可传，二级管理员忽略；传 global 表示查询全局兜底规则）" }, { "name": "hazardLevel", "in": "query", "required": false, "type": "string", "description": "隐患等级编码（general/major/critical）" }, { "name": "hazardCategory", "in": "query", "required": false, "type": "string", "description": "隐患类别" }, { "name": "enabled", "in": "query", "required": false, "type": "integer / int32", "description": "是否启用：0-禁用 1-启用" }, { "name": "ruleName", "in": "query", "required": false, "type": "string", "description": "规则名称（模糊匹配）" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分规则配置", "name": "查询当前厂区所有积分规则", "usage": "返回当前登录用户所属厂区的规则列表，同时包含全局兜底规则（dept_id 为 NULL）。返回 data 为 PointsRuleConfig 数组。", "method": "GET", "path": "/gd_dataserver/business/points/rule/myFactoryRules", "operationId": "myFactoryRulesUsingGET", "parameters": [], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分规则配置", "name": "获取隐患分类根规则列表", "usage": "返回当前用户厂区每个大类（一般/较大/重大）的最高优先级根规则，用于 APP 上报时隐患分类下拉选择。返回 data 为 PointsRuleConfig 数组（最多3条）。", "method": "GET", "path": "/gd_dataserver/business/points/rule/rootRules", "operationId": "rootRulesUsingGET", "parameters": [], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分规则配置", "name": "获取积分规则树形结构", "usage": "返回当前用户厂区的积分规则树形结构，按大类（一般/较大/重大）分组，每个大类下包含子规则列表，用于审批时选择具体档次。返回 data 为数组，每项含 id/hazardLevel/hazardLevelName/ruleName/points/children。", "method": "GET", "path": "/gd_dataserver/business/points/rule/ruleTree", "operationId": "ruleTreeUsingGET", "parameters": [], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分规则配置", "name": "获取指定等级下的积分规则列表", "usage": "根据隐患等级编码（general/major/critical）返回当前厂区该等级下的根规则和子档位列表，用于审批人在当前等级内选择具体档次。返回 data 为对象，包含 hazardLevel-等级编码、hazardLevelName-等级名称、root-根规则对象（可为null）、children-子档位规则数组。", "method": "GET", "path": "/gd_dataserver/business/points/rule/rulesByLevel", "operationId": "rulesByLevelUsingGET", "parameters": [ { "name": "hazardLevel", "in": "query", "required": true, "type": "string", "description": "隐患等级编码（general/major/critical）" }, { "name": "deptId", "in": "query", "required": false, "type": "string", "description": "厂区部门ID（仅超级管理员生效：传具体ID查看该厂区+全局，传global仅查看全局兜底，不传查看全部厂区）" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分规则配置", "name": "启用/禁用积分规则", "usage": "enabled=1 启用，enabled=0 禁用。二级管理员只能操作本厂区规则。", "method": "POST", "path": "/gd_dataserver/business/points/rule/toggleEnabled", "operationId": "toggleEnabledUsingPOST", "parameters": [ { "name": "id", "in": "query", "required": true, "type": "integer / int64", "description": "规则ID" }, { "name": "enabled", "in": "query", "required": true, "type": "integer / int32", "description": "启用状态：0-禁用 1-启用" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分规则配置", "name": "积分规则试算", "usage": "模拟积分计算过程，返回匹配的规则详情和计算结果。返回 data 为对象：deptId-生效厂区、hazardLevel-输入的隐患等级、hazardCategory-输入的隐患类别、matchedRule-匹配到的规则对象或null、calculatedPoints-计算得到的积分数值(无匹配时为0)、matchScope-命中范围(FACTORY-厂区专属/GLOBAL-全局兜底/NONE-未命中)。", "method": "GET", "path": "/gd_dataserver/business/points/rule/trialCalculate", "operationId": "trialCalculateUsingGET", "parameters": [ { "name": "deptId", "in": "query", "required": false, "type": "string", "description": "厂区部门ID（二级管理员忽略此参数）" }, { "name": "hazardLevel", "in": "query", "required": true, "type": "string", "description": "隐患等级编码" }, { "name": "hazardCategory", "in": "query", "required": true, "type": "string", "description": "隐患类别编码" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分规则配置", "name": "修改积分规则", "usage": "二级管理员只能修改本厂区规则，不可变更所属厂区；超级管理员可任意修改。", "method": "POST", "path": "/gd_dataserver/business/points/rule/updateById", "operationId": "updateByIdUsingPOST_10", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "积分规则配置" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分流水明细", "name": "新增", "usage": "新增单条记录，请求体为实体类对象（字段说明见对应实体模型）。成功返回 data 为 null。", "method": "POST", "path": "/gd_dataserver/business/points/transaction/add", "operationId": "addOneUsingPOST_10", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "积分流水明细" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分流水明细", "name": "批量新增", "usage": "批量新增多条记录，请求体为实体类数组。成功返回 data 为 null。", "method": "POST", "path": "/gd_dataserver/business/points/transaction/addBatch", "operationId": "addBatchUsingPOST_10", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "array<积分流水明细>" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分流水明细", "name": "新增并返回保存的数据", "usage": "新增单条记录并返回保存后的数据（含自增ID），请求体为实体类对象。成功返回 data 为保存的实体对象。", "method": "POST", "path": "/gd_dataserver/business/points/transaction/addReturn", "operationId": "addReturnUsingPOST_10", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "积分流水明细" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分流水明细", "name": "根据属性删除", "usage": "根据实体属性条件删除记录，请求体为实体类对象。成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/points/transaction/delete", "operationId": "deleteUsingGET_10", "parameters": [ { "name": "afterBalance", "in": "query", "required": false, "type": "integer / int32", "description": "变动后可用余额" }, { "name": "afterFrozen", "in": "query", "required": false, "type": "integer / int32", "description": "变动后冻结余额" }, { "name": "amount", "in": "query", "required": false, "type": "integer / int32", "description": "变动积分（正数=入账，负数=出账）" }, { "name": "beforeBalance", "in": "query", "required": false, "type": "integer / int32", "description": "变动前可用余额" }, { "name": "beforeFrozen", "in": "query", "required": false, "type": "integer / int32", "description": "变动前冻结余额" }, { "name": "bizId", "in": "query", "required": false, "type": "string", "description": "业务单号" }, { "name": "bizType", "in": "query", "required": false, "type": "string", "description": "业务类型：REPORT-隐患上报奖励 EXCHANGE-兑换扣减 REFUND-退款回滚 FREEZE-冻结 UNFREEZE-解冻" }, { "name": "createTime", "in": "query", "required": false, "type": "string / date-time", "description": "创建时间" }, { "name": "factoryDeptId", "in": "query", "required": false, "type": "string", "description": "所属厂区部门ID" }, { "name": "id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "operator", "in": "query", "required": false, "type": "string", "description": "操作人" }, { "name": "remark", "in": "query", "required": false, "type": "string", "description": "备注" }, { "name": "status", "in": "query", "required": false, "type": "integer / int32", "description": "状态：1-有效 2-已冲正" }, { "name": "txnNo", "in": "query", "required": false, "type": "string", "description": "流水号" }, { "name": "userId", "in": "query", "required": false, "type": "integer / int64", "description": "用户ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分流水明细", "name": "主键删除", "usage": "根据主键ID删除单条记录，成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/points/transaction/deleteById", "operationId": "deleteOneUsingGET_10", "parameters": [ { "name": "id", "in": "query", "required": true, "type": "string", "description": "主键ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分流水明细", "name": "批量删除", "usage": "根据ID列表批量删除记录，成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/points/transaction/deleteByIds", "operationId": "deleteListUsingGET_21", "parameters": [ { "name": "ids", "in": "query", "required": true, "type": "string", "description": "ID列表(逗号分隔)" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分流水明细", "name": "查询所有", "usage": "查询所有记录（无分页、无条件）。成功返回 data 为实体类数组。", "method": "GET", "path": "/gd_dataserver/business/points/transaction/getAll", "operationId": "getAllUsingGET_10", "parameters": [], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分流水明细", "name": "分页查询", "usage": "分页查询记录列表，查询条件为实体类字段。成功返回 data 为 PageInfo 分页对象，其中 list 为实体类数组。", "method": "GET", "path": "/gd_dataserver/business/points/transaction/getListByPage", "operationId": "getListByPageUsingGET_11", "parameters": [ { "name": "afterBalance", "in": "query", "required": false, "type": "integer / int32", "description": "变动后可用余额" }, { "name": "afterFrozen", "in": "query", "required": false, "type": "integer / int32", "description": "变动后冻结余额" }, { "name": "amount", "in": "query", "required": false, "type": "integer / int32", "description": "变动积分（正数=入账，负数=出账）" }, { "name": "beforeBalance", "in": "query", "required": false, "type": "integer / int32", "description": "变动前可用余额" }, { "name": "beforeFrozen", "in": "query", "required": false, "type": "integer / int32", "description": "变动前冻结余额" }, { "name": "bizId", "in": "query", "required": false, "type": "string", "description": "业务单号" }, { "name": "bizType", "in": "query", "required": false, "type": "string", "description": "业务类型：REPORT-隐患上报奖励 EXCHANGE-兑换扣减 REFUND-退款回滚 FREEZE-冻结 UNFREEZE-解冻" }, { "name": "createTime", "in": "query", "required": false, "type": "string / date-time", "description": "创建时间" }, { "name": "factoryDeptId", "in": "query", "required": false, "type": "string", "description": "所属厂区部门ID" }, { "name": "id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "operator", "in": "query", "required": false, "type": "string", "description": "操作人" }, { "name": "pageNum", "in": "query", "required": true, "type": "integer / int32", "description": "页码" }, { "name": "remark", "in": "query", "required": false, "type": "string", "description": "备注" }, { "name": "status", "in": "query", "required": false, "type": "integer / int32", "description": "状态：1-有效 2-已冲正" }, { "name": "txnNo", "in": "query", "required": false, "type": "string", "description": "流水号" }, { "name": "userId", "in": "query", "required": false, "type": "integer / int64", "description": "用户ID" }, { "name": "pageSize", "in": "query", "required": true, "type": "integer / int32", "description": "每页条数" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分流水明细", "name": "详情", "usage": "根据主键ID查询单条记录详情。成功返回 data 为实体类对象，包含该实体所有字段。", "method": "GET", "path": "/gd_dataserver/business/points/transaction/info", "operationId": "infoUsingGET_11", "parameters": [ { "name": "id", "in": "query", "required": true, "type": "string", "description": "主键ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分流水明细", "name": "条件查询", "usage": "根据实体属性条件查询记录列表。成功返回 data 为实体类数组。", "method": "GET", "path": "/gd_dataserver/business/points/transaction/list", "operationId": "getListUsingGET_10", "parameters": [ { "name": "afterBalance", "in": "query", "required": false, "type": "integer / int32", "description": "变动后可用余额" }, { "name": "afterFrozen", "in": "query", "required": false, "type": "integer / int32", "description": "变动后冻结余额" }, { "name": "amount", "in": "query", "required": false, "type": "integer / int32", "description": "变动积分（正数=入账，负数=出账）" }, { "name": "beforeBalance", "in": "query", "required": false, "type": "integer / int32", "description": "变动前可用余额" }, { "name": "beforeFrozen", "in": "query", "required": false, "type": "integer / int32", "description": "变动前冻结余额" }, { "name": "bizId", "in": "query", "required": false, "type": "string", "description": "业务单号" }, { "name": "bizType", "in": "query", "required": false, "type": "string", "description": "业务类型：REPORT-隐患上报奖励 EXCHANGE-兑换扣减 REFUND-退款回滚 FREEZE-冻结 UNFREEZE-解冻" }, { "name": "createTime", "in": "query", "required": false, "type": "string / date-time", "description": "创建时间" }, { "name": "factoryDeptId", "in": "query", "required": false, "type": "string", "description": "所属厂区部门ID" }, { "name": "id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "operator", "in": "query", "required": false, "type": "string", "description": "操作人" }, { "name": "remark", "in": "query", "required": false, "type": "string", "description": "备注" }, { "name": "status", "in": "query", "required": false, "type": "integer / int32", "description": "状态：1-有效 2-已冲正" }, { "name": "txnNo", "in": "query", "required": false, "type": "string", "description": "流水号" }, { "name": "userId", "in": "query", "required": false, "type": "integer / int64", "description": "用户ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分流水明细", "name": "查询我的积分流水（APP端）", "usage": "返回 data 为 PageInfo 分页对象。list 中每条记录为 PointsTransactionLog 对象，主要字段：txnNo-流水号、userId-用户ID、bizId-业务单号、bizType-业务类型(REPORT-上报奖励/EXCHANGE-兑换扣减/REFUND-退款/APPEAL_ADD-申诉补发/APPEAL_DEDUCT-申诉扣减/MALL_DEDUCT-商城扣减/MALL_REFUND-商城退款)、amount-变动积分(正=入账，负=出账)、beforeBalance-变动前余额、afterBalance-变动后余额、status-状态(1有效/2已冲正)、createTime-创建时间。", "method": "GET", "path": "/gd_dataserver/business/points/transaction/myList", "operationId": "myListUsingGET_3", "parameters": [ { "name": "afterBalance", "in": "query", "required": false, "type": "integer / int32", "description": "变动后可用余额" }, { "name": "afterFrozen", "in": "query", "required": false, "type": "integer / int32", "description": "变动后冻结余额" }, { "name": "amount", "in": "query", "required": false, "type": "integer / int32", "description": "变动积分（正数=入账，负数=出账）" }, { "name": "beforeBalance", "in": "query", "required": false, "type": "integer / int32", "description": "变动前可用余额" }, { "name": "beforeFrozen", "in": "query", "required": false, "type": "integer / int32", "description": "变动前冻结余额" }, { "name": "bizId", "in": "query", "required": false, "type": "string", "description": "业务单号" }, { "name": "bizType", "in": "query", "required": false, "type": "string", "description": "业务类型：REPORT-隐患上报奖励 EXCHANGE-兑换扣减 REFUND-退款回滚 FREEZE-冻结 UNFREEZE-解冻" }, { "name": "createTime", "in": "query", "required": false, "type": "string / date-time", "description": "创建时间" }, { "name": "factoryDeptId", "in": "query", "required": false, "type": "string", "description": "所属厂区部门ID" }, { "name": "id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "operator", "in": "query", "required": false, "type": "string", "description": "操作人" }, { "name": "pageNum", "in": "query", "required": false, "type": "integer / int32", "description": "页码" }, { "name": "remark", "in": "query", "required": false, "type": "string", "description": "备注" }, { "name": "status", "in": "query", "required": false, "type": "integer / int32", "description": "状态：1-有效 2-已冲正" }, { "name": "txnNo", "in": "query", "required": false, "type": "string", "description": "流水号" }, { "name": "userId", "in": "query", "required": false, "type": "integer / int64", "description": "用户ID" }, { "name": "pageSize", "in": "query", "required": false, "type": "integer / int32", "description": "每页数量" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分流水明细", "name": "逻辑删除", "usage": "根据主键ID逻辑删除单条记录，成功返回 data 为 null。", "method": "GET", "path": "/gd_dataserver/business/points/transaction/removeById", "operationId": "deleteListUsingGET_20", "parameters": [ { "name": "id", "in": "query", "required": true, "type": "string", "description": "主键ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分流水明细", "name": "积分冲正", "usage": "根据流水ID冲正该笔积分变动，原流水标记为已冲正(status=2)，并生成反向流水。返回 data 为 boolean，true-冲正成功。", "method": "POST", "path": "/gd_dataserver/business/points/transaction/reverse/{logId}", "operationId": "reverseTransactionUsingPOST", "parameters": [ { "name": "logId", "in": "path", "required": true, "type": "integer / int64", "description": "原流水ID" }, { "name": "reason", "in": "query", "required": false, "type": "string", "description": "冲正原因" }, { "name": "operator", "in": "query", "required": true, "type": "string", "description": "操作人" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "积分流水明细", "name": "修改", "usage": "根据主键ID修改记录，请求体为实体类对象（需包含id字段）。成功返回 data 为 null。", "method": "POST", "path": "/gd_dataserver/business/points/transaction/updateById", "operationId": "updateByIdUsingPOST_11", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "积分流水明细" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "流程审批_签字", "name": "查询签字记录列表", "usage": "支持按条件筛选签字记录", "method": "GET", "path": "/gd_dataserver/business/flowqz/getList", "operationId": "getListUsingGET_11", "parameters": [ { "name": "comment", "in": "query", "required": false, "type": "string", "description": "意见" }, { "name": "file", "in": "query", "required": false, "type": "string", "description": "照片地址" }, { "name": "id", "in": "query", "required": false, "type": "integer / int64", "description": "主键ID" }, { "name": "instanceId", "in": "query", "required": false, "type": "string", "description": "流程实例Id" }, { "name": "qz", "in": "query", "required": false, "type": "string", "description": "签字" }, { "name": "result", "in": "query", "required": false, "type": "string", "description": "结果" }, { "name": "taskId", "in": "query", "required": false, "type": "string", "description": "任务id" }, { "name": "taskName", "in": "query", "required": false, "type": "string", "description": "任务名称" }, { "name": "time", "in": "query", "required": false, "type": "string", "description": "签字时间" }, { "name": "type", "in": "query", "required": false, "type": "string", "description": "业务类型" }, { "name": "userId", "in": "query", "required": false, "type": "string", "description": "用户Id" }, { "name": "userName", "in": "query", "required": false, "type": "string", "description": "用户名称" }, { "name": "zyxkid", "in": "query", "required": false, "type": "string", "description": "作业许可id" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "隐患流程模板配置", "name": "修改流程模板配置", "usage": "修改流程Key、流程名称等信息。不可修改厂区ID和隐患等级。请求体字段：id-配置ID(必填)、flowKey-流程定义Key、flowName-流程名称、hazardLevelName-隐患等级名称等可修改字段。非超级管理员只能修改自己厂区的配置，否则返回错误。返回 data 为提示字符串，如\"修改成功\"。", "method": "PUT", "path": "/gd_dataserver/flowable/hazardFlowConfig", "operationId": "editUsingPUT", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "隐患流程模板配置" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "隐患流程模板配置", "name": "新增流程模板配置", "usage": "配置某个厂区、某业务类型、某隐患等级对应的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 为提示字符串，如\"新增成功\"。", "method": "POST", "path": "/gd_dataserver/flowable/hazardFlowConfig", "operationId": "addUsingPOST_1", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "隐患流程模板配置" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "隐患流程模板配置", "name": "查询流程模板配置列表", "usage": "系统管理员返回所有配置；二级管理员自动过滤为所属厂区的配置。可选按厂区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-创建时间。", "method": "GET", "path": "/gd_dataserver/flowable/hazardFlowConfig/list", "operationId": "listUsingGET_2", "parameters": [ { "name": "pageNum", "in": "query", "required": true, "type": "integer / int32", "description": "当前页码" }, { "name": "pageSize", "in": "query", "required": true, "type": "integer / int32", "description": "每页条数" }, { "name": "deptId", "in": "query", "required": false, "type": "string", "description": "厂区部门ID（不传则按当前用户权限自动过滤，超级管理员不传返回全部）" }, { "name": "bizType", "in": "query", "required": false, "type": "string", "description": "业务类型（report-上报/appeal-申诉/rectify-整改/verify-验收，不传则不过滤）" }, { "name": "hazardLevel", "in": "query", "required": false, "type": "string", "description": "隐患等级编码（general-一般/major-较大/critical-重大，不传则不过滤）" }, { "name": "status", "in": "query", "required": false, "type": "string", "description": "状态（0-停用/1-正常，不传则查全部状态）" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "隐患流程模板配置", "name": "获取当前厂区已配置的上报流程模板", "usage": "前端上报隐患时调用，仅返回当前用户所属厂区 bizType=report 的配置（申诉/整改/验收不会返回），用于前端展示可选的隐患等级下拉。返回 data 为 QcHazardFlowConfig 数组，每条记录包含：id-主键、deptId-厂区部门ID、deptName-厂区名称、bizType-业务类型(固定report)、hazardLevel-隐患等级编码、hazardLevelName-隐患等级名称、flowKey-流程定义Key、flowName-流程名称。若当前用户未分配厂区部门则返回错误。", "method": "GET", "path": "/gd_dataserver/flowable/hazardFlowConfig/myFactoryConfigs", "operationId": "myFactoryConfigsUsingGET", "parameters": [], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "隐患流程模板配置", "name": "获取流程模板配置详情", "usage": "根据ID查询单条流程模板配置的完整信息。返回 data 为 QcHazardFlowConfig 对象，字段：id-主键、deptId-厂区部门ID、deptName-厂区名称、bizType-业务类型(report/appeal/rectify/verify)、hazardLevel-隐患等级编码、hazardLevelName-隐患等级名称、flowKey-流程定义Key、flowName-流程名称、status-状态(0停用/1正常)、createBy-创建者、createTime-创建时间、updateBy-更新者、updateTime-更新时间。非超级管理员无权查看其他厂区的配置。", "method": "GET", "path": "/gd_dataserver/flowable/hazardFlowConfig/{id}", "operationId": "getInfoUsingGET_1", "parameters": [ { "name": "id", "in": "path", "required": true, "type": "integer / int64", "description": "配置ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "隐患流程模板配置", "name": "删除流程模板配置", "usage": "逻辑删除（设置del_flag=1），不做物理删除。非超级管理员只能删除自己厂区的配置，否则返回错误。返回 data 为提示字符串，如\"删除成功\"。", "method": "DELETE", "path": "/gd_dataserver/flowable/hazardFlowConfig/{id}", "operationId": "removeUsingDELETE_1", "parameters": [ { "name": "id", "in": "path", "required": true, "type": "integer / int64", "description": "配置ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "204", "description": "No Content", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] } ] }, { "tag": "系统工具", "name": "获取组织架构（部门-人员树）", "usage": "返回 data 为树形数组，每个节点包含 id-部门ID、label-部门名称、children-子节点数组。子节点包含部门或人员，人员节点包含 id-用户ID、label-用户姓名。", "method": "GET", "path": "/gd_dataserver/system/getOrgUsers", "operationId": "getOrgUsersUsingGET", "parameters": [], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "array" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "系统工具", "name": "获取当前登录用户信息", "usage": "返回 data 为 SysUser 对象，包含 userId-用户ID、userName-用户名、nickName-昵称、phonenumber-手机号、email-邮箱、dept-部门对象{deptId,deptName}等字段。", "method": "GET", "path": "/gd_dataserver/system/getTokenUser", "operationId": "getTokenUserUsingGET", "parameters": [], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "sys-dept-controller", "name": "获取所有厂区级部门列表", "usage": "返回部门树中第二层（二级）的所有部门，供超级管理员在下拉框中选择厂区。厂区级定义：父节点为根级部门（parentId=0）的部门。", "method": "GET", "path": "/gd_dataserver/system/dept/factoryList", "operationId": "factoryListUsingGET", "parameters": [], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "sys-dept-controller", "name": "获取当前用户所属厂区部门", "usage": "根据当前登录用户的部门信息，向上回溯到厂区级（二级）部门并返回。适用于非超级管理员获取自己所属厂区。返回 data 为 SysDept 对象，包含 deptId、deptName 等字段。", "method": "GET", "path": "/gd_dataserver/system/dept/myFactory", "operationId": "myFactoryUsingGET", "parameters": [], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "test-controller-1", "name": "获取用户列表", "usage": "", "method": "GET", "path": "/gd_dataserver/test/user/list", "operationId": "userListUsingGET_1", "parameters": [], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "R«List«UserEntity»»" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "test-controller-1", "name": "新增用户", "usage": "", "method": "POST", "path": "/gd_dataserver/test/user/save", "operationId": "saveUsingPOST_2", "parameters": [ { "name": "mobile", "in": "query", "required": false, "type": "string", "description": "用户手机" }, { "name": "password", "in": "query", "required": false, "type": "string", "description": "用户密码" }, { "name": "userId", "in": "query", "required": false, "type": "integer / int32", "description": "用户id" }, { "name": "username", "in": "query", "required": false, "type": "string", "description": "用户名称" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "R«string»" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "test-controller-1", "name": "更新用户", "usage": "", "method": "PUT", "path": "/gd_dataserver/test/user/update", "operationId": "updateUsingPUT", "parameters": [], "requestBodies": [ { "contentType": "application/json", "schema": "UserEntity" } ], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "R«string»" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "test-controller-1", "name": "获取用户详细", "usage": "", "method": "GET", "path": "/gd_dataserver/test/user/{userId}", "operationId": "getUserUsingGET", "parameters": [ { "name": "userId", "in": "path", "required": true, "type": "integer / int32", "description": "用户ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "R«UserEntity»" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "test-controller-1", "name": "删除用户信息", "usage": "", "method": "DELETE", "path": "/gd_dataserver/test/user/{userId}", "operationId": "deleteUsingDELETE_2", "parameters": [ { "name": "userId", "in": "path", "required": true, "type": "integer / int32", "description": "用户ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "R«string»" } ] }, { "status": "204", "description": "No Content", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] } ] }, { "tag": "用户消息中心", "name": "消息详情", "usage": "查看后自动标记为已读。返回 data 为 UserMessage 对象，包含 id、msgType、title、content、bizId、createTime。", "method": "GET", "path": "/gd_dataserver/business/message/detail/{id}", "operationId": "detailUsingGET_1", "parameters": [ { "name": "id", "in": "path", "required": true, "type": "integer / int64", "description": "消息ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "用户消息中心", "name": "分页查询我的消息列表", "usage": "返回 data 为 Page 分页对象。list 中每条记录为 UserMessage 对象，主要字段：id、userId-用户ID、msgType-消息类型(如points_award/hazard_audit/appeal_result)、title-消息标题、content-消息内容、bizId-关联业务ID、isRead-是否已读(0未读/1已读)、createTime-创建时间。", "method": "GET", "path": "/gd_dataserver/business/message/list", "operationId": "listUsingGET_3", "parameters": [ { "name": "msgType", "in": "query", "required": false, "type": "string", "description": "消息类型（可选）" }, { "name": "onlyUnread", "in": "query", "required": false, "type": "boolean", "description": "是否只查未读" }, { "name": "pageNum", "in": "query", "required": false, "type": "integer / int32", "description": "页码" }, { "name": "pageSize", "in": "query", "required": false, "type": "integer / int32", "description": "每页数量" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "用户消息中心", "name": "标记消息已读", "usage": "将指定消息标记为已读。返回 data 为 null，成功时 code=200。", "method": "POST", "path": "/gd_dataserver/business/message/read/{id}", "operationId": "markReadUsingPOST", "parameters": [ { "name": "id", "in": "path", "required": true, "type": "integer / int64", "description": "消息ID" } ], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "用户消息中心", "name": "全部标记已读", "usage": "将当前用户所有未读消息标记为已读。返回 data 为 null，成功时 code=200。", "method": "POST", "path": "/gd_dataserver/business/message/readAll", "operationId": "markAllReadUsingPOST", "parameters": [], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "201", "description": "Created", "schemas": [] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] }, { "tag": "用户消息中心", "name": "获取未读消息数量", "usage": "返回 data 为 Long 类型的未读消息数量，如 5。用于APP端消息红点展示。", "method": "GET", "path": "/gd_dataserver/business/message/unread-count", "operationId": "unreadCountUsingGET", "parameters": [], "requestBodies": [], "responses": [ { "status": "200", "description": "OK", "schemas": [ { "contentType": "*/*", "schema": "object" } ] }, { "status": "401", "description": "Unauthorized", "schemas": [] }, { "status": "403", "description": "Forbidden", "schemas": [] }, { "status": "404", "description": "Not Found", "schemas": [] } ] } ]