deviceStatus.js 5.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596
  1. /**
  2. * 监测**设备**自身状态 → 视觉表现(票 44;决策票 07)。
  3. *
  4. * ── 为什么必须是**平行**于 `pointStatus.js` 的另一张表,而不是复用它 ──
  5. * 两张表的业务对象不同、状态来源也不同:
  6. * · `pointStatus.js` 表达**监测点聚合状态**(后端解析并发布,六个取值含 `EMPTY`「无设备」);
  7. * · 本表表达**监测设备自身状态**(五个取值,**没有 `EMPTY`** —— 那是点位聚合态专有)。
  8. * 早先 `detailFlow.js` 正拿点位那张表给设备配色配形(即"把设备猜成点位状态"在代码里已经发生),
  9. * 那是越界;本票把它改到本表(见 `domain/detailFlow.js` 的 `deviceStatusView`)。
  10. *
  11. * ── 三条纪律(与 `pointStatus.js` 同源,但取值集不同)──
  12. * 1. **前端不重算**:只接收后端 `deviceStatus` 字符串;认不出的落 `UNKNOWN`(「状态未发布」),
  13. * 宁可如实说不知道,**不猜成 NORMAL** —— 猜成正常是最危险的一种谎话。
  14. * 2. **颜色不是唯一线索**:每态同时有 `tone`(色键)+ `shape`(形状)+ `label`(文字)。
  15. * 色键**只写键名**,色值仍只在 `styles/tokens.css` 声明(票 06 的单一口径)。
  16. * 3. **色键可同、语义不混**:点位与设备可用同一组 `--lv1..--neutral` 调色板,
  17. * 但两表的键位含义各自成立,不得互相推导。
  18. *
  19. * 五态与中文标签照抄后端 `CockpitMonitoringPointDeviceCard.deviceStatus` 的取值
  20. * (`ALARM`/`WARNING`/`WORK_ORDER`/`NORMAL`/`OFFLINE`),不另造业务词汇。
  21. * 本票只交付**静态**色/形/文字;动效(扩散脉冲/闪烁/旋转环)归票 47。
  22. */
  23. import { SHAPES } from './pointStatus.js'
  24. /** 后端设备自身状态的五个取值(原样字符串,不改名、不缩写)。 */
  25. export const DEVICE_STATUS = {
  26. ALARM: 'ALARM',
  27. WARNING: 'WARNING',
  28. WORK_ORDER: 'WORK_ORDER',
  29. NORMAL: 'NORMAL',
  30. OFFLINE: 'OFFLINE',
  31. }
  32. /**
  33. * 设备状态视觉词表。
  34. *
  35. * 形状**复用** `pointStatus.js` 的 `SHAPES` 片段(同风格、同一份 SVG 来源,避免两套图形定义),
  36. * 但**键与语义在本表独立成立**:例如点位表的 `EMPTY`(无设备)在这里根本不存在。
  37. *
  38. * `priority` 是**设备点自己的显示序**(维护者 2026-11-06《点位特效显示规则》「设备点」一节:
  39. * 报警 > 工单 > 预警 > 独立设备),**不沿用**后端点位的枚举 priority —— 后者是监测点的**聚合**序
  40. * (报警 > 预警 > 工单),两张序刻意不同(见后端 `CockpitMonitoringPointStatus` 的类注释)。
  41. * 此前这里沿用枚举值,2026-11-02 的对调曾让它短暂「正确」,但那只是巧合;现在由规则直接钉住。
  42. * 关心的是「多个标签同时存在时展示谁」,所以排列顺序与聚合符号取色都以本表为准。
  43. */
  44. export const DEVICE_STATUS_VISUALS = {
  45. ALARM: { key: 'ALARM', tone: 'lv1', shape: 'triangle', label: '报警', priority: 1, effect: 'pulse' },
  46. // 工单处置排在预警之前:两地都「在处置中」时,处置动作是更进展的那一步(规则原文②③)。
  47. WORK_ORDER: { key: 'WORK_ORDER', tone: 'lv3', shape: 'square', label: '工单处置', priority: 2, effect: 'spin' },
  48. WARNING: { key: 'WARNING', tone: 'lv2', shape: 'diamond', label: '预警', priority: 3, effect: 'blink' },
  49. NORMAL: { key: 'NORMAL', tone: 'lv4', shape: 'circle', label: '正常', priority: 4, effect: null },
  50. OFFLINE: { key: 'OFFLINE', tone: 'point-offline', shape: 'ring', label: '离线', priority: 5, effect: null },
  51. }
  52. /**
  53. * 认不出的设备状态:如实说「不知道」,**不落到任何一个真实状态上**(尤其不猜 NORMAL)。
  54. * `effect: null` —— 状态都不知道,**更不能给它编一个动效**(那会把"未知"画成"正在报警")。
  55. */
  56. export const DEVICE_UNKNOWN_VISUAL = { key: 'UNKNOWN', tone: 'point-unknown', shape: 'hollowDiamond', label: '状态未发布', priority: 6, effect: null }
  57. /** 设备状态字符串 → 视觉词条;认不出的一律 `DEVICE_UNKNOWN_VISUAL`。 */
  58. export function deviceVisualForStatus(status) {
  59. return DEVICE_STATUS_VISUALS[status] || DEVICE_UNKNOWN_VISUAL
  60. }
  61. /** 一条设备的视觉词条 → 地图标记要的形状名(引擎只认形状,不认业务状态)。 */
  62. export function deviceShapeOf(device) {
  63. return deviceVisualForStatus(device && device.status).shape
  64. }
  65. /**
  66. * 设备状态图例行(**独立于监测点摘要图例**,规格与票 09 的边界都要求分开)。
  67. *
  68. * 行序 = 设备点的显示序(报警 > 工单处置 > 预警 > 正常 > 离线 > 未发布,见上面的词表注释):
  69. * 图例是「优先级」的对外说明,若它按另一套顺序排,读者会以为预警比工单优先。
  70. * `count` = 当前模式实际绘制的该状态设备数(由调用方给,本层只负责行与顺序)。
  71. * 0 不隐藏行(形状的含义要能查到)。
  72. * @param {object} [byStatus] `{ [visualKey]: count }`
  73. */
  74. export function deviceLegend(byStatus = {}) {
  75. const rows = [...Object.keys(DEVICE_STATUS_VISUALS).map((key) => DEVICE_STATUS_VISUALS[key]), DEVICE_UNKNOWN_VISUAL]
  76. return rows
  77. .sort((a, b) => a.priority - b.priority)
  78. .map((visual) => ({
  79. key: visual.key,
  80. tone: visual.tone,
  81. shape: visual.shape,
  82. label: visual.label,
  83. count: byStatus[visual.key] || 0,
  84. }))
  85. }
  86. /** 该形状名在本表(及其复用的 `SHAPES`)里是否存在;供静态守卫与降级判据用。 */
  87. export function isKnownDeviceShape(shape) {
  88. return Object.prototype.hasOwnProperty.call(SHAPES, shape)
  89. }