docs(ops): 补充工单生命周期、保洁/安保业务核心链路

开发者文档/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 的联动点
+- 工单创建可触发设备联动（如保洁工单自动解锁门禁）
+- 设备告警可自动生成工单
+- 工单完成可触发设备状态变更
+
+## 待补充
+- 具体超时时间阈值
+- 自动派单算法细节
+- 与具体业务（保洁/安保）的字段差异

开发者文档/02-Ops领域/02-保洁业务核心链路.md

@@ -0,0 +1,74 @@
+# 保洁业务核心链路
+
+## 目标与范围
+定义保洁业务从需求触发到服务完成的完整链路。
+
+## 业务触发场景
+
+### 场景一：计划保洁
+- 按固定周期自动生成保洁工单
+- 适用于日常保洁、周期性深度保洁
+
+### 场景二：即时保洁
+- 现场发现问题，即时发起保洁请求
+- 适用于突发污渍、临时清洁需求
+
+### 场景三：告警触发
+- IoT 设备检测到异常（如地面水渍传感器）
+- 自动生成保洁工单并派单
+
+## 核心链路流程
+
+```
+触发 → 工单生成 → 派单 → 执行人接单 → 到达现场 → 执行保洁 → 完成提交 → 验收 → 闭环
+```
+
+### 详细步骤
+
+| 阶段 | 关键动作 | 系统行为 | 移动端行为 |
+|------|----------|----------|------------|
+| 触发 | 计划/即时/告警 | 创建工单草稿 | - |
+| 工单生成 | 补充位置、保洁类型、要求 | 生成正式工单 | 推送通知 |
+| 派单 | 匹配执行人 | 计算最优执行人 | 发送接单提醒 |
+| 接单 | 执行人确认 | 状态变更为"执行中" | 显示工单详情 |
+| 到达现场 | 扫码/定位签到 | 记录到达时间 | 签到页面 |
+| 执行保洁 | 按标准作业 | 计时、可上传过程照片 | 作业指导、拍照 |
+| 完成提交 | 提交完成、上传结果 | 状态变更为"待验收" | 提交完成 |
+| 验收 | 验收人检查 | 验收通过/驳回 | 验收通知 |
+| 闭环 | 评价、归档 | 工单完成、数据统计 | - |
+
+## 关键字段
+
+### 工单特有字段
+- 保洁类型：日常保洁 / 深度保洁 / 专项保洁
+- 保洁区域：具体位置、面积
+- 保洁标准：参考的保洁标准编号
+- 预计工时
+- 所需物料清单
+
+### 执行反馈字段
+- 实际开始时间
+- 实际完成时间
+- 现场照片（Before/After）
+- 异常情况说明
+- 物料消耗记录
+
+## 质量检查点
+
+### 执行前
+- 执行人资质确认
+- 物料准备确认
+- 现场安全确认
+
+### 执行中
+- 过程照片留痕
+- 关键节点打卡
+
+### 执行后
+- 验收标准对照
+- 客户满意度评价
+
+## 待补充
+- 具体保洁标准定义
+- 物料管理流程
+- 与 IoT 设备的联动细节（如清洁机器人）

开发者文档/02-Ops领域/03-安保业务核心链路.md

@@ -0,0 +1,92 @@
+# 安保业务核心链路
+
+## 目标与范围
+定义安保业务从任务触发到完成巡逻/处理的完整链路。
+
+## 业务触发场景
+
+### 场景一：定时巡逻
+- 按预设路线和时间进行巡逻
+- 适用于日常安保、区域巡查
+
+### 场景二：事件响应
+- 接到告警或求助，立即响应
+- 适用于突发事件、紧急求助
+
+### 场景三：定点值守
+- 在关键位置定点值守
+- 适用于出入口、重要区域
+
+## 核心链路流程
+
+### 巡逻任务链路
+```
+计划生成 → 派单 → 开始巡逻 → 巡逻中（打点） → 巡逻完成 → 异常处理（如有） → 闭环
+```
+
+### 事件响应链路
+```
+事件上报 → 工单生成 → 紧急派单 → 响应确认 → 现场处置 → 处置完成 → 上报结果 → 闭环
+```
+
+## 详细步骤
+
+### 巡逻任务
+
+| 阶段 | 关键动作 | 系统行为 | 移动端行为 |
+|------|----------|----------|------------|
+| 计划生成 | 按巡逻计划生成任务 | 创建巡逻工单 | 推送任务提醒 |
+| 派单 | 分配给巡逻人员 | 计算巡逻路线 | 显示巡逻路线 |
+| 开始巡逻 | 巡逻人员确认开始 | 开始计时、记录轨迹 | 巡逻模式启动 |
+| 巡逻中 | 按路线巡逻、打点 | 记录打点时间、位置 | 打点页面、轨迹记录 |
+| 巡逻完成 | 完成巡逻路线 | 计算完成率、用时 | 巡逻总结 |
+| 异常处理 | 发现异常上报 | 生成异常工单 | 异常上报页面 |
+
+### 事件响应
+
+| 阶段 | 关键动作 | 系统行为 | 移动端行为 |
+|------|----------|----------|------------|
+| 事件上报 | 告警/求助触发 | 生成紧急工单、高优先级 | 紧急通知 |
+| 紧急派单 | 立即指派最近安保人员 | 计算最优响应人员 | 紧急接单提醒 |
+| 响应确认 | 安保人员确认响应 | 开始计时 | 响应确认 |
+| 现场处置 | 到达现场、处置事件 | 记录到达时间、处置过程 | 处置记录、拍照 |
+| 处置完成 | 完成处置、提交结果 | 状态变更 | 提交完成 |
+| 上报结果 | 汇总处置情况 | 归档、统计 | - |
+
+## 关键字段
+
+### 巡逻任务特有字段
+- 巡逻路线：预设路线编号
+- 巡逻点位：需打卡的关键点位
+- 巡逻频次：每日/每周次数
+- 巡逻时段：具体时间段
+
+### 事件响应特有字段
+- 事件类型：入侵/火灾/求助/设备故障/其他
+- 紧急程度：P0/P1/P2/P3
+- 事件位置：具体位置、坐标
+- 上报来源：IoT告警/人工上报/系统触发
+
+### 执行反馈字段
+- 实际巡逻轨迹
+- 打点记录（时间、位置、照片）
+- 异常情况描述
+- 处置措施记录
+- 现场照片/视频
+
+## 与 IoT 的联动
+
+### 触发联动
+- 门禁异常 → 自动生成巡逻任务
+- 视频监控告警 → 推送最近安保人员
+- 烟感/红外告警 → 紧急事件工单
+
+### 执行联动
+- 巡逻人员接近 → 自动解锁门禁
+- 紧急事件 → 联动广播、照明
+- 完成巡逻 → 自动布防
+
+## 待补充
+- 具体巡逻路线定义
+- 与视频监控系统的对接
+- 紧急事件升级机制