# 服务评价相关功能

> 模块编码：evaluation
> 端侧：微信小程序
> 关联文档：01-模块划分.md（v4.0）、02-功能清单-小程序端.md（§7）、03-业务流转逻辑-小程序端.md（§7）、05-接口规范.md（§9）、06-项目技术要求.md

## 功能概览

| 项目 | 说明 |
|------|------|
| 菜单名称 | 服务评价 |
| 子菜单 | 待评价列表 / 评分留言 / 历史评价 |
| 功能编号 | MP-EV-01 ~ MP-EV-03 |
| 权限编码 | evaluation:list:* |

## 页面清单

### 页面1：待评价列表

- **页面路径**：`/pages/evaluation/pending`
- **适用角色**：报修人
- **页面元素**：
  - 待评价工单列表
  - 工单摘要信息
  - 评价入口
  - 提醒红点/数字标记
- **查询条件**：无（自动过滤待评价工单）
- **列表字段**：

| 字段 | 类型 | 说明 |
|------|------|------|
| 工单编号 | 文本 | 报修工单号 |
| 报修类型 | 标签 | 报修分类 |
| 报修描述 | 文本 | 问题描述摘要 |
| 完工时间 | 时间 | 维修完成时间 |
| 维修人员 | 文本 | 处理人姓名 |
| 评价状态 | 标签 | 待评价/已评价 |

- **界面布局**：
  - 顶部：待评价数量统计
  - 中部：工单卡片列表，每张卡片显示工单信息
  - 底部：无操作栏
- **操作按钮**：
  - 「去评价」→ 跳转评分留言页

**触发条件**：工单完工验收后，系统自动推送评价通知给报修人

**数据来源**：物业公司在Web/小程序端验收通过后，触发评价事件（ORDER_COMPLETED）

**需求追溯**：

| 功能点编号 | 功能名称 | 文档来源 | 后续服务 | 关联功能 |
|------------|----------|----------|----------|----------|
| MP-EV-01 | 待评价列表 | 02-小程序端 §7 | 评分留言 | 在线报修（验收完成后触发） |

---

### 页面2：评分留言

- **页面路径**：`/pages/evaluation/rate`
- **适用角色**：报修人
- **页面元素**：
  - 工单信息摘要卡片
  - 五分制评分组件（⭐⭐⭐⭐⭐）
  - 评分维度标签（响应速度/服务态度/维修质量/整体满意度）
  - 文字留言输入框（多行文本，最多200字）
  - 图片上传区（≤9张）
  - 匿名评价开关
  - 提交按钮
- **查询条件**：无
- **列表字段**：无
- **界面布局**：
  - 顶部：工单信息摘要
  - 中部：评分星星 + 维度标签 + 留言框 + 图片上传
  - 底部：匿名开关 + 提交按钮
- **操作按钮**：
  - 「选择评分」→ 点击星星选择1~5分
  - 「拍照」→ 调用相机拍照评价凭证
  - 「提交评价」→ 提交评价（权限：evaluation:list:create）

**评价规则**：
- 五分制评分：1分=非常不满意，2分=不满意，3分=一般，4分=满意，5分=非常满意
- 评分≤3分时触发低分评价事件（LOW_SCORE_EVALUATION），通知主管
- 提交后不可修改评价
- 评价数据写入评价模块，物业公司Web端可查看和回复

**需求追溯**：

| 功能点编号 | 功能名称 | 文档来源 | 后续服务 | 关联功能 |
|------------|----------|----------|----------|----------|
| MP-EV-02 | 评分留言 | 02-小程序端 §7 | 物业公司查看回复 | 服务评价（Web端） |

---

### 页面3：历史评价

- **页面路径**：`/pages/evaluation/history`
- **适用角色**：报修人
- **页面元素**：
  - 历史评价列表
  - 评价详情查看
  - 物业回复内容展示
- **查询条件**：
  - 评分筛选（全部/好评/中评/差评）
  - 时间筛选
- **列表字段**：

| 字段 | 类型 | 说明 |
|------|------|------|
| 工单编号 | 文本 | 报修工单号 |
| 评分 | 数字 | 1~5分 |
| 评价内容 | 文本 | 留言摘要 |
| 评价时间 | 时间 | 提交评价时间 |
| 回复状态 | 标签 | 已回复/未回复 |

- **界面布局**：
  - 顶部：筛选条件 + 统计信息
  - 中部：评价卡片列表，每张卡片显示评分、留言、回复
  - 底部：无操作栏
- **操作按钮**：
  - 「查看详情」→ 查看评价详情及物业回复

**需求追溯**：

| 功能点编号 | 功能名称 | 文档来源 | 后续服务 | 关联功能 |
|------------|----------|----------|----------|----------|
| MP-EV-03 | 历史评价 | 02-小程序端 §7 | 无 | 服务评价（Web端） |

---

## 业务规则

1. **评价触发**：工单完工验收通过后自动触发评价通知（事件：ORDER_COMPLETED）
2. **评价时效**：验收通过后7天内可评价，超期不可评价
3. **低分预警**：评分≤3分触发 LOW_SCORE_EVALUATION 事件，通知主管
4. **评价匿名**：支持匿名评价，物业公司无法看到评价人信息
5. **评价不可修改**：提交后不可修改评价内容
6. **物业回复**：物业公司可在Web端查看评价并回复，回复内容在小程序端展示
7. **图片水印**：评价图片自动添加时间水印
8. **图片数量**：单次评价最多上传9张图片
9. **评分维度**：支持多维度评分（响应速度/服务态度/维修质量/整体满意度）

## 状态流转

### 评价状态

```
待评价 → 已评价（显示物业回复）
    ↓
  超期未评价 → 关闭评价入口
```

### 事件触发

```
工单验收通过 → ORDER_COMPLETED 事件 → 触发评价通知
评价提交（≤3分）→ LOW_SCORE_EVALUATION 事件 → 通知主管
评价提交 → 评价数据写入评价模块 → 物业公司Web端可查看回复
```