---
name: task-rate
description: >-
  在任务全部阶段验收通过后，雇主与中标威客互评（速度/质量/态度 1–5 星）。
  Use when rating or reviewing a completed task after status=4.
---

# task-rate

## When to use

- 全部交付验收通过后给对方评价
- 用户说「评价任务 / 打分 / 互评」

## Prerequisites

- JWT
- 任务 `status=4`（待评价）
- 仅雇主或中标威客可评；不能评自己
- 同一对评价对象只能评一次

## Endpoints

Base: `/api/v1`

### `POST /tasks/{id}/rate`（需登录）

```json
{
  "to_uid": 123456,
  "comment": "可选评语",
  "speed_score": 5,
  "quality_score": 5,
  "attitude_score": 5
}
```

| 字段 | 必填 | 说明 |
|------|------|------|
| to_uid | 是 | 被评人内部 user id（雇主或中标威客） |
| speed_score | 是 | 1–5 |
| quality_score | 是 | 1–5 |
| attitude_score | 是 | 1–5 |
| comment | 否 | 文本 |

成功例: `{ "message": "评价成功", "task_status": 5 }`（双方都评完时可能更新为 5）。

## Workflow

1. `GET /tasks/{id}` 确认 `status=4` 与对方身份
2. 组装 `to_uid` 与三维度分数
3. `POST /tasks/{id}/rate`
4. 若仍 status=4，提示等待对方评价

## Errors

- 400 仅全部验收后可评价 / 已评价过 / 不能对自己评价 / 分数越界
- 403 非雇主且非中标威客
- 401 未登录
- 404 任务不存在

## Availability

- 评价接口若返回未实现或业务错误，以 HTTP 响应为准，勿伪造评价成功
