diff --git a/开发者文档/02-Ops领域/01-工单生命周期与状态机.md b/开发者文档/02-Ops领域/01-工单生命周期与状态机.md new file mode 100644 index 0000000..8e4031d --- /dev/null +++ b/开发者文档/02-Ops领域/01-工单生命周期与状态机.md @@ -0,0 +1,72 @@ +# 工单生命周期与状态机 + +## 目标与范围 +本文档定义 Ops 工单的核心生命周期、状态流转规则及关键决策点。 + +面向:后端、测试、产品、移动端联调。 + +## 工单生命周期 + +### 核心状态 +``` +草稿(Draft) → 待分配(Pending) → 已分配(Assigned) → 执行中(InProgress) → 待验收(Review) → 已完成(Completed) + ↓ ↓ ↓ + 已取消(Cancelled) 已转派(Reassigned) 已驳回(Rejected) +``` + +### 状态定义 + +| 状态 | 定义 | 触发条件 | +|------|------|----------| +| 草稿 | 工单已创建但未发布 | 创建者保存草稿 | +| 待分配 | 工单已发布,等待派单 | 草稿发布 / 自动触发 | +| 已分配 | 工单已指派给执行人 | 派单成功 | +| 执行中 | 执行人已接单并开始作业 | 执行人确认接单 | +| 待验收 | 执行人提交完成,等待验收 | 执行人标记完成 | +| 已完成 | 验收通过,工单闭环 | 验收人确认通过 | +| 已取消 | 工单被取消,不再执行 | 创建者/管理员取消 | +| 已转派 | 工单被转给其他执行人 | 原执行人转派 | +| 已驳回 | 验收不通过,打回重做 | 验收人驳回 | + +## 状态流转规则 + +### 正向流程 +``` +待分配 → 已分配 → 执行中 → 待验收 → 已完成 +``` + +### 异常/分支流程 +- 待分配 → 已取消(创建者取消) +- 已分配 → 已转派(执行人无法处理) +- 已分配 → 已取消(管理员介入) +- 执行中 → 已转派(执行人变更) +- 待验收 → 已驳回(质量不达标) +- 已驳回 → 执行中(重新执行) + +## 关键业务规则 + +### 派单规则 +1. 支持手动派单和自动派单两种模式 +2. 自动派单考虑:执行人负载、技能匹配、地理位置 +3. 派单失败进入待分配队列,等待重新派单 + +### 超时规则 +- 待分配超时:N 小时未分配,触发告警并升级 +- 执行中超时:超过预计工期,触发进度确认 +- 待验收超时:N 小时未验收,自动完成或升级 + +### 优先级规则 +- P0:紧急,立即处理 +- P1:高优先级,当日完成 +- P2:普通,按排期处理 +- P3:低优先级,可延后 + +## 与 IoT 的联动点 +- 工单创建可触发设备联动(如保洁工单自动解锁门禁) +- 设备告警可自动生成工单 +- 工单完成可触发设备状态变更 + +## 待补充 +- 具体超时时间阈值 +- 自动派单算法细节 +- 与具体业务(保洁/安保)的字段差异 diff --git a/开发者文档/02-Ops领域/02-保洁业务核心链路.md b/开发者文档/02-Ops领域/02-保洁业务核心链路.md new file mode 100644 index 0000000..468ce72 --- /dev/null +++ b/开发者文档/02-Ops领域/02-保洁业务核心链路.md @@ -0,0 +1,74 @@ +# 保洁业务核心链路 + +## 目标与范围 +定义保洁业务从需求触发到服务完成的完整链路。 + +## 业务触发场景 + +### 场景一:计划保洁 +- 按固定周期自动生成保洁工单 +- 适用于日常保洁、周期性深度保洁 + +### 场景二:即时保洁 +- 现场发现问题,即时发起保洁请求 +- 适用于突发污渍、临时清洁需求 + +### 场景三:告警触发 +- IoT 设备检测到异常(如地面水渍传感器) +- 自动生成保洁工单并派单 + +## 核心链路流程 + +``` +触发 → 工单生成 → 派单 → 执行人接单 → 到达现场 → 执行保洁 → 完成提交 → 验收 → 闭环 +``` + +### 详细步骤 + +| 阶段 | 关键动作 | 系统行为 | 移动端行为 | +|------|----------|----------|------------| +| 触发 | 计划/即时/告警 | 创建工单草稿 | - | +| 工单生成 | 补充位置、保洁类型、要求 | 生成正式工单 | 推送通知 | +| 派单 | 匹配执行人 | 计算最优执行人 | 发送接单提醒 | +| 接单 | 执行人确认 | 状态变更为"执行中" | 显示工单详情 | +| 到达现场 | 扫码/定位签到 | 记录到达时间 | 签到页面 | +| 执行保洁 | 按标准作业 | 计时、可上传过程照片 | 作业指导、拍照 | +| 完成提交 | 提交完成、上传结果 | 状态变更为"待验收" | 提交完成 | +| 验收 | 验收人检查 | 验收通过/驳回 | 验收通知 | +| 闭环 | 评价、归档 | 工单完成、数据统计 | - | + +## 关键字段 + +### 工单特有字段 +- 保洁类型:日常保洁 / 深度保洁 / 专项保洁 +- 保洁区域:具体位置、面积 +- 保洁标准:参考的保洁标准编号 +- 预计工时 +- 所需物料清单 + +### 执行反馈字段 +- 实际开始时间 +- 实际完成时间 +- 现场照片(Before/After) +- 异常情况说明 +- 物料消耗记录 + +## 质量检查点 + +### 执行前 +- 执行人资质确认 +- 物料准备确认 +- 现场安全确认 + +### 执行中 +- 过程照片留痕 +- 关键节点打卡 + +### 执行后 +- 验收标准对照 +- 客户满意度评价 + +## 待补充 +- 具体保洁标准定义 +- 物料管理流程 +- 与 IoT 设备的联动细节(如清洁机器人) diff --git a/开发者文档/02-Ops领域/03-安保业务核心链路.md b/开发者文档/02-Ops领域/03-安保业务核心链路.md new file mode 100644 index 0000000..5b532e9 --- /dev/null +++ b/开发者文档/02-Ops领域/03-安保业务核心链路.md @@ -0,0 +1,92 @@ +# 安保业务核心链路 + +## 目标与范围 +定义安保业务从任务触发到完成巡逻/处理的完整链路。 + +## 业务触发场景 + +### 场景一:定时巡逻 +- 按预设路线和时间进行巡逻 +- 适用于日常安保、区域巡查 + +### 场景二:事件响应 +- 接到告警或求助,立即响应 +- 适用于突发事件、紧急求助 + +### 场景三:定点值守 +- 在关键位置定点值守 +- 适用于出入口、重要区域 + +## 核心链路流程 + +### 巡逻任务链路 +``` +计划生成 → 派单 → 开始巡逻 → 巡逻中(打点) → 巡逻完成 → 异常处理(如有) → 闭环 +``` + +### 事件响应链路 +``` +事件上报 → 工单生成 → 紧急派单 → 响应确认 → 现场处置 → 处置完成 → 上报结果 → 闭环 +``` + +## 详细步骤 + +### 巡逻任务 + +| 阶段 | 关键动作 | 系统行为 | 移动端行为 | +|------|----------|----------|------------| +| 计划生成 | 按巡逻计划生成任务 | 创建巡逻工单 | 推送任务提醒 | +| 派单 | 分配给巡逻人员 | 计算巡逻路线 | 显示巡逻路线 | +| 开始巡逻 | 巡逻人员确认开始 | 开始计时、记录轨迹 | 巡逻模式启动 | +| 巡逻中 | 按路线巡逻、打点 | 记录打点时间、位置 | 打点页面、轨迹记录 | +| 巡逻完成 | 完成巡逻路线 | 计算完成率、用时 | 巡逻总结 | +| 异常处理 | 发现异常上报 | 生成异常工单 | 异常上报页面 | + +### 事件响应 + +| 阶段 | 关键动作 | 系统行为 | 移动端行为 | +|------|----------|----------|------------| +| 事件上报 | 告警/求助触发 | 生成紧急工单、高优先级 | 紧急通知 | +| 紧急派单 | 立即指派最近安保人员 | 计算最优响应人员 | 紧急接单提醒 | +| 响应确认 | 安保人员确认响应 | 开始计时 | 响应确认 | +| 现场处置 | 到达现场、处置事件 | 记录到达时间、处置过程 | 处置记录、拍照 | +| 处置完成 | 完成处置、提交结果 | 状态变更 | 提交完成 | +| 上报结果 | 汇总处置情况 | 归档、统计 | - | + +## 关键字段 + +### 巡逻任务特有字段 +- 巡逻路线:预设路线编号 +- 巡逻点位:需打卡的关键点位 +- 巡逻频次:每日/每周次数 +- 巡逻时段:具体时间段 + +### 事件响应特有字段 +- 事件类型:入侵/火灾/求助/设备故障/其他 +- 紧急程度:P0/P1/P2/P3 +- 事件位置:具体位置、坐标 +- 上报来源:IoT告警/人工上报/系统触发 + +### 执行反馈字段 +- 实际巡逻轨迹 +- 打点记录(时间、位置、照片) +- 异常情况描述 +- 处置措施记录 +- 现场照片/视频 + +## 与 IoT 的联动 + +### 触发联动 +- 门禁异常 → 自动生成巡逻任务 +- 视频监控告警 → 推送最近安保人员 +- 烟感/红外告警 → 紧急事件工单 + +### 执行联动 +- 巡逻人员接近 → 自动解锁门禁 +- 紧急事件 → 联动广播、照明 +- 完成巡逻 → 自动布防 + +## 待补充 +- 具体巡逻路线定义 +- 与视频监控系统的对接 +- 紧急事件升级机制