# 统一工单处置生命周期（七态共识）· 前端职责

状态：accepted（与后端 `pipe-ner-server`、UE 驾驶舱 `Pipelines` 一致的跨仓领域共识）
确立日期：2026-09-04
后端权威文档：`pipe-network-service/docs/domain/work-order-lifecycle.md`、ADR-0008
取代口径：旧“九态模型”（含“已驳回”终态、“延期审核/已延期”）。

> 本文是前端 `city-life-line` 渲染与操作工单状态的唯一业务依据。状态名是权威；后端现网编码迁移另开任务，迁移完成前按第 7 节对照表换算，前端不得写死依赖旧“已驳回/延期”语义。

## 1. 本仓职责

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

## 2. 角色

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

## 3. 两条入口

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

## 4. 七个状态

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

终态只有“已结案（6）/ 已取消（7）”。

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

| 动作 | 角色 | 前置态 | 目标态 | 前端要点 |
| --- | --- | --- | --- | --- |
| 创建（报警转工单） | 系统/管理员 | — | 1 | 不在报警创建接口塞责任人 |
| 直接下派（巡检/维修） | 管理员 | — | 2 | 创建即选唯一责任人 |
| 派单/下发 | 管理员 | 1 | 2 | 部门树 + 单选责任人弹窗 |
| 接单确认 | 责任人 | 2 | 3 | — |
| 开始处置 | 责任人 | 3 | 4 | **必传处理前照片 + 现场简述** |
| 追加处理流水 | 责任人 | 4 | 4 | 可多次，图片+描述，不改状态 |
| 提交审核 | 责任人 | 4 | 5 | **必传处理后照片 + 处理描述** |
| 审核通过 | 管理员 | 5 | 6 | 填审核评价/建议 |
| 验收驳回 | 管理员 | 5 | 4（回退） | **必填驳回原因**，工单不终止 |
| 取消工单 | 管理员 | 1/2/3/4/5 | 7（终态） | 建议填取消原因；已结案不可取消 |

前端渲染约束：

- “验收驳回”是动作不是状态，列表/时间线里不出现独立“已驳回”状态标签；被驳回的工单显示为“处理中”，并在时间线展示驳回原因。
- “已取消”是终态，用灰色不可操作样式；不提供复活/继续处置入口。
- 状态标签必须文字与颜色同时表达，颜色语义沿用设计文档（红紧急、橙待办、青绿处理中、绿完成、灰已取消/不可操作）。
- 不再渲染任何“申请延期 / 延期审核 / 已延期”入口或标签。

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

- 处理前证据在“开始处置（3→4）”上传；处理流水在“处理中（4）”多次追加；处理后证据在“提交审核（4→5）”上传；验收意见/驳回原因/取消原因在对应动作记录。
- 附件走后端 MinIO + KingbaseES 阶段化元数据方案，旧图片 URL 字段兼容读取，前端不得丢失历史图片。

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

目标编码从 1 开始后，前六态与现网旧编码 1–6 同值，仅第 7 态语义不同。

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

前端状态字典应同时能解析新旧编码，但新增功能只面向七态；后端迁移完成后删除旧分支。

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

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