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

状态：accepted
更新日期：2026-09-10
后端权威文档：`pipe-network-service/docs/domain/work-order-lifecycle.md`

> 本文是前端 `city-life-line` 渲染与操作工单状态的唯一业务依据。状态名是业务权威；调用方只能按所属接口契约解释状态编码，不得跨接口复用裸数字。2026-09-10 起，管理端业务工单采用数据库与前端一致的 `0–7` 契约。

## 1. 本仓职责

- 本仓是**管理端 Web UI**：按管理端契约渲染工单状态标签、状态统计、详情时间线与当前可用操作按钮。
- 前端只做“当前状态允许哪些动作”的展示控制；最终授权与状态流转由后端校验，前端不自行改状态。
- UE 驾驶舱是另一只读消费方，本仓不向其输出写操作。

## 2. 角色

- **管理员（派单/验收者）**：派单下发、验收通过、验收驳回、取消工单。
- **接单责任人**：接单确认、开始处置、多次追加处理流水、提交验收。一次派发指定唯一接单责任人。

## 3. 管理端工单状态

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

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

## 4. 状态迁移与前端动作

| 动作 | 角色 | 前置态 | 目标态 | 前端要点 |
| --- | --- | --- | --- | --- |
| 创建（报警转工单） | 系统/管理员 | — | 待派单 | 不在报警创建接口塞责任人 |
| 直接下派（巡检/维修） | 管理员 | — | 待接单 | 创建即选唯一责任人 |
| 派单/下发 | 管理员 | 待派单 | 待接单 | 部门树 + 单选责任人弹窗 |
| 核查接单 | 责任人 | 待接单 | 已接单 | 必传现场情况附件，作为处理前证据 |
| 处置 | 责任人 | 已接单 | 处理中 | 可多次追加描述与附件 |
| 处置 | 责任人 | 处理中 / 延期中 | 原状态 | 处理流水自循环，不改状态 |
| 提交验收 | 责任人 | 处理中 / 延期中 | 待验收 | 必传处理后证据与描述 |
| 验收通过 | 管理员 | 待验收 | 已结案 | 填验收结果 |
| 验收驳回 | 管理员 | 待验收 | 处理中 | 必填驳回原因，交同一责任人继续整改 |
| 取消工单 | 管理员 | 待派单 / 待接单 / 已接单 / 处理中 / 待验收 | 已取消 | 建议填取消原因 |
| 申请延期 | 责任人 | 处理中 | 待延期审核 | 写入延期申请状态，不改主状态 |
| 延期审核 | 管理员 | 待延期审核 | 处理中 / 延期中 | 通过进入延期中，驳回回到处理中 |

前端渲染约束：

- “验收驳回”是动作不是状态；被驳回的工单显示为“处理中”，并在时间线展示驳回原因。
- “延期中”是处理旁路状态；不得把它渲染成已结案或终态。
- “延期申请状态”与“工单状态”是两个来源，不得互相替代。
- “已取消”是终态，用灰色不可操作样式；不提供复活/继续处置入口。
- 状态标签必须文字与颜色同时表达，颜色语义沿用供水设计文档。

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

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

## 6. 与驾驶舱只读契约的关系

UE 驾驶舱继续消费只读适配契约；该契约必须由后端显式把管理端 `0–7` 状态映射为驾驶舱展示状态，并由后端保证“延期中”等旁路状态不会误映射成终态。前端 GIS 和管理端工单页面只消费管理端关联工单摘要，不承担数据库状态迁移。

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

工单状态独立于设备报警状态与报警记录状态，三者来源不同、不得互相替代；工单结案只触发后端清警复核，前端不直接把设备改为正常。