docs(ops): 更新安保与维修业务文档,对齐底层工牌与信标感应逻辑

This commit is contained in:
lzh
2026-04-06 23:04:58 +08:00
parent 7082d01b0f
commit e5fa0462c5

View File

@@ -1,47 +1,34 @@
# 03-安保业务核心链路
# 03-安保与维修业务链路
安保业务相比于保洁,更加注重**路线的规律性**与**突发事件的强响应**
它强依赖于系统的“空间树”基础数据
安保`SECURITY`)、维修(`REPAIR`)和客服(`SERVICE`)属于 Ops 领域下平行的工单类型(`WorkOrderTypeEnum`
虽然业务名称不同,但其底层调度均复用统一的硬件体系(智能工牌 + 现场信标)
## 一、巡检点位与路线规划
## 一、硬件联动的现场打卡
安保日常工作的核心是“巡更”
无论是安保巡逻,还是维修人员去现场检修,都不再依赖手机 App 的 GPS 定位去防止作弊,而是通过**物理信标BEACON感应**
### 1. 空间树复用
- 巡检点Check Point直接关联系统底层的“空间树Space Tree”节点如 1栋-2层-弱电井)
- 每个巡检点在物理世界对应一个 NFC 贴片或专属二维码
1. **接单 (`DISPATCHED` -> `CONFIRMED`)**
- 维修/安保工单下发后,员工的智能工牌收到通知
- 员工在工牌上按键确认
2. **到场感应 (`CONFIRMED` -> `ARRIVED`)**
- 员工走到事发位置(如损坏的配电箱或巡更点)。
- 现场预埋的信标BEACON发射信号被工牌捕获。
- 工牌将“感应事件”上报后台,工单状态由后台**自动跃迁**为 `ARRIVED`(已到岗)。这就彻底消除了“远程假打卡”的可能。
### 2. 路线规划与生成
- **路线Route**:由一系列有序的巡检点组成。
- 系统通过定时任务(如每天凌晨 1 点),根据排班计划和预设路线,批量生成安保巡检工单。
- 巡检工单在移动端显示为任务清单,安保人员需按照顺序依次前往各个点位进行扫码/碰一碰。
## 二、工单派发的多维度支持
### 3. 防作弊与漏检处理
- 后端严格校验两次扫码的时间差:如果两个相距 500 米的巡检点,扫码间隔只有 5 秒,系统将判定为异常并自动打上 `SUSPICIOUS` 标签。
- 到了规定时间未完成的点位,自动标记为“漏检”,并纳入该人员绩效扣分计算中。
对于维修或安保的紧急事件,派单引擎可组合使用以下策略(`DispatchStrategyEnum`
## 二、异常上报与流转路径
- **技能匹配 (`SKILL_MATCH`)**:当水管爆裂时,系统会自动筛选拥有“水暖维修”技能标签的工程人员,避免派给弱电工程师。
- **最近距离 (`NEAREST`)**:结合工牌实时上报的位置,安保紧急事件(如消防告警)会直接派发给距离事发点最近的保安,做到秒级响应。
安保在巡检中不仅是“打卡”,更承担了“发现问题”的职能。
## 三、工单与设备的闭环
### 1. 巡检内异常上报
- 安保扫码某个巡检点时,发现消防栓玻璃破裂。
- 在移动端当前点位的巡检单中,直接点击【上报异常】。
- 提交描述和照片后,该巡检点的状态变为【异常已记录】,但当前**巡检主工单仍可继续往下进行**。
安保和维修工单,往往由 IoT 设备的异常触发:
### 2. 派生维修工单
- 上述异常提交后,系统后台会捕捉到这个动作。
- 后端异步触发流转,自动**派生Spawn**出一个新的【维修工单】,归属到工程维修组
- 在数据关系上,该维修工单的 `parent_id``source_id` 指向安保的巡检单,形成追溯链路
1. IoT 模块捕获告警。
2. **规则引擎 (`EventDomainEnum.RULE`)** 将告警转化为工单(类型为 `SECURITY``REPAIR`
3. 调度引擎 (`DISPATCH`) 寻找人选推送到工牌
4. 员工到岗处理并完工后,绩效模块 (`PERFORMANCE`) 介入统计响应时长和修复时长
## 三、突发事件IoT联动强推播
这是安保业务防线中最关键的应急链路。当 IoT 领域传来如“烟雾报警”等严重异常时:
### 1. 紧急工单生成
- 后端接收到高优告警事件,直接绕过人工审核,自动生成等级为 `URGENT` 的安保应急工单。
### 2. LBS 强推播与锁定
- 系统利用所有安保人员最后一次上传的 GPS 坐标,计算出距离事发点 500 米范围内的在线安保人员。
- **强提醒**:向这些人的 App 发送最高优先级的 WebSocket 消息,拉起强制弹窗和震动报警。
- **抢单锁定**:与保洁的普通抢单不同,这类紧急事件若 1 分钟内无人抢单,系统将强行指派给距离最近的安保,并通过自动拨打语音电话(规划中)进行通知,确保事件 100% 得到响应。
这套体系确保了“设备报修 -> 硬件派单 -> 硬件确认到场 -> 完工结算”的端到端防伪闭环。