# 服务监督

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

## 功能概览

| 项目 | 说明 |
|------|------|
| 菜单名称 | 服务监督 |
| 子菜单 | 报修数据查看、巡检数据查看、保洁数据查看 |
| 功能编号 | HO-SP-01 ~ HO-SP-04 |
| 权限编码前缀 | 继承物业模块权限的只读版本 |

> **重要**：医院账号仅查看关联物业公司的日常业务数据，**只读，不可操作**。

---

## 页面1：报修数据查看页

**页面编号**：HO-SP-01-P01
**端侧归属**：Web专属
**页面路径**：/supervision/repair

### 界面布局

```
┌──────────────────────────────────────────────────────────────────┐
│ [面包屑] 服务监督 > 报修数据查看                                    │
├──────────────────────────────────────────────────────────────────┤
│ [查询条件区]                                                      │
│ 工单号[____] 状态[▼] 报修类型[▼] 紧急程度[▼]                      │
│ 提交日期[起始]~[结束]  所属班组[▼]  所属区域[▼]                    │
│                                              [查询] [重置]        │
├──────────────────────────────────────────────────────────────────┤
│ [统计卡片区]                                                       │
│ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐                             │
│ │总工单│ │待分配│ │处理中│ │已完成│                             │
│ │ 156  │ │  12  │ │  23  │ │ 108  │                             │
│ └──────┘ └──────┘ └──────┘ └──────┘                             │
├──────────────────────────────────────────────────────────────────┤
│ [列表区]                                                          │
│ 工单号 | 报修类型 | 紧急程度 | 状态 | 报修人 | 班组 | 提交时间      │
│ WX001  | 水电     | 紧急     | 待分配| 张三  | 水电班| 04-16 10:30│
├──────────────────────────────────────────────────────────────────┤
│ [分页]  共156条  每页[20▼]  < 1 2 3 ... 8 >                       │
└──────────────────────────────────────────────────────────────────┘
```

### 查询条件

| 字段名 | 控件类型 | 必填 | 默认值 | 说明 |
|--------|----------|------|--------|------|
| 工单号 | 文本输入 | 否 | — | 模糊匹配 |
| 状态 | 下拉多选 | 否 | 全部 | — |
| 报修类型 | 下拉单选 | 否 | 全部 | — |
| 紧急程度 | 下拉单选 | 否 | 全部 | — |
| 提交日期 | 日期范围 | 否 | — | — |
| 所属班组 | 下拉单选 | 否 | 全部 | — |
| 所属区域 | 级联选择 | 否 | 全部 | — |

### 列表字段

| 序号 | 字段名 | 列宽 | 支持排序 | 说明 |
|------|--------|------|----------|------|
| 1 | 工单号 | 140px | 是 | 点击查看详情(只读) |
| 2 | 报修类型 | 80px | 否 | — |
| 3 | 紧急程度 | 80px | 否 | — |
| 4 | 状态 | 90px | 是 | — |
| 5 | 报修人 | 80px | 否 | — |
| 6 | 负责班组 | 90px | 否 | — |
| 7 | 维修人员 | 80px | 否 | — |
| 8 | 提交时间 | 150px | 是 | 默认倒序 |
| 9 | 操作 | 80px | — | 查看详情(只读) |

### 操作按钮

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

### 角色差异化视图

| 角色 | 可见按钮 | 数据范围 | 备注 |
|------|----------|----------|------|
| 医院账号 | 仅查看 | 关联物业公司的全部报修数据 | 无任何操作按钮 |

### 工单详情页（只读）

- 展示与物业公司工单详情相同的信息
- 标签页：基本信息、流转记录、照片附件
- 底部无任何操作按钮

### API端点

| 页面操作 | API路径 | 方法 | 说明 |
|----------|---------|------|------|
| 列表查询 | /api/v1/repair-orders | GET | 只读，自动过滤关联物业公司 |
| 详情查询 | /api/v1/repair-orders/{id} | GET | 只读 |

---

## 页面2：巡检数据查看页

**页面编号**：HO-SP-03-P01
**端侧归属**：Web专属
**页面路径**：/supervision/inspection

### 列表字段

| 序号 | 字段名 | 列宽 | 支持排序 | 说明 |
|------|--------|------|----------|------|
| 1 | 巡检人员 | 80px | 否 | — |
| 2 | 计划名称 | 150px | 否 | — |
| 3 | 巡检区域 | 150px | 否 | — |
| 4 | 打卡时间 | 140px | 是 | — |
| 5 | 打卡方式 | 80px | 否 | 蓝牙/手动/补录 |
| 6 | 状态 | 80px | 否 | 正常/异常 |
| 7 | 异常数 | 70px | 否 | — |
| 8 | 操作 | 80px | — | 查看详情 |

### 操作按钮

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

---

## 页面3：保洁数据查看页

**页面编号**：HO-SP-04-P01
**端侧归属**：Web专属
**页面路径**：/supervision/cleaning

### 列表字段

| 序号 | 字段名 | 列宽 | 支持排序 | 说明 |
|------|--------|------|----------|------|
| 1 | 保洁人员 | 80px | 否 | — |
| 2 | 保洁区域 | 150px | 否 | — |
| 3 | 任务日期 | 100px | 是 | — |
| 4 | 打卡时间 | 140px | 否 | — |
| 5 | 打卡方式 | 80px | 否 | — |
| 6 | 完成状态 | 80px | 否 | 已完成/超时/未执行 |
| 7 | 抽查结果 | 80px | 否 | 合格/不合格/未抽查 |
| 8 | 操作 | 80px | — | 查看详情 |

### 操作按钮

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

---

## 需求追溯

| 功能点编号 | 功能名称 | 文档来源 | 后续服务 | 关联功能 |
|------------|----------|----------|----------|----------|
| HO-SP-01 | 报修数据查看 | 02-医院 §3 / 03-医院 §3.1 | — | 物业在线报修(数据来源) |
| HO-SP-02 | 工单详情查看 | 02-医院 §3 / 03-医院 §3.1 | — | 物业工单详情(数据来源) |
| HO-SP-03 | 巡检数据查看 | 02-医院 §3 / 03-医院 §3.1 | — | 物业巡检管理(数据来源) |
| HO-SP-04 | 保洁数据查看 | 02-医院 §3 / 03-医院 §3.1 | — | 物业保洁管理(数据来源) |

## 业务规则

1. **仅查看不可操作**：医院账号可查看关联物业公司的全部日常业务数据，但不能分配工单、审核补录等操作（来源：01 §4.3 / 03-医院 §3）
2. **数据来源**：物业公司日常业务录入的数据（来源：03-医院 §3.1）
3. **数据范围**：仅查看为本医院服务的物业公司的数据（来源：01 §1.3 / 03-医院 §3）
4. **支持筛选和导出**：支持时间范围、区域、状态等筛选条件，支持导出报表（只读）（来源：03-医院 §3.1）