| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833 |
- /**
- * 总体概览模式四块面板的**领域与视图层**(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<object>, 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,
- }
|