|
|
# 微信小程序端 — 业务流转逻辑
|
|
|
|
|
|
> 版本：v4.0
|
|
|
> 微信小程序仅供物业人员使用，**医院账号无小程序端**。
|
|
|
> 不同角色登录后看到不同功能入口。
|
|
|
> 关联文档：`01-模块划分.md`（v4.0）、`02-功能清单-小程序端.md`
|
|
|
|
|
|
---
|
|
|
|
|
|
## 1. 登录与权限加载流程
|
|
|
|
|
|
### 1.1 首次登录
|
|
|
|
|
|
```
|
|
|
用户打开小程序
|
|
|
│
|
|
|
微信授权获取openid
|
|
|
│
|
|
|
绑定手机号（微信获取手机号组件）
|
|
|
│
|
|
|
系统匹配物业公司+人员信息
|
|
|
**数据来源：物业公司Web端创建的下属账号（sys_user表）**
|
|
|
│
|
|
|
┌─── 匹配成功 ──┐ ┌─── 匹配失败 ──┐
|
|
|
│ │ │ │
|
|
|
创建账号 提示"未找到关联信息，请联系管理员"
|
|
|
进入工作台 无法使用
|
|
|
```
|
|
|
|
|
|
### 1.2 再次登录
|
|
|
|
|
|
```
|
|
|
打开小程序
|
|
|
│
|
|
|
读取本地token
|
|
|
│
|
|
|
┌─── token有效 ──┐ ┌─── token无效 ──┐
|
|
|
│ │ │ │
|
|
|
直接进入工作台 openid静默登录
|
|
|
**数据来源：系统用户表自动匹配**
|
|
|
│
|
|
|
刷新token
|
|
|
│
|
|
|
进入工作台
|
|
|
```
|
|
|
|
|
|
### 1.3 权限加载与界面渲染
|
|
|
|
|
|
```
|
|
|
用户登录成功
|
|
|
│
|
|
|
获取角色及权限集（四级粒度）
|
|
|
**数据来源：超级管理员定义的角色+物业公司管理员分配的角色**
|
|
|
│
|
|
|
根据权限动态渲染：
|
|
|
├── 可见菜单项
|
|
|
├── 页面内可见功能点
|
|
|
├── 功能点可用动作（按钮显示/隐藏/禁用）
|
|
|
└── 数据范围（行级隔离）
|
|
|
```
|
|
|
|
|
|
---
|
|
|
|
|
|
## 2. 报修流程
|
|
|
|
|
|
### 2.1 报修人视角
|
|
|
|
|
|
```
|
|
|
首页工作台 → 一键报修
|
|
|
│
|
|
|
选择报修类型（数据来源：物业公司Web端配置的报修类型字典）
|
|
|
│
|
|
|
填写描述
|
|
|
│
|
|
|
拍照上传（≤9张，含水印时间定位）
|
|
|
│
|
|
|
提交 → 生成工单 → 等待分配
|
|
|
│
|
|
|
接收处理通知
|
|
|
│
|
|
|
接收完工通知 → 评价（五分制+留言）
|
|
|
```
|
|
|
|
|
|
### 2.2 维修人员视角
|
|
|
|
|
|
```
|
|
|
接收工单通知（小程序推送）
|
|
|
│
|
|
|
查看待处理工单列表
|
|
|
**数据来源：物业公司Web端分配的工单，或自动分配**
|
|
|
│
|
|
|
接单
|
|
|
│
|
|
|
处理维修
|
|
|
│
|
|
|
┌─── 正常完工 ────────────────────┐
|
|
|
│ 上传维修后照片 → 填写说明 → 提交 │
|
|
|
│ → 工单状态变为"待验收" │
|
|
|
└────────────────────────────────────┘
|
|
|
│
|
|
|
┌─── 需要延期 ────────────────────┐
|
|
|
│ 填写延期原因和预计完成时间 │
|
|
|
│ → 工单状态变为"延期中" │
|
|
|
│ → 等待主管审批 │
|
|
|
│ **审批数据来源：主管在Web或小程序端审批** │
|
|
|
└────────────────────────────────────┘
|
|
|
│
|
|
|
┌─── 需要协助 ────────────────────┐
|
|
|
│ 请求其他班组协助 │
|
|
|
│ → 生成协助子工单 │
|
|
|
│ → 等待协助完成 │
|
|
|
└────────────────────────────────────┘
|
|
|
│
|
|
|
等待验收
|
|
|
**验收数据来源：主管或报修人在Web/小程序端验收**
|
|
|
```
|
|
|
|
|
|
### 2.3 主管视角（工单管理）
|
|
|
|
|
|
```
|
|
|
查看待分配工单列表
|
|
|
**数据来源：报修人提交的工单（小程序端）+ Web端录入的工单**
|
|
|
│
|
|
|
工单分配（手动分配到班组/人员）
|
|
|
│
|
|
|
延期审批（审批维修人员延期申请）
|
|
|
**数据来源：维修人员在小程序端提交的延期申请**
|
|
|
│
|
|
|
工单验收
|
|
|
```
|
|
|
|
|
|
---
|
|
|
|
|
|
## 3. 巡检流程（巡检人员视角）
|
|
|
|
|
|
```
|
|
|
查看今日巡检任务
|
|
|
**数据来源：物业管理员在Web端创建的巡检计划自动生成**
|
|
|
│
|
|
|
到达巡检点位
|
|
|
│
|
|
|
查询蓝牙策略配置
|
|
|
**数据来源：系统配置的蓝牙策略（GET /system/bluetooth-policy → inspection_check_in）**
|
|
|
│
|
|
|
┌─── 策略=REQUIRED（强制蓝牙）───────────────────────────┐
|
|
|
│ │
|
|
|
│ 小程序自动扫描蓝牙Beacon │
|
|
|
│ │ │
|
|
|
│ ┌─── 检测到目标Beacon ───┐ ┌─── 未检测到 ────────────┐ │
|
|
|
│ │ │ │ │ │
|
|
|
│ │ 读取UUID │ 提示"未检测到蓝牙信号" │ │
|
|
|
│ │ 连接蓝牙设备 │ │ │ │
|
|
|
│ │ 连接成功即打卡 │ ┌─重试──▶ 重新扫描 │ │
|
|
|
│ │ check_type=BLUETOOTH │ └─补录──▶ 进入补录模式 │ │
|
|
|
│ │ **无需距离校验** │ │ │ │
|
|
|
│ └─────────────────────────┘ 选择补录原因 │ │
|
|
|
│ 手动填写巡检记录 │ │
|
|
|
│ 提交补录申请 │ │
|
|
|
│ **需主管审核（Web/小程序）**│ │
|
|
|
└──────────────────────────────────────────────────────────┘
|
|
|
│
|
|
|
┌─── 策略=OPTIONAL（非强制蓝牙）──────────────────────────┐
|
|
|
│ │
|
|
|
│ 用户选择打卡方式 │
|
|
|
│ ┌───蓝牙打卡──┐───手动打卡──┐ │
|
|
|
│ 扫描蓝牙 直接打卡 │
|
|
|
│ check_type= check_type=MANUAL │
|
|
|
│ BLUETOOTH │
|
|
|
└──────────────────────────────────────────────────────────┘
|
|
|
│
|
|
|
打卡成功后 → 逐项检查巡检清单 → 记录正常/异常
|
|
|
│
|
|
|
┌─── 发现异常 ────────────────────────────────────┐
|
|
|
│ 拍照上传 + 标记严重等级 │
|
|
|
│ 可一键生成报修工单（数据写入报修模块） │
|
|
|
└──────────────────────────────────────────────────┘
|
|
|
│
|
|
|
┌─── 拍照（蓝牙策略=REQUIRED时）────────────────────┐
|
|
|
│ 拍照也须在蓝牙连接状态下进行 │
|
|
|
│ **拍照策略数据来源：GET /system/bluetooth-policy │
|
|
|
│ → inspection_photo** │
|
|
|
└──────────────────────────────────────────────────┘
|
|
|
```
|
|
|
|
|
|
---
|
|
|
|
|
|
## 4. 保洁流程（保洁人员视角）
|
|
|
|
|
|
```
|
|
|
查看今日保洁任务
|
|
|
**数据来源：物业管理员在Web端配置的排班自动生成**
|
|
|
│
|
|
|
到达保洁区域
|
|
|
│
|
|
|
查询蓝牙策略配置
|
|
|
**数据来源：系统配置的蓝牙策略（GET /system/bluetooth-policy → cleaning_check_in）**
|
|
|
│
|
|
|
┌─── 策略=REQUIRED（强制蓝牙）──────────────────────┐
|
|
|
│ 蓝牙强制打卡确认（流程同巡检3.1） │
|
|
|
│ check_type=BLUETOOTH │
|
|
|
│ 未检测到蓝牙 → 进入补录模式（需主管审核） │
|
|
|
└──────────────────────────────────────────────────────┘
|
|
|
│
|
|
|
┌─── 策略=OPTIONAL（非强制蓝牙）─────────────────────┐
|
|
|
│ 可选蓝牙打卡或手动打卡 │
|
|
|
│ 手动打卡：check_type=MANUAL │
|
|
|
└──────────────────────────────────────────────────────┘
|
|
|
│
|
|
|
逐项完成保洁清单 → 上传完成后照片
|
|
|
│
|
|
|
┌─── 发现异常 ─────────────────────────────┐
|
|
|
│ 异常反馈 → 拍照上报 │
|
|
|
└────────────────────────────────────────────┘
|
|
|
│
|
|
|
任务完成
|
|
|
│
|
|
|
主管抽查（数据来源：主管在小程序端标记）
|
|
|
┌─合格─┐ ┌─不合格─┐
|
|
|
确认完成 重新生成任务
|
|
|
```
|
|
|
|
|
|
---
|
|
|
|
|
|
## 5. 考勤打卡流程（员工视角）
|
|
|
|
|
|
```
|
|
|
到达班组打卡点
|
|
|
│
|
|
|
查询蓝牙策略配置
|
|
|
**数据来源：系统配置的蓝牙策略（GET /system/bluetooth-policy → attendance_check）**
|
|
|
│
|
|
|
┌─── 策略=REQUIRED（强制蓝牙）──────────────────────┐
|
|
|
│ │
|
|
|
│ 小程序自动扫描蓝牙Beacon │
|
|
|
│ │ │
|
|
|
│ ┌─── 检测到指定打卡点Beacon ───┐ │
|
|
|
│ │ 验证Beacon属于本人班组打卡点 │ │
|
|
|
│ │ 连接蓝牙成功 │ │
|
|
|
│ │ 记录打卡时间+Beacon标识 │ │
|
|
|
│ │ **打卡点数据来源：Web端配置的打卡点+蓝牙绑定** │
|
|
|
│ │ 打卡成功 check_method=BLUETOOTH │
|
|
|
│ └──────────────────────────────┘ │
|
|
|
│ │ │
|
|
|
│ ┌─── 未检测到打卡点蓝牙 ──────────┐ │
|
|
|
│ │ 提示"未检测到打卡点蓝牙信号" │ │
|
|
|
│ │ ┌─重试──▶ 重新扫描 │ │
|
|
|
│ │ └─异常申诉──▶ 提交打卡异常申诉 │ │
|
|
|
│ │ 选择异常原因（蓝牙故障/手机异常/系统异常/ │
|
|
|
│ │ 忘记打卡/其他） │
|
|
|
│ │ 补充说明(可上传照片) │
|
|
|
│ │ 提交申诉 → 等待主管审核 │
|
|
|
│ │ **审核数据来源：主管在Web/小程序端审核** │
|
|
|
│ └──────────────────────────────────┘ │
|
|
|
└──────────────────────────────────────────────────────┘
|
|
|
│
|
|
|
┌─── 策略=OPTIONAL（非强制蓝牙）─────────────────────┐
|
|
|
│ 可选蓝牙打卡或手动打卡 │
|
|
|
│ 手动打卡：check_method=MANUAL │
|
|
|
└──────────────────────────────────────────────────────┘
|
|
|
│
|
|
|
打卡成功 → 记录操作日志
|
|
|
```
|
|
|
|
|
|
### 5.1 打卡异常申诉审核流程
|
|
|
|
|
|
```
|
|
|
员工提交打卡异常申诉（小程序端）
|
|
|
│
|
|
|
主管审核（Web+小程序均可）
|
|
|
**申诉数据来源：小程序端提交的异常申诉**
|
|
|
│
|
|
|
┌─审核通过─┐ ┌─审核驳回─┐
|
|
|
系统自动补录 通知员工
|
|
|
打卡记录 申诉未通过
|
|
|
标注"补录" 记录审核日志
|
|
|
记录审核日志
|
|
|
```
|
|
|
|
|
|
---
|
|
|
|
|
|
## 6. 组织架构相关流程
|
|
|
|
|
|
```
|
|
|
查看我的班组
|
|
|
**数据来源：物业管理员在Web端配置的班组信息**
|
|
|
│
|
|
|
班组信息 + 班组成员列表
|
|
|
│
|
|
|
查看我的排班
|
|
|
**数据来源：物业管理员在Web端配置的排班数据**
|
|
|
│
|
|
|
个人排班日历
|
|
|
```
|
|
|
|
|
|
---
|
|
|
|
|
|
## 7. 服务评价流程（报修人视角）
|
|
|
|
|
|
```
|
|
|
工单完工后收到评价通知
|
|
|
**触发数据来源：物业公司在Web/小程序端验收通过**
|
|
|
│
|
|
|
打开待评价列表
|
|
|
│
|
|
|
五分制评分 + 文字留言 + 图片上传
|
|
|
│
|
|
|
提交评价
|
|
|
│
|
|
|
物业公司可查看和回复（数据写入评价模块）
|
|
|
**评价数据来源：小程序端提交，物业公司Web端可查看回复**
|
|
|
```
|
|
|
|
|
|
---
|
|
|
|
|
|
## 8. 统计概览流程
|
|
|
|
|
|
### 8.1 管理员/主管视角
|
|
|
|
|
|
```
|
|
|
进入工作台 → 简版统计概览
|
|
|
│
|
|
|
按角色权限显示今日/本周关键指标：
|
|
|
├── 报修：今日工单数/待处理/已完成
|
|
|
├── 巡检：今日任务数/已完成/异常
|
|
|
├── 保洁：今日任务数/已完成/超时
|
|
|
└── 考勤：今日出勤率
|
|
|
│
|
|
|
**数据来源：物业公司各业务模块实时数据**
|
|
|
```
|
|
|
|
|
|
### 8.2 员工视角
|
|
|
|
|
|
```
|
|
|
进入工作台 → 个人绩效统计
|
|
|
│
|
|
|
个人工单量、评分、考勤
|
|
|
**数据来源：报修模块工单数据 + 评价模块评分 + 考勤模块打卡数据**
|
|
|
```
|
|
|
|
|
|
---
|
|
|
|
|
|
## 9. 物业公司管理员小程序功能
|
|
|
|
|
|
```
|
|
|
物业管理员登录小程序
|
|
|
│
|
|
|
功能入口（与Web端对应，但功能简化）：
|
|
|
├── 报修管理：工单列表/分配/流转
|
|
|
├── 巡检管理：计划/看板/记录
|
|
|
├── 保洁管理：任务/排班/抽查
|
|
|
├── 考勤管理：记录/统计
|
|
|
├── 评价管理：查看/回复
|
|
|
└── 组织架构查看：查看班组/人员
|
|
|
│
|
|
|
**所有数据来源：与Web端同一数据源，操作实时同步**
|
|
|
```
|
|
|
|
|
|
---
|
|
|
|
|
|
## 10. 小程序更新流程
|
|
|
|
|
|
```
|
|
|
小程序启动
|
|
|
│
|
|
|
调用后台接口获取最新版本号 + 最低兼容版本
|
|
|
**数据来源：超级管理员在Web端配置的版本信息**
|
|
|
│
|
|
|
与本地版本号比较
|
|
|
│
|
|
|
┌── 版本一致 ──▶ 正常使用
|
|
|
│
|
|
|
┌── 小版本更新（兼容） ──▶ 提示"发现新版本，是否更新？"
|
|
|
│ │
|
|
|
│ 用户确认 → 触发热更新/重启
|
|
|
│ 用户取消 → 继续使用旧版
|
|
|
│
|
|
|
└── 大版本更新（不兼容） ──▶ 强制更新
|
|
|
│
|
|
|
提示"版本过低，必须更新"
|
|
|
│
|
|
|
引导前往微信更新小程序
|
|
|
```
|
|
|
|
|
|
**SDK依赖校验：**
|
|
|
- 启动时校验蓝牙SDK、微信SDK等关键依赖版本
|
|
|
- 低于最低兼容版本时提示更新
|
|
|
- 记录SDK版本信息到操作日志（便于排查问题）
|
|
|
|
|
|
---
|
|
|
|
|
|
## 11. 审批流程（主管视角）
|
|
|
|
|
|
```
|
|
|
收到审批推送（小程序推送通知）
|
|
|
**推送数据来源：系统根据业务规则自动触发**
|
|
|
│
|
|
|
打开审批中心
|
|
|
│
|
|
|
查看待审批列表
|
|
|
│
|
|
|
查看详情 → 通过/驳回
|
|
|
│
|
|
|
通知申请人
|
|
|
│
|
|
|
记录审批操作日志
|
|
|
```
|
|
|
|
|
|
**审批场景汇总：**
|
|
|
|
|
|
| 审批场景 | 发起端 | 审批端 | 数据来源 |
|
|
|
|----------|--------|--------|----------|
|
|
|
| 工单延期审批 | 小程序（维修人员申请） | Web+小程序（主管审批） | 小程序端延期申请 |
|
|
|
| 工单分配 | Web+小程序（主管分配） | — | 报修人提交的工单 |
|
|
|
| 工单验收 | Web+小程序（主管/报修人） | — | 维修人员提交的完工 |
|
|
|
| 打卡异常审核 | 小程序（员工申诉） | Web+小程序（主管审核） | 小程序端异常申诉 |
|
|
|
| 数据补录审核 | 小程序（员工补录） | Web+小程序（主管审核） | 小程序端补录申请 |
|
|
|
| 保洁抽查 | 小程序（主管标记） | — | 保洁人员完成的任务 |
|