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

状态：accepted
更新日期：2026-09-10
决策依据：[ADR-0010 当前工单状态枚举为权威](../adr/0010-current-work-order-status-enum-is-authoritative.md)

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

## 1. 状态

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

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

## 2. 状态迁移

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

约束：

- “验收驳回”是动作不是状态；被驳回的工单状态显示为“处理中”，并在时间线展示驳回原因。
- “已取消”是终态，不能复活；如需继续处置，应另建新工单。
- “延期申请状态”与“工单状态”是两个来源，不得互相替代。
- “已结案”不可再取消、驳回或回退。

## 3. 处理流水与证据

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

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

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