|
|
# 服务评价
|
|
|
|
|
|
> 模块编码：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）
|