city-life-line/CONTEXT.md

城市生命线业务语境

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

供水监测与工单

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

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

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

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

报警运营页面: 供水报警管理是供水专属的只读报警流水与态势台账，展示四级历史趋势及报警/设备分类占比；排水保留公共报警清单、提醒和研判。两者查询范围均由设备类型树及菜单授权约束，报警审核仍为独立的人工审核入口，报警管理不承载审核或工单写操作。 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: 把相同数字直接认定为相同工单状态