# 工单评分管理接口说明

## 1. 查询工单评分列表

### 接口地址
GET /gxt/orderScore/list

### 接口描述
查询合并的维修工单和维保工单列表

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

### 响应参数
```json
{
  "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 | 否 | 评分状态 |

### 响应参数
```json
{
  "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 | 否 | 月份筛选条件 |

### 响应参数
```json
{
  "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 |

### 响应参数
```json
{
  "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

### 接口描述
保存自评信息

### 请求参数
```json
{
  "orderType": 1,
  "id": 1,
  "workSummary": "完成了齿轮箱更换工作",
  "maintenanceType": "A类",
  "scorePersonList": [
    {
      "id": 1,
      "selfScore": 9.0
    }
  ]
}
```

### 响应参数
```json
{
  "code": 200,
  "msg": "操作成功"
}
```

### 权限要求
@gxt:orderScore:selfEvaluation

## 6. 保存复评信息

### 接口地址
PUT /gxt/orderScore/review

### 接口描述
保存复评信息

### 请求参数
```json
{
  "orderType": 1,
  "id": 1,
  "modifyReason": "工作质量优秀",
  "reviewScoreNum": 1,
  "scorePersonList": [
    {
      "id": 1,
      "reviewScore": 9.5
    }
  ]
}
```

### 响应参数
```json
{
  "code": 200,
  "msg": "操作成功"
}
```

### 权限要求
@gxt:orderScore:review

## 7. 保存终评信息

### 接口地址
PUT /gxt/orderScore/finalEvaluation

### 接口描述
保存终评信息

### 请求参数
```json
{
  "orderType": 1,
  "id": 1,
  "finalCoefficient": 1.0,
  "scorePersonList": [
    {
      "id": 1,
      "finalScore": 9.8
    }
  ]
}
```

### 响应参数
```json
{
  "code": 200,
  "msg": "操作成功"
}
```

### 权限要求
@gxt:orderScore:finalEvaluation

## 8. 保存确认信息

### 接口地址
PUT /gxt/orderScore/confirm

### 接口描述
保存确认信息

### 请求参数
```json
{
  "orderType": 1,
  "id": 1,
  "confirmStatus": 1,
  "feedbackReason": "",
  "scorePersonList": [
    {
      "id": 1,
      "reviewScore": 9.5
    }
  ]
}
```

### 响应参数
```json
{
  "code": 200,
  "msg": "操作成功"
}
```

### 权限要求
@gxt:orderScore:confirm

## 9. 发起申诉

### 接口地址
PUT /gxt/orderScore/appeal

### 接口描述
发起申诉

### 请求参数
```json
{
  "orderType": 1,
  "id": 1,
  "appealReason": "评分不合理，工作质量优秀"
}
```

### 响应参数
```json
{
  "code": 200,
  "msg": "操作成功"
}
```

### 权限要求
@gxt:orderScore:appeal
