You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

160 lines
5.4 KiB
Markdown

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# 服务评价相关功能
> 模块编码evaluation
> 端侧:微信小程序
> 关联文档01-模块划分.mdv4.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端可查看回复
```