work-order-lifecycle.md 3.6 KB

统一工单处置生命周期 · 管理端权威口径

状态:accepted 更新日期:2026-10-14 决策依据:ADR-0010 当前工单状态枚举为权威

本文以最新统一工单代码和 WorkOrderStatusEnum 为权威。状态名是业务权威;接口编码按所属契约解释,不能跨接口复用裸数字。

1. 状态

编码 状态 含义 是否终态
0 待派单 工单已创建,未指定接单责任人 否
1 待接单 已派给责任人,等待责任人核查接单 否
2 已接单 责任人已核查接单,尚未开始处置 否
3 处理中 责任人已开始处置,可多次追加处理流水 否
4 待验收 责任人已提交验收,等待管理员验收 否
5 已结案 管理员验收通过,处置闭环 是
6 延期中 延期申请审核通过后的处理旁路,仍需继续处置 否
7 已取消 管理员取消工单,强制终止;改派需另建新单 是

终态只有“已结案(5)”和“已取消(7)”。“延期中”不是终态,也不是独立的验收结果。

2. 状态迁移

动作 角色 前置态 目标态 必填信息
创建报警转工单 系统/管理员 — 待派单 报警来源、设备、描述
派单 管理员 待派单 待接单 唯一接单责任人
核查接单 责任人 待接单 已接单 现场情况附件,作为处理前证据
开始处置 责任人 已接单 处理中 处理描述与附件
追加处理流水 责任人 处理中 / 延期中 原状态 处理描述,可含附件
提交验收 责任人 处理中 / 延期中 待验收 处理后描述与附件
验收通过 管理员 待验收 已结案 验收意见
验收驳回 管理员 待验收 处理中 驳回原因,交同一责任人继续整改
取消工单 管理员 待派单 / 待接单 已取消 取消原因
申请延期 责任人 处理中 待延期审核 延期原因和截止时间
延期审核通过 管理员 待延期审核 延期中 审核意见
延期审核驳回 管理员 待延期审核 处理中 审核意见

约束:

  • “验收驳回”是动作不是状态;被驳回的工单状态显示为“处理中”,并在时间线展示驳回原因。
  • “已取消”是终态,不能复活;如需继续处置,应另建新工单。
  • 取消仅允许待派单(0)、待接单(1);接单后所有状态均不可取消。此规则按 2026-10-14 用户要求收窄,取代旧 ADR-0008 的任意中间态可取消口径,状态编码不变。
  • “延期申请状态”与“工单状态”是两个来源,不得互相替代。
  • “已结案”不可再取消、驳回或回退。

3. 处理流水与证据

  • 处理前证据在“核查接单”上传。
  • 处理流水在“已接单→处理中”及后续处置中追加。
  • 处理后证据在“提交验收”上传。
  • 验收意见、驳回原因、取消原因、延期原因和延期审核结果记录在对应动作日志中。
  • 附件继续兼容既有图片 URL;新附件按后端 MinIO + KingbaseES 阶段化元数据方案处理。

4. 与设备报警状态的关系

工单状态独立于设备报警状态、报警记录状态和报警展示状态。工单结案只触发清警复核;运行系统确认没有有效报警原因后才允许自动清警。前端或工单服务不得直接把设备报警状态改为正常。