Selaa lähdekoodia

docs(work-order): record management status migration contract

Kazerin 1 kuukausi sitten
vanhempi
commit
8cca600296
1 muutettua tiedostoa jossa 13 lisäystä ja 15 poistoa
  1. 13 15
      pipe-network-service/docs/domain/work-order-lifecycle.md

+ 13 - 15
pipe-network-service/docs/domain/work-order-lifecycle.md

@@ -98,24 +98,22 @@ stateDiagram-v2
 - 同一设备同一报警类型,同一时间只能存在一张未结束(非 6/7 终态)的同类工单;不同报警类型可分别建单。
 - 一次维修同时消除其他异常属于“随同修复”,其他工单仍各自保留并完成验收,不静默结案。
 
-## 8. 目标编码与现网编码对照(迁移期)
+## 8. 目标编码与现网接口编码(迁移期)
 
-现网 `work_order.order_status` 仍是旧 1–9 编码;**对齐到目标 1–7 的代码与存量数据迁移另开任务**,迁移完成前按下表换算,业务讨论一律使用状态名。目标编码从 1 开始后,前六态与现网旧编码 1–6 **同值**,仅第 7 态语义不同。
+目标七态仍以 1–7 为权威。当前后端已出现两类并存契约:驾驶舱只读适配器输出目标 1–7;管理端 `BusinessWorkOrderService` 与供水设备详情仍读取数据库现网 0–7 编码,并保留 `6-延期中` 兼容分支。
 
-| 状态名 | 目标编码(权威) | 现网旧编码(迁移前) |
+| 状态名 | 目标编码(权威/驾驶舱只读) | 管理端现网编码 |
 | --- | --- | --- |
-| 待派单 | 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 状态字典;前六态编码与现网一致,无需整体重排。
+| 待派单 | 1 | 0 |
+| 待接单 | 2 | 1 |
+| 已接单 | 3 | 2 |
+| 处理中 | 4 | 3 |
+| 待验收 | 5 | 4 |
+| 已结案 | 6 | 5 |
+| 已取消 | 7 | 7 |
+| ~~延期中(废止目标状态)~~ | — | 6(迁移期兼容) |
+
+迁移期间调用方必须按接口契约解释编码并以状态名展示,不能跨接口复用裸数字。监测设备 GIS 只消费管理端关联工单摘要,不承担数据库状态迁移。后续迁移任务需把管理端状态编码对齐目标 1–7、删除延期兼容分支,并同步操作日志、前端和 UE 状态字典。
 
 ## 9. 本版明确删除/不纳入的内容