ygtx_worklog/docs/diagrams/gxt-order-score-api-description.md

工单评分管理接口说明

1. 查询工单评分列表

接口地址

GET /gxt/orderScore/list

接口描述

查询合并的维修工单和维保工单列表

请求参数

参数名	类型	必填	说明
repairOrder	GxtRepairOrder	否	维修工单查询条件
workOrder	GxtWorkOrder	否	维保工单查询条件

响应参数

{
  "code": 200,
  "msg": "查询成功",
  "data": {
    "total": 100,
    "rows": [
      {
        "orderType": 1,
        "id": 1,
        "workOrderProjectNo": "WX20251201001",
        "workOrderStatus": "completed",
        "scoringStatus": "to_self",
        "scorePersonList": [
          {
            "id": 1,
            "userId": 1001,
            "nickName": "张三",
            "selfScore": null,
            "reviewScore": null,
            "finalScore": null,
            "isLeader": 1,
            "confirmStatus": 0
          }
        ]
      }
    ]
  }
}

权限要求

@gxt:orderScore:list

2. 查询移动端工单评分列表

接口地址

GET /gxt/orderScore/mobile/list

接口描述

查询移动端合并的维修工单和维保工单列表

请求参数

参数名	类型	必填	说明
repairOrder	GxtRepairOrder	否	维修工单查询条件
workOrder	GxtWorkOrder	否	维保工单查询条件
keyword	String	否	关键词
scoringStatus	String	否	评分状态

响应参数

{
  "code": 200,
  "msg": "查询成功",
  "data": {
    "total": 100,
    "rows": [
      {
        "orderType": 2,
        "id": 2,
        "workOrderProjectNo": "WB20251201001",
        "workOrderStatus": "completed",
        "scoringStatus": "to_re",
        "inspectionType": "年检",
        "scorePersonList": [
          {
            "id": 2,
            "userId": 1002,
            "nickName": "李四",
            "selfScore": 8.5,
            "reviewScore": null,
            "finalScore": null,
            "isLeader": 0,
            "confirmStatus": 0
          }
        ]
      }
    ]
  }
}

3. 获取工单评分统计信息

接口地址

GET /gxt/orderScore/statistics

接口描述

获取工单评分统计信息

请求参数

参数名	类型	必填	说明
repairOrder	GxtRepairOrder	否	维修工单查询条件
workOrder	GxtWorkOrder	否	维保工单查询条件
month	String	否	月份筛选条件

响应参数

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "totalScore": 85.5,
    "maintenanceScore": 45.0,
    "repairScore": 40.5,
    "maintenanceCount": 5,
    "repairCount": 3
  }
}

4. 获取工单评分详细信息

接口地址

GET /gxt/orderScore/{orderType}/{orderId}

接口描述

获取工单评分详细信息

请求参数

参数名	类型	必填	说明
orderType	Integer	是	工单类型(1-维修工单，2-维保工单)
orderId	Long	是	工单ID

响应参数

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "id": 1,
    "workOrderProjectNo": "WX20251201001",
    "workOrderStatus": "completed",
    "scoringStatus": "to_self",
    "content": "风机齿轮箱更换",
    "maintenanceType": "A类",
    "scorePersonList": [
      {
        "id": 1,
        "userId": 1001,
        "nickName": "张三",
        "selfScore": null,
        "reviewScore": null,
        "finalScore": null,
        "isLeader": 1,
        "confirmStatus": 0
      }
    ]
  }
}

5. 保存自评信息

接口地址

PUT /gxt/orderScore/selfEvaluation

接口描述

保存自评信息

请求参数

{
  "orderType": 1,
  "id": 1,
  "workSummary": "完成了齿轮箱更换工作",
  "maintenanceType": "A类",
  "scorePersonList": [
    {
      "id": 1,
      "selfScore": 9.0
    }
  ]
}

响应参数

{
  "code": 200,
  "msg": "操作成功"
}

权限要求

@gxt:orderScore:selfEvaluation

6. 保存复评信息

接口地址

PUT /gxt/orderScore/review

接口描述

保存复评信息

请求参数

{
  "orderType": 1,
  "id": 1,
  "modifyReason": "工作质量优秀",
  "reviewScoreNum": 1,
  "scorePersonList": [
    {
      "id": 1,
      "reviewScore": 9.5
    }
  ]
}

响应参数

{
  "code": 200,
  "msg": "操作成功"
}

权限要求

@gxt:orderScore:review

7. 保存终评信息

接口地址

PUT /gxt/orderScore/finalEvaluation

接口描述

保存终评信息

请求参数

{
  "orderType": 1,
  "id": 1,
  "finalCoefficient": 1.0,
  "scorePersonList": [
    {
      "id": 1,
      "finalScore": 9.8
    }
  ]
}

响应参数

{
  "code": 200,
  "msg": "操作成功"
}

权限要求

@gxt:orderScore:finalEvaluation

8. 保存确认信息

接口地址

PUT /gxt/orderScore/confirm

接口描述

保存确认信息

请求参数

{
  "orderType": 1,
  "id": 1,
  "confirmStatus": 1,
  "feedbackReason": "",
  "scorePersonList": [
    {
      "id": 1,
      "reviewScore": 9.5
    }
  ]
}

响应参数

{
  "code": 200,
  "msg": "操作成功"
}

权限要求

@gxt:orderScore:confirm

9. 发起申诉

接口地址

PUT /gxt/orderScore/appeal

接口描述

发起申诉

请求参数

{
  "orderType": 1,
  "id": 1,
  "appealReason": "评分不合理，工作质量优秀"
}

响应参数

{
  "code": 200,
  "msg": "操作成功"
}

权限要求

@gxt:orderScore:appeal