# 服务评价

> 模块编码：evaluation
> 端侧：Web专属（仅医院账号）
> 关联文档：01-模块划分 §4.4 / 02-功能清单-医院 §4 / 03-业务流转逻辑-医院 §4 / 05-接口规范 §9.2

## 功能概览

| 项目 | 说明 |
|------|------|
| 菜单名称 | 服务评价 |
| 子菜单 | 发起评价、评价汇总查看、评价列表查看 |
| 功能编号 | HO-EV-01 ~ HO-EV-03 |
| 权限编码前缀 | evaluation:list:* |

> **重要**：医院账号是评价的**发起方**，物业公司是评价的**接收和回复方**。

---

## 页面1：发起评价页

**页面编号**：HO-EV-01-P01
**端侧归属**：Web专属
**页面路径**：/evaluation/create

### 界面布局

```
┌──────────────────────────────────────────────────────────────────┐
│ [面包屑] 服务评价 > 发起评价                                       │
├──────────────────────────────────────────────────────────────────┤
│ ── 评价类型 ──                                                    │
│ ○ 报修服务  ○ 巡检服务  ○ 保洁服务  ○ 综合评价                     │
├──────────────────────────────────────────────────────────────────┤
│ ── 评价对象 ──                                                    │
│ 关联物业公司：[▼]                                                 │
│ 关联服务：[▼] (选择具体工单/巡检任务/保洁任务)                      │
├──────────────────────────────────────────────────────────────────┤
│ ── 评分 ──                                                        │
│ ★★★★★  5分-非常满意                                              │
│ ★★★★☆  4分-满意                                                  │
│ ★★★☆☆  3分-一般                                                  │
│ ★★☆☆☆  2分-不满意                                                │
│ ★☆☆☆☆  1分-非常不满意                                             │
├──────────────────────────────────────────────────────────────────┤
│ ── 评价内容 ──                                                    │
│ 留言：[____________________________]                              │
│ 图片：[+点击上传] (≤5张)                                          │
├──────────────────────────────────────────────────────────────────┤
│                                         [取消]  [提交评价]        │
└──────────────────────────────────────────────────────────────────┘
```

### 表单字段

| 字段名 | 控件类型 | 必填 | 默认值 | 数据来源 | 校验规则 |
|--------|----------|------|--------|----------|----------|
| 评价类型 | 单选按钮 | 是 | — | 固定选项 | 报修/巡检/保洁/综合 |
| 关联物业公司 | 下拉单选 | 是 | — | 本医院关联物业公司 | — |
| 关联服务 | 下拉单选 | 条件 | — | 物业公司业务数据 | 非综合评价时必填 |
| 评分 | 星级选择 | 是 | — | 固定选项 | 1~5分 |
| 留言 | 多行文本 | 否 | — | 自填 | 最大500字 |
| 图片 | 图片上传 | 否 | — | 上传 | ≤5张 |

### 通知触发

| 触发操作 | 通知对象 | 通知方式 | 消息模板 | 文档来源 |
|----------|----------|----------|----------|----------|
| 低评分(≤2分) | 物业主管+管理员 | 小程序推送 | 低评分评价通知 | 03-医院 §4.1 / 03-物业公司 §6 |
| 新评价 | 物业公司 | — | 物业可查看评价 | — |

### 评分触发规则

| 评分 | 含义 | 物业端触发动作 | 文档来源 |
|------|------|----------------|----------|
| 5分 | 非常满意 | — | 03-医院 §4.1 |
| 4分 | 满意 | — | 03-医院 §4.1 |
| 3分 | 一般 | 主管关注 | 03-医院 §4.1 |
| 2分 | 不满意 | 自动通知物业主管，要求回复 | 03-医院 §4.1 |
| 1分 | 非常不满意 | 通知主管+管理员，24h内必须回复 | 03-医院 §4.1 |

### API端点

| 页面操作 | API路径 | 方法 | 说明 |
|----------|---------|------|------|
| 发起评价 | /api/v1/evaluations | POST | — |

---

## 页面2：评价汇总查看页

**页面编号**：HO-EV-02-P01
**端侧归属**：Web专属
**页面路径**：/evaluation/dashboard

### 界面布局

```
┌──────────────────────────────────────────────────────────────────┐
│ [面包屑] 服务评价 > 评价汇总                                       │
├──────────────────────────────────────────────────────────────────┤
│ [时间选择]  本月 / 本季度 / 本年 / 自定义                          │
├──────────────────────────────────────────────────────────────────┤
│ [统计卡片区]                                                       │
│ ┌──────┐ ┌──────┐ ┌──────┐                                       │
│ │总评价│ │平均分│ │待回复│                                       │
│ │  45  │ │ 4.2  │ │  3   │                                       │
│ └──────┘ └──────┘ └──────┘                                       │
├──────────────────────────────────────────────────────────────────┤
│ [图表区]                                                          │
│ ┌────────────────────────┐ ┌────────────────────────┐           │
│ │ 评分趋势（折线图）       │ │ 各物业公司评分对比（柱状图）│           │
│ └────────────────────────┘ └────────────────────────┘           │
│ ┌────────────────────────┐                                       │
│ │ 星级分布（饼图）         │                                       │
│ └────────────────────────┘                                       │
└──────────────────────────────────────────────────────────────────┘
```

### API端点

| 页面操作 | API路径 | 方法 | 说明 |
|----------|---------|------|------|
| 汇总数据 | /api/v1/evaluations/summary | GET | 本医院发起的评价汇总 |

---

## 页面3：评价列表查看页

**页面编号**：HO-EV-03-P01
**端侧归属**：Web专属
**页面路径**：/evaluation/list

### 查询条件

| 字段名 | 控件类型 | 必填 | 默认值 | 说明 |
|--------|----------|------|--------|------|
| 评价类型 | 下拉单选 | 否 | 全部 | — |
| 评分 | 下拉单选 | 否 | 全部 | — |
| 物业公司 | 下拉单选 | 否 | 全部 | — |
| 日期范围 | 日期范围 | 否 | — | — |

### 列表字段

| 序号 | 字段名 | 列宽 | 支持排序 | 说明 |
|------|--------|------|----------|------|
| 1 | 评价类型 | 90px | 否 | — |
| 2 | 关联服务 | 150px | 否 | — |
| 3 | 物业公司 | 120px | 否 | — |
| 4 | 评分 | 80px | 是 | 星级展示 |
| 5 | 评价内容 | 200px | 否 | — |
| 6 | 评价时间 | 140px | 是 | 默认倒序 |
| 7 | 回复状态 | 80px | 否 | 已回复/未回复 |
| 8 | 物业回复 | 200px | 否 | — |
| 9 | 操作 | 80px | — | 查看详情 |

### 操作按钮

| 按钮 | 权限编码 | 位置 | 显示条件 | 说明 |
|------|----------|------|----------|------|
| 查看详情 | evaluation:list:view | 行操作 | 始终 | 只读 |

### 角色差异化视图

| 角色 | 可见按钮 | 数据范围 | 备注 |
|------|----------|----------|------|
| 医院账号 | 查看 | 本医院发起的所有评价 | — |

### API端点

| 页面操作 | API路径 | 方法 | 说明 |
|----------|---------|------|------|
| 列表查询 | /api/v1/evaluations | GET | 本医院发起的评价 |
| 详情 | /api/v1/evaluations/{id} | GET | 含物业回复 |

---

## 需求追溯

| 功能点编号 | 功能名称 | 文档来源 | 后续服务 | 关联功能 |
|------------|----------|----------|----------|----------|
| HO-EV-01 | 发起评价 | 02-医院 §4 / 03-医院 §4.1 | 评价→通知物业公司 | 物业服务评价(查看/回复) |
| HO-EV-02 | 评价汇总查看 | 02-医院 §4 / 03-医院 §4.2 | — | 物业评价汇总看板(数据来源) |
| HO-EV-03 | 评价列表查看 | 02-医院 §4 / 03-医院 §4.2 | — | 物业评价列表(数据来源) |

## 业务规则

1. **医院是评价发起方**：医院账号对物业服务发起评分与留言，物业公司查看和回复（来源：01 §6.1 / 03-医院 §4）
2. **评价类型**：报修服务/巡检服务/保洁服务/综合评价（来源：03-医院 §4.1）
3. **关联服务**：评价时需选择具体的工单/巡检任务/保洁任务（综合评价除外）（来源：03-医院 §4.1）
4. **低评分通知**：2分自动通知物业主管，1分通知主管+管理员且24h内必须回复（来源：03-医院 §4.1）
5. **评价数据来源**：物业公司业务数据为只读引用，不可修改（来源：03-医院 §4.1）