浏览代码

docs(work-order): align alarm and gis page responsibilities

Kazerin 1 月之前
父节点
当前提交
04886098f9
共有 2 个文件被更改,包括 59 次插入 和 30 次删除
  1. 7 3
      CONTEXT.md
  2. 52 27
      docs/design/2026-08-22-water-supply-work-order-ui.md

+ 7 - 3
CONTEXT.md

@@ -5,7 +5,7 @@
 ## 供水监测与工单
 
 **设备异常**:
-供水监测设备处于需要人工关注或处置的异常状态;设备自动报警是设备异常的一种来源。
+供水监测设备处于需要人工关注或处置的异常状态;设备自动报警、离线或维修过程都是设备异常的来源。
 _Avoid_: 维修任务、异常工单
 
 **报警转工单**:
@@ -13,13 +13,17 @@ _Avoid_: 维修任务、异常工单
 _Avoid_: 报警处理、报警派单
 
 **报警审核**:
-对设备报警是否属实及其审核意见进行确认的业务活动;它与同一页面承载的工单处置仍是不同活动。
+对报警是否属实做出“转工单”或“误报解除”结论的审核活动;完整工单处置由统一工单页承载。
 _Avoid_: 工单审核、工单处置
 
 **报警等级**:
 根据报警规则和实际监测数据计算出的严重程度,共分一级、二级、三级和四级,其中一级最严重。
 _Avoid_: 工单优先级
 
+**报警展示状态**:
+由报警持久化状态、审核结果和关联工单推导出的面向用户的状态,用于区分待审核、已转工单和已解除;它不替代设备报警状态。
+_Avoid_: 报警记录持久化状态、设备报警状态
+
 **报警记录状态**:
 表示单条报警记录是否已经人工处置的辅助状态;它不决定设备当前是否报警,也不代表关联工单的进度。
 _Avoid_: 设备报警状态、工单状态
@@ -45,7 +49,7 @@ _Avoid_: 已驳回、终止
 _Avoid_: 工单状态、报警记录状态
 
 **工单派发**:
-为待派单工单指定唯一接单责任人的业务活动。
+在统一工单页中为待派单工单指定唯一接单责任人的业务活动;报警审核只生成待派单工单,不直接派发。
 _Avoid_: 报警转工单、工单接单
 
 **接单责任人**:

+ 52 - 27
docs/design/2026-08-22-water-supply-work-order-ui.md

@@ -8,15 +8,18 @@
 
 本次覆盖:
 
+- 供水系统首页
 - 设备维修派单
 - 设备异常管理
 - 报警管理
 - 报警审核
+- 监测报警一张图
 - 供水工单总览(现有统一工单页)
 - 供水系统完整菜单树的图标
 
 不在本次范围:
 
+- 监测报警-阈值管理页
 - 在供水系统创建或首次派发日常巡检、设备保养工单
 - 其他供水业务页面的布局重构
 - 深色主题
@@ -27,17 +30,17 @@
 ### 报警与设备状态
 
 - 设备当前是否报警以设备状态表的设备报警状态为准。
-- 单条报警记录的未处理或已处理状态只作为历史辅助信息。
+- 报警持久化状态只保留 `0-未处理 / 1-已处理`,不作为用户可见状态。
+- 用户可见的报警展示状态由后端聚合推导:待审核、已转工单、已解除。
 - 报警严重程度由运行监测系统计算,前端只展示一级至四级结果,不重新计算。
 - 报警等级颜色固定为:一级红、二级橙、三级蓝、四级绿。标签必须同时显示等级文字,不能只依赖颜色。
-
 ### 报警转工单与去重
 
 - 报警接口先创建待派单的故障维修工单,责任人由后续统一工单派发完成。
 - 同一报警记录不得重复生成工单。
 - 同一设备、同一报警编码同时只能存在一个未结束的故障维修工单;报警编码缺失时按报警分类判定。
 - 同一设备的不同报警编码可以分别生成故障维修工单。
-- 用户在报警管理点击“派单”时,前端连续完成“确保待派单工单存在”和“选择责任人并派发”两个步骤。第二步失败时保留待派单工单,以便重试。
+- 报警管理不直接派单;报警审核生成待派单工单后,由统一工单页完成责任人派发。
 
 ### 恢复、误报与结案
 
@@ -57,38 +60,55 @@
 - 前端根据当前用户、工单状态及后端返回的允许操作展示按钮,最终权限由后端校验。
 
 ## 页面职责
+### 供水首页
 
-### 设备异常管理
+- 供水首页采用纵向业务工作台,自上而下分为三个区块:A 指挥台、B 异常待办、C 数据总览。
+- A 区展示核心总量指标、实时报警、地图态势和工单进展。
+- B 区展示异常待办、选中设备摘要和设备异常管理、报警管理、报警审核、监测报警一张图入口。
+- C 区展示报警总数、报警中设备、待验收工单、在线率、报警趋势、报警分类占比和设备分类占比。
+- 首页是蓝白业务工作台,不做成深色大屏;点击入口后跳转到对应业务页面。
 
-- 展示全部异常设备、设备报警状态、当前报警原因和关联工单进度。
-- 支持查看详情和故障维修派单。
-- 已存在适用的未结束工单时,隐藏重复派单操作,显示工单编号、责任人、状态和查看入口。
 
-### 设备维修派单
+### 设备异常管理
+- 异常范围包含离线设备;页面支持离线、报警、离线且报警、维修中和全部异常筛选。
 
-- 聚焦尚无适用故障维修工单的异常设备。
-- 主操作为选择唯一接单责任人并派单。
-- 已有关联工单的设备降低视觉优先级并提供查看入口。
+- 设备异常管理是只读状态看板,展示设备基本信息、在线状态、报警状态、最近上报、关联工单进度和异常原因。
+- 支持设备详情和批量导出,不提供工单创建、维修派单或状态修改操作。
+- 已有关联工单时,展示工单编号、责任人、当前状态和进度入口。
+### 设备维修派单
 
+- 设备维修派单是进入统一工单页的业务入口。
+- 统一工单页是跨系统共用的工单处置页面,负责派单、接单、处理、验收、验收驳回、取消和延期等完整处置动作。
+- 异常设备本身不在这里重复承载处置操作。
 ### 报警管理
+- 统计与趋势数据由后端聚合接口提供;前端不做全量历史记录统计。
 
-- 展示整体报警态势、报警等级、设备报警状态和关联工单处置状态。
-- 支持报警详情、报警转工单、责任人派发和查看关联工单。
-- 不提供接单、处理、验收等后续处置操作。
-
+- 报警管理是报警台账总览,展示报警态势、历史趋势、报警分类占比、设备分类占比、设备报警状态、报警展示状态和关联工单。
+- 支持报警详情、批量导出和跳转报警审核。
+- 不提供审核、转工单、误报解除、标记处理或直接派单操作。
+- 菜单名称保持“报警管理”。
 ### 报警审核
+- 页面默认展示待审核;提供待审核、已转工单、已解除和全部状态切换。
 
+- 报警审核是审核处置工作台,是审核动作的唯一归属地。
+- 审核结果只有两个:转工单、误报解除。
+- 转工单后生成待派单故障维修工单;完整派单、接单、处理、提交验收、验收、验收驳回、取消和延期由统一工单页承载。
+- 本页只展示关联工单进度,不重复承载工单处置操作。
 - 菜单名称保持“报警审核”。
-- 只承载供水设备的故障维修工单及其关联报警。
-- 提供报警审核,以及派单、接单、开始处理、提交验收、验收、验收驳回(回退动作)和取消等完整工单流程。
+### 监测报警一张图
+- 同一设备的多条报警或工单合并为一个设备点位;点位状态按“关联工单 > 报警 > 预警 > 离线 > 正常”取最高风险语义。
 
-### 供水工单总览
+- 监测报警一张图只展示异常相关点位,包括设备预警、报警和关联工单状态,不在本图展示全部正常设备。
+- 点位继续使用共享 GIS 画布和统一坐标点样式;输入 WGS-84,渲染前转换为 BD-09。
+- 点位颜色沿用监测点状态语义:正常绿、报警红、预警黄、有关联工单蓝、离线灰。
+- 点击点位后使用右侧抽屉展示详情,保留当前页面左侧状态栏总览。
 
-- 保留统一工单页并调整为全部供水类型工单的集中检索与管理入口。
-- 故障维修工单提供完整处置流程。
-- 日常巡检和设备保养工单由其他业务系统创建。
-- 巡检或保养工单派给当前用户后,允许其在本页继续接单、处理、提交验收;相应管理人员可以执行后续审核操作。
+### 供水工单总览
 
+- 统一工单页是所有系统共用的工单处置页面,也是供水工单的集中检索与处置入口。
+- 工单状态沿用最新代码枚举:0-待派单、1-待接单、2-已接单、3-处理中、4-待验收、5-已结案、6-延期中、7-已取消。
+- 终态只有已结案和已取消;延期中是处理旁路状态。
+- 故障维修、日常巡检和设备保养工单可在此继续按权限处置。
 ## 共享交互
 
 ### 接单责任人选择器
@@ -101,7 +121,7 @@
 
 ### 表单反馈
 
-- 设备维修、设备异常和报警管理派单均要求责任人和问题描述。
+- 统一工单页的派单必须选择唯一接单责任人并填写问题描述;报警审核只负责生成待派单工单。
 - 优先级默认一般;报警可按已有报警等级给出默认优先级;计划完成时间可选。
 - 报警工单类型只读显示“故障维修(报警转入)”。
 - 成功提示“已派单,等待接单”,刷新并定位关联工单。
@@ -120,12 +140,14 @@
 - 交互过渡为 120-180ms;报警状态不持续闪烁。
 
 ### 页面构图
+- 供水首页:纵向业务工作台,按指挥台、异常待办、数据总览三段组织。
 
 - 报警管理:紧凑指标带、筛选栏、报警表格、右侧详情抽屉。
-- 报警审核:左侧列表与右侧详情工作台;详情标签为报警信息、工单处置、处理记录;底部固定当前可用操作。
+- 报警审核:默认待审核工作台,左侧列表与右侧详情工作台;审核动作只提供转工单和误报解除。
 - 供水工单总览:复用主从工作台,强化工单类型、来源系统、责任人和状态。
-- 设备异常管理:异常指标带、筛选、设备表格和右侧详情抽屉。
-- 设备维修派单:待派单队列为主,突出责任人选择和派单操作。
+- 设备异常管理:只读异常指标带、筛选、设备表格和右侧详情抽屉。
+- 设备维修派单:作为业务入口进入统一工单页,不重复承载派单操作。
+- 监测报警一张图:异常点位地图,左侧状态总览,点击点位打开右侧详情抽屉。
 
 ### 图标与导航
 
@@ -159,10 +181,13 @@
 5. 工单接口能够表达当前用户允许执行的操作,并在服务端执行最终授权校验。
 6. 日常巡检和设备保养工单允许接单责任人在供水工单总览继续后续处置。
 7. 供水动态菜单配置提供所有菜单项的图标值,并与前端图标解析规则一致。
+8. 报警管理提供后端聚合接口,返回报警趋势、报警分类占比和设备分类占比。
+9. 报警列表或详情返回后端推导的报警展示状态:待审核、已转工单、已解除。
+10. 监测报警一张图返回按设备聚合后的异常点位,避免同一设备产生重复点位。
 
 ## 验收标准
 
-- 五个页面按职责显示正确的数据范围和操作集合。
+- 首页、设备异常管理、报警管理、报警审核和监测报警一张图按职责显示正确的数据范围和操作集合。
 - 三类状态来源明确,页面不再把报警记录状态当作设备报警状态。
 - 同一责任人选择器在相关入口保持一致,且派单只产生一个责任人。
 - 同设备同报警编码不能并行生成多个未结束工单;不同报警编码可以分别生成。