# 统一工单处置生命周期（七态共识）

状态：accepted（跨后端 `pipe-ner-server`、前端 `city-life-line`、UE 驾驶舱 `Pipelines` 的统一领域共识）
确立日期：2026-09-04（状态编码 2026-09-05 调整为从 1 开始）
决策依据：[ADR-0008 工单生命周期收敛为七态](../adr/0008-work-order-lifecycle-seven-states.md)
取代口径：旧“九态模型”（含“已驳回”终态、“延期审核/已延期”），以及 ADR-0004 中“驳回、延期日志语义”的旧表述。

> 本文只定义**领域流程共识**（状态、角色、迁移动作、证据与边界），不规定具体类、接口或 SQL。后端代码与存量数据当前仍是旧编码，**编码迁移另开任务**，在迁移完成前以本文状态名为唯一业务权威，编码以对照表换算。

## 1. 角色

- **管理员（派单/验收者）**：派单下发、验收（审核通过 / 验收驳回 / 取消工单）。可在任意中间态取消工单。
- **接单责任人**：接单确认、开始处置、多次追加处理流水、提交审核。一次派发指定唯一接单责任人。
- **运行系统/设备**：产生设备预警、报警，是工单的来源之一，但不参与工单状态决策。

## 2. 进入流程的两条入口

1. **报警转工单**：由设备预警/报警创建工单，进入“待派单”，创建时不指定责任人。
2. **直接下派**：巡检工单、维修工单等可在创建时直接派给责任人，跳过“待派单”，直接进入“待接单”。

## 3. 七个状态（目标权威模型）

状态编码从 1 开始：

| 目标编码 | 状态 | 含义 | 是否终态 |
| --- | --- | --- | --- |
| 1 | 待派单 | 已创建、尚未指定接单责任人，等待管理员派单 | 否 |
| 2 | 待接单 | 已派给责任人，等待责任人接单确认 | 否 |
| 3 | 已接单 | 责任人已接单确认，尚未开始现场处置 | 否 |
| 4 | 处理中 | 责任人已开始处置；可多次追加处理流水 | 否 |
| 5 | 待验收 | 责任人已提交审核，等待管理员验收 | 否 |
| 6 | 已结案 | 管理员审核通过，处置闭环 | 是 |
| 7 | 已取消 | 管理员取消，强制终止；用于改派新责任人（另建新单） | 是 |

终态只有“已结案（6）”和“已取消（7）”。除两个终态外，其余均为中间态（1–5）。

## 4. 状态迁移（动作即事件）

| 动作 | 角色 | 前置态 | 目标态 | 必填信息 |
| --- | --- | --- | --- | --- |
| 创建（报警转工单） | 系统/管理员 | — | 1 待派单 | 工单描述、来源报警/设备 |
| 直接下派（巡检/维修等） | 管理员 | — | 2 待接单 | 唯一责任人 |
| 派单/下发 | 管理员 | 1 | 2 待接单 | 唯一责任人 |
| 接单确认 | 责任人 | 2 | 3 已接单 | — |
| 开始处置 | 责任人 | 3 | 4 处理中 | **处理前照片 + 现场简述** |
| 追加处理流水 | 责任人 | 4 | 4 处理中（自循环，可多次） | 处理描述，可含图片 |
| 提交审核 | 责任人 | 4 | 5 待验收 | **处理后照片 + 处理描述** |
| 审核通过 | 管理员 | 5 | 6 已结案（终态） | 审核评价/建议 |
| 验收驳回 | 管理员 | 5 | 4 处理中（**回退**） | 驳回原因 |
| 取消工单 | 管理员 | 1/2/3/4/5 任一中间态 | 7 已取消（终态） | 建议填取消原因 |

约束：

- “已结案（6）”不可再取消、驳回或回退。
- “已取消（7）”是终态，不能复活；需要换责任人时，**另建一张新工单**重新派发。
- “验收驳回”只发生在“待验收（5）”，回到“处理中（4）”交**同一责任人**继续处理，可再次走“提交审核→待验收”。

### 状态机视图

```mermaid
stateDiagram-v2
    [*] --> 待派单: 报警转工单创建
    [*] --> 待接单: 巡检/维修直接下派
    待派单 --> 待接单: 管理员派单
    待接单 --> 已接单: 责任人接单确认
    已接单 --> 处理中: 开始处置(处理前照片+简述)
    处理中 --> 处理中: 追加处理流水(可多次)
    处理中 --> 待验收: 提交审核(处理后照片+描述)
    待验收 --> 处理中: 验收驳回(驳回原因)
    待验收 --> 已结案: 审核通过(评价/建议)
    待派单 --> 已取消: 管理员取消
    待接单 --> 已取消: 管理员取消
    已接单 --> 已取消: 管理员取消
    处理中 --> 已取消: 管理员取消
    待验收 --> 已取消: 管理员取消
    已结案 --> [*]
    已取消 --> [*]
```

## 5. “验收驳回”与“取消工单”的区别（重点，消除旧歧义）

- **验收驳回**是一个**动作而非状态**：管理员对处置结果不满意时，把“待验收”工单退回“处理中”，由原责任人继续整改；工单不终止、不换单。
- **取消工单**是一个**迁到终态“已取消”的动作**：用于不再继续本单（例如对该责任人处置不满、误报、停止处置）。取消后若仍需处置，应创建新工单并派给新责任人。
- 旧模型中“已驳回”是独立终态、且只允许在待派单/待接单驳回；**该终态在七态模型中废止**：未开始即终止的情形统一走“取消→已取消”，验收不通过统一走“驳回→回处理中”。

## 6. 处理流水与处置证据

处置证据按阶段区分，遵循 [ADR-0006 工单附件存储](../adr/0006-work-order-attachment-storage.md)（MinIO 对象 + KingbaseES 阶段化元数据，旧 URL 字段兼容）：

- **处理前证据**：开始处置（3→4）时上传处理前照片与现场简述。
- **处理流水**：处理中（4）可多次追加，每条可含图片与处理描述，并逐条写入工单操作日志，不改变状态。
- **处理后证据**：提交审核（4→5）时上传处理后照片与处理描述。
- **验收意见**：审核通过时记录评价/建议；验收驳回时记录驳回原因；取消时记录取消原因。

## 7. 与设备预警/报警的关系

- 工单来源于设备预警/报警，但**工单状态独立于设备报警状态**：工单结案/取消不直接清除报警；设备是否恢复由运行系统依据“有效报警原因”自动维护（见 ADR-0002）。
- 同一设备同一报警类型，同一时间只能存在一张未结束（非 6/7 终态）的同类工单；不同报警类型可分别建单。
- 一次维修同时消除其他异常属于“随同修复”，其他工单仍各自保留并完成验收，不静默结案。

## 8. 目标编码与现网编码对照（迁移期）

现网 `work_order.order_status` 仍是旧 1–9 编码；**对齐到目标 1–7 的代码与存量数据迁移另开任务**，迁移完成前按下表换算，业务讨论一律使用状态名。目标编码从 1 开始后，前六态与现网旧编码 1–6 **同值**，仅第 7 态语义不同。

| 状态名 | 目标编码（权威） | 现网旧编码（迁移前） |
| --- | --- | --- |
| 待派单 | 1 | 1（同值） |
| 待接单 | 2 | 2（同值） |
| 已接单 | 3 | 3（同值） |
| 处理中 | 4 | 4（同值） |
| 待验收 | 5 | 5（同值） |
| 已结案 | 6 | 6（同值） |
| 已取消 | 7 | 旧实现无独立值（`cancel`/`reject` 都落到旧 7） |
| ~~已驳回（废止）~~ | — | 7（旧终态，取消与驳回混用） |
| ~~延期审核（废止）~~ | — | 8 |
| ~~已延期（废止）~~ | — | 9 |

迁移任务至少需要：把旧 7（“已驳回”/取消混用）重定义为独立“已取消（7）”、把“验收驳回”实现为 5→4 回退、下线延期状态（旧 8/9）与字段语义、同步工单操作日志类型与各前端/UE 状态字典；前六态编码与现网一致，无需整体重排。

## 9. 本版明确删除/不纳入的内容

- **删除“已驳回”终态**：驳回仅指“待验收→处理中”的回退动作。
- **删除延期相关状态**：不再有“延期审核（旧 8）”“已延期（旧 9）”，工单主流程不含申请/审核延期环节；旧字段的下线随迁移任务处理。
- 不引入 Flowable 等外部工作流引擎，继续使用数据库状态机 + 事务服务（沿用 ADR-0004 中仍有效的部分）。