# 城市生命线业务语境

本语境统一城市生命线平台各业务页面使用的业务语言，当前重点覆盖供水监测报警与工单处置。

## 供水监测与工单

**设备异常**:
供水监测设备处于需要人工关注或处置的异常状态；设备自动报警、离线或维修过程都是设备异常的来源。设备异常管理看板按设备状态表口径并列展示三种来源：报警中（`alarm_status=1`）、离线（`online_status=0`）、维修中（`current_status=1`），三者相互独立、可同时命中，不得互相替代，也不在页面提供派单或建单入口。
_Avoid_: 维修任务、异常工单、只把报警当作异常、把维修中并入报警

**报警转工单**:
用户根据设备报警创建尚未指定接单责任人的故障维修工单，将报警纳入人工处置流程。报警记录与工单分别表达监测事实和处置过程。
_Avoid_: 报警处理、报警派单

**报警审核**:
四个子系统共用审核页，对未处理报警做出“确认报警”或“误报警”结论。确认报警创建待派单工单，但两种审核都不修改设备状态或报警处理状态；完整工单处置由统一工单页承载。确认日志直接包含“已转工单（实际工单号）”与选填意见，工单关联及后续操作不复制到报警日志。审核页与详情页共用按日期分组的倒序报警历史，样式参照 `dispose.vue`，人工操作显示用户昵称。
_Avoid_: 工单审核、工单处置

**报警等级**:
根据报警规则和实际监测数据计算出的严重程度，共分一级、二级、三级和四级，其中一级最严重。
_Avoid_: 工单优先级

**报警运营页面**:
供水/排水共用 `subSystem/alarm/list` 清单，排水另设 `remind` 提醒、`drainage/analysis` 研判和 `drainage/alarmGIS` GIS。查询范围由菜单 `rootTypeId` 与后端获授权菜单共同约束，设备类型包含根及后代；清单展示历史已恢复事件，审核列表仍只看未处理事件。GIS 详情仅设备信息、报警记录、监测曲线，无周边环境页签。
_Avoid_: 将清单权限等同于审核权限

报警提醒仅展示 `alarm_status=0`，移除跳转报警清单操作。清单查询使用“报警时间”和“请输入设备编码/名称”，移除审核结果查询条件但保留结果列。GIS 监测曲线与研判事件候选仅保留实际值非空的事件，0 正常保留；地图点位和报警记录不因此过滤，研判候选在后端分页前筛选。

**报警单号**:
`alarm_data.alarm_no`，新记录由后端程序在保存前生成 `BJyyyyMMddHHmmss` + 4 位随机数，使用北京时间；保留数据库唯一索引，普通更新不可修改单号；不使用数据库生成触发器或序列。清单/审核首列与转工单创建日志使用该号；不回填历史，无号码显示 `—`。
_Avoid_: 报警 UUID、监测指标编码、工单编号

**报警展示状态**:
由报警持久化状态、审核结果和关联工单推导出的面向用户的状态，用于区分待审核、已转工单、已解除和误报警；它不替代设备报警状态。
_Avoid_: 报警记录持久化状态、设备报警状态

**报警记录状态**:
表示单条报警记录是否已经人工处置的辅助状态；它不决定设备当前是否报警，也不代表关联工单的进度。
_Avoid_: 设备报警状态、工单状态

**设备报警状态**:
表示监测设备当前是否处于报警中的设备级状态，由运行系统根据设备仍然有效的报警原因维护。
_Avoid_: 报警记录状态、工单状态

**设备当前状态**:
设备状态表 `equipment_status.current_status` 表达的资产状态，编码以后端 `CurrentStatusEnum` 为准：0-在用、1-维修、2-报废。设备异常管理看板与统一设备模块按此口径解释；旧 GIS 代码里的 3-维修 不再是权威。
_Avoid_: 在线状态、报警状态、3-维修

**工单处置状态**:
表示统一工单当前所处的待派单、待接单、已接单、处理中、延期中、待验收、已结案或已取消阶段；延期中是处理中的旁路阶段，终态仅已结案与已取消。
_Avoid_: 设备报警状态、报警记录状态、已驳回状态、延期审核状态、把延期中视作终态

**验收驳回**:
管理员在待验收阶段将工单退回处理中、由同一接单责任人继续整改的动作，必填驳回原因；它是动作而非工单状态。
_Avoid_: 已驳回状态、工单驳回终态

**已取消**:
管理员取消工单后进入的终态；任意中间态均可进入，进入后不可复活，改派需另建新单。
_Avoid_: 已驳回、终止

**处理流水**:
接单责任人在处理中阶段多次追加的处置记录，含描述与可选图片，不改变工单状态。
_Avoid_: 工单状态、报警记录状态

**工单派发**:
在统一工单页中为待派单工单指定唯一接单责任人的业务活动；报警审核只生成待派单工单，不直接派发。
_Avoid_: 报警转工单、工单接单

**接单责任人**:
一次工单派发中唯一负责接收并推进该工单的系统用户。
_Avoid_: 接单人列表、维修人员姓名

**工单处置**:
接单责任人对工单执行接单、处理和提交验收，管理人员随后完成验收或验收驳回的全过程。
_Avoid_: 报警审核、报警处理

**延期中**:
延期申请审核通过后，工单继续由责任人执行的处理旁路阶段。它不是终态，也不表示处置已结束。
_Avoid_: 已延期、延期审核、已结案

**故障维修工单**:
处理设备故障、设备异常或设备报警的工单类型。维修任务和报警转入的处置均归入此类型。
_Avoid_: 维修任务、报警工单

**同类报警工单**:
同一设备主键针对同一 `alarm_data.warning_code` 建立的故障维修工单，同一时间只能存在一个尚未结束的同类报警工单（0/1/2/3/4/6），已结案或已取消不占名额；普通手动建单、隐患转工单不限制同设备数量。报警编码缺失时阻止报警转工单，不再按报警显示名称替代判定（2026-09-24）。
_Avoid_: 同一报警记录、同设备全部工单

**随同修复**:
一项维修工作同时消除了同一设备其他工单所对应异常的处置结果；其他工单仍须保留记录并完成各自的验收结案。
_Avoid_: 自动结案、重复维修

**日常巡检工单**:
用于执行计划内日常检查的工单类型。
_Avoid_: 巡检任务

**设备保养工单**:
用于执行计划内设备维护保养的工单类型。
_Avoid_: 保养任务、维修任务

**统一工单**:
承载故障维修、日常巡检和设备保养全过程的业务记录。
_Avoid_: 维修任务、报警工单

**工单状态编码口径**:
工单状态名是跨系统交流的业务权威；迁移期间不同技术契约可能使用不同编码，调用方必须依据所属契约解释并以状态名展示，不得脱离契约复用裸编码。
_Avoid_: 把相同数字直接认定为相同工单状态