zhongyouweb/docs/api/catalog.json

[
  {
    "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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<integer / int64>",
        "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<integer / int64>",
        "description": ""
      },
      {
        "name": "params",
        "in": "query",
        "required": false,
        "type": "object",
        "description": ""
      },
      {
        "name": "permissions",
        "in": "query",
        "required": false,
        "type": "array<string>",
        "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<string, 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<string, 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<string, 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<string, 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<integer / int64>",
        "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<string>",
        "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<integer / int64>",
        "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<integer / int64>",
        "description": ""
      },
      {
        "name": "roles[0].params",
        "in": "query",
        "required": false,
        "type": "object",
        "description": ""
      },
      {
        "name": "roles[0].permissions",
        "in": "query",
        "required": false,
        "type": "array<string>",
        "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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, string>",
        "description": "查询参数（支持pageNum/pageSize等）"
      }
    ],
    "requestBodies": [],
    "responses": [
      {
        "status": "200",
        "description": "OK",
        "schemas": [
          {
            "contentType": "*/*",
            "schema": "object<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, string>",
        "description": "查询参数（支持pageNum/pageSize等）"
      }
    ],
    "requestBodies": [],
    "responses": [
      {
        "status": "200",
        "description": "OK",
        "schemas": [
          {
            "contentType": "*/*",
            "schema": "object<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<object>"
          }
        ]
      },
      {
        "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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, 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<string, object>"
          }
        ]
      },
      {
        "status": "401",
        "description": "Unauthorized",
        "schemas": []
      },
      {
        "status": "403",
        "description": "Forbidden",
        "schemas": []
      },
      {
        "status": "404",
        "description": "Not Found",
        "schemas": []
      }
    ]
  }
]