|
|
# 保洁管理
|
|
|
|
|
|
> 模块编码：cleaning
|
|
|
> 端侧：Web + 小程序（双端）
|
|
|
> 关联文档：01-模块划分 §3.3 / 02-功能清单-物业公司 §3 / 03-业务流转逻辑-物业公司 §3 / 05-接口规范 §9.2 / 06-项目技术要求 §4.4
|
|
|
|
|
|
## 功能概览
|
|
|
|
|
|
| 项目 | 说明 |
|
|
|
|------|------|
|
|
|
| 菜单名称 | 保洁管理 |
|
|
|
| 子菜单 | 保洁区域管理、保洁任务看板、人员排班、蓝牙点位管理、超时预警、保洁抽查、数据补录 |
|
|
|
| 功能编号 | PR-C-01 ~ PR-C-08 |
|
|
|
| 权限编码前缀 | cleaning:area:* / cleaning:task:* / cleaning:schedule:* / cleaning:spot-check:* / cleaning:supplement:* |
|
|
|
|
|
|
---
|
|
|
|
|
|
## 页面1：保洁区域管理页
|
|
|
|
|
|
**页面编号**：PR-C-01-P01
|
|
|
**端侧归属**：Web专属
|
|
|
**页面路径**：/cleaning/areas
|
|
|
|
|
|
### 界面布局
|
|
|
|
|
|
```
|
|
|
┌──────────────────────────────────────────────────────────────────┐
|
|
|
│ [面包屑] 保洁管理 > 保洁区域管理 │
|
|
|
├──────────────────────────────────────────────────────────────────┤
|
|
|
│ [操作栏] [新增区域] │
|
|
|
├──────────────────────────────────────────────────────────────────┤
|
|
|
│ [树形+列表] │
|
|
|
│ ┌──────────────┐ ┌──────────────────────────────────────────┐ │
|
|
|
│ │ 主院区(项目) │ │ 区域：主院区 > 门诊楼 > 3层 > 公共区域 │ │
|
|
|
│ │ ├ 门诊楼 │ │ 区域责任人：张三 │ │
|
|
|
│ │ │ ├ 1层 │ │ 蓝牙Beacon：B-010 (在线) │ │
|
|
|
│ │ │ │ ├ 大厅 │ │ 当前排班：早班(06:00-14:00) │ │
|
|
|
│ │ │ │ └ 走廊 │ │ [编辑] [删除]│ │
|
|
|
│ │ │ ├ 2层 │ └──────────────────────────────────────────┘ │
|
|
|
│ │ │ └ 3层 │ │
|
|
|
│ │ └ 住院楼 │ │
|
|
|
│ └──────────────┘ │
|
|
|
└──────────────────────────────────────────────────────────────────┘
|
|
|
```
|
|
|
|
|
|
### 五级架构
|
|
|
|
|
|
| 层级 | 说明 | 示例 |
|
|
|
|------|------|------|
|
|
|
| 项目 | 最顶层 | 主院区 |
|
|
|
| 区域 | 建筑分区 | 门诊楼 |
|
|
|
| 楼栋 | 单独楼 | 1号楼 |
|
|
|
| 楼层 | 楼层 | 3层 |
|
|
|
| 区域责任人 | 最末级+负责人 | 公共区域(张三) |
|
|
|
|
|
|
### 操作按钮
|
|
|
|
|
|
| 按钮 | 权限编码 | 位置 | 显示条件 | 说明 |
|
|
|
|------|----------|------|----------|------|
|
|
|
| 新增区域 | cleaning:area:create | 操作栏 | 始终 | 弹窗 |
|
|
|
| 编辑 | cleaning:area:update | 详情区 | 始终 | — |
|
|
|
| 删除 | cleaning:area:delete | 详情区 | 无排班关联时 | 二次确认 |
|
|
|
|
|
|
### 表单字段（新增/编辑弹窗）
|
|
|
|
|
|
| 字段名 | 控件类型 | 必填 | 默认值 | 数据来源 | 校验规则 |
|
|
|
|--------|----------|------|--------|----------|----------|
|
|
|
| 区域名称 | 文本输入 | 是 | — | 自填 | 最大30字 |
|
|
|
| 上级区域 | 级联选择 | 是 | — | 区域树 | — |
|
|
|
| 区域责任人 | 下拉单选 | 是 | — | 组织架构-人员 | — |
|
|
|
| 蓝牙Beacon | 下拉单选 | 是 | — | 蓝牙设备管理 | — |
|
|
|
| 保洁清单 | 下拉多选 | 是 | — | 保洁清单模板 | 至少选一个 |
|
|
|
|
|
|
### API端点
|
|
|
|
|
|
| 页面操作 | API路径 | 方法 | 说明 |
|
|
|
|----------|---------|------|------|
|
|
|
| 区域树 | /api/v1/cleaning-areas/tree | GET | 五级树形结构 |
|
|
|
| 新增 | /api/v1/cleaning-areas | POST | — |
|
|
|
| 编辑 | /api/v1/cleaning-areas/{id} | PUT | — |
|
|
|
| 删除 | /api/v1/cleaning-areas/{id} | DELETE | — |
|
|
|
|
|
|
---
|
|
|
|
|
|
## 页面2：保洁任务看板页
|
|
|
|
|
|
**页面编号**：PR-C-02-P01
|
|
|
**端侧归属**：Web专属
|
|
|
**页面路径**：/cleaning/tasks
|
|
|
|
|
|
### 界面布局
|
|
|
|
|
|
```
|
|
|
┌──────────────────────────────────────────────────────────────────┐
|
|
|
│ [面包屑] 保洁管理 > 保洁任务看板 │
|
|
|
├──────────────────────────────────────────────────────────────────┤
|
|
|
│ [看板视图] │
|
|
|
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
|
|
|
│ │ 待执行(5) │ │ 执行中(3) │ │ 已完成(12)│ │
|
|
|
│ │ ┌──────┐ │ │ ┌──────┐ │ │ ┌──────┐ │ │
|
|
|
│ │ │门诊1层│ │ │ │门诊3层│ │ │ │门诊2层│ │ │
|
|
|
│ │ │张三 │ │ │ │李四 │ │ │ │王五 │ │ │
|
|
|
│ │ │06:00 │ │ │ │06:15 │ │ │ │07:00 │ │ │
|
|
|
│ │ └──────┘ │ │ └──────┘ │ │ └──────┘ │ │
|
|
|
│ └──────────┘ └──────────┘ └──────────┘ │
|
|
|
├──────────────────────────────────────────────────────────────────┤
|
|
|
│ [查询条件区] │
|
|
|
│ 日期[____] 班组[▼] 人员[____] 状态[▼] [查询] [重置] │
|
|
|
└──────────────────────────────────────────────────────────────────┘
|
|
|
```
|
|
|
|
|
|
### 查询条件
|
|
|
|
|
|
| 字段名 | 控件类型 | 必填 | 默认值 | 说明 |
|
|
|
|--------|----------|------|--------|------|
|
|
|
| 日期 | 日期选择 | 否 | 今天 | — |
|
|
|
| 班组 | 下拉单选 | 否 | 全部 | — |
|
|
|
| 人员 | 文本输入 | 否 | — | 模糊匹配 |
|
|
|
| 状态 | 下拉单选 | 否 | 全部 | 待执行/执行中/已完成/超时 |
|
|
|
|
|
|
### 操作按钮
|
|
|
|
|
|
| 按钮 | 权限编码 | 位置 | 显示条件 | 说明 |
|
|
|
|------|----------|------|----------|------|
|
|
|
| 查看详情 | cleaning:task:view | 卡片/行操作 | 始终 | 跳转任务详情 |
|
|
|
|
|
|
### API端点
|
|
|
|
|
|
| 页面操作 | API路径 | 方法 | 说明 |
|
|
|
|----------|---------|------|------|
|
|
|
| 任务列表 | /api/v1/cleaning-tasks | GET | 分页查询+看板数据 |
|
|
|
|
|
|
---
|
|
|
|
|
|
## 页面3：人员排班页
|
|
|
|
|
|
**页面编号**：PR-C-03-P01
|
|
|
**端侧归属**：Web专属
|
|
|
**页面路径**：/cleaning/schedules
|
|
|
|
|
|
### 界面布局
|
|
|
|
|
|
```
|
|
|
┌──────────────────────────────────────────────────────────────────┐
|
|
|
│ [面包屑] 保洁管理 > 人员排班 │
|
|
|
├──────────────────────────────────────────────────────────────────┤
|
|
|
│ [视图切换] 📅周视图 📆月视图 [◀ 本周 ▶] [复制上周排班] │
|
|
|
├──────────────────────────────────────────────────────────────────┤
|
|
|
│ [周视图] │
|
|
|
│ 区域/人员 | 周一 | 周二 | 周三 | ... | 周日 │
|
|
|
│ 门诊1层大厅 | 张三早班| 张三早班| 李四早班| ... | 张三早班 │
|
|
|
│ 门诊2层走廊 | 王五早班| 王五早班| 王五早班| ... | — │
|
|
|
│ 住院1层 | 李四晚班| 李四晚班| — | ... | 李四晚班 │
|
|
|
├──────────────────────────────────────────────────────────────────┤
|
|
|
│ [操作] [保存排班] [清空本周] [导出排班表] │
|
|
|
└──────────────────────────────────────────────────────────────────┘
|
|
|
```
|
|
|
|
|
|
### 操作按钮
|
|
|
|
|
|
| 按钮 | 权限编码 | 位置 | 显示条件 | 说明 |
|
|
|
|------|----------|------|----------|------|
|
|
|
| 复制上周排班 | cleaning:schedule:create | 操作栏 | 始终 | 一键复制上周排班到本周 |
|
|
|
| 保存排班 | cleaning:schedule:update | 操作栏 | 始终 | — |
|
|
|
| 清空本周 | cleaning:schedule:delete | 操作栏 | 始终 | 二次确认 |
|
|
|
| 导出排班表 | cleaning:schedule:export | 操作栏 | 始终 | 导出Excel |
|
|
|
|
|
|
### 表单字段（排班编辑弹窗）
|
|
|
|
|
|
| 字段名 | 控件类型 | 必填 | 默认值 | 数据来源 | 校验规则 |
|
|
|
|--------|----------|------|--------|----------|----------|
|
|
|
| 保洁人员 | 下拉单选 | 是 | — | 组织架构-保洁人员 | — |
|
|
|
| 班次 | 下拉单选 | 是 | — | 字典管理-班次 | 早班/晚班/全天 |
|
|
|
| 时间范围 | 时间范围 | 是 | — | 自填 | — |
|
|
|
|
|
|
### API端点
|
|
|
|
|
|
| 页面操作 | API路径 | 方法 | 说明 |
|
|
|
|----------|---------|------|------|
|
|
|
| 排班查询 | /api/v1/cleaning-schedules | GET | 按周/月查询 |
|
|
|
| 保存排班 | /api/v1/cleaning-schedules/batch | POST | 批量保存 |
|
|
|
| 复制排班 | /api/v1/cleaning-schedules/copy | POST | 从指定周复制 |
|
|
|
| 导出 | /api/v1/cleaning-schedules/export | GET | 导出Excel |
|
|
|
|
|
|
---
|
|
|
|
|
|
## 页面4：蓝牙点位管理页
|
|
|
|
|
|
**页面编号**：PR-C-04-P01
|
|
|
**端侧归属**：Web专属
|
|
|
**页面路径**：/cleaning/beacon-points
|
|
|
|
|
|
### 查询条件
|
|
|
|
|
|
| 字段名 | 控件类型 | 必填 | 默认值 | 说明 |
|
|
|
|--------|----------|------|--------|------|
|
|
|
| 区域 | 级联选择 | 否 | 全部 | — |
|
|
|
| Beacon状态 | 下拉单选 | 否 | 全部 | 在线/离线 |
|
|
|
| 电量 | 下拉单选 | 否 | 全部 | 正常/低电量 |
|
|
|
|
|
|
### 列表字段
|
|
|
|
|
|
| 序号 | 字段名 | 列宽 | 支持排序 | 说明 |
|
|
|
|------|--------|------|----------|------|
|
|
|
| 1 | Beacon名称 | 120px | 否 | — |
|
|
|
| 2 | UUID | 180px | 否 | — |
|
|
|
| 3 | 绑定区域 | 150px | 否 | — |
|
|
|
| 4 | 状态 | 80px | 是 | 在线(绿)/离线(红) |
|
|
|
| 5 | 电量 | 80px | 是 | <20%=红色低电量 |
|
|
|
| 6 | 最后心跳 | 140px | 是 | 超过15分钟=离线 |
|
|
|
| 7 | 操作 | 100px | — | 编辑绑定/解绑 |
|
|
|
|
|
|
### 操作按钮
|
|
|
|
|
|
| 按钮 | 权限编码 | 位置 | 显示条件 | 说明 |
|
|
|
|------|----------|------|----------|------|
|
|
|
| 编辑绑定 | cleaning:area:update | 行操作 | 始终 | 绑定/更换区域 |
|
|
|
| 解绑 | cleaning:area:update | 行操作 | 已绑定 | 二次确认 |
|
|
|
|
|
|
### 通知触发
|
|
|
|
|
|
| 触发操作 | 通知对象 | 通知方式 | 消息模板 | 文档来源 |
|
|
|
|----------|----------|----------|----------|----------|
|
|
|
| Beacon离线 | 物业管理员 | 系统内通知 | Beacon离线预警 | 05 §5.2 (BEACON_OFFLINE) |
|
|
|
| Beacon低电量 | 物业管理员 | 系统内通知 | Beacon低电量预警 | 05 §5.2 (BEACON_LOW_BATTERY) |
|
|
|
|
|
|
### API端点
|
|
|
|
|
|
| 页面操作 | API路径 | 方法 | 说明 |
|
|
|
|----------|---------|------|------|
|
|
|
| 列表查询 | /api/v1/cleaning-beacon-points | GET | — |
|
|
|
| 绑定 | /api/v1/cleaning-beacon-points/{id}/bind | PUT | 绑定区域 |
|
|
|
| 解绑 | /api/v1/cleaning-beacon-points/{id}/unbind | PUT | — |
|
|
|
|
|
|
---
|
|
|
|
|
|
## 页面5：超时预警页
|
|
|
|
|
|
**页面编号**：PR-C-05-P01
|
|
|
**端侧归属**：Web专属
|
|
|
**页面路径**：/cleaning/timeouts
|
|
|
|
|
|
### 列表字段
|
|
|
|
|
|
| 序号 | 字段名 | 列宽 | 支持排序 | 说明 |
|
|
|
|------|--------|------|----------|------|
|
|
|
| 1 | 任务区域 | 150px | 否 | — |
|
|
|
| 2 | 保洁人员 | 80px | 否 | — |
|
|
|
| 3 | 计划完成时间 | 140px | 是 | — |
|
|
|
| 4 | 超时时长 | 80px | 是 | 红色标记 |
|
|
|
| 5 | 当前状态 | 100px | 否 | 超时未开始/超时未完成 |
|
|
|
| 6 | 操作 | 100px | — | 催办/查看 |
|
|
|
|
|
|
### 通知触发
|
|
|
|
|
|
| 触发操作 | 通知对象 | 通知方式 | 消息模板 | 文档来源 |
|
|
|
|----------|----------|----------|----------|----------|
|
|
|
| 任务超时 | 物业主管 | 小程序推送 | 保洁超时预警 | 01 §7.1 / 05 §5.2 (CLEANING_TIMEOUT) |
|
|
|
|
|
|
### API端点
|
|
|
|
|
|
| 页面操作 | API路径 | 方法 | 说明 |
|
|
|
|----------|---------|------|------|
|
|
|
| 超时列表 | /api/v1/cleaning-tasks/timeouts | GET | 仅显示超时任务 |
|
|
|
|
|
|
---
|
|
|
|
|
|
## 页面6：保洁抽查页
|
|
|
|
|
|
**页面编号**：PR-C-06-P01
|
|
|
**端侧归属**：Web专属
|
|
|
**页面路径**：/cleaning/spot-checks
|
|
|
|
|
|
### 查询条件
|
|
|
|
|
|
| 字段名 | 控件类型 | 必填 | 默认值 | 说明 |
|
|
|
|--------|----------|------|--------|------|
|
|
|
| 抽查结果 | 下拉单选 | 否 | 全部 | 合格/不合格 |
|
|
|
| 抽查人 | 文本输入 | 否 | — | 模糊匹配 |
|
|
|
| 日期范围 | 日期范围 | 否 | — | — |
|
|
|
|
|
|
### 列表字段
|
|
|
|
|
|
| 序号 | 字段名 | 列宽 | 支持排序 | 说明 |
|
|
|
|------|--------|------|----------|------|
|
|
|
| 1 | 任务区域 | 150px | 否 | — |
|
|
|
| 2 | 保洁人员 | 80px | 否 | — |
|
|
|
| 3 | 抽查人 | 80px | 否 | 主管名称 |
|
|
|
| 4 | 抽查时间 | 140px | 是 | 默认倒序 |
|
|
|
| 5 | 抽查结果 | 80px | 否 | 合格(绿)/不合格(红) |
|
|
|
| 6 | 不合格原因 | 150px | 否 | — |
|
|
|
| 7 | 操作 | 100px | — | 标记抽查 |
|
|
|
|
|
|
### 操作按钮
|
|
|
|
|
|
| 按钮 | 权限编码 | 位置 | 显示条件 | 说明 |
|
|
|
|------|----------|------|----------|------|
|
|
|
| 标记抽查 | cleaning:spot-check:approve | 操作栏 | 始终 | 弹窗选择合格/不合格 |
|
|
|
| 不合格→重新生成 | cleaning:spot-check:approve | 行操作 | 结果=不合格 | 重新生成该区域保洁任务 |
|
|
|
|
|
|
### API端点
|
|
|
|
|
|
| 页面操作 | API路径 | 方法 | 说明 |
|
|
|
|----------|---------|------|------|
|
|
|
| 抽查列表 | /api/v1/cleaning-spot-checks | GET | — |
|
|
|
| 标记抽查 | /api/v1/cleaning-spot-checks | POST | — |
|
|
|
|
|
|
---
|
|
|
|
|
|
## 页面7：数据补录与补录审核页
|
|
|
|
|
|
**页面编号**：PR-C-07-P01 / PR-C-08-P01
|
|
|
**端侧归属**：Web专属
|
|
|
**页面路径**：/cleaning/supplement
|
|
|
|
|
|
### 补录数据标记规范
|
|
|
|
|
|
| 标记项 | 说明 |
|
|
|
|--------|------|
|
|
|
| is_supplement | true |
|
|
|
| supplement_reason | 蓝牙故障/系统异常/定位失败/其他 |
|
|
|
| supplement_audit_status | 待审核/通过/驳回 |
|
|
|
| 统计排除 | 补录数据在统计中单独标记 |
|
|
|
|
|
|
### 操作按钮
|
|
|
|
|
|
| 按钮 | 权限编码 | 位置 | 显示条件 | 说明 |
|
|
|
|------|----------|------|----------|------|
|
|
|
| 审核 | cleaning:supplement:approve | 行操作 | 审核状态=待审核 | 通过/驳回 |
|
|
|
|
|
|
---
|
|
|
|
|
|
## 需求追溯
|
|
|
|
|
|
| 功能点编号 | 功能名称 | 文档来源 | 后续服务 | 关联功能 |
|
|
|
|------------|----------|----------|----------|----------|
|
|
|
| PR-C-01 | 保洁区域管理 | 02-物业公司 §3 / 03-物业公司 §3 | 五级架构→排班→任务生成 | 巡检区域管理(复用架构) |
|
|
|
| PR-C-02 | 保洁任务看板 | 02-物业公司 §3 / 03-物业公司 §3 | — | 小程序端今日保洁(MP-CL-01) |
|
|
|
| PR-C-03 | 人员排班 | 02-物业公司 §3 / 03-物业公司 §3 | 排班→自动生成每日任务 | 组织架构→人员管理 |
|
|
|
| PR-C-04 | 蓝牙点位管理 | 02-物业公司 §3 | 区域→Beacon绑定 | 系统配置→蓝牙设备管理 |
|
|
|
| PR-C-05 | 超时预警 | 02-物业公司 §3 / 03-物业公司 §3 | 超时→推送主管 | 通知机制 |
|
|
|
| PR-C-06 | 保洁抽查 | 02-物业公司 §3 / 03-物业公司 §3 | 不合格→重新生成任务 | 小程序端抽查标记(MP-CL-05) |
|
|
|
| PR-C-07 | 数据补录 | 02-物业公司 §3 / 03-物业公司 §2.2 | 补录→审核 | 小程序端异常数据补录(MP-CL-07) |
|
|
|
| PR-C-08 | 补录审核 | 02-物业公司 §3 / 03-物业公司 §2.2 | 审核→通知补录人 | 操作日志→补录日志 |
|
|
|
|
|
|
## 业务规则
|
|
|
|
|
|
1. **五级架构**：项目→区域→楼栋→楼层→区域责任人，最末级必须指定责任人（来源：02-物业公司 PR-C-01）
|
|
|
2. **排班自动生成任务**：根据排班数据自动生成每日保洁任务（来源：03-物业公司 §3）
|
|
|
3. **蓝牙打卡确认**：策略=REQUIRED时必须连接Beacon后才可确认完成，失败进入补录模式（来源：06 §4.4）
|
|
|
4. **蓝牙双模式**：策略=OPTIONAL时允许手动打卡(check_type=MANUAL)（来源：06 §4.4）
|
|
|
5. **超时预警**：任务超过计划完成时间未完成，系统自动预警推送主管（来源：02-物业公司 PR-C-05 / 03-物业公司 §3）
|
|
|
6. **抽查不合格**：主管标记不合格后，系统自动重新生成该区域保洁任务（来源：03-物业公司 §3）
|
|
|
7. **补录流程**：与巡检一致，补录需主管审核（来源：03-物业公司 §2.2）
|