| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754 |
- /**
- * 事件列表与预警/报警切换(票 13)的领域层。
- *
- * 数据源是**跨设备** `/events/current`(后端 `CockpitCurrentEventsResponse`,
- * 见 `E:\pipe-ner-server\docs\cockpit\README.md` 与 `CockpitCurrentEventsService`):
- * `mode`(WARNING|ALARM)必填并校验;`sections.events` 是
- * `CockpitSectionResult<List<EventItem>>`(**预警与报警永不混合**,mode 决定取哪一族);
- * 行内另带 `sections.workOrders`(工单摘要分区,本票不画、留给票 19)。
- *
- * 与设备维度 `/equipments/{code}/events/current`(`CockpitEventReadResponse`)不是
- * 同一个契约:设备维度一次带回 warnings+alarms 两族,本层只认跨设备的这一份。
- * `domain/events.js` 的 `toEventRead` 留在设备维度用,不在这里重复实现。
- *
- * 四条硬纪律(都是本票验收原句,收口在这里、组件不再自己判):
- * 1. **预警与报警可切换,列表字段和状态标签同步变化**(验收第 1 条):
- * `eventListSwitchView(mode)` 是**唯一**的切换视图 —— 字段标签(预警编号/报警编号)
- * 与状态标签名(预警状态/报警状态)从同一个对象取,切换时必然一起变,
- * 不会出现"字段是报警的、标签还是预警的"(结构上不可能)。
- * 2. **事件等级使用 1-4 级颜色并有文字辅助**(验收第 3 条):
- * `eventLevelTag(level)` 走 `statusTones.js` 的 `LEVEL_TAGS`(lv1..lv4 + '1级'..'4级'),
- * 与点位状态色(`pointStatus.js`)不是同一张表;认不出的等级落中性灰 + 文字,不猜。
- * 3. **事件不创建独立地图标记**(验收第 4 条):本层不产生任何标记计划、不 import
- * 引擎/地图服务;事件只带 `deviceCode` / `monitoringPointCode` 供票 14 按设备回联位置。
- * 4. **不判断预警真伪或误报**(验收第 5 条):后端契约明确「系统不判断预警真伪,
- * 没有任何准确率、误报率字段」(README 第 2 节),本层不发明任何判定,状态照原样带出。
- *
- * 事件 `status` 是后端**未冻结**的自由字符串(现网取值含 PENDING/PROCESSING/HANDLING 等,
- * 见 `BusinessCockpitDeviceFactResolver.OPEN_WARNING_STATUS`;契约测试用 ACTIVE/PENDING/
- * PROCESSING)。与票 17 的 `scale` 同一处境:直译已知取值,**认不出的回原码**(它是数据值
- * 不是原因码,照原样显示才是诚实的,CODE_TEXT 的立场),并由逻辑闸门守「登记码不得等于原码」。
- *
- * 本文件是纯函数层:不 import service、不碰 DOM、不自己发请求(t05 的 D3/D4 守卫盯着)。
- */
- import { fieldReader, toLocation, TIME_LABELS } from './fields.js'
- import { SECTION_STATE, section, sectionStateFromBackend } from './sectionState.js'
- import { EVENT_FAMILY, LEVEL_COLORS } from './events.js'
- import { statusText as familyStatusText } from './eventStatusVocab.js'
- import { LEVEL_TAGS, DEFAULT_TONE } from './statusTones.js'
- import { DETAIL_PLACEHOLDER } from './detailFlow.js'
- import { workOrderStateName } from './workOrder.js'
- import { pagedRows } from './pagination.js'
- // 票 67:本面板"不随当前范围变化"的措辞(单一来源,面板不各写一份)。
- import { districtEchoView } from './filterCaliber.js'
- /** 事件 `status` 的直译表(已知取值,来源见文件头;认不出的回原码)。 */
- export const EVENT_STATUS_TEXT = {
- ACTIVE: '进行中',
- PENDING: '待处理',
- PROCESSING: '处理中',
- HANDLING: '处置中',
- // 实测取值(维护者 2026-10-29:卡片状态原样显示英文):
- // 报警侧用 UNHANDLED/HANDLED,预警侧另有 RECEIVED/CLOSED/DRAFT 等字典值。
- UNHANDLED: '未处理',
- HANDLED: '已处理',
- RECEIVED: '已接收',
- CLEARED: '已解除',
- CLOSED: '已关闭',
- DRAFT: '草稿',
- CANCELLED: '已取消',
- MISREPORT: '误报',
- RESOLVED: '已解除',
- }
- /**
- * 事件**类型码 → 中文**(票 66)。
- *
- * 为什么需要:多维分析端点(`/events/multidimensional-analysis`)的 `EVENT_TYPE` 桶
- * **`bucketLabel` 与 `bucketCode` 同值**,下发的就是采集协议码(实测 2026-10-22:
- * `WARN-PRESSURE` / `WARN-CONDUCTIVITY` / `WARN-WATER-LEVEL`),后端不翻译。
- * 照 `bucketLabel` 直画就是把接口代号印上大屏(票 05/17 立的纪律,票 22/27 同类先例)。
- *
- * 取值来源**逐条有据**(不是猜的,也不许猜):
- * · `WarningCodeEnum`(管线后端 `com.zksy.base.alarm.domain.Enum`):悬浮物/COD/氨氮/电导率/PH;
- * · `AlarmMetricSource`(同仓 `base.alarm.enums`):瞬时流量/流速/水位/压力(真实分析端点下发这一套);
- * · `GasWarningCodeEnum`、`FirefightingWarningCodeEnum`、窨井 `WARN_CODE_*`、漏失 `LEAK_*` 常量。
- *
- * **两种拼法都要登记**:同一批编码在库里既有连字符(`WARN-WATER-LEVEL`)也有下划线
- * (`AlarmMetricSource` 与实测 `/events/current` 里的 `WARN_WATER_LEVEL`)。
- * 只登一种,同一个「水位预警」就会一条链路有中文、另一条漏英文码。
- *
- * **一处如实登记的冲突**:`WARN-PRESSURE` 在消防压力服务里叫「消防压力过高预警」,
- * 在 `AlarmMetricSource` 里是遥测压力(供水/排水)。分析端点只给码、分不出是哪一种,
- * 实测该码挂在「测试压力计」(供水) 与「公司正门」(排水) 上 ⇒ 取**指标语义**的「压力预警」,
- * 不冒充消防口径(票 66 正文记了这条冲突)。
- */
- export const EVENT_TYPE_TEXT = {
- // 压力(AlarmMetricSource 主码 + 消防压力服务的五个上下限/变幅码)
- 'WARN-PRESSURE': '压力预警',
- 'WARN-PRESSURE-HIGH': '压力上限预警',
- 'WARN-PRESSURE-HIGH-HIGH': '压力上上限预警',
- 'WARN-PRESSURE-LOW': '压力下限预警',
- 'WARN-PRESSURE-LOW-LOW': '压力下下限预警',
- 'WARN-PRESSURE-VARY': '压力变幅预警',
- // 流量/流速/水位
- 'WARN-INSTANT-FLOW': '瞬时流量预警',
- 'WARN-INSTANT-FLOW-SUPPLY': '供水瞬时流量预警',
- 'WARN-FLOW-SPEED': '流速预警',
- 'WARN-FLOW-SPEED-SUPPLY': '供水流速预警',
- 'WARN-WATER-LEVEL': '水位预警',
- // 污水水质(WarningCodeEnum)
- 'WARN-SUSPENDED-SOLIDS': '悬浮物预警',
- 'WARN-COD': '化学需氧量(COD)预警',
- 'WARN-AMMONIA-NITROGEN': '氨氮预警',
- 'WARN-CONDUCTIVITY': '电导率预警',
- 'WARN-PH': '酸碱度(pH)预警',
- // 可燃气体
- 'WARN-GAS-CONCENTRATION': '可燃气体浓度预警',
- // 后端枚举自己拼错了(`TEMPERATRUE`),键照抄它的拼法,不然真实数据认不出
- 'WARN-GAS-TEMPERATRUE': '可燃气体温度预警',
- 'WARN-GAS-HUMIDITY': '可燃气体湿度预警',
- // 窨井 / 漏失
- 'WARN-TILT': '窨井倾斜预警',
- 'WARN-WATER-INFILTRATION': '窨井渗水预警',
- 'WARN-WATER-MANHOLE-LEVEL': '窨井水位预警',
- 'WARN-LEAK': '漏失预警',
- 'WARN-LEAK-FREQ': '漏失特征频段预警',
- // 下划线拼法(`AlarmMetricSource` 的水质码;实测 `/events/current` 下发 `WARN_WATER_LEVEL`)
- 'WARN_PRESSURE': '压力预警',
- 'WARN_INSTANT_FLOW': '瞬时流量预警',
- 'WARN_FLOW_SPEED': '流速预警',
- 'WARN_WATER_LEVEL': '水位预警',
- 'WARN_SUSPENDED_SOLIDS': '悬浮物预警',
- 'WARN_COD': '化学需氧量(COD)预警',
- 'WARN_AMMONIA_NITROGEN': '氨氮预警',
- 'WARN_CONDUCTIVITY': '电导率预警',
- 'WARN_PH': '酸碱度(pH)预警',
- // 后端给「事件类型缺失」的显式兜底桶
- UNKNOWN_EVENT_TYPE: '未知事件类型',
- }
- /**
- * **契约样例专用**的类型码(票 66)。
- *
- * `contractMocks` 的样例事件用的是 `GAS_CONCENTRATION` / `SEWAGE_PH` 这类虚构码
- * (真实后端不下发它们,见 `mocks/contractMocks.js` 的 `CURRENT_WARNINGS`)。
- * 单独成表而不是混进 `EVENT_TYPE_TEXT`:这一张是**样例词汇**,真实词汇与它分得开,
- * 排查「这个码哪来的」时不会把样例码当成真实编码。
- *
- * 中文名取自样例行自己的 `eventName`(如 `GAS_CONCENTRATION` 的样例名是「燃气浓度预警」),
- * 不另外臆造。登记它的唯一目的:mock 模式下也不把码画上屏(否则维护者切 mock 又看到一遍英文)。
- */
- export const SAMPLE_EVENT_TYPE_TEXT = {
- GAS_CONCENTRATION: '燃气浓度预警',
- GAS_PRESSURE: '燃气压力预警',
- WATER_PRESSURE: '供水压力预警',
- WATER_FLOW: '供水流量预警',
- WATER_CHLORINE: '供水余氯预警',
- WATER_TURBIDITY: '供水浊度预警',
- SEWAGE_CONCENTRATION: '污水化学需氧量(COD)预警',
- SEWAGE_PH: '污水酸碱度(pH)预警',
- SEWAGE_NH3: '污水氨氮预警',
- SEWAGE_TEMP: '污水温度预警',
- DRAINAGE_LEVEL: '排水水位预警',
- DRAINAGE_FLOW: '排水流量预警',
- }
- /** 成因码 → 中文(`CAUSE` 维度;后端兜底桶 `UNKNOWN_CAUSE` 的 label 本身就是这几个中文字)。 */
- export const CAUSE_TEXT = {
- UNKNOWN_CAUSE: '未知/缺失成因',
- }
- const CJK = /[\u3400-\u4dbf\u4e00-\u9fff]/
- /** 后端给的 label 是不是「人话」(含中日韩文字)。不含就是码/空白,不能当展示文本。 */
- function humanLabel(label) {
- const text = typeof label === 'string' ? label.trim() : ''
- return text && CJK.test(text) && !/\p{Script=Latin}/u.test(text) ? text : ''
- }
- /**
- * 码 → 中文的统一收口(票 66 的翻译层,所有维度共用这一条判定顺序)。
- *
- * 判定顺序(顺序本身就是口径,改动前先读票 66):
- * 1. **登记表命中** → 中文。单一词表优先,不受后端 label 干扰(后端 label 与 code 常常同值);
- * 2. 后端 label 已经是人话(含中文)→ 用它。不越俎代庖:真实载荷里 `eventType` 确实
- * 存在「电导率预警」这种已中文化的值,改写反而丢信息;
- * 3. 认不出 → **回原码**。`eventType`/`cause` 是**数据值**(实测同一字段里同时出现
- * `WARN-PRESSURE`、`1`、`2`、「电导率预警」——不是封闭枚举),照原样显示才是诚实的,
- * 与 `panelBlocks.CODE_TEXT` 的立场一致。空码则回空串(不把「没有」画成某个值)。
- *
- * 「认不出的码回原码」的另一半是**闸门**:t66 用真实载荷做普查,登记表漏了哪个码当场判红,
- * 所以本次上屏的码不会是漏网之鱼。
- */
- export function localizeCodeText(code, label, ...dictionaries) {
- const rawCode = typeof code === 'string' ? code.trim() : ''
- for (const dictionary of dictionaries) {
- const hit = rawCode && dictionary && dictionary[rawCode]
- if (hit) return hit
- }
- const human = humanLabel(label) || humanLabel(rawCode)
- if (human) return human
- return rawCode || label ? '未知' : ''
- }
- /** 事件类型码 → 中文(真实码优先,其次契约样例码;都认不出见 `localizeCodeText` 第 3 条)。 */
- export function eventTypeText(code, label) {
- return localizeCodeText(code, label, EVENT_TYPE_TEXT, SAMPLE_EVENT_TYPE_TEXT)
- }
- /** GET 真实名称的精确词表;未登记的业务名称/编号原样保留。 */
- export function eventNameText(value) {
- const name = typeof value === 'string' ? value.trim() : ''
- const names = {
- 'COD监测': '化学需氧量(COD)监测', 'PH监测': '酸碱度(pH)监测', 'pH监测': '酸碱度(pH)监测', OFFLINE: '离线报警',
- '污水 COD 预警': '污水化学需氧量(COD)预警', '污水 PH 预警': '污水酸碱度(pH)预警',
- '污水 COD 报警': '污水化学需氧量(COD)报警', '污水 PH 报警': '污水酸碱度(pH)报警',
- }
- return Object.hasOwn(names, name) ? names[name] : name
- }
- /** 成因码 → 中文。 */
- export function causeText(code, label) {
- return localizeCodeText(code, label, CAUSE_TEXT)
- }
- /**
- * 等级桶(`LEVEL` 维度的 `bucketCode`/颜色名)→ 等级号 1–4;认不出回 null。
- *
- * 为什么要认两种:`bucketCode` 是等级号('1'…'4'、'UNKNOWN'),`bucketLabel` 是颜色名
- * (RED/YELLOW/BLUE/GREEN/UNKNOWN)。只认号,遇到只有颜色名的载荷就整块丢成「等级未知」。
- */
- export function eventLevelFromBucket(code, label) {
- const numeric = Number(code)
- if (Number.isInteger(numeric) && numeric >= 1 && numeric <= 4) return numeric
- const text = String(label || code || '').trim().toUpperCase()
- const index = LEVEL_COLORS.indexOf(text)
- return index >= 0 ? index + 1 : null
- }
- /** 等级桶 → `LEVEL_TAGS` 的色键 + 文字(认不出走 `eventLevelTag(null)` = 中性灰 + 「等级未知」)。 */
- export function eventLevelTagFromBucket(code, label) {
- return eventLevelTag(eventLevelFromBucket(code, label))
- }
- /** 预警/报警的切换视图(**唯一**一份:字段标签与状态标签从同一对象取,切换必然同步)。 */
- export function eventListSwitchView(mode) {
- if (mode === EVENT_FAMILY.ALARM) {
- return {
- key: EVENT_FAMILY.ALARM,
- label: '报警',
- title: '当前报警',
- codeLabel: '报警编号',
- nameLabel: '报警名称',
- statusLabel: '报警状态',
- }
- }
- return {
- key: EVENT_FAMILY.WARNING,
- label: '预警',
- title: '当前预警',
- codeLabel: '预警编号',
- nameLabel: '预警名称',
- statusLabel: '预警状态',
- }
- }
- /** 两个切换选项(组件遍历它画分段按钮;顺序固定:预警在前、报警在后)。 */
- export function eventListSwitchOptions() {
- return [eventListSwitchView(EVENT_FAMILY.WARNING), eventListSwitchView(EVENT_FAMILY.ALARM)]
- }
- /** 当前切换键是否合法(不合法就不该拿去换后端 400)。 */
- export function isKnownEventMode(mode) {
- return mode === EVENT_FAMILY.WARNING || mode === EVENT_FAMILY.ALARM
- }
- /**
- * 事件等级 → 色键 + 文字(验收第 3 条:颜色 + 文字辅助)。
- *
- * 事件等级 1-4 对应 `LEVEL_TAGS`(lv1..lv4,标签 '1级'..'4级')—— 与点位状态色
- * 分离是结构性的:本函数只从 `statusTones.js` 的等级表取,不碰 `pointStatus.js`。
- * 认不出的等级落 `DEFAULT_TONE`(中性灰)+ 文字「等级未知」,不猜成某个真实等级。
- * @param {number|null|undefined} level 后端 `EventItem.level`(1-4)
- */
- export function eventLevelTag(level) {
- const tag = Number.isInteger(level) && level >= 1 && level <= 4 ? LEVEL_TAGS[level - 1] : null
- return tag ? { tone: tag.tone, label: tag.label } : { tone: DEFAULT_TONE, label: '等级未知' }
- }
- /**
- * 事件 `status` → 展示文本。已知取值直译;**认不出的回原码**(数据值照原样显示才是
- * 诚实的,与 `CODE_TEXT` 同一立场);空串回空串(不把"没有状态"画成某个状态)。
- */
- /**
- * 终态(已处理完)判定(维护者 2026-10-29 第 2 条:当前预警/报警不展示已处置/已取消)。
- *
- * 「当前」列表的语义是**还在进行中的**,已经处理完的不该混进来。
- * 判定用词表而非猜:命中终态词就过滤;认不出的状态**保留**(宁可多显示,
- * 也不能因为认不出把还在进行中的事件藏掉)。
- */
- const TERMINAL_STATUS = new Set(['HANDLED', 'RESOLVED', 'CLEARED', 'CLOSED', 'CANCELLED', 'MISREPORT'])
- export function isTerminalEventStatus(status) {
- const value = typeof status === 'string' ? status.trim().toUpperCase() : ''
- return TERMINAL_STATUS.has(value)
- }
- /**
- * 「当前」列表按族排除的状态(维护者 2026-11-05)。
- *
- * 预警状态为 DRAFT/PENDING/RECEIVED/PROCESSING/HANDLED/CLOSED 六态,**除草稿与已解除外
- * 都算预警状态**——已处置(HANDLED)仍需核查,必须出现在当前列表里(否则预警数量对不上,
- * 维护者实测应为 8)。报警维持原口径:已处理即离开「当前」。
- * 认不出/缺失的状态按「不能证明已排除」保留。
- */
- const WARNING_EXCLUDED_FROM_CURRENT = new Set(['DRAFT', 'CLOSED'])
- export function isHiddenFromCurrentList(status, family) {
- const value = typeof status === 'string' ? status.trim().toUpperCase() : ''
- if (!value) return false
- if (String(family || '').trim().toUpperCase() === 'WARNING') return WARNING_EXCLUDED_FROM_CURRENT.has(value)
- return TERMINAL_STATUS.has(value)
- }
- /** 已知family用正式词表;无family兼容旧调用;未知机器码只显示中文占位。 */
- export function eventStatusText(status, family = '') {
- if (isKnownEventMode(String(family).toUpperCase())) return familyStatusText(family, status)
- const value = typeof status === 'string' ? status.trim() : ''
- if (!value) return ''
- return Object.hasOwn(EVENT_STATUS_TEXT, value.toUpperCase()) ? EVENT_STATUS_TEXT[value.toUpperCase()] : humanLabel(value) || '状态未知'
- }
- /**
- * ISO 时间戳 → 列表列的短读法(2026-10-13 维护者反馈:全串把右侧列挤出可视区被裁)。
- * `2026-09-02T10:00:00+08:00` → `09-02 10:00`;解析不了回原串(不丢信息、不编造)。
- * 只影响显示;排序仍走 `eventTime` 原值(字典序即时间序,ISO 偏移一致时成立)。
- */
- export function shortEventTime(value) {
- const text = typeof value === 'string' ? value.trim() : ''
- if (!text) return ''
- const matched = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2})/.exec(text)
- if (!matched) return text
- const [, , month, day, hour, minute] = matched
- return `${month}-${day} ${hour}:${minute}`
- }
- /**
- * ISO 时间戳 → `yyyy-MM-dd HH:mm:ss`(维护者 2026-11-13:列表与详情统一用完整时间)。
- *
- * 解析不了(缺秒/非 ISO)就回原串——不猜、不补零造一个假时间。
- * 只影响显示;排序仍走原值。
- */
- export function formatEventTime(value) {
- const text = typeof value === 'string' ? value.trim() : ''
- if (!text) return ''
- const matched = /^(\d{4})-(\d{2})-(\d{2})[T ](\d{2}):(\d{2}):(\d{2})/.exec(text)
- if (!matched) return shortEventTime(text)
- const [, year, month, day, hour, minute, second] = matched
- return `${year}-${month}-${day} ${hour}:${minute}:${second}`
- }
- /** 有内容可画的分区状态(过期是有值,内容照画)。 */
- const CONTENT_STATES = [SECTION_STATE.SUCCESS, SECTION_STATE.STALE]
- /** 该事件分区有没有内容可画。 */
- export function eventSectionHasContent(section) {
- return CONTENT_STATES.includes((section && section.state) || '')
- }
- /**
- * 一条 `EventItem` → 领域行(票 13 的列表行;票 14 的事件详情在其上扩展)。
- *
- * 位置只以 `deviceCode` / `monitoringPointCode` 带出,**不在这里做任何地图标记**。
- * 经纬度与 `coordinate` 仍保留给票 14(按坐标回联/详情),但本票不消费 renderable。
- * @param {object} raw 后端 `CockpitCurrentEventsResponse.EventItem`
- */
- export function toEventItem(raw) {
- const reader = fieldReader(raw, 'eventItem')
- return {
- // 内部键:预警与报警都用 eventNo(契约里两族同一字段名,不存在同名冲突)。
- // 注意报警的 eventNo 是**主键 UUID**,上屏必须用 eventCode(业务编号 alarmNo)
- // —— 维护者 2026-10-29:「报警详情的事件编码应该用 code 而非 id」。
- code: reader.str('eventNo'),
- codeText: reader.optionalStr('code') || reader.optionalStr('eventCode'),
- name: reader.optionalStr('eventName'),
- type: reader.optionalStr('eventType'),
- level: reader.optionalNum('level'),
- levelColor: reader.optionalStr('levelColor'),
- status: reader.optionalStr('status'),
- eventTime: reader.optionalStr('eventTime'),
- updatedTime: reader.optionalStr('updatedTime'),
- value: reader.optionalNum('value'),
- unit: reader.optionalStr('unit'),
- // 设备编码是回联位置的键(票 14);缺失时留空,不伪造。
- deviceCode: reader.optionalStr('deviceCode'),
- deviceName: reader.optionalStr('deviceName'),
- monitoringPointCode: reader.optionalStr('monitoringPointCode'),
- monitoringPointName: reader.optionalStr('monitoringPointName'),
- location: reader.optionalStr('location'),
- industry: reader.optionalStr('industry'),
- thresholdMinValue: reader.optionalNum('thresholdMinValue'),
- thresholdMaxValue: reader.optionalNum('thresholdMaxValue'),
- // 坐标校验(BT-4 后事件行携带;本票不画地图,只留作票 14 的输入)。
- coordinate: toLocation(raw && raw.coordinateValidation),
- // 工单摘要(`CockpitCurrentEventsResponse.WorkOrderSummary`;列表行只带编码与状态名,
- // 其余留给票 14/19 的详情)。
- workOrder: toWorkOrderBrief(raw && raw.workOrderSummary),
- missing: reader.missing,
- }
- }
- /** 工单摘要 → 领域短行(缺整段就 null,不画空对象冒充)。 */
- export function toWorkOrderBrief(raw) {
- if (!raw || typeof raw !== 'object') return null
- const reader = fieldReader(raw, 'workOrderSummary')
- return {
- code: reader.optionalStr('workOrderCode'),
- stateCode: reader.optionalNum('stateCode'),
- stateName: reader.optionalStr('stateName') || workOrderStateName(reader.optionalNum('stateCode')),
- }
- }
- /**
- * 后端 `CockpitSectionResult<List<EventItem>>` → 前端 `section()`(分区状态 1:1)。
- * 失败/空分区 `data` 为 null;成功分区 `data` 是领域行数组。
- */
- export function toEventSection(raw) {
- const reader = fieldReader(raw, 'eventsSection')
- const state = sectionStateFromBackend(reader.optionalStr('state'))
- const reason = reader.optionalStr('reason')
- const message = reader.optionalStr('message')
- const payload = reader.raw.data
- const hasPayload = Array.isArray(payload)
- return section(state, {
- reason: message || reason,
- data: hasPayload ? payload.map(toEventItem) : null,
- })
- }
- /**
- * `/events/current` 响应 → 领域对象(票 13 唯一入口)。
- *
- * `sections` 刻意不含后端裸键名:`workOrders` 分区在领域里叫 `orders`
- * (票 05 的静态守卫只认 `workOrders` 为后端字段名,组件/页面里出现即视为泄漏)。
- *
- * @param {object} raw 后端 `CockpitCurrentEventsResponse`
- */
- export function toCurrentEvents(raw) {
- const reader = fieldReader(raw, 'currentEvents')
- const sections = reader.obj('sections')
- const filters = reader.optionalObj('filters') || {}
- const pagination = reader.optionalObj('pagination') || {}
- const mapFilter = reader.optionalObj('mapFilter') || {}
- return {
- mode: reader.optionalStr('mode') || EVENT_FAMILY.WARNING,
- displayName: reader.optionalStr('displayName'),
- updatedAt: reader.optionalStr('updatedAt'),
- filters: {
- mode: filters.mode || '',
- level: typeof filters.level === 'number' ? filters.level : null,
- industry: filters.industry || '',
- status: filters.status || '',
- // 票 79:片区回显**双字段**原样带出(null 保真,票 42/20 的纪律)——
- // 「未筛」与「只看未分区」的差别就在这两个字段的组合里,丢掉任何一个,
- // 状态条就只能靠猜(判定单源在 filterCaliber.districtEchoView)。
- district: typeof filters.district === 'number' ? filters.district : null,
- districtName: typeof filters.districtName === 'string' ? filters.districtName : null,
- },
- pagination: {
- page: pagination.page,
- pageSize: pagination.pageSize,
- total: pagination.total,
- totalPages: pagination.totalPages,
- hasMore: pagination.hasMore === true,
- },
- mapFilter: {
- mode: mapFilter.mode || '',
- level: typeof mapFilter.level === 'number' ? mapFilter.level : null,
- industry: mapFilter.industry || '',
- status: mapFilter.status || '',
- deviceCodes: Array.isArray(mapFilter.deviceCodes) ? mapFilter.deviceCodes : [],
- },
- sections: {
- // 事件分区(本票渲染它;`orders` 留给票 19 的「当前预警」工单块)。
- events: toEventSection(sections.events),
- orders: toEventSection(sections && sections.workOrders),
- },
- missing: reader.missing,
- }
- }
- /**
- * 事件列表行视图(组件只遍历它,不认后端字段)。
- *
- * 等级标签与状态文本都从领域行现算 —— 组件里不再出现第二份映射。
- * @param {object} eventItem `toEventItem()` 的结果
- */
- /**
- * 事件处理状态 → 语义色键(维护者 2026-10-29:状态也用颜色区分,不只靠文字)。
- *
- * 只登记**已知**状态;认不出的走中性灰。状态码是后端未冻结的自由串,
- * 所以这里按语义归一(进行中/待处理/处理中/已解除…),不硬绑定单一拼写。
- */
- export function eventStatusTone(status) {
- const value = typeof status === 'string' ? status.trim().toUpperCase() : ''
- if (!value) return DEFAULT_TONE
- if (/^(ACTIVE|PENDING|UNHANDLED|WAIT|待处理|进行中|待核实|待确认)$/.test(value)) return 'lv2'
- if (/^(PROCESSING|HANDLING|HANDLED|DEALING|处理中|处置中|已接单)$/.test(value)) return 'lv3'
- if (/^(RESOLVED|CLEAR|CLEARED|CLOSED|DONE|已解除|已关闭|已处置|已结案)$/.test(value)) return 'lv4'
- if (/^(CANCELLED|MISREPORT|作废|已取消|误报)$/.test(value)) return DEFAULT_TONE
- return DEFAULT_TONE
- }
- /**
- * 卡片上的一句话摘要:**这件事到底发生了什么**(维护者 2026-10-29)。
- *
- * 组合顺序有意:指标名 → 实际值(带单位)→ 阈值。缺哪段少哪段,
- * 一段都没有时回空串(渲染层据此不画那一行),绝不编造一句通用话术。
- */
- export function eventSummaryText(item, quantity) {
- const current = item || {}
- // 指标名一律**中文化**:后端下发的是采集协议码(WARN-WATER-LEVEL 等),
- // 直接印码等于把接口词汇漏上大屏(维护者 2026-10-29 第 2 条)。
- const rawMetric = current.type || current.warningType || current.eventType || ''
- const metric = rawMetric ? eventTypeText(rawMetric, current.typeName || current.warningTypeName || current.eventTypeName) : ''
- const parts = []
- if (metric) parts.push(metric)
- if (quantity && quantity !== DETAIL_PLACEHOLDER) parts.push(`实际值 ${quantity}`)
- const min = current.thresholdMinValue
- const max = current.thresholdMaxValue
- if (typeof min === 'number' || typeof max === 'number') {
- const range = typeof min === 'number' && typeof max === 'number' ? `${min} ~ ${max}`
- : typeof min === 'number' ? `≥ ${min}` : `≤ ${max}`
- parts.push(`阈值 ${current.unit ? range + ' ' + current.unit : range}`)
- }
- return parts.join(' · ')
- }
- export function eventRowView(eventItem) {
- const item = eventItem || {}
- const tag = eventLevelTag(item.level)
- const quantity =
- typeof item.value === 'number' && Number.isFinite(item.value)
- ? item.unit
- ? `${item.value} ${item.unit}`
- : String(item.value)
- : DETAIL_PLACEHOLDER
- return {
- key: item.code || DETAIL_PLACEHOLDER,
- family: item.family || '',
- // 切换后的字段标签(预警/报警各自一套,来自切换视图 —— 与状态标签同步变化)。
- // `code` 是内部键(取数用);`codeText` 是上屏的业务编号(报警为 alarmNo)。
- code: item.code,
- codeText: item.codeText || '编码未提供',
- identityCode: item.code || '',
- identityFamily: String(item.family || '').toUpperCase(),
- identityReason: item.code ? '' : '缺少事件编号,无法展开',
- name: eventNameText(item.name) || item.codeText || '事件名称未提供',
- type: item.type || '',
- level: { tone: tag.tone, label: tag.label },
- statusText: eventStatusText(item.status, item.family),
- // 处理状态也要能按颜色区分(维护者 2026-10-29):色键与文字同源,
- // 认不出的状态落中性灰 + 原码 —— 不猜成"处理中"。
- statusTone: eventStatusTone(item.status),
- // 卡片上"到底发生了什么"的一句话:指标 + 实际值/阈值,缺什么就少说什么。
- summaryText: eventSummaryText(item, quantity),
- eventTime: item.eventTime || '',
- // 列表列的短读法(2026-10-13 维护者反馈:ISO 全串把右侧列挤出可视区被裁)。
- // 只截断显示、不改排序键(排序仍用 eventTime 原值);解析不了回原串。
- eventTimeText: shortEventTime(item.eventTime),
- updatedTime: item.updatedTime || '',
- quantity,
- value: item.value,
- unit: item.unit || '',
- deviceCode: item.deviceCode || '',
- deviceName: item.deviceName || '',
- monitoringPointCode: item.monitoringPointCode || '',
- monitoringPointName: item.monitoringPointName || '',
- deviceLabel: item.deviceName || item.monitoringPointName || item.deviceCode || item.monitoringPointCode || '设备未发布',
- location: item.location || '',
- industry: item.industry || '',
- thresholdMinValue: item.thresholdMinValue,
- thresholdMaxValue: item.thresholdMaxValue,
- coordinate: item.coordinate || null,
- workOrderCode: (item.workOrder && item.workOrder.code) || '',
- workOrderStateName: (item.workOrder && item.workOrder.stateName) || '',
- }
- }
- /** 刷新未返回所选事件时保留身份,但明确标注旧数据,不据缺页推断已处置。 */
- export function refreshedEventSelection(selected, domain) {
- if (!selected) return null
- const events = domain && domain.sections && domain.sections.events
- const found = events && Array.isArray(events.data) && events.data.find((row) => row.code === selected.code)
- if (found && eventSectionHasContent(events)) return { ...eventRowView(found), refreshNotice: '' }
- return { ...selected, refreshNotice: '当前列表未返回该事件,详情为上次读取的数据' }
- }
- /**
- * 事件分区 → 列表行(票 61:**不再截最新 N 条**——分页交给服务端,行就是当前页)。
- * @param {object} eventsSection `toCurrentEvents().sections.events`
- */
- export function eventListRows(eventsSection) {
- const list = (eventsSection && eventsSection.data) || []
- return list.map(eventRowView)
- }
- /**
- * 事件排序:eventTime 倒序(缺时间排最后),同时间按 eventNo 升序 —— 与后端
- * `CockpitCurrentEventsService.eventOrdering()` 同一条口径(票 13 立的单源)。
- *
- * 票 61 起它只服务**历史事件多窗合并集合**(多个窗口各自回一页,合并后必须按同一
- * 口径重排才能稳定分页);当前事件表**不再走这里**——服务端分页按后端返回序渲染,
- * 前端不发明第二套排序(票 57 规范非目标)。
- * @param {Array} items 领域事件数组(未排序)
- */
- export function sortEventRows(items) {
- return [...(items || [])].sort((left, right) => {
- const l = (left && left.eventTime) || ''
- const r = (right && right.eventTime) || ''
- if (l && r && l !== r) return l > r ? -1 : 1
- if (l && !r) return -1
- if (!l && r) return 1
- const lc = (left && left.code) || ''
- const rc = (right && right.code) || ''
- if (lc && rc && lc !== rc) return lc < rc ? -1 : 1
- return 0
- })
- }
- /**
- * 当前事件的成员资格准备:只读领域数组、终态与类型,不读页码或展示字段。
- * 本层不自行缓存;响应替换/数组增删/状态或类型原地变化由调用方的深依赖触发重算。
- * 返回的仍是领域行引用,分页后才投影视图,避免缓存可变展示行。
- */
- export function prepareCurrentEventItems(domain, eventsSection, warningType = '') {
- const current = domain || null
- const sectionValue = eventsSection || (current && current.sections && current.sections.events) || null
- const items = (sectionValue && sectionValue.data) || []
- // 未知状态保留;按族排除「已离开当前」的状态(预警:草稿/已解除;报警:原终态口径)。
- // 类型筛选只对这一批已加载领域行生效。
- const family = (current && current.mode) || ''
- const visibleItems = items.filter((item) => !isHiddenFromCurrentList(item && item.status, family))
- const typeCode = typeof warningType === 'string' ? warningType.trim() : ''
- const rows = typeCode ? visibleItems.filter((item) => item && item.type === typeCode) : visibleItems
- return {
- rows,
- typeCode,
- loaded: visibleItems.length,
- rawLoaded: items.length,
- hiddenTerminalCount: items.length - visibleItems.length,
- }
- }
- /**
- * 当前预警面板的视图计划(票 13 在 `currentEvents` 面板的挂载内容)。
- *
- * `eventsSection` 是**事件分区**(不是整个响应分区):状态栏/占位措辞说的都是"这批事件"
- * 有没有数据,工单分区成败不影响它(票 11/18 的分区独立纪律)。
- *
- * 两个入参的分工:`domain` 携带已转换的事件数组(成功时),`eventsSection` 携带
- * 分区自己的状态(pending / empty / failed / unavailable)。失败/空时 `domain` 为
- * null,但分区状态仍在 —— 单独传分区才能说对"为什么没有数据"。
- * @param {object|null} domain `toCurrentEvents()` 的结果(成功时有值)
- * @param {object} [eventsSection] 事件分区(`section()`;缺省从 domain 里取)
- * @param {{warningType?: string, warningTypeLabel?: string}} [options]
- * 「预警类型」**本地筛选**(G11):只在已加载行上过滤,不回后端。
- * 后端 `/events/current` 不收 type 参数,且当前列表本身只含"可解析设备"的子集 ——
- * 所以这里必须给出**覆盖范围**(`filterView`),不能声称筛选完整。
- * @param {object} [prepared] 同一 domain/事件分区/有效类型码的准备结果,调用方保证成员变化时重算
- */
- export function currentEventsView(domain, eventsSection, options = {}, prepared) {
- const current = domain || null
- const sectionValue = eventsSection || (current && current.sections && current.sections.events) || null
- const switchView = eventListSwitchView((current && current.mode) || EVENT_FAMILY.WARNING)
- const hasContent = eventSectionHasContent(sectionValue)
- // 还没取过数(分区未 loaded)时说「正在取数」,不说「没有数据」——
- // 那是在报告一件还没问过的事(与 panelBlocks 的 sectionPending 同一立场)。
- const pending = !!sectionValue && sectionValue.loaded === false
- const family = switchView.key
- // 旧入口自行准备;store 可复用成员集合。标签、提示、元数据与本页字段仍在视图现算。
- const { rows, typeCode, loaded, rawLoaded, hiddenTerminalCount } = prepared || prepareCurrentEventItems(current, sectionValue, options.warningType)
- const typeLabel = typeof options.warningTypeLabel === 'string' && options.warningTypeLabel ? options.warningTypeLabel : typeCode
- const filterView = typeCode
- ? {
- active: true,
- code: typeCode,
- label: typeLabel,
- loaded,
- matched: rows.length,
- // 覆盖范围**必须**随筛选一起出现(票 07/G11 的类型缺口):后端 2026-11-05 起
- // 返回全部当前预警(含未解析设备与已处置),本地类型筛选在这一份集合里做减法,
- // 分页也在同一份集合上做——命中数与总数自此对得上。
- note: `已按预警类型「${typeLabel}」本地筛选:命中 ${rows.length} / 当前预警共 ${loaded} 条`,
- }
- : { active: false, code: '', label: '', loaded, matched: loaded, note: '' }
- // 维护者 2026-10-29:**分页必须按「过滤后的可见行」算**。
- // 旧做法把后端 pagination(含已终态事件)当页码,而行已经滤掉终态 ——
- // 报警 92 条里 91 条已处理,屏上只剩 1 行却仍画出 10 页控件,还能翻到空页。
- // 现在:事件一次性取全(见 store 的 CURRENT_EVENTS_FETCH_SIZE),这里对可见行前端分页,
- // 「共 N 条 / 共 Y 页」与用户真的看得到的行严格一致。
- const requestedPage = Number.isInteger(options.page) && options.page > 0 ? options.page : 1
- const pageView = pagedRows(rows, requestedPage)
- // 取全被截断(后端总数 > 已加载条数)时如实标注,不假装是全部。
- const rawTotal = Number(current && current.pagination && current.pagination.total)
- const truncated = Number.isFinite(rawTotal) && rawTotal > rawLoaded
- const pagination = { page: pageView.page, pageCount: pageView.pageCount, total: pageView.total, pageSize: pageView.pageSize }
- // 维护者 2026-10-30 第 3 条:这两句原先画在面板体里,现在只作为「?」摘要的条目。
- const hiddenText = hiddenTerminalCount > 0 ? `已隐藏 ${hiddenTerminalCount} 条已了结事件(本表只列进行中的)` : ''
- const truncatedText = truncated ? '事件过多,只加载了部分(已按可见行分页)' : ''
- const filterNote = [hiddenText, truncatedText].filter(Boolean).join(' · ')
- const placeholder = hasContent
- ? ''
- : pending
- ? '正在取数…'
- : !sectionValue
- ? '该分区加载失败(其它分区不受影响)'
- : sectionValue.state === SECTION_STATE.EMPTY
- ? '当前没有事件'
- : sectionValue.state === SECTION_STATE.UNAVAILABLE
- ? '该分区数据不可用(其它分区不受影响)'
- : '该分区加载失败(其它分区不受影响)'
- return {
- switchView,
- section: sectionValue,
- hasContent,
- // 行=**当前页**的可见行(过滤后前端分页);`total` 是可见行总数。
- // 先在领域行上筛选/分页,再格式化本页;翻页不再投影整批事件。
- rows: pageView.rows.map((item) => ({
- ...eventRowView({ ...item, family }),
- family,
- identityFamily: family,
- })),
- total: pageView.total,
- placeholder,
- pagination: hasContent ? pagination : null,
- updatedAt: (current && current.updatedAt) || '',
- // 页脚那行是**信封快照时间**(后端 snapshot.getUpdatedAt()),不是某条业务数据的时刻——
- // 旧词「数据时间」把它说成后者,是读不懂的根因(票 62)。标签取自 `TIME_LABELS` 单点词表。
- snapshotLabel: TIME_LABELS.snapshot,
- // 票 79:片区生效状态由**后端回显**判定(双字段口径,措辞单源 filterCaliber):
- // 筛选生效时给一句说明(组件按 data-scope-echo 渲染),未筛(note 为空)不占行。
- scopeEcho: districtEchoView(current && current.filters),
- // 票 79:片区缺口已关闭 —— `/events/current` 自票 77 起真收 district(部署后实测
- // 非法值 400、0/1 读数不同),所以本表随「当前范围」收窄,不再挂缺口说明。
- // 保留字段是为了渲染层与既有断言面稳定(空串=不画)。
- gap: '',
- // G11:类型本地筛选的回显与覆盖范围(组件画选中态 + 「清除筛选」入口)。
- filterView,
- // 「当前」表已过滤掉终态:过滤了几条如实说,免得读成「后端只回了这些」。
- // 维护者 2026-10-30 第 3 条:这句话不再画在面板体里,改成面板标题栏「?」摘要的一条
- //(`filterNote`)—— 面板体只留数据本身。
- hiddenTerminalCount,
- // 取全被截断时说清(后端总数 > 已加载),不假装是全部。
- truncated,
- filterNote,
- // 维护者 2026-10-30 第 3 条:片区回显也改走「?」摘要(面板体只留数据与操作)。
- scopeNote: (current && current.filters ? districtEchoView(current.filters).note : '') || '',
- // 信封快照时间也改走摘要(原来占面板体一整行)。
- snapshotNote: [TIME_LABELS.snapshot, (current && current.updatedAt) || ''].filter(Boolean).join(' '),
- }
- }
|