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.

173 lines
7.8 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.

# 服务监督
> 模块编码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