diff --git a/开发者文档/02-Ops领域/03-安保业务核心链路.md b/开发者文档/02-Ops领域/03-安保业务核心链路.md index 24524ba..f640f8b 100644 --- a/开发者文档/02-Ops领域/03-安保业务核心链路.md +++ b/开发者文档/02-Ops领域/03-安保业务核心链路.md @@ -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% 得到响应。 \ No newline at end of file +这套体系确保了“设备报修 -> 硬件派单 -> 硬件确认到场 -> 完工结算”的端到端防伪闭环。 \ No newline at end of file