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.
houqin-java/docs/03-业务流转逻辑-物业公司.md

364 lines
14 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.

# 物业公司 — 业务流转逻辑
> 版本v4.0
> 物业公司管理员负责绑定医院的日常业务管理,可创建下属人员账号并分配角色。
> 端侧Web端 + 微信小程序端(小程序端交互详见 `03-业务流转逻辑-小程序端.md`
> 关联文档:`01-模块划分.md`v4.0)、`02-功能清单-物业公司.md`
---
## 1. 在线报修 — 工单流转
### 1.1 工单状态流转图
```
报修提交 ──▶ 待分配 ──▶ 处理中 ──▶ 待验收 ──▶ 已完成
│ │ │
▼ ▼ ▼
已关闭 延期中 退单/返修
(待审批)
延期审批
通过/驳回
```
### 1.2 工单流转规则
| 当前状态 | 操作 | 目标状态 | 执行角色 | 端侧 | 说明 |
|----------|------|----------|----------|------|------|
| — | 提交报修 | 待分配 | 报修人 | 小程序 | 自动生成工单号,**数据来源:小程序端报修提交** |
| 待分配 | 分配工单 | 处理中 | 物业(主管)/系统 | Web+小程序 | 手动或自动 |
| 待分配 | 关闭工单 | 已关闭 | 物业(主管) | Web+小程序 | 无效报修 |
| 处理中 | 提交完工 | 待验收 | 维修人员 | 小程序 | 上传照片和说明,**数据来源:小程序端完工提交** |
| 处理中 | 申请延期 | 延期中 | 维修人员 | 小程序 | 填写原因和时间,**数据来源:小程序端延期申请** |
| 处理中 | 申请协助 | 处理中 | 维修人员 | 小程序 | 生成协助子工单,**数据来源:小程序端协助申请** |
| 延期中 | 审批通过 | 处理中 | 物业(主管) | Web+小程序 | 延长时限 |
| 延期中 | 审批驳回 | 处理中 | 物业(主管) | Web+小程序 | 须按时完成 |
| 待验收 | 验收通过 | 已完成 | 物业(主管/报修人) | Web+小程序 | 触发评价(**数据来源:医院发起评价,见医院端评价流程** |
| 待验收 | 验收不通过 | 处理中 | 物业(主管/报修人) | Web+小程序 | 退回返修 |
| 已完成 | 评价 | 已完成 | 报修人 | 小程序 | 五分制+留言 |
> **医院账号:** 仅查看工单数据(数据来源:物业公司的报修数据),不可操作。
> **每次操作自动记录操作日志。**
---
## 2. 巡检管理 — 任务流转
### 2.1 巡检计划与执行流程
```
物业管理员创建巡检计划Web端
配置:区域、设备、频次、人员
系统按计划自动生成每日巡检任务
巡检人员执行(小程序端,详见小程序端流程)
┌─── 正常完成 ──────────────────┐
│ 打卡+逐项检查 → 记录巡检结果 │
│ 数据来源:小程序端巡检打卡 │
└────────────────────────────────┘
┌─── 异常上报 ──────────────────┐
│ 拍照上传+标记严重等级 │
│ 可一键生成报修工单 │
│ → 触发报修流程见1.2
│ 数据来源:小程序端异常上报 │
└────────────────────────────────┘
物业管理员查看巡检记录Web端
异常跟踪 → 查看关联报修工单进度
```
### 2.2 异常数据补录流程
```
蓝牙失灵/定位失败/系统宕机(小程序端触发)
员工选择"补录模式"(小程序端操作)
选择补录原因(蓝牙故障/手机异常/系统异常/其他)
手动填写巡检记录(时间、位置、检查项)
提交补录申请 → 标记为"补录" → 记录操作日志
**数据来源:小程序端补录提交**
主管审核Web+小程序均可)
┌─审核通过─┐ ┌─审核驳回─┐
补录记录生效 通知员工重新执行
记录审核日志 记录审核日志
```
### 2.3 补录数据标记规则
| 字段 | 值 | 说明 |
|------|------|------|
| is_supplement | true | 是否补录数据 |
| supplement_reason | 枚举值 | 蓝牙故障/系统异常/定位失败/其他 |
| supplement_remark | 文本 | 补录详细说明 |
| supplement_audit_status | 枚举值 | 待审核/通过/驳回 |
| supplement_auditor | 人员ID | 审核人 |
| supplement_audit_time | 时间 | 审核时间 |
---
## 3. 保洁管理 — 任务流转
```
物业管理员配置保洁区域Web端
五级架构:项目→区域→楼栋→楼层→区域责任人
配置人员排班 + 蓝牙点位
系统按排班自动生成每日保洁任务
保洁人员执行(小程序端,详见小程序端流程)
┌─── 正常完成 ──────────────────────────┐
│ 蓝牙打卡确认+完成保洁清单+上传照片 │
│ 数据来源:小程序端保洁打卡 │
└────────────────────────────────────────┘
┌─── 超时未完成 ────────────────────────┐
│ 系统自动预警 → 推送主管(小程序推送) │
└────────────────────────────────────────┘
主管抽查Web+小程序)
┌─合格─┐ ┌─不合格─┐
任务完成 重新生成任务
```
> 保洁异常数据补录流程与巡检一致见2.2),补录数据来源为小程序端补录提交。
---
## 4. 组织架构 — 下属账号管理流程
```
物业管理员进入"下属管理"
点击"新增下属"
填写基本信息:姓名、手机号、所属班组
选择角色(数据来源:超级管理员定义的角色列表)
┌── 是否需要自定义权限?──┐
│ │
NO YES
│ │
直接创建 进入权限覆盖界面
│ │
下属账号创建完成 在角色权限基础上调整(四级树形)
保存自定义权限
下属账号创建完成
记录操作日志和权限审计日志
```
> **说明:** 物业下属人员不单独设有效期,随物业公司管理员账号到期而自动失效。
---
## 5. 考勤打卡 — 管理流程
```
物业管理员配置打卡规则Web端
┌─── 打卡点管理 ──────────────────────────┐
│ 按班组/角色设置不同上下班打卡点 │
│ 绑定蓝牙Beacon数据来源系统配置-蓝牙设备) │
└──────────────────────────────────────────┘
┌─── 打卡规则 ────────────────────────────┐
│ 设置上班/下班时间窗口 │
│ 设置迟到/早退规则(可自定义) │
└──────────────────────────────────────────┘
员工打卡(小程序端操作,详见小程序端流程)
物业管理员查看考勤记录Web端
┌─── 异常审核 ──────────────────────────┐
│ 员工提交的打卡异常申诉(数据来源:小程序端) │
│ 主管审核通过 → 系统自动补录打卡记录 │
│ 主管审核驳回 → 通知员工 │
└──────────────────────────────────────────┘
┌─── 数据补录 ──────────────────────────┐
│ 对因系统/蓝牙异常导致的考勤缺失进行补录 │
│ 标注补录标记和原因 │
└──────────────────────────────────────────┘
```
---
## 6. 服务评价 — 查看与回复流程
```
服务完成(工单/巡检/保洁)
医院账号发起评价数据来源医院端评价流程详见03-业务流转逻辑-医院.md
┌─── 评价通知 ──────────────────────────┐
│ 低评分≤2分→ 自动通知主管+物业管理员 │
│ 2分 → 要求回复 │
│ 1分 → 24h内必须回复 │
└──────────────────────────────────────────┘
物业管理员/主管查看评价Web端
评价回复 → 通知评价人(数据来源:医院账号的评价)
评价汇总看板 → 各模块平均评分、星级分布、评分趋势
**数据来源:医院账号发起的评价数据**
```
| 评分 | 含义 | 物业端触发动作 |
|------|------|----------------|
| 5分 | 非常满意 | — |
| 4分 | 满意 | — |
| 3分 | 一般 | 主管关注 |
| 2分 | 不满意 | 自动通知主管,要求回复 |
| 1分 | 非常不满意 | 通知主管+物业管理员24h内必须回复 |
---
## 7. 统计报表 — 查询与导出流程
```
物业管理员进入统计报表模块
选择报表类型(报修/巡检/保洁/评价/考勤/综合看板/自定义)
选择时间维度(天/周/月/年/自定义)
选择筛选条件(区域/班组/人员/状态等,可自定义组合)
生成报表 → 展示图表+数据表格
**数据来源:本系统各业务模块数据**
导出Excel/PDF → 记录导出操作日志
```
---
## 8. 操作日志 — 记录与展示流程
### 8.1 日志记录范围
| 模块 | 记录的操作 |
|------|-----------|
| 在线报修 | 工单提交/分配/流转/延期/协助/验收 |
| 巡检管理 | 计划创建/打卡/异常上报/补录/补录审核 |
| 保洁管理 | 任务生成/打卡/抽查/补录/补录审核 |
| 考勤打卡 | 打卡/异常申诉/异常审核 |
| 服务评价 | 评价查看/回复 |
| 组织架构 | 下属账号创建/角色分配/权限覆盖 |
| 系统配置 | 蓝牙/字典/微信/消息模板配置变更 |
### 8.2 日志展示形式
**时间轴视图:**
```
┃ 2026-04-16 10:30:25 张三 提交了报修工单 #WX20260416001
┃ 2026-04-16 10:15:10 李四 审批通过了延期申请 #DQ20260416003
┃ 2026-04-16 09:45:00 王五 完成了巡检打卡 门诊楼1层
┃ 2026-04-16 09:00:12 赵六 上班打卡 1号楼大厅
```
**列表视图:**
| 时间 | 操作人 | 模块 | 操作类型 | 操作内容 | 详情 |
|------|--------|------|----------|----------|------|
| 10:30:25 | 张三 | 报修 | 新增 | 提交工单 #WX... | 查看 |
| 10:15:10 | 李四 | 报修 | 审批 | 延期审批通过 #DQ... | 查看 |
| 09:45:00 | 王五 | 巡检 | 查看 | 巡检打卡 门诊楼1层 | 查看 |
**日志详情(点击"查看"展开):**
```
操作人:张三(水电维修班)
操作时间2026-04-16 10:30:25
操作IP192.168.1.100
操作模块:在线报修 → 工单列表 → 工单管理 → 新增
操作内容:提交报修工单 #WX20260416001
变更前数据:(无,新增操作)
变更后数据:{ "id": "WX20260416001", "type": "水电", ... }
请求参数:{ "type": "水电", "description": "3楼灯管不亮", ... }
响应状态:成功
```
---
## 9. 系统配置管理流程
### 9.1 蓝牙设备管理
```
物业管理员进入"蓝牙设备管理"
Beacon列表数据来源系统已注册的蓝牙设备
位置绑定 → 将Beacon绑定到具体巡检点位/保洁区域/打卡点
状态监控 → 在线/离线状态实时展示
电量预警 → Beacon电量低于阈值时预警提醒
```
### 9.2 字典管理
```
物业管理员进入"字典管理"
按模块维护字典数据:
├── 报修类型(水电/木工/空调/其他...
├── 巡检类型(日常/专项/夜间...
├── 保洁类型(日常保洁/深度清洁/专项...
└── 自定义字典
字典数据仅对本物业公司(租户)可见
```
### 9.3 消息模板管理
```
物业管理员进入"消息模板"
配置微信模板消息:
├── 新工单通知模板
├── 催单通知模板
├── 审批待办通知模板
└── 其他自定义模板
支持自定义模板变量(工单号、人员姓名、时间等)
消息发送记录可查询
```
---
## 10. 异常场景处理汇总
| 场景 | 处理方式 | 补录要求 | 日志记录 |
|------|----------|----------|----------|
| 巡检蓝牙无信号(策略=REQUIRED | 进入补录模式 | 填写原因,手动提交,主管审核 | 记录补录日志 |
| 巡检蓝牙无信号(策略=OPTIONAL | 允许手动打卡 | check_type=MANUAL无需补录 | 记录手动打卡日志 |
| 保洁蓝牙无信号(策略=REQUIRED | 进入补录模式 | 填写原因,手动提交,主管审核 | 记录补录日志 |
| 保洁蓝牙无信号(策略=OPTIONAL | 允许手动打卡 | check_type=MANUAL无需补录 | 记录手动打卡日志 |
| 考勤蓝牙无信号(策略=REQUIRED | 提交异常申诉 | 填写原因,主管审核 | 记录申诉日志 |
| 考勤蓝牙无信号(策略=OPTIONAL | 允许手动打卡 | check_method=MANUAL无需申诉 | 记录手动打卡日志 |
| 巡检定位偏差 | 手动确认打卡 | 系统标注"定位偏差" | 记录偏差日志 |
| 系统宕机 | 恢复后补录申请 | 注明宕机时间段,主管审核 | 记录补录日志 |
| 工单数据丢失 | Web端补录 | 标注补录标记和原因 | 记录补录日志 |