/** * 总体概览模式四块面板的**领域与视图层**(2026-10-22 四模块重做 · 票 02)。 * * 四块面板(身份与左右栏顺序的唯一来源是 `domain/panelCatalog.js`,本文件只决定"每块画什么"): * 左栏 感知设备 `perceptionDevices` / 基础设施 `pipeNetwork` * 右栏 运行监测-预警研判 `warningStudy` / 运行监测-报警处置 `alarmDisposal` * * 三层分工沿用票 17–20 已定的成例,一字不改: * 1. **契约适配**:端点载荷 → 领域对象(字段改名、缺失记账、码翻人话); * 2. **视图计划**:领域对象 → 组件可以直接画的块(块画法在 `domain/panelBlocks.js`); * 3. **取数**:`services/` + `stores/`(**本票不接线**,见下)。 * * 本票的交付边界(票 02 原文「可先按契约数据结构画,数据源/后端接线归后续票 05–08」): * 这四块目前**没有 store 喂数据**,分区停在「正在取数」;05–08 把规格 §1 的四个新端点 * 接上后本文件的块形状不再改动 —— 这正是本票的目的:先把身份、顺序、画法钉死。 * * 口径唯一来源:`.scratch/cockpit-overview-redesign/specs/2026-10-22-overview-four-modules-contract.md` * §2 感知设备 / §3 基础设施 / §4 预警研判 / §5 报警处置 / §6 UI 契约。 * * 纯函数:不 import service、不碰 DOM、不自己发请求。 * 渲染层(`components/PanelBlocks.vue`)仍**不认识 panelId、不认识后端字段**。 */ import { BACKLOG_CALIBER_NOTE, DEFAULT_BACKLOG_TIME_ZONE, alarmBacklogSeries, backlogGapNote, backlogSnapshotNote, } from './alarmBacklog.js' import { fieldReader } from './fields.js' import { DETAIL_PLACEHOLDER } from './detailFlow.js' import { valueText } from './equipmentDetailView.js' import { SECTION_STATE } from './sectionState.js' import { cardsBlock, donutBlock, kpiBlock, numberish, panelMissingNote, rankingBarsBlock, ratioText, rowsBlock, sectionHasContent, sectionPlaceholder, stackedBlock, supplementalBlock, trendBlock, } from './panelBlocks.js' /** 总体概览模式的四个 panelId(顺序即界面顺序:左栏两块在前,右栏两块在后)。 */ export const OVERVIEW_PANEL_IDS = ['perceptionDevices', 'pipeNetwork', 'warningStudy', 'alarmDisposal'] /** * 设备大类(后端根类型码 1/2/3/4)→ 行业色键 / 行业图标 / 全局行业筛选键。 * * 三张表都按**后端根类型码**索引(不是中文名):码是稳定键,中文只用于展示(ADR 0003 同一条立场)。 * 筛选键取 `domain/filterOptions.js` 的既有行业键,所以点类型卡走的是与顶部行业 chip **同一条**筛选, * 不是第二个筛选入口。 */ const TYPE_TONES = { 1: 'industry:water', 2: 'industry:drainage', 3: 'industry:gas', 4: 'industry:manhole' } const TYPE_ICONS = { 1: 'water', 2: 'drainage', 3: 'gas', 4: 'manhole' } const TYPE_FILTER_KEYS = { 1: 'water', 2: 'drainage', 3: 'gas', 4: 'manhole' } // ================================================================ 契约适配 /** 比例读数(`{value, numerator, denominator, state, reason}`)→ 领域对象。 */ function toRatio(raw) { const rate = fieldReader(raw, 'ratio') return { value: numberish(rate.raw.value), numerator: numberish(rate.raw.numerator), denominator: numberish(rate.raw.denominator), state: rate.optionalStr('state'), reason: rate.optionalStr('reason'), } } /** 今日/昨日/差值(规格 §0:「较昨日」= 今日新增 − 昨日新增,可为负)。 */ function toToday(raw) { const today = fieldReader(raw, 'today') return { newCount: numberish(today.raw.newCount), yesterdayCount: numberish(today.raw.yesterdayCount), delta: numberish(today.raw.delta), } } /** * 感知设备(规格 §2 `/overview/perception`)→ 领域对象。 * * 交接说明(票 05):`types` 已按后端固定顺序(供水/排水/燃气/窨井)原样带出, * **本层不重排、不补项**;`note` 就是后端给的监测内容小字(规格 §2 的固定常量映射)。 */ export function toPerception(raw) { const reader = fieldReader(raw, 'overviewPerception') const totals = fieldReader(reader.raw.totals, 'overviewPerception.totals') const excluded = reader.raw.excluded || {} return { updatedAt: reader.optionalStr('updatedAt'), deviceCount: numberish(totals.raw.deviceCount), onlineCount: numberish(totals.raw.onlineCount), offlineCount: numberish(totals.raw.offlineCount), onlineRate: toRatio(totals.raw.onlineRate), // 类型卡:四项固定顺序由后端给;卡内小字 = `monitoringContent`。 // 维护者 2026-10-23:供水/排水这两张卡下的小字「尽可能精简」—— // 真实内容很长(供水 4 项、排水 8 项,如「排水瞬时流量监测 / 排水流速监测 / …」), // 所以展示层压缩成「最多两项 + 等」,**完整原文进 title 悬停可读**,不丢信息。 types: reader.optionalList('byType').map((item) => { const row = fieldReader(item, 'overviewPerception.byType') const monitoringContent = row.optionalStr('monitoringContent') return { code: row.optionalStr('code'), label: row.optionalStr('name') || row.optionalStr('code'), count: numberish(row.raw.deviceCount) ?? 0, onlineCount: numberish(row.raw.onlineCount), offlineCount: numberish(row.raw.offlineCount), note: conciseMonitoring(monitoringContent), noteTitle: monitoringContent, } }), // 片区卡:三项固定(城南/城北/太常),无数据是 0。 districts: reader.optionalList('byDistrict').map((item) => { const row = fieldReader(item, 'overviewPerception.byDistrict') const district = row.raw.district return { code: district === null || district === undefined ? 'UNASSIGNED' : String(district), label: row.optionalStr('name') || row.optionalStr('district'), count: numberish(row.raw.deviceCount) ?? 0, } }), excluded: { unknownTypeCount: numberish(excluded.unknownTypeCount), unassignedDistrictCount: numberish(excluded.unassignedDistrictCount), }, missing: reader.missing, } } /** 基础设施(规格 §3 `/overview/pipe-network`)→ 领域对象。 */ export function toPipeNetwork(raw) { const reader = fieldReader(raw, 'overviewPipeNetwork') const totals = fieldReader(reader.raw.totals, 'overviewPipeNetwork.totals') const excluded = reader.raw.excluded || {} return { updatedAt: reader.optionalStr('updatedAt'), pipeCount: numberish(totals.raw.pipeCount), lengthKm: numberish(totals.raw.lengthKm), // 三类固定顺序:供水/排水/燃气(后端已排好,本层不重排)。 types: reader.optionalList('byPipeType').map((item) => { const row = fieldReader(item, 'overviewPipeNetwork.byPipeType') return { code: row.optionalStr('code'), label: row.optionalStr('name') || row.optionalStr('code'), count: numberish(row.raw.count) ?? 0, lengthKm: numberish(row.raw.lengthKm), ratio: numberish(row.raw.ratio), } }), excluded: { unclassifiedCount: numberish(excluded.unclassifiedCount) }, missing: reader.missing, } } /** 预警研判(规格 §4 `/overview/warning-study`)→ 领域对象。 */ export function toWarningStudy(raw) { const reader = fieldReader(raw, 'overviewWarningStudy') const unresolved = fieldReader(reader.raw.unresolved, 'overviewWarningStudy.unresolved') const statuses = fieldReader(unresolved.raw.statuses, 'overviewWarningStudy.unresolved.statuses') const ranking = fieldReader(reader.raw.typeRanking, 'overviewWarningStudy.typeRanking') return { updatedAt: reader.optionalStr('updatedAt'), today: toToday(reader.raw.today), unresolved: { count: numberish(unresolved.raw.count), // 固定四键(规格 §4);缺的给 0(后端契约固定铺满)。 statuses: { PENDING: numberish(statuses.raw.PENDING) ?? 0, RECEIVED: numberish(statuses.raw.RECEIVED) ?? 0, PROCESSING: numberish(statuses.raw.PROCESSING) ?? 0, HANDLED: numberish(statuses.raw.HANDLED) ?? 0, }, }, // 等级卡:一级→四级固定顺序,无数据 0。 levels: reader.optionalList('byLevel').map((item) => { const row = fieldReader(item, 'overviewWarningStudy.byLevel') return { code: String(row.raw.level ?? ''), label: row.optionalStr('name') || String(row.raw.level ?? ''), count: numberish(row.raw.count) ?? 0, } }), typeRanking: { rangeDays: numberish(ranking.raw.rangeDays), total: numberish(ranking.raw.total), // 后端已按计数降序且并列按码升序(规格 §4),本层不重排。 top: ranking.optionalList('top').map((item) => { const row = fieldReader(item, 'overviewWarningStudy.typeRanking.top') return { code: row.optionalStr('code'), label: row.optionalStr('name') || row.optionalStr('code'), count: numberish(row.raw.count) ?? 0, } }), }, missing: reader.missing, } } /** 时长读数(规格 §5:`{value, unit, sampleCount, invalidSampleCount, state, reason}`)→ 领域对象。 */ function toDuration(raw) { const row = fieldReader(raw, 'duration') return { value: numberish(row.raw.value), unit: row.optionalStr('unit') || 'HOURS', sampleCount: numberish(row.raw.sampleCount), // 负时长被后端剔除的样本数(规格 §5 的 `invalidSampleCount`):只说"剔除了几个", // 不拿无效样本凑平均,也不静默丢。 invalidSampleCount: numberish(row.raw.invalidSampleCount), state: row.optionalStr('state'), reason: row.optionalStr('reason'), } } /** * 报警处置(规格 §5 `/overview/alarm-disposal`)→ 领域对象。 * * 票 96:第二个入参是**原始报警记录**(`/events/current?mode=ALARM`)。日积压不再取后端 * `sevenDayTrend[].unhandledTotal` —— 它是"按当前状态回溯"算的,处置一条会让七天一起变 * (维护者 2026-10-28 实测 `1,2,2,2,2,2,2` → `1,1,1,1,1,1,1`)。这里改用记录逐日还原历史。 * @param {object} raw 端点载荷 * @param {{events?: Array, complete?: boolean}} [extras] 报警记录(取不到就不画第二条线) */ export function toAlarmDisposal(raw, extras = {}) { const reader = fieldReader(raw, 'overviewAlarmDisposal') // 分桶边界必须与后端同一个时区(信封回显),否则整天错位。 const timeZone = String((raw && raw.timezone) || '') || DEFAULT_BACKLOG_TIME_ZONE const conversion = fieldReader(reader.raw.workOrderConversion, 'overviewAlarmDisposal.workOrderConversion') const disposal = fieldReader(reader.raw.disposal, 'overviewAlarmDisposal.disposal') return { updatedAt: reader.optionalStr('updatedAt'), today: toToday(reader.raw.today), conversion: { convertedCount: numberish(conversion.raw.convertedCount), unconvertedCount: numberish(conversion.raw.unconvertedCount), totalCount: numberish(conversion.raw.totalCount), }, // 处置率与两个时长都**带着 state**:分母/样本为 0 时不显示 0%,显示占位符(规格 §5/§6.7)。 rate: toRatio(disposal.raw.rate), responseDuration: toDuration(disposal.raw.avgResponseDuration), disposalDuration: toDuration(disposal.raw.avgDisposalDuration), levels: reader.optionalList('byLevel').map((item) => { const row = fieldReader(item, 'overviewAlarmDisposal.byLevel') return { code: String(row.raw.level ?? ''), label: row.optionalStr('name') || String(row.raw.level ?? ''), count: numberish(row.raw.count) ?? 0, } }), // 近 7 日:固定 7 点、含 0 值、顺序从早到晚(后端保证;本层不补点)。 // `count` = 当天新增(可信,来自事件时间分桶)。 // `unhandledTotal` **只留作诊断**(后端按当前状态回溯算的值,不是历史)—— // 票 96 起折线的第二条线不再消费它,改由下面的 `backlog` 逐日还原。 sevenDayTrend: reader.optionalList('sevenDayTrend').map((point) => { const row = fieldReader(point, 'overviewAlarmDisposal.sevenDayTrend') return { date: row.optionalStr('date'), count: numberish(row.raw.count) ?? 0, unhandledTotal: numberish(row.raw.unhandledTotal), } }), // 票 96:真实日积压(counts=null ⇒ 不画这条线,reason 说明为什么)。 // snapshotAt 透传出来只给口径行用("今天"这一点可能比 live 聚合晚一拍)。 backlog: { ...alarmBacklogSeries({ events: extras.events, complete: extras.complete !== false, dates: reader.optionalList('sevenDayTrend') .map((point) => fieldReader(point, 'overviewAlarmDisposal.sevenDayTrend').optionalStr('date')), timeZone, }), snapshotAt: String(extras.snapshotAt || ''), }, missing: reader.missing, } } // ================================================================ 视图计划 /** * 比例读数 → 界面文本:`state: EMPTY`(分母 0)显示占位符,**不显示 0%**(规格 §5 末句)。 * 与票 18/20 的在线率判据同一条,不另写第二套。 */ function ratioView(rate) { const row = rate || {} const available = row.state !== 'EMPTY' && typeof row.denominator === 'number' && row.denominator > 0 return available ? ratioText(row.value) : DETAIL_PLACEHOLDER } /** * 报警转单率(维护者 2026-10-29 新增的工单口径读数)。 * 分母=已核实报警总数(后端给 totalCount,缺失时用 converted + unconverted 兜底,同源); * 分母为 0 或缺失时回占位符 —— 与处置率同一条纪律,绝不画 0%。 */ function conversionRateView(conversion) { const row = conversion || {} const converted = numberish(row.convertedCount) const unconverted = numberish(row.unconvertedCount) const total = numberish(row.totalCount) ?? (converted === null ? null : converted + (unconverted ?? 0)) if (converted === null || total === null || total <= 0) return DETAIL_PLACEHOLDER return (Math.round((converted / total) * 1000) / 10) + '%' } /** 转单率的口径小字(分母为 0 时说明不适用,不编造解释)。 */ function conversionRateHint(conversion) { const row = conversion || {} const converted = numberish(row.convertedCount) const unconverted = numberish(row.unconvertedCount) const total = numberish(row.totalCount) ?? (converted === null ? null : converted + (unconverted ?? 0)) if (converted === null || total === null) return '后端未给出转单计数' if (total <= 0) return '当前窗口没有已核实报警,转单率不适用' return '已转 ' + converted + ' / 已核实 ' + total + ' 条' } /** 近30日类型集中度:只在总数有正分母时计算;缺失不冒充 0%。 */ export function warningConcentrationRows(ranking) { const total = numberish(ranking && ranking.total) const rows = Array.isArray(ranking && ranking.top) ? ranking.top : [] if (!(total > 0)) { return [ { key: 'top1', label: '首位类型占比', value: DETAIL_PLACEHOLDER }, { key: 'top3', label: '前三类型占比', value: DETAIL_PLACEHOLDER }, ] } const valid = rows.map((row) => numberish(row && row.count)).filter((value) => value !== null) const percent = (value) => (Math.round((value / total) * 1000) / 10) + '%' return [ { key: 'top1', label: '首位类型占比', value: valid.length ? percent(valid[0]) : DETAIL_PLACEHOLDER }, { key: 'top3', label: '前三类型占比', value: valid.length ? percent(valid.slice(0, 3).reduce((sum, value) => sum + value, 0)) : DETAIL_PLACEHOLDER }, { key: 'types', label: '本期类型数', value: String(rows.length) }, ] } /** * 等级卡 → 带等级色的行(票 11 视觉对齐)。 * * 等级色键 lv1..lv4 由**等级码 1..4** 直接给出(ADR 0006/0008 的既有调色板), * 不因为「一级」在预警里是最高优先、在报警里也是最高优先而另写一份映射。 * 徽标(icon)不画:设计稿的等级卡只有数字 + 名称。 */ function withLevelTones(levels) { return levels.map((row) => ({ ...row, valueTone: LEVEL_TONES[row.code] || '' })) } /** 等级码 → 色键(两块的等级卡共用这一张表)。 */ const LEVEL_TONES = { 1: 'lv1', 2: 'lv2', 3: 'lv3', 4: 'lv4' } /** * 把「监测内容」压成卡内一行小字(维护者 2026-10-23:供水/排水卡下的小字尽可能精简)。 * * 原始内容来自库(`equipment_warning_type` 派生,实测供水 4 项、排水 8 项,最长约 90 字), * 直接上屏会撑满两行还被裁切。压缩规则都是**去冗余、不改变含义**: * 1. 按 `/` 切成条目; * 2. 去掉条目里的行业前缀(卡名已经是「供水设备」「排水设备」,前缀重复); * 3. 去掉每个条目结尾的「监测」("供水压力监测" → "压力"); * 4. 最多留 **两项**,超出加「等」。 * 例:供水 → `压力 / 瞬时流量 等`;排水 → `水位 / 瞬时流量 等`。 * * 完整原文不进这里,由调用方放进 `noteTitle`(渲染层用作 title 悬停),所以没有信息丢失。 */ function conciseMonitoring(text) { const raw = String(text == null ? '' : text).trim() if (!raw) return '' const items = raw .split('/') .map((part) => part.trim()) .map((part) => part.replace(/^(供水|排水|燃气|窨井)/, '').replace(/监测$/, '').trim()) .filter(Boolean) if (!items.length) return '' const kept = items.slice(0, 2) return items.length > kept.length ? `${kept.join(' / ')} 等` : kept.join(' / ') } /** 折线点列 → 纯数值列表(多序列 API 只要值,日期标签共用主轴的 points)。 */ function trendOf(sevenDayTrend) { return (sevenDayTrend || []).map((point) => numberish(point.count) || 0) } /** * 「未处理报警(截至当日)」序列(票 96 定稿):直接取 `alarmBacklogSeries()` 的逐日积压。 * * 为什么不再用后端 `unhandledTotal`:它是"按当前状态回溯"算的 —— 今天处置一条,七天的值 * 一起变(2026-10-28 实测 `1,2,2,2,2,2,2` → `1,1,1,1,1,1,1`),历史日不是历史。 * 现在这条线由原始报警记录逐日还原:今天怎么处置,过去几天都不动。 * * `counts === null` ⇒ 不画这条线(缺记录/缺时间戳/分页截断/未知状态),由 `backlogGapNote()` 说明。 */ function backlogOf(current) { const backlog = current && current.backlog return backlog && Array.isArray(backlog.counts) ? backlog.counts : [] } /** * 第二条线的口径行(票 96)。三件事: * 1. 有积压线时说明**口径与限制**:未处理=报警状态未解除;处置时刻取"最近更新",积压只会偏高; * 2. 报警记录快照落后时点明快照时间(端点是每日快照,"今天"那点会晚一拍); * 3. 没画线时说明原因(缺记录/缺时间戳/分页截断/未知状态),不静默少一条线。 */ function backlogNote(current) { const backlog = (current && current.backlog) || {} if (backlog.reason) return backlogGapNote(backlog.reason) if (!Array.isArray(backlog.counts)) return '' return BACKLOG_CALIBER_NOTE + backlogSnapshotNote(backlog.snapshotAt, current && current.updatedAt) } /** * 未解除卡片的第三行小字:「处置中预警」(设计稿原句)。 * * 只有**真的**取到处置中条数(>0)才报这个数;否则回落到「待处置预警总量」的口径说明—— * 不编一个读数,也不把 0 写成「处置中 0 条」这种看起来像正常业务的假读数。 */ function unresolvedCaption(unresolved) { const processing = numberish((unresolved || {}).statuses && (unresolved || {}).statuses.PROCESSING) if (processing !== null && processing > 0) return `处置中预警 ${processing} 条` return '含待办 / 已接收 / 处置中 / 已处置' } /** 后端 `reason` 码 → 给人读的半句(认不出的回空串,不把接口词汇甩到大屏上) */ const EMPTY_REASON_TEXT = { NO_DEVICES: '当前没有设备', NO_ALARMS: '当前没有已核实报警', NO_RESPONSE_LOGS: '没有接单日志', NO_DISPOSAL_LOGS: '没有验收通过日志', } function emptyReasonText(reason) { return Object.prototype.hasOwnProperty.call(EMPTY_REASON_TEXT, reason) ? EMPTY_REASON_TEXT[reason] : '' } /** 比例读数的口径说明(悬停读全:分子/分母,或"分母为 0 不适用")。 */ function ratioHint(rate) { const row = rate || {} const available = row.state !== 'EMPTY' && typeof row.denominator === 'number' && row.denominator > 0 if (!available) { const why = emptyReasonText(row.reason) return why ? `${why},该比例不适用(不显示 0%)` : '分母为 0,该比例不适用(不显示 0%)' } return `分子 ${valueText(row.numerator)} / 分母 ${valueText(row.denominator)}` } /** 单位码 → 人话(接口词汇不上大屏)。 */ function durationUnitText(unit) { const dictionary = { HOURS: '小时', MINUTES: '分钟' } return dictionary[unit] || '' } /** 时长读数 → 界面文本(无有效样本 → 占位符,不显示 0 小时)。 */ function durationView(duration) { const row = duration || {} if (row.state === 'EMPTY' || numberish(row.value) === null) return DETAIL_PLACEHOLDER return valueText(row.value) } /** 时长的口径说明:单位 + 样本数 + 被剔除的无效样本(规格 §5 的 `sampleCount/invalidSampleCount`)。 */ function durationHint(duration) { const row = duration || {} if (row.state === 'EMPTY' || numberish(row.value) === null) { const why = emptyReasonText(row.reason) return why ? `${why},该时长不适用` : '无有效样本,该时长不适用' } const unit = durationUnitText(row.unit) const sample = typeof row.sampleCount === 'number' ? `,样本 ${row.sampleCount}` : '' const invalid = typeof row.invalidSampleCount === 'number' && row.invalidSampleCount > 0 ? `(已剔除 ${row.invalidSampleCount} 个无效样本)` : '' return `单位 ${unit || row.unit}${sample}${invalid}` } /** * 本面板「有内容可画」的判据(规格 §6.7 的例外 + 盘点 §7.2)。 * * 常规分区只有 SUCCESS/STALE 有内容可画;但**固定项面板**(类型卡/片区卡/等级卡)在 * 「后端说没有数据、却仍给固定行」时必须照画 0 —— 否则「无数据 0」会被占位吞掉。 * 触发形状固定为 `state = EMPTY` 且 `data != null`(fetcher 的空判据只认关键段缺失, * 不按计数为 0 判空,所以 EMPTY 也会带 data —— 两处判据是配套的)。 * * 基础设施**不适用**这条例外:没有管道就不画假环(ticket 06 的验收原句)。 */ function fixedCardsSection(section) { if (sectionHasContent(section)) return true return !!section && section.state === SECTION_STATE.EMPTY && section.data !== null && section.data !== undefined } /** 排除项说明(规格 §2/§3 的 `excluded`:不静默丢,见 G9)。 */ function excludedText(parts) { const text = parts.filter(Boolean).join(' · ') return text ? `口径剔除:${text}` : '' } /** * 感知设备面板(规格 §6.2)。 * * 顶部 4 指标卡(总数/在线/离线/在线率)→ 4 张设备类型卡(含监测内容小字)→ 3 张片区卡。 * 在线率分母为 0 时显示占位符;无状态记录的设备计离线(G7 裁定)。 */ export function perceptionDevicesPanel(data, section, extra) { const current = data || {} // 当前生效的全局行业筛选键(外壳喂的标量):只用来画类型卡的选中态。 const activeIndustry = (extra && extra.industry) || '' const blocks = [ // 顶部四卡(设计稿 2026-10-23 视觉对齐):读数在上、标签在下,每卡顶部一条语义色横条, // 读数按语义着色(在线绿 / 离线红 / 其余白)—— 色与横条都是 domain 给的 valueTone/accent。 kpiBlock( [ { key: 'deviceCount', label: '设备总数', value: valueText(current.deviceCount), unit: '台', accent: 'info' }, { key: 'online', label: '在线', value: valueText(current.onlineCount), unit: '台', valueTone: 'lv4', accent: 'lv4' }, { key: 'offline', label: '离线', value: valueText(current.offlineCount), unit: '台', valueTone: 'lv1', accent: 'lv1' }, { key: 'onlineRate', label: '在线率', value: ratioView(current.onlineRate), hint: ratioHint(current.onlineRate), accent: 'info', }, ], { layout: 'value-first' }, ), // 类型卡 2x2(设计稿):卡内小字=后端的监测内容;行业图标 + 行业色边框; // 可点 → 写全局行业筛选(与条形图同一条 panel-action: industry 接缝,不新造交互)。 cardsBlock( '按设备类型', (current.types || []).map((row) => ({ ...row, tone: TYPE_TONES[row.code] || '', icon: TYPE_ICONS[row.code] || '', actionKey: TYPE_FILTER_KEYS[row.code] || '', // 选中态:当前行业筛选正好是这张卡代表的行业(再点一次即取消,走外壳既有 toggle 语义)。 selected: Boolean(activeIndustry) && TYPE_FILTER_KEYS[row.code] === activeIndustry, })), // 维护者第 15 轮补充:还原 2x2(一行四张在正常分辨率下把卡压得太窄; // 「取消滚动条」不是正常分辨率的要求 —— 宽屏尽量减少即可)。 { fixed: true, layout: 'two-by-two', action: 'industry', aside: '点击按行业筛选' }, ), // 片区卡:城南/城北/太常固定三项,无数据画 0(规格 §6.2 第 3 条);一排三张。 cardsBlock('按设备片区', current.districts || [], { fixed: true, layout: 'three', aside: '片区在网设备' }), // 维护者第 15 轮补充:还原为上下两块(并排在这种窄面板里把环图压得太小, // 环与排行都不好读)。高度问题按「宽屏尽量减少」处理,不追求任何分辨率都无滚动条。 supplementalBlock(donutBlock('各类型在线设备', (current.types || []) .filter((row) => numberish(row.onlineCount) !== null) .map((row) => ({ code: row.code, label: row.label, count: row.onlineCount })), { layout: 'compact' })), supplementalBlock(rankingBarsBlock('类型在线率排行', (current.types || []) .filter((row) => numberish(row.onlineCount) !== null && numberish(row.offlineCount) !== null && row.onlineCount + row.offlineCount > 0) .map((row) => ({ code: row.code, label: row.label, count: Math.round((row.onlineCount / (row.onlineCount + row.offlineCount)) * 1000) / 10, hint: `在线 ${row.onlineCount} / 状态可判 ${row.onlineCount + row.offlineCount}`, })) .sort((a, b) => b.count - a.count), { limit: 0, unit: '%', variant: 'rank' })), ] return { name: 'perceptionDevices', label: '感知设备', section, // 空态仍要画 4 类型卡 / 3 片区卡的 0(规格 §6.7 的例外)。 hasContent: fixedCardsSection(section), blocks, excludedNote: excludedText([ current.excluded && current.excluded.unknownTypeCount ? `类型未知 ${valueText(current.excluded.unknownTypeCount)} 台` : '', current.excluded && current.excluded.unassignedDistrictCount ? `未分片区 ${valueText(current.excluded.unassignedDistrictCount)} 台(不进片区卡)` : '', ]), note: '设备数取台账全量;无状态记录计离线', missing: panelMissingNote(current), placeholder: sectionPlaceholder(section), } } /** * 基础设施面板(规格 §6.3)。 * * 顶部 2 指标卡(管道数/管线里程 km)→ 环形饼图(三类管道条数与占比,图例逐项带计数)。 */ export function pipeNetworkPanel(data, section) { const current = data || {} const blocks = [ // 两卡按设计稿:图标+标签 → 大号数值+单位 → 口径小字(`caption`)。 kpiBlock([ { key: 'pipeCount', label: '管道数', value: valueText(current.pipeCount), unit: '根', caption: '供水 · 排水 · 燃气', }, { key: 'lengthKm', label: '管线里程', value: valueText(current.lengthKm), unit: 'km', caption: '管网总长' }, ], { layout: 'two' }), // 环形居中、图例在下横排。 // 2026-10-23 维护者第 3 条:标题**不再重复管道数量**(上面两张指标卡已经给了), // 就叫「管道分类占比」—— 同一屏里同一个数说两遍只是噪音。 donutBlock( '管道分类占比', (current.types || []).map((row) => ({ code: row.code, label: row.label, count: row.count, // 环形几何按计数画;里程进悬停说明(图例仍逐项带条数)。 hint: numberish(row.lengthKm) === null ? '' : `${row.lengthKm} km`, })), { layout: 'stack-below' }, ), supplementalBlock(rankingBarsBlock('各类管线里程', (current.types || []) .filter((row) => numberish(row.lengthKm) !== null) .map((row) => ({ code: row.code, label: row.label, count: row.lengthKm })) .sort((a, b) => b.count - a.count), { limit: 0, unit: 'km', variant: 'rank' })), supplementalBlock(rankingBarsBlock('平均单管长度', (current.types || []) .filter((row) => numberish(row.lengthKm) !== null && numberish(row.count) > 0) .map((row) => ({ code: row.code, label: row.label, count: Math.round((row.lengthKm * 1000 / row.count) * 10) / 10, hint: `${row.count} 根 · ${row.lengthKm} km`, })) .sort((a, b) => b.count - a.count), { limit: 0, unit: 'm/根', variant: 'rank' })), ] return { name: 'pipeNetwork', label: '基础设施', section, hasContent: sectionHasContent(section), blocks, excludedNote: excludedText([ current.excluded && current.excluded.unclassifiedCount ? `未分类管线 ${valueText(current.excluded.unclassifiedCount)} 条(计入总数、不进饼图)` : '', ]), note: '里程按管长合计折算;占比按条数', missing: panelMissingNote(current), placeholder: sectionPlaceholder(section), } } /** * 运行监测-预警研判面板(规格 §6.4)。 * * 顶部 2 指标卡(今日新增带差值、未解除)→ 4 张固定等级卡 → 类型排行 TOP3(可点)。 * 排行标题严格为 `近30日 · 共XX起 · 点击筛选`(XX = 后端给的近 30 日总数)。 */ export function warningStudyPanel(data, section) { const current = data || {} const today = current.today || {} const ranking = current.typeRanking || {} // 排行标题按设计稿拆成两段:块标题「预警类型排行」+ 右上角小字「近30日 · 共XX起 · 点击筛选」。 // 小字整句仍是需求原文的锁定文案(拆位置不拆字),闸门按整句断言。 const rankingAside = `近30日 · 共${valueText(ranking.total)}起 · 点击筛选` const blocks = [ kpiBlock([ // 差值:正红负绿(规格 §6.6),块构造器按 `delta` 自动补文案与色调。 { key: 'warningToday', label: '今日新增', value: valueText(today.newCount), unit: '条', delta: today.delta }, // 未解除的第三行小字是「处置中预警」——处置中条数是本契约里可证实的读数(不再另编口径)。 { key: 'warningUnresolved', label: '未解除', value: valueText((current.unresolved || {}).count), unit: '条', caption: unresolvedCaption(current.unresolved), }, ], { layout: 'two' }), // 等级卡:一级→四级固定四项,无数据 0(规格 §6.4 第 2 条);数字与边框同等级色。 cardsBlock( '未解除预警 · 分级', withLevelTones(current.levels || []), { fixed: true, layout: 'four' }, ), // 全类型可点:动作键 `warningType`(落点:切「预警处置」模式并按类型过滤本地列表)。 // 维护者 2026-10-23 第 4 条:不再只列前三,所有类型都排出来(limit: 0 = 全部)。 rankingBarsBlock('预警类型排行', ranking.top || [], { limit: 0, action: 'warningType', variant: 'rank', unit: '起', aside: rankingAside, }), supplementalBlock(stackedBlock('未解除预警状态', [ { key: 'PENDING', label: '待接收', count: current.unresolved?.statuses?.PENDING }, { key: 'RECEIVED', label: '已接收', count: current.unresolved?.statuses?.RECEIVED }, { key: 'PROCESSING', label: '处置中', count: current.unresolved?.statuses?.PROCESSING }, { key: 'HANDLED', label: '已处置', count: current.unresolved?.statuses?.HANDLED }, ])), supplementalBlock(donutBlock('未解除处置结构', [ { code: 'todo', label: '待处置', count: ['PENDING', 'RECEIVED', 'PROCESSING'].reduce((sum, key) => sum + (Number(current.unresolved?.statuses?.[key]) || 0), 0) }, { code: 'handled', label: '已处置', count: Number(current.unresolved?.statuses?.HANDLED) || 0 }, ])), ] return { name: 'warningStudy', label: '运行监测-预警研判', section, // 无预警时等级卡要画 4 个 0(规格 §6.4 第 2 条 + §6.7 例外)。 hasContent: fixedCardsSection(section), blocks, linkNote: '点类型排行会切到「预警处置」模式并按该预警类型过滤当前列表(规格 §6.4 第 4 条;类型筛选支持归票 07)', note: '未解除含待办/处置中/已处置', missing: panelMissingNote(current), placeholder: sectionPlaceholder(section), } } /** * 运行监测-报警处置面板(规格 §6.5)。 * * 第一行 3 指标卡(今日新增带差值/已转工单/未转工单)→ 第二行 3 指标卡 * (处置率/平均响应时长/平均处置时长)→ 4 张固定等级卡 → 近 7 日折线(标题【近7日报警数】)。 * 比例与时长在分母/样本为 0 时显示占位符(规格 §5 末句 + §6.7)。 */ export function alarmDisposalPanel(data, section) { const current = data || {} const today = current.today || {} const conversion = current.conversion || {} const rate = current.rate || {} const response = current.responseDuration || {} const disposal = current.disposalDuration || {} const blocks = [ // 第一行(设计稿):今日新增(带较昨日差值)、已转工单、未转工单;每卡第三行是口径小字。 kpiBlock([ { key: 'alarmToday', label: '今日新增', value: valueText(today.newCount), unit: '条', delta: today.delta }, { key: 'alarmConverted', label: '已转工单', value: valueText(conversion.convertedCount), unit: '条', caption: '已派发处置' }, { key: 'alarmUnconverted', label: '未转工单', value: valueText(conversion.unconvertedCount), unit: '条', caption: '待核实转派' }, ], { layout: 'three' }), kpiBlock([ { key: 'alarmRate', label: '报警处置率', value: ratioView(rate), hint: ratioHint(rate), caption: '已解除占比' }, { key: 'responseDuration', label: '平均响应时长', value: durationView(response), unit: durationUnitText(response.unit), hint: durationHint(response), caption: '处置响应', }, { key: 'disposalDuration', label: '平均处置时长', value: durationView(disposal), unit: durationUnitText(disposal.unit), hint: durationHint(disposal), caption: '处置完成', }, ], { layout: 'three' }), // 等级卡:一级→四级固定四项,无数据 0(规格 §6.5 第 3 条);数字与边框同等级色。 cardsBlock('已核实报警 · 分级', withLevelTones(current.levels || []), { fixed: true, layout: 'four' }), // 折线:标题严格为「【近7日报警数】」,X 轴 MM-DD、悬停读全日期(hint),含 0 点; // 线色按设计稿取 lv2(橙),tone 由 domain 给、色值仍只在 tokens.css 声明一份。 trendBlock( '【近7日报警数】', (current.sevenDayTrend || []).map((point) => ({ key: point.date, label: shortDate(point.date), count: point.count, hint: point.date, })), // 两条线并列(维护者 2026-10-23 反馈第 2 条): // ① 当天新增(当天 create_time 的条数); // ② 未处理报警(截至当天仍未处理的积压条数,`alarm_status = 0`)。 // 两条线各按联合最大值归一并带图例,读者自己就能读出对照关系。 // // 票 94 审查:第二条线**保留一句口径小字**(上一轮"不需要解释文案"的判定的例外)。 // 原因不是"解释数据",而是**解歧义**:同一块面板上方 KPI 有「未转工单」(工单转化口径), // 折线这里是「未处理报警」(报警状态口径),两条读数会同时出现且数值不同 // (2026-10-28 实测:未转工单 0 / 未处理报警 2,两者都真)。不点明,值班人员必然读成矛盾。 // 小字放块右上角(`aside`),不改块标题【近7日报警数】(规格 §6.5 锁定标题)。 { chart: 'line', compact: true, // 维护者第 16 轮:下方口径块压到两行后腾出的高度给这张折线(保底拉高一档)。 tall: true, aside: '未处理=报警状态未解除,非工单口径', series: [ { key: 'newAlarms', label: '当天新增', tone: 'lv2', counts: trendOf(current.sevenDayTrend) }, // 票 96:由原始记录逐日还原(历史日不随今天的处置变化)。 { key: 'unhandledTotal', label: '未处理报警(截至当日)', tone: 'lv1', counts: backlogOf(current) }, ], }, ), // 维护者 2026-10-29:折线下方补工单口径统计(转单构成 + 转单率),仍是真实字段。 supplementalBlock(donutBlock('报警转工单构成', [ { code: 'converted', label: '已转工单', count: conversion.convertedCount }, { code: 'unconverted', label: '未转工单', count: conversion.unconvertedCount }, ], { layout: 'compact' })), // 工单口径读数(只放上方还没有的读数:转单率与已核实报警总数)。 // 处置率/平均时长**已经在上方 KPI 里**,这里重复就是噪音(同一屏说两遍)。 // 维护者第 16 轮:这组读数「不那么重要」,压到**两行**即可 —— 原五行占了将近一块图的高度, // 把上面的「近7日报警数」折线挤成了细条。转单率与已核实总数保留(另两行是它们的分解, // 已在上方环图里表达),口径说明并进提示,不再单占一行。 supplementalBlock(rowsBlock('工单转化口径', [ { key: 'alarmConvertRate', label: '报警转单率', value: conversionRateView(conversion) }, { key: 'verifiedAlarmCount', label: '已核实报警', value: valueText(conversion.totalCount) + ' 条' }, ])), ] return { name: 'alarmDisposal', label: '运行监测-报警处置', section, // 无报警时等级卡要画 4 个 0、7 日折线画 7 个 0 点(规格 §6.5 + §6.7 例外)。 hasContent: fixedCardsSection(section), blocks, // 面板口径说明(顶部折叠区)。**不再**把"上方全量 / 折线近7日"写成一句 —— // 维护者 2026-10-23 第 2 条明确不要那类多余说明;折线改成两条线 + 图例后, // "新增归零而积压不为零"这层关系读者自己看得出来,不需要一段文字去解释。 // 口径行(票 94):第二条线撤下时把"为什么少一条线"写在这里,不静默丢。 note: '基础集合为已核实报警;时长只计有日志的样本' + backlogNote(current), missing: panelMissingNote(current), placeholder: sectionPlaceholder(section), } } /** `YYYY-MM-DD` → 轴标签 `MM-DD`(悬停仍给完整日期,见上面折线的 `hint`)。 */ function shortDate(date) { const text = typeof date === 'string' ? date.trim() : '' return text.length >= 10 && text[4] === '-' && text[7] === '-' ? text.slice(5) : text } /** panelId → 视图构造函数(本模式自己的四块)。 */ export const OVERVIEW_PANEL_BUILDERS = { perceptionDevices: perceptionDevicesPanel, pipeNetwork: pipeNetworkPanel, warningStudy: warningStudyPanel, alarmDisposal: alarmDisposalPanel, }