/** * 事件列表与预警/报警切换(票 13)的领域层。 * * 数据源是**跨设备** `/events/current`(后端 `CockpitCurrentEventsResponse`, * 见 `E:\pipe-ner-server\docs\cockpit\README.md` 与 `CockpitCurrentEventsService`): * `mode`(WARNING|ALARM)必填并校验;`sections.events` 是 * `CockpitSectionResult>`(**预警与报警永不混合**,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>` → 前端 `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(' '), } }