Ver código fonte

docs(cockpit): 补记图例入桶规则与状态事实来源

- 图例各行为独立标签桶,在线/离线只认显式 ONLINE/OFFLINE,未知不并入在线
- 设备在线/报警以 equipment_status 为准,后端快照需随状态重建(30 秒上限)
- 点位特效显示规则补「事实来源」一条,避免再用报警流水二次推断
ChenJZ 2 dias atrás
pai
commit
f437979141
1 arquivos alterados com 6 adições e 1 exclusões
  1. 6 1
      CONTEXT.md

+ 6 - 1
CONTEXT.md

@@ -223,9 +223,14 @@ _Avoid_: 把点位聚合数量当设备数量、同时计入监测点和其设
 **设备状态图例**:
 一张图顶部状态栏各行的**计数口径**:报警/预警/工单处置/独立设备是设备侧可叠加标签的台数,在线/离线是台账互斥台数,无设备监测点是点位侧特殊状态。每行另给出「上图 N」——当前模式下真正画到地图上的对象数,与前面的设备台数不是一个口径(设备无坐标、或挂载点位按聚合状态显示成别的颜色,都会让 N 更小),两个数并排显示,不留读者猜哪个错了。
 _Avoid_: 把图例计数当作地图坐标点数、把「上图 N」也按设备口径读、把两数不等当缺陷
+**图例入桶规则**:
+图例每一行都是**独立的标签桶**,按标签显式入桶,不用「总数减某一桶」倒推:报警/预警/工单处置/独立设备是可叠加标签(同一设备可同时进多个桶),在线与离线是互斥的基础属性,只把状态明确为 ONLINE / OFFLINE 的设备计入对应桶;台账没给状态或给了认不出的值时单列「未知」,**不许并入在线**。无设备监测点是点位侧唯一例外,仍按点位口径。
+设备的在线/报警事实以 `equipment_status` 为准;后端为它发布的快照必须随状态变化重建(当前设 30 秒上限),否则设备已开机、图例还是「在线 0」。
+_Avoid_: 用总数减离线算在线、把未知状态算成在线、把可叠加标签当成互斥状态、让快照永久冻结当成实时值
 
 **点位特效显示规则**:
 厂家 2026-11-06 重述的两套**显示优先级**,只管点位/设备点画什么颜色与特效,不管统计与筛选(统计按「设备预警/报警统计」的池口径,筛选按标签命中)。
+**事实来源**(维护者 2026-11-10):设备在线/报警一律以设备状态表 `equipment_status` 为准;不在驾驶舱用报警流水二次推断报警态——设备未开机等情况会让上游数据本身失信,那是后端数据问题,不由驾驶舱改写口径。
 **设备点**:无任何标签时只分在线/离线;有标签时按 报警 > 工单处置 > 预警 > 独立设备 展示;全部报警都已由未结束工单承接时显示工单处置(蓝),只要还剩一条报警未关联工单就显示报警(红);工单全部进入终态后若仍有未解除的预警/报警,照常显示黄/红;无任何业务标签且在线时,用黄绿区分「正常关联监测点的设备」与「未关联监测点的独立设备」。
 **监测点**:按内部关联设备的**显示状态**聚合,报警 > 预警 > 工单处置;关联设备全是离线则离线;没有关联设备则「无设备监测点」。监测点自身不进入顶部图例的设备计数池(唯一例外是无设备监测点),只参与设备筛选。
-_Avoid_: 用同一张优先级表同时服务设备点与监测点(两张序在预警/工单上刻意相反,合并必有一方违规)、把监测点的设备聚合数计进设备图例
+_Avoid_: 用同一张优先级表同时服务设备点与监测点(两张序在预警/工单上刻意相反,合并必有一方违规)、把监测点的设备聚合数计进设备图例、绕过设备状态表另数报警流水来决定点位颜色