eventList.js 40 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754
  1. /**
  2. * 事件列表与预警/报警切换(票 13)的领域层。
  3. *
  4. * 数据源是**跨设备** `/events/current`(后端 `CockpitCurrentEventsResponse`,
  5. * 见 `E:\pipe-ner-server\docs\cockpit\README.md` 与 `CockpitCurrentEventsService`):
  6. * `mode`(WARNING|ALARM)必填并校验;`sections.events` 是
  7. * `CockpitSectionResult<List<EventItem>>`(**预警与报警永不混合**,mode 决定取哪一族);
  8. * 行内另带 `sections.workOrders`(工单摘要分区,本票不画、留给票 19)。
  9. *
  10. * 与设备维度 `/equipments/{code}/events/current`(`CockpitEventReadResponse`)不是
  11. * 同一个契约:设备维度一次带回 warnings+alarms 两族,本层只认跨设备的这一份。
  12. * `domain/events.js` 的 `toEventRead` 留在设备维度用,不在这里重复实现。
  13. *
  14. * 四条硬纪律(都是本票验收原句,收口在这里、组件不再自己判):
  15. * 1. **预警与报警可切换,列表字段和状态标签同步变化**(验收第 1 条):
  16. * `eventListSwitchView(mode)` 是**唯一**的切换视图 —— 字段标签(预警编号/报警编号)
  17. * 与状态标签名(预警状态/报警状态)从同一个对象取,切换时必然一起变,
  18. * 不会出现"字段是报警的、标签还是预警的"(结构上不可能)。
  19. * 2. **事件等级使用 1-4 级颜色并有文字辅助**(验收第 3 条):
  20. * `eventLevelTag(level)` 走 `statusTones.js` 的 `LEVEL_TAGS`(lv1..lv4 + '1级'..'4级'),
  21. * 与点位状态色(`pointStatus.js`)不是同一张表;认不出的等级落中性灰 + 文字,不猜。
  22. * 3. **事件不创建独立地图标记**(验收第 4 条):本层不产生任何标记计划、不 import
  23. * 引擎/地图服务;事件只带 `deviceCode` / `monitoringPointCode` 供票 14 按设备回联位置。
  24. * 4. **不判断预警真伪或误报**(验收第 5 条):后端契约明确「系统不判断预警真伪,
  25. * 没有任何准确率、误报率字段」(README 第 2 节),本层不发明任何判定,状态照原样带出。
  26. *
  27. * 事件 `status` 是后端**未冻结**的自由字符串(现网取值含 PENDING/PROCESSING/HANDLING 等,
  28. * 见 `BusinessCockpitDeviceFactResolver.OPEN_WARNING_STATUS`;契约测试用 ACTIVE/PENDING/
  29. * PROCESSING)。与票 17 的 `scale` 同一处境:直译已知取值,**认不出的回原码**(它是数据值
  30. * 不是原因码,照原样显示才是诚实的,CODE_TEXT 的立场),并由逻辑闸门守「登记码不得等于原码」。
  31. *
  32. * 本文件是纯函数层:不 import service、不碰 DOM、不自己发请求(t05 的 D3/D4 守卫盯着)。
  33. */
  34. import { fieldReader, toLocation, TIME_LABELS } from './fields.js'
  35. import { SECTION_STATE, section, sectionStateFromBackend } from './sectionState.js'
  36. import { EVENT_FAMILY, LEVEL_COLORS } from './events.js'
  37. import { statusText as familyStatusText } from './eventStatusVocab.js'
  38. import { LEVEL_TAGS, DEFAULT_TONE } from './statusTones.js'
  39. import { DETAIL_PLACEHOLDER } from './detailFlow.js'
  40. import { workOrderStateName } from './workOrder.js'
  41. import { pagedRows } from './pagination.js'
  42. // 票 67:本面板"不随当前范围变化"的措辞(单一来源,面板不各写一份)。
  43. import { districtEchoView } from './filterCaliber.js'
  44. /** 事件 `status` 的直译表(已知取值,来源见文件头;认不出的回原码)。 */
  45. export const EVENT_STATUS_TEXT = {
  46. ACTIVE: '进行中',
  47. PENDING: '待处理',
  48. PROCESSING: '处理中',
  49. HANDLING: '处置中',
  50. // 实测取值(维护者 2026-10-29:卡片状态原样显示英文):
  51. // 报警侧用 UNHANDLED/HANDLED,预警侧另有 RECEIVED/CLOSED/DRAFT 等字典值。
  52. UNHANDLED: '未处理',
  53. HANDLED: '已处理',
  54. RECEIVED: '已接收',
  55. CLEARED: '已解除',
  56. CLOSED: '已关闭',
  57. DRAFT: '草稿',
  58. CANCELLED: '已取消',
  59. MISREPORT: '误报',
  60. RESOLVED: '已解除',
  61. }
  62. /**
  63. * 事件**类型码 → 中文**(票 66)。
  64. *
  65. * 为什么需要:多维分析端点(`/events/multidimensional-analysis`)的 `EVENT_TYPE` 桶
  66. * **`bucketLabel` 与 `bucketCode` 同值**,下发的就是采集协议码(实测 2026-10-22:
  67. * `WARN-PRESSURE` / `WARN-CONDUCTIVITY` / `WARN-WATER-LEVEL`),后端不翻译。
  68. * 照 `bucketLabel` 直画就是把接口代号印上大屏(票 05/17 立的纪律,票 22/27 同类先例)。
  69. *
  70. * 取值来源**逐条有据**(不是猜的,也不许猜):
  71. * · `WarningCodeEnum`(管线后端 `com.zksy.base.alarm.domain.Enum`):悬浮物/COD/氨氮/电导率/PH;
  72. * · `AlarmMetricSource`(同仓 `base.alarm.enums`):瞬时流量/流速/水位/压力(真实分析端点下发这一套);
  73. * · `GasWarningCodeEnum`、`FirefightingWarningCodeEnum`、窨井 `WARN_CODE_*`、漏失 `LEAK_*` 常量。
  74. *
  75. * **两种拼法都要登记**:同一批编码在库里既有连字符(`WARN-WATER-LEVEL`)也有下划线
  76. * (`AlarmMetricSource` 与实测 `/events/current` 里的 `WARN_WATER_LEVEL`)。
  77. * 只登一种,同一个「水位预警」就会一条链路有中文、另一条漏英文码。
  78. *
  79. * **一处如实登记的冲突**:`WARN-PRESSURE` 在消防压力服务里叫「消防压力过高预警」,
  80. * 在 `AlarmMetricSource` 里是遥测压力(供水/排水)。分析端点只给码、分不出是哪一种,
  81. * 实测该码挂在「测试压力计」(供水) 与「公司正门」(排水) 上 ⇒ 取**指标语义**的「压力预警」,
  82. * 不冒充消防口径(票 66 正文记了这条冲突)。
  83. */
  84. export const EVENT_TYPE_TEXT = {
  85. // 压力(AlarmMetricSource 主码 + 消防压力服务的五个上下限/变幅码)
  86. 'WARN-PRESSURE': '压力预警',
  87. 'WARN-PRESSURE-HIGH': '压力上限预警',
  88. 'WARN-PRESSURE-HIGH-HIGH': '压力上上限预警',
  89. 'WARN-PRESSURE-LOW': '压力下限预警',
  90. 'WARN-PRESSURE-LOW-LOW': '压力下下限预警',
  91. 'WARN-PRESSURE-VARY': '压力变幅预警',
  92. // 流量/流速/水位
  93. 'WARN-INSTANT-FLOW': '瞬时流量预警',
  94. 'WARN-INSTANT-FLOW-SUPPLY': '供水瞬时流量预警',
  95. 'WARN-FLOW-SPEED': '流速预警',
  96. 'WARN-FLOW-SPEED-SUPPLY': '供水流速预警',
  97. 'WARN-WATER-LEVEL': '水位预警',
  98. // 污水水质(WarningCodeEnum)
  99. 'WARN-SUSPENDED-SOLIDS': '悬浮物预警',
  100. 'WARN-COD': '化学需氧量(COD)预警',
  101. 'WARN-AMMONIA-NITROGEN': '氨氮预警',
  102. 'WARN-CONDUCTIVITY': '电导率预警',
  103. 'WARN-PH': '酸碱度(pH)预警',
  104. // 可燃气体
  105. 'WARN-GAS-CONCENTRATION': '可燃气体浓度预警',
  106. // 后端枚举自己拼错了(`TEMPERATRUE`),键照抄它的拼法,不然真实数据认不出
  107. 'WARN-GAS-TEMPERATRUE': '可燃气体温度预警',
  108. 'WARN-GAS-HUMIDITY': '可燃气体湿度预警',
  109. // 窨井 / 漏失
  110. 'WARN-TILT': '窨井倾斜预警',
  111. 'WARN-WATER-INFILTRATION': '窨井渗水预警',
  112. 'WARN-WATER-MANHOLE-LEVEL': '窨井水位预警',
  113. 'WARN-LEAK': '漏失预警',
  114. 'WARN-LEAK-FREQ': '漏失特征频段预警',
  115. // 下划线拼法(`AlarmMetricSource` 的水质码;实测 `/events/current` 下发 `WARN_WATER_LEVEL`)
  116. 'WARN_PRESSURE': '压力预警',
  117. 'WARN_INSTANT_FLOW': '瞬时流量预警',
  118. 'WARN_FLOW_SPEED': '流速预警',
  119. 'WARN_WATER_LEVEL': '水位预警',
  120. 'WARN_SUSPENDED_SOLIDS': '悬浮物预警',
  121. 'WARN_COD': '化学需氧量(COD)预警',
  122. 'WARN_AMMONIA_NITROGEN': '氨氮预警',
  123. 'WARN_CONDUCTIVITY': '电导率预警',
  124. 'WARN_PH': '酸碱度(pH)预警',
  125. // 后端给「事件类型缺失」的显式兜底桶
  126. UNKNOWN_EVENT_TYPE: '未知事件类型',
  127. }
  128. /**
  129. * **契约样例专用**的类型码(票 66)。
  130. *
  131. * `contractMocks` 的样例事件用的是 `GAS_CONCENTRATION` / `SEWAGE_PH` 这类虚构码
  132. * (真实后端不下发它们,见 `mocks/contractMocks.js` 的 `CURRENT_WARNINGS`)。
  133. * 单独成表而不是混进 `EVENT_TYPE_TEXT`:这一张是**样例词汇**,真实词汇与它分得开,
  134. * 排查「这个码哪来的」时不会把样例码当成真实编码。
  135. *
  136. * 中文名取自样例行自己的 `eventName`(如 `GAS_CONCENTRATION` 的样例名是「燃气浓度预警」),
  137. * 不另外臆造。登记它的唯一目的:mock 模式下也不把码画上屏(否则维护者切 mock 又看到一遍英文)。
  138. */
  139. export const SAMPLE_EVENT_TYPE_TEXT = {
  140. GAS_CONCENTRATION: '燃气浓度预警',
  141. GAS_PRESSURE: '燃气压力预警',
  142. WATER_PRESSURE: '供水压力预警',
  143. WATER_FLOW: '供水流量预警',
  144. WATER_CHLORINE: '供水余氯预警',
  145. WATER_TURBIDITY: '供水浊度预警',
  146. SEWAGE_CONCENTRATION: '污水化学需氧量(COD)预警',
  147. SEWAGE_PH: '污水酸碱度(pH)预警',
  148. SEWAGE_NH3: '污水氨氮预警',
  149. SEWAGE_TEMP: '污水温度预警',
  150. DRAINAGE_LEVEL: '排水水位预警',
  151. DRAINAGE_FLOW: '排水流量预警',
  152. }
  153. /** 成因码 → 中文(`CAUSE` 维度;后端兜底桶 `UNKNOWN_CAUSE` 的 label 本身就是这几个中文字)。 */
  154. export const CAUSE_TEXT = {
  155. UNKNOWN_CAUSE: '未知/缺失成因',
  156. }
  157. const CJK = /[\u3400-\u4dbf\u4e00-\u9fff]/
  158. /** 后端给的 label 是不是「人话」(含中日韩文字)。不含就是码/空白,不能当展示文本。 */
  159. function humanLabel(label) {
  160. const text = typeof label === 'string' ? label.trim() : ''
  161. return text && CJK.test(text) && !/\p{Script=Latin}/u.test(text) ? text : ''
  162. }
  163. /**
  164. * 码 → 中文的统一收口(票 66 的翻译层,所有维度共用这一条判定顺序)。
  165. *
  166. * 判定顺序(顺序本身就是口径,改动前先读票 66):
  167. * 1. **登记表命中** → 中文。单一词表优先,不受后端 label 干扰(后端 label 与 code 常常同值);
  168. * 2. 后端 label 已经是人话(含中文)→ 用它。不越俎代庖:真实载荷里 `eventType` 确实
  169. * 存在「电导率预警」这种已中文化的值,改写反而丢信息;
  170. * 3. 认不出 → **回原码**。`eventType`/`cause` 是**数据值**(实测同一字段里同时出现
  171. * `WARN-PRESSURE`、`1`、`2`、「电导率预警」——不是封闭枚举),照原样显示才是诚实的,
  172. * 与 `panelBlocks.CODE_TEXT` 的立场一致。空码则回空串(不把「没有」画成某个值)。
  173. *
  174. * 「认不出的码回原码」的另一半是**闸门**:t66 用真实载荷做普查,登记表漏了哪个码当场判红,
  175. * 所以本次上屏的码不会是漏网之鱼。
  176. */
  177. export function localizeCodeText(code, label, ...dictionaries) {
  178. const rawCode = typeof code === 'string' ? code.trim() : ''
  179. for (const dictionary of dictionaries) {
  180. const hit = rawCode && dictionary && dictionary[rawCode]
  181. if (hit) return hit
  182. }
  183. const human = humanLabel(label) || humanLabel(rawCode)
  184. if (human) return human
  185. return rawCode || label ? '未知' : ''
  186. }
  187. /** 事件类型码 → 中文(真实码优先,其次契约样例码;都认不出见 `localizeCodeText` 第 3 条)。 */
  188. export function eventTypeText(code, label) {
  189. return localizeCodeText(code, label, EVENT_TYPE_TEXT, SAMPLE_EVENT_TYPE_TEXT)
  190. }
  191. /** GET 真实名称的精确词表;未登记的业务名称/编号原样保留。 */
  192. export function eventNameText(value) {
  193. const name = typeof value === 'string' ? value.trim() : ''
  194. const names = {
  195. 'COD监测': '化学需氧量(COD)监测', 'PH监测': '酸碱度(pH)监测', 'pH监测': '酸碱度(pH)监测', OFFLINE: '离线报警',
  196. '污水 COD 预警': '污水化学需氧量(COD)预警', '污水 PH 预警': '污水酸碱度(pH)预警',
  197. '污水 COD 报警': '污水化学需氧量(COD)报警', '污水 PH 报警': '污水酸碱度(pH)报警',
  198. }
  199. return Object.hasOwn(names, name) ? names[name] : name
  200. }
  201. /** 成因码 → 中文。 */
  202. export function causeText(code, label) {
  203. return localizeCodeText(code, label, CAUSE_TEXT)
  204. }
  205. /**
  206. * 等级桶(`LEVEL` 维度的 `bucketCode`/颜色名)→ 等级号 1–4;认不出回 null。
  207. *
  208. * 为什么要认两种:`bucketCode` 是等级号('1'…'4'、'UNKNOWN'),`bucketLabel` 是颜色名
  209. * (RED/YELLOW/BLUE/GREEN/UNKNOWN)。只认号,遇到只有颜色名的载荷就整块丢成「等级未知」。
  210. */
  211. export function eventLevelFromBucket(code, label) {
  212. const numeric = Number(code)
  213. if (Number.isInteger(numeric) && numeric >= 1 && numeric <= 4) return numeric
  214. const text = String(label || code || '').trim().toUpperCase()
  215. const index = LEVEL_COLORS.indexOf(text)
  216. return index >= 0 ? index + 1 : null
  217. }
  218. /** 等级桶 → `LEVEL_TAGS` 的色键 + 文字(认不出走 `eventLevelTag(null)` = 中性灰 + 「等级未知」)。 */
  219. export function eventLevelTagFromBucket(code, label) {
  220. return eventLevelTag(eventLevelFromBucket(code, label))
  221. }
  222. /** 预警/报警的切换视图(**唯一**一份:字段标签与状态标签从同一对象取,切换必然同步)。 */
  223. export function eventListSwitchView(mode) {
  224. if (mode === EVENT_FAMILY.ALARM) {
  225. return {
  226. key: EVENT_FAMILY.ALARM,
  227. label: '报警',
  228. title: '当前报警',
  229. codeLabel: '报警编号',
  230. nameLabel: '报警名称',
  231. statusLabel: '报警状态',
  232. }
  233. }
  234. return {
  235. key: EVENT_FAMILY.WARNING,
  236. label: '预警',
  237. title: '当前预警',
  238. codeLabel: '预警编号',
  239. nameLabel: '预警名称',
  240. statusLabel: '预警状态',
  241. }
  242. }
  243. /** 两个切换选项(组件遍历它画分段按钮;顺序固定:预警在前、报警在后)。 */
  244. export function eventListSwitchOptions() {
  245. return [eventListSwitchView(EVENT_FAMILY.WARNING), eventListSwitchView(EVENT_FAMILY.ALARM)]
  246. }
  247. /** 当前切换键是否合法(不合法就不该拿去换后端 400)。 */
  248. export function isKnownEventMode(mode) {
  249. return mode === EVENT_FAMILY.WARNING || mode === EVENT_FAMILY.ALARM
  250. }
  251. /**
  252. * 事件等级 → 色键 + 文字(验收第 3 条:颜色 + 文字辅助)。
  253. *
  254. * 事件等级 1-4 对应 `LEVEL_TAGS`(lv1..lv4,标签 '1级'..'4级')—— 与点位状态色
  255. * 分离是结构性的:本函数只从 `statusTones.js` 的等级表取,不碰 `pointStatus.js`。
  256. * 认不出的等级落 `DEFAULT_TONE`(中性灰)+ 文字「等级未知」,不猜成某个真实等级。
  257. * @param {number|null|undefined} level 后端 `EventItem.level`(1-4)
  258. */
  259. export function eventLevelTag(level) {
  260. const tag = Number.isInteger(level) && level >= 1 && level <= 4 ? LEVEL_TAGS[level - 1] : null
  261. return tag ? { tone: tag.tone, label: tag.label } : { tone: DEFAULT_TONE, label: '等级未知' }
  262. }
  263. /**
  264. * 事件 `status` → 展示文本。已知取值直译;**认不出的回原码**(数据值照原样显示才是
  265. * 诚实的,与 `CODE_TEXT` 同一立场);空串回空串(不把"没有状态"画成某个状态)。
  266. */
  267. /**
  268. * 终态(已处理完)判定(维护者 2026-10-29 第 2 条:当前预警/报警不展示已处置/已取消)。
  269. *
  270. * 「当前」列表的语义是**还在进行中的**,已经处理完的不该混进来。
  271. * 判定用词表而非猜:命中终态词就过滤;认不出的状态**保留**(宁可多显示,
  272. * 也不能因为认不出把还在进行中的事件藏掉)。
  273. */
  274. const TERMINAL_STATUS = new Set(['HANDLED', 'RESOLVED', 'CLEARED', 'CLOSED', 'CANCELLED', 'MISREPORT'])
  275. export function isTerminalEventStatus(status) {
  276. const value = typeof status === 'string' ? status.trim().toUpperCase() : ''
  277. return TERMINAL_STATUS.has(value)
  278. }
  279. /**
  280. * 「当前」列表按族排除的状态(维护者 2026-11-05)。
  281. *
  282. * 预警状态为 DRAFT/PENDING/RECEIVED/PROCESSING/HANDLED/CLOSED 六态,**除草稿与已解除外
  283. * 都算预警状态**——已处置(HANDLED)仍需核查,必须出现在当前列表里(否则预警数量对不上,
  284. * 维护者实测应为 8)。报警维持原口径:已处理即离开「当前」。
  285. * 认不出/缺失的状态按「不能证明已排除」保留。
  286. */
  287. const WARNING_EXCLUDED_FROM_CURRENT = new Set(['DRAFT', 'CLOSED'])
  288. export function isHiddenFromCurrentList(status, family) {
  289. const value = typeof status === 'string' ? status.trim().toUpperCase() : ''
  290. if (!value) return false
  291. if (String(family || '').trim().toUpperCase() === 'WARNING') return WARNING_EXCLUDED_FROM_CURRENT.has(value)
  292. return TERMINAL_STATUS.has(value)
  293. }
  294. /** 已知family用正式词表;无family兼容旧调用;未知机器码只显示中文占位。 */
  295. export function eventStatusText(status, family = '') {
  296. if (isKnownEventMode(String(family).toUpperCase())) return familyStatusText(family, status)
  297. const value = typeof status === 'string' ? status.trim() : ''
  298. if (!value) return ''
  299. return Object.hasOwn(EVENT_STATUS_TEXT, value.toUpperCase()) ? EVENT_STATUS_TEXT[value.toUpperCase()] : humanLabel(value) || '状态未知'
  300. }
  301. /**
  302. * ISO 时间戳 → 列表列的短读法(2026-10-13 维护者反馈:全串把右侧列挤出可视区被裁)。
  303. * `2026-09-02T10:00:00+08:00` → `09-02 10:00`;解析不了回原串(不丢信息、不编造)。
  304. * 只影响显示;排序仍走 `eventTime` 原值(字典序即时间序,ISO 偏移一致时成立)。
  305. */
  306. export function shortEventTime(value) {
  307. const text = typeof value === 'string' ? value.trim() : ''
  308. if (!text) return ''
  309. const matched = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2})/.exec(text)
  310. if (!matched) return text
  311. const [, , month, day, hour, minute] = matched
  312. return `${month}-${day} ${hour}:${minute}`
  313. }
  314. /**
  315. * ISO 时间戳 → `yyyy-MM-dd HH:mm:ss`(维护者 2026-11-13:列表与详情统一用完整时间)。
  316. *
  317. * 解析不了(缺秒/非 ISO)就回原串——不猜、不补零造一个假时间。
  318. * 只影响显示;排序仍走原值。
  319. */
  320. export function formatEventTime(value) {
  321. const text = typeof value === 'string' ? value.trim() : ''
  322. if (!text) return ''
  323. const matched = /^(\d{4})-(\d{2})-(\d{2})[T ](\d{2}):(\d{2}):(\d{2})/.exec(text)
  324. if (!matched) return shortEventTime(text)
  325. const [, year, month, day, hour, minute, second] = matched
  326. return `${year}-${month}-${day} ${hour}:${minute}:${second}`
  327. }
  328. /** 有内容可画的分区状态(过期是有值,内容照画)。 */
  329. const CONTENT_STATES = [SECTION_STATE.SUCCESS, SECTION_STATE.STALE]
  330. /** 该事件分区有没有内容可画。 */
  331. export function eventSectionHasContent(section) {
  332. return CONTENT_STATES.includes((section && section.state) || '')
  333. }
  334. /**
  335. * 一条 `EventItem` → 领域行(票 13 的列表行;票 14 的事件详情在其上扩展)。
  336. *
  337. * 位置只以 `deviceCode` / `monitoringPointCode` 带出,**不在这里做任何地图标记**。
  338. * 经纬度与 `coordinate` 仍保留给票 14(按坐标回联/详情),但本票不消费 renderable。
  339. * @param {object} raw 后端 `CockpitCurrentEventsResponse.EventItem`
  340. */
  341. export function toEventItem(raw) {
  342. const reader = fieldReader(raw, 'eventItem')
  343. return {
  344. // 内部键:预警与报警都用 eventNo(契约里两族同一字段名,不存在同名冲突)。
  345. // 注意报警的 eventNo 是**主键 UUID**,上屏必须用 eventCode(业务编号 alarmNo)
  346. // —— 维护者 2026-10-29:「报警详情的事件编码应该用 code 而非 id」。
  347. code: reader.str('eventNo'),
  348. codeText: reader.optionalStr('code') || reader.optionalStr('eventCode'),
  349. name: reader.optionalStr('eventName'),
  350. type: reader.optionalStr('eventType'),
  351. level: reader.optionalNum('level'),
  352. levelColor: reader.optionalStr('levelColor'),
  353. status: reader.optionalStr('status'),
  354. eventTime: reader.optionalStr('eventTime'),
  355. updatedTime: reader.optionalStr('updatedTime'),
  356. value: reader.optionalNum('value'),
  357. unit: reader.optionalStr('unit'),
  358. // 设备编码是回联位置的键(票 14);缺失时留空,不伪造。
  359. deviceCode: reader.optionalStr('deviceCode'),
  360. deviceName: reader.optionalStr('deviceName'),
  361. monitoringPointCode: reader.optionalStr('monitoringPointCode'),
  362. monitoringPointName: reader.optionalStr('monitoringPointName'),
  363. location: reader.optionalStr('location'),
  364. industry: reader.optionalStr('industry'),
  365. thresholdMinValue: reader.optionalNum('thresholdMinValue'),
  366. thresholdMaxValue: reader.optionalNum('thresholdMaxValue'),
  367. // 坐标校验(BT-4 后事件行携带;本票不画地图,只留作票 14 的输入)。
  368. coordinate: toLocation(raw && raw.coordinateValidation),
  369. // 工单摘要(`CockpitCurrentEventsResponse.WorkOrderSummary`;列表行只带编码与状态名,
  370. // 其余留给票 14/19 的详情)。
  371. workOrder: toWorkOrderBrief(raw && raw.workOrderSummary),
  372. missing: reader.missing,
  373. }
  374. }
  375. /** 工单摘要 → 领域短行(缺整段就 null,不画空对象冒充)。 */
  376. export function toWorkOrderBrief(raw) {
  377. if (!raw || typeof raw !== 'object') return null
  378. const reader = fieldReader(raw, 'workOrderSummary')
  379. return {
  380. code: reader.optionalStr('workOrderCode'),
  381. stateCode: reader.optionalNum('stateCode'),
  382. stateName: reader.optionalStr('stateName') || workOrderStateName(reader.optionalNum('stateCode')),
  383. }
  384. }
  385. /**
  386. * 后端 `CockpitSectionResult<List<EventItem>>` → 前端 `section()`(分区状态 1:1)。
  387. * 失败/空分区 `data` 为 null;成功分区 `data` 是领域行数组。
  388. */
  389. export function toEventSection(raw) {
  390. const reader = fieldReader(raw, 'eventsSection')
  391. const state = sectionStateFromBackend(reader.optionalStr('state'))
  392. const reason = reader.optionalStr('reason')
  393. const message = reader.optionalStr('message')
  394. const payload = reader.raw.data
  395. const hasPayload = Array.isArray(payload)
  396. return section(state, {
  397. reason: message || reason,
  398. data: hasPayload ? payload.map(toEventItem) : null,
  399. })
  400. }
  401. /**
  402. * `/events/current` 响应 → 领域对象(票 13 唯一入口)。
  403. *
  404. * `sections` 刻意不含后端裸键名:`workOrders` 分区在领域里叫 `orders`
  405. * (票 05 的静态守卫只认 `workOrders` 为后端字段名,组件/页面里出现即视为泄漏)。
  406. *
  407. * @param {object} raw 后端 `CockpitCurrentEventsResponse`
  408. */
  409. export function toCurrentEvents(raw) {
  410. const reader = fieldReader(raw, 'currentEvents')
  411. const sections = reader.obj('sections')
  412. const filters = reader.optionalObj('filters') || {}
  413. const pagination = reader.optionalObj('pagination') || {}
  414. const mapFilter = reader.optionalObj('mapFilter') || {}
  415. return {
  416. mode: reader.optionalStr('mode') || EVENT_FAMILY.WARNING,
  417. displayName: reader.optionalStr('displayName'),
  418. updatedAt: reader.optionalStr('updatedAt'),
  419. filters: {
  420. mode: filters.mode || '',
  421. level: typeof filters.level === 'number' ? filters.level : null,
  422. industry: filters.industry || '',
  423. status: filters.status || '',
  424. // 票 79:片区回显**双字段**原样带出(null 保真,票 42/20 的纪律)——
  425. // 「未筛」与「只看未分区」的差别就在这两个字段的组合里,丢掉任何一个,
  426. // 状态条就只能靠猜(判定单源在 filterCaliber.districtEchoView)。
  427. district: typeof filters.district === 'number' ? filters.district : null,
  428. districtName: typeof filters.districtName === 'string' ? filters.districtName : null,
  429. },
  430. pagination: {
  431. page: pagination.page,
  432. pageSize: pagination.pageSize,
  433. total: pagination.total,
  434. totalPages: pagination.totalPages,
  435. hasMore: pagination.hasMore === true,
  436. },
  437. mapFilter: {
  438. mode: mapFilter.mode || '',
  439. level: typeof mapFilter.level === 'number' ? mapFilter.level : null,
  440. industry: mapFilter.industry || '',
  441. status: mapFilter.status || '',
  442. deviceCodes: Array.isArray(mapFilter.deviceCodes) ? mapFilter.deviceCodes : [],
  443. },
  444. sections: {
  445. // 事件分区(本票渲染它;`orders` 留给票 19 的「当前预警」工单块)。
  446. events: toEventSection(sections.events),
  447. orders: toEventSection(sections && sections.workOrders),
  448. },
  449. missing: reader.missing,
  450. }
  451. }
  452. /**
  453. * 事件列表行视图(组件只遍历它,不认后端字段)。
  454. *
  455. * 等级标签与状态文本都从领域行现算 —— 组件里不再出现第二份映射。
  456. * @param {object} eventItem `toEventItem()` 的结果
  457. */
  458. /**
  459. * 事件处理状态 → 语义色键(维护者 2026-10-29:状态也用颜色区分,不只靠文字)。
  460. *
  461. * 只登记**已知**状态;认不出的走中性灰。状态码是后端未冻结的自由串,
  462. * 所以这里按语义归一(进行中/待处理/处理中/已解除…),不硬绑定单一拼写。
  463. */
  464. export function eventStatusTone(status) {
  465. const value = typeof status === 'string' ? status.trim().toUpperCase() : ''
  466. if (!value) return DEFAULT_TONE
  467. if (/^(ACTIVE|PENDING|UNHANDLED|WAIT|待处理|进行中|待核实|待确认)$/.test(value)) return 'lv2'
  468. if (/^(PROCESSING|HANDLING|HANDLED|DEALING|处理中|处置中|已接单)$/.test(value)) return 'lv3'
  469. if (/^(RESOLVED|CLEAR|CLEARED|CLOSED|DONE|已解除|已关闭|已处置|已结案)$/.test(value)) return 'lv4'
  470. if (/^(CANCELLED|MISREPORT|作废|已取消|误报)$/.test(value)) return DEFAULT_TONE
  471. return DEFAULT_TONE
  472. }
  473. /**
  474. * 卡片上的一句话摘要:**这件事到底发生了什么**(维护者 2026-10-29)。
  475. *
  476. * 组合顺序有意:指标名 → 实际值(带单位)→ 阈值。缺哪段少哪段,
  477. * 一段都没有时回空串(渲染层据此不画那一行),绝不编造一句通用话术。
  478. */
  479. export function eventSummaryText(item, quantity) {
  480. const current = item || {}
  481. // 指标名一律**中文化**:后端下发的是采集协议码(WARN-WATER-LEVEL 等),
  482. // 直接印码等于把接口词汇漏上大屏(维护者 2026-10-29 第 2 条)。
  483. const rawMetric = current.type || current.warningType || current.eventType || ''
  484. const metric = rawMetric ? eventTypeText(rawMetric, current.typeName || current.warningTypeName || current.eventTypeName) : ''
  485. const parts = []
  486. if (metric) parts.push(metric)
  487. if (quantity && quantity !== DETAIL_PLACEHOLDER) parts.push(`实际值 ${quantity}`)
  488. const min = current.thresholdMinValue
  489. const max = current.thresholdMaxValue
  490. if (typeof min === 'number' || typeof max === 'number') {
  491. const range = typeof min === 'number' && typeof max === 'number' ? `${min} ~ ${max}`
  492. : typeof min === 'number' ? `≥ ${min}` : `≤ ${max}`
  493. parts.push(`阈值 ${current.unit ? range + ' ' + current.unit : range}`)
  494. }
  495. return parts.join(' · ')
  496. }
  497. export function eventRowView(eventItem) {
  498. const item = eventItem || {}
  499. const tag = eventLevelTag(item.level)
  500. const quantity =
  501. typeof item.value === 'number' && Number.isFinite(item.value)
  502. ? item.unit
  503. ? `${item.value} ${item.unit}`
  504. : String(item.value)
  505. : DETAIL_PLACEHOLDER
  506. return {
  507. key: item.code || DETAIL_PLACEHOLDER,
  508. family: item.family || '',
  509. // 切换后的字段标签(预警/报警各自一套,来自切换视图 —— 与状态标签同步变化)。
  510. // `code` 是内部键(取数用);`codeText` 是上屏的业务编号(报警为 alarmNo)。
  511. code: item.code,
  512. codeText: item.codeText || '编码未提供',
  513. identityCode: item.code || '',
  514. identityFamily: String(item.family || '').toUpperCase(),
  515. identityReason: item.code ? '' : '缺少事件编号,无法展开',
  516. name: eventNameText(item.name) || item.codeText || '事件名称未提供',
  517. type: item.type || '',
  518. level: { tone: tag.tone, label: tag.label },
  519. statusText: eventStatusText(item.status, item.family),
  520. // 处理状态也要能按颜色区分(维护者 2026-10-29):色键与文字同源,
  521. // 认不出的状态落中性灰 + 原码 —— 不猜成"处理中"。
  522. statusTone: eventStatusTone(item.status),
  523. // 卡片上"到底发生了什么"的一句话:指标 + 实际值/阈值,缺什么就少说什么。
  524. summaryText: eventSummaryText(item, quantity),
  525. eventTime: item.eventTime || '',
  526. // 列表列的短读法(2026-10-13 维护者反馈:ISO 全串把右侧列挤出可视区被裁)。
  527. // 只截断显示、不改排序键(排序仍用 eventTime 原值);解析不了回原串。
  528. eventTimeText: shortEventTime(item.eventTime),
  529. updatedTime: item.updatedTime || '',
  530. quantity,
  531. value: item.value,
  532. unit: item.unit || '',
  533. deviceCode: item.deviceCode || '',
  534. deviceName: item.deviceName || '',
  535. monitoringPointCode: item.monitoringPointCode || '',
  536. monitoringPointName: item.monitoringPointName || '',
  537. deviceLabel: item.deviceName || item.monitoringPointName || item.deviceCode || item.monitoringPointCode || '设备未发布',
  538. location: item.location || '',
  539. industry: item.industry || '',
  540. thresholdMinValue: item.thresholdMinValue,
  541. thresholdMaxValue: item.thresholdMaxValue,
  542. coordinate: item.coordinate || null,
  543. workOrderCode: (item.workOrder && item.workOrder.code) || '',
  544. workOrderStateName: (item.workOrder && item.workOrder.stateName) || '',
  545. }
  546. }
  547. /** 刷新未返回所选事件时保留身份,但明确标注旧数据,不据缺页推断已处置。 */
  548. export function refreshedEventSelection(selected, domain) {
  549. if (!selected) return null
  550. const events = domain && domain.sections && domain.sections.events
  551. const found = events && Array.isArray(events.data) && events.data.find((row) => row.code === selected.code)
  552. if (found && eventSectionHasContent(events)) return { ...eventRowView(found), refreshNotice: '' }
  553. return { ...selected, refreshNotice: '当前列表未返回该事件,详情为上次读取的数据' }
  554. }
  555. /**
  556. * 事件分区 → 列表行(票 61:**不再截最新 N 条**——分页交给服务端,行就是当前页)。
  557. * @param {object} eventsSection `toCurrentEvents().sections.events`
  558. */
  559. export function eventListRows(eventsSection) {
  560. const list = (eventsSection && eventsSection.data) || []
  561. return list.map(eventRowView)
  562. }
  563. /**
  564. * 事件排序:eventTime 倒序(缺时间排最后),同时间按 eventNo 升序 —— 与后端
  565. * `CockpitCurrentEventsService.eventOrdering()` 同一条口径(票 13 立的单源)。
  566. *
  567. * 票 61 起它只服务**历史事件多窗合并集合**(多个窗口各自回一页,合并后必须按同一
  568. * 口径重排才能稳定分页);当前事件表**不再走这里**——服务端分页按后端返回序渲染,
  569. * 前端不发明第二套排序(票 57 规范非目标)。
  570. * @param {Array} items 领域事件数组(未排序)
  571. */
  572. export function sortEventRows(items) {
  573. return [...(items || [])].sort((left, right) => {
  574. const l = (left && left.eventTime) || ''
  575. const r = (right && right.eventTime) || ''
  576. if (l && r && l !== r) return l > r ? -1 : 1
  577. if (l && !r) return -1
  578. if (!l && r) return 1
  579. const lc = (left && left.code) || ''
  580. const rc = (right && right.code) || ''
  581. if (lc && rc && lc !== rc) return lc < rc ? -1 : 1
  582. return 0
  583. })
  584. }
  585. /**
  586. * 当前事件的成员资格准备:只读领域数组、终态与类型,不读页码或展示字段。
  587. * 本层不自行缓存;响应替换/数组增删/状态或类型原地变化由调用方的深依赖触发重算。
  588. * 返回的仍是领域行引用,分页后才投影视图,避免缓存可变展示行。
  589. */
  590. export function prepareCurrentEventItems(domain, eventsSection, warningType = '') {
  591. const current = domain || null
  592. const sectionValue = eventsSection || (current && current.sections && current.sections.events) || null
  593. const items = (sectionValue && sectionValue.data) || []
  594. // 未知状态保留;按族排除「已离开当前」的状态(预警:草稿/已解除;报警:原终态口径)。
  595. // 类型筛选只对这一批已加载领域行生效。
  596. const family = (current && current.mode) || ''
  597. const visibleItems = items.filter((item) => !isHiddenFromCurrentList(item && item.status, family))
  598. const typeCode = typeof warningType === 'string' ? warningType.trim() : ''
  599. const rows = typeCode ? visibleItems.filter((item) => item && item.type === typeCode) : visibleItems
  600. return {
  601. rows,
  602. typeCode,
  603. loaded: visibleItems.length,
  604. rawLoaded: items.length,
  605. hiddenTerminalCount: items.length - visibleItems.length,
  606. }
  607. }
  608. /**
  609. * 当前预警面板的视图计划(票 13 在 `currentEvents` 面板的挂载内容)。
  610. *
  611. * `eventsSection` 是**事件分区**(不是整个响应分区):状态栏/占位措辞说的都是"这批事件"
  612. * 有没有数据,工单分区成败不影响它(票 11/18 的分区独立纪律)。
  613. *
  614. * 两个入参的分工:`domain` 携带已转换的事件数组(成功时),`eventsSection` 携带
  615. * 分区自己的状态(pending / empty / failed / unavailable)。失败/空时 `domain` 为
  616. * null,但分区状态仍在 —— 单独传分区才能说对"为什么没有数据"。
  617. * @param {object|null} domain `toCurrentEvents()` 的结果(成功时有值)
  618. * @param {object} [eventsSection] 事件分区(`section()`;缺省从 domain 里取)
  619. * @param {{warningType?: string, warningTypeLabel?: string}} [options]
  620. * 「预警类型」**本地筛选**(G11):只在已加载行上过滤,不回后端。
  621. * 后端 `/events/current` 不收 type 参数,且当前列表本身只含"可解析设备"的子集 ——
  622. * 所以这里必须给出**覆盖范围**(`filterView`),不能声称筛选完整。
  623. * @param {object} [prepared] 同一 domain/事件分区/有效类型码的准备结果,调用方保证成员变化时重算
  624. */
  625. export function currentEventsView(domain, eventsSection, options = {}, prepared) {
  626. const current = domain || null
  627. const sectionValue = eventsSection || (current && current.sections && current.sections.events) || null
  628. const switchView = eventListSwitchView((current && current.mode) || EVENT_FAMILY.WARNING)
  629. const hasContent = eventSectionHasContent(sectionValue)
  630. // 还没取过数(分区未 loaded)时说「正在取数」,不说「没有数据」——
  631. // 那是在报告一件还没问过的事(与 panelBlocks 的 sectionPending 同一立场)。
  632. const pending = !!sectionValue && sectionValue.loaded === false
  633. const family = switchView.key
  634. // 旧入口自行准备;store 可复用成员集合。标签、提示、元数据与本页字段仍在视图现算。
  635. const { rows, typeCode, loaded, rawLoaded, hiddenTerminalCount } = prepared || prepareCurrentEventItems(current, sectionValue, options.warningType)
  636. const typeLabel = typeof options.warningTypeLabel === 'string' && options.warningTypeLabel ? options.warningTypeLabel : typeCode
  637. const filterView = typeCode
  638. ? {
  639. active: true,
  640. code: typeCode,
  641. label: typeLabel,
  642. loaded,
  643. matched: rows.length,
  644. // 覆盖范围**必须**随筛选一起出现(票 07/G11 的类型缺口):后端 2026-11-05 起
  645. // 返回全部当前预警(含未解析设备与已处置),本地类型筛选在这一份集合里做减法,
  646. // 分页也在同一份集合上做——命中数与总数自此对得上。
  647. note: `已按预警类型「${typeLabel}」本地筛选:命中 ${rows.length} / 当前预警共 ${loaded} 条`,
  648. }
  649. : { active: false, code: '', label: '', loaded, matched: loaded, note: '' }
  650. // 维护者 2026-10-29:**分页必须按「过滤后的可见行」算**。
  651. // 旧做法把后端 pagination(含已终态事件)当页码,而行已经滤掉终态 ——
  652. // 报警 92 条里 91 条已处理,屏上只剩 1 行却仍画出 10 页控件,还能翻到空页。
  653. // 现在:事件一次性取全(见 store 的 CURRENT_EVENTS_FETCH_SIZE),这里对可见行前端分页,
  654. // 「共 N 条 / 共 Y 页」与用户真的看得到的行严格一致。
  655. const requestedPage = Number.isInteger(options.page) && options.page > 0 ? options.page : 1
  656. const pageView = pagedRows(rows, requestedPage)
  657. // 取全被截断(后端总数 > 已加载条数)时如实标注,不假装是全部。
  658. const rawTotal = Number(current && current.pagination && current.pagination.total)
  659. const truncated = Number.isFinite(rawTotal) && rawTotal > rawLoaded
  660. const pagination = { page: pageView.page, pageCount: pageView.pageCount, total: pageView.total, pageSize: pageView.pageSize }
  661. // 维护者 2026-10-30 第 3 条:这两句原先画在面板体里,现在只作为「?」摘要的条目。
  662. const hiddenText = hiddenTerminalCount > 0 ? `已隐藏 ${hiddenTerminalCount} 条已了结事件(本表只列进行中的)` : ''
  663. const truncatedText = truncated ? '事件过多,只加载了部分(已按可见行分页)' : ''
  664. const filterNote = [hiddenText, truncatedText].filter(Boolean).join(' · ')
  665. const placeholder = hasContent
  666. ? ''
  667. : pending
  668. ? '正在取数…'
  669. : !sectionValue
  670. ? '该分区加载失败(其它分区不受影响)'
  671. : sectionValue.state === SECTION_STATE.EMPTY
  672. ? '当前没有事件'
  673. : sectionValue.state === SECTION_STATE.UNAVAILABLE
  674. ? '该分区数据不可用(其它分区不受影响)'
  675. : '该分区加载失败(其它分区不受影响)'
  676. return {
  677. switchView,
  678. section: sectionValue,
  679. hasContent,
  680. // 行=**当前页**的可见行(过滤后前端分页);`total` 是可见行总数。
  681. // 先在领域行上筛选/分页,再格式化本页;翻页不再投影整批事件。
  682. rows: pageView.rows.map((item) => ({
  683. ...eventRowView({ ...item, family }),
  684. family,
  685. identityFamily: family,
  686. })),
  687. total: pageView.total,
  688. placeholder,
  689. pagination: hasContent ? pagination : null,
  690. updatedAt: (current && current.updatedAt) || '',
  691. // 页脚那行是**信封快照时间**(后端 snapshot.getUpdatedAt()),不是某条业务数据的时刻——
  692. // 旧词「数据时间」把它说成后者,是读不懂的根因(票 62)。标签取自 `TIME_LABELS` 单点词表。
  693. snapshotLabel: TIME_LABELS.snapshot,
  694. // 票 79:片区生效状态由**后端回显**判定(双字段口径,措辞单源 filterCaliber):
  695. // 筛选生效时给一句说明(组件按 data-scope-echo 渲染),未筛(note 为空)不占行。
  696. scopeEcho: districtEchoView(current && current.filters),
  697. // 票 79:片区缺口已关闭 —— `/events/current` 自票 77 起真收 district(部署后实测
  698. // 非法值 400、0/1 读数不同),所以本表随「当前范围」收窄,不再挂缺口说明。
  699. // 保留字段是为了渲染层与既有断言面稳定(空串=不画)。
  700. gap: '',
  701. // G11:类型本地筛选的回显与覆盖范围(组件画选中态 + 「清除筛选」入口)。
  702. filterView,
  703. // 「当前」表已过滤掉终态:过滤了几条如实说,免得读成「后端只回了这些」。
  704. // 维护者 2026-10-30 第 3 条:这句话不再画在面板体里,改成面板标题栏「?」摘要的一条
  705. //(`filterNote`)—— 面板体只留数据本身。
  706. hiddenTerminalCount,
  707. // 取全被截断时说清(后端总数 > 已加载),不假装是全部。
  708. truncated,
  709. filterNote,
  710. // 维护者 2026-10-30 第 3 条:片区回显也改走「?」摘要(面板体只留数据与操作)。
  711. scopeNote: (current && current.filters ? districtEchoView(current.filters).note : '') || '',
  712. // 信封快照时间也改走摘要(原来占面板体一整行)。
  713. snapshotNote: [TIME_LABELS.snapshot, (current && current.updatedAt) || ''].filter(Boolean).join(' '),
  714. }
  715. }