overviewPanels.js 43 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833
  1. /**
  2. * 总体概览模式四块面板的**领域与视图层**(2026-10-22 四模块重做 · 票 02)。
  3. *
  4. * 四块面板(身份与左右栏顺序的唯一来源是 `domain/panelCatalog.js`,本文件只决定"每块画什么"):
  5. * 左栏 感知设备 `perceptionDevices` / 基础设施 `pipeNetwork`
  6. * 右栏 运行监测-预警研判 `warningStudy` / 运行监测-报警处置 `alarmDisposal`
  7. *
  8. * 三层分工沿用票 17–20 已定的成例,一字不改:
  9. * 1. **契约适配**:端点载荷 → 领域对象(字段改名、缺失记账、码翻人话);
  10. * 2. **视图计划**:领域对象 → 组件可以直接画的块(块画法在 `domain/panelBlocks.js`);
  11. * 3. **取数**:`services/` + `stores/`(**本票不接线**,见下)。
  12. *
  13. * 本票的交付边界(票 02 原文「可先按契约数据结构画,数据源/后端接线归后续票 05–08」):
  14. * 这四块目前**没有 store 喂数据**,分区停在「正在取数」;05–08 把规格 §1 的四个新端点
  15. * 接上后本文件的块形状不再改动 —— 这正是本票的目的:先把身份、顺序、画法钉死。
  16. *
  17. * 口径唯一来源:`.scratch/cockpit-overview-redesign/specs/2026-10-22-overview-four-modules-contract.md`
  18. * §2 感知设备 / §3 基础设施 / §4 预警研判 / §5 报警处置 / §6 UI 契约。
  19. *
  20. * 纯函数:不 import service、不碰 DOM、不自己发请求。
  21. * 渲染层(`components/PanelBlocks.vue`)仍**不认识 panelId、不认识后端字段**。
  22. */
  23. import {
  24. BACKLOG_CALIBER_NOTE,
  25. DEFAULT_BACKLOG_TIME_ZONE,
  26. alarmBacklogSeries,
  27. backlogGapNote,
  28. backlogSnapshotNote,
  29. } from './alarmBacklog.js'
  30. import { fieldReader } from './fields.js'
  31. import { DETAIL_PLACEHOLDER } from './detailFlow.js'
  32. import { valueText } from './equipmentDetailView.js'
  33. import { SECTION_STATE } from './sectionState.js'
  34. import {
  35. cardsBlock,
  36. donutBlock,
  37. kpiBlock,
  38. numberish,
  39. panelMissingNote,
  40. rankingBarsBlock,
  41. ratioText,
  42. rowsBlock,
  43. sectionHasContent,
  44. sectionPlaceholder,
  45. stackedBlock,
  46. supplementalBlock,
  47. trendBlock,
  48. } from './panelBlocks.js'
  49. /** 总体概览模式的四个 panelId(顺序即界面顺序:左栏两块在前,右栏两块在后)。 */
  50. export const OVERVIEW_PANEL_IDS = ['perceptionDevices', 'pipeNetwork', 'warningStudy', 'alarmDisposal']
  51. /**
  52. * 设备大类(后端根类型码 1/2/3/4)→ 行业色键 / 行业图标 / 全局行业筛选键。
  53. *
  54. * 三张表都按**后端根类型码**索引(不是中文名):码是稳定键,中文只用于展示(ADR 0003 同一条立场)。
  55. * 筛选键取 `domain/filterOptions.js` 的既有行业键,所以点类型卡走的是与顶部行业 chip **同一条**筛选,
  56. * 不是第二个筛选入口。
  57. */
  58. const TYPE_TONES = { 1: 'industry:water', 2: 'industry:drainage', 3: 'industry:gas', 4: 'industry:manhole' }
  59. const TYPE_ICONS = { 1: 'water', 2: 'drainage', 3: 'gas', 4: 'manhole' }
  60. const TYPE_FILTER_KEYS = { 1: 'water', 2: 'drainage', 3: 'gas', 4: 'manhole' }
  61. // ================================================================ 契约适配
  62. /** 比例读数(`{value, numerator, denominator, state, reason}`)→ 领域对象。 */
  63. function toRatio(raw) {
  64. const rate = fieldReader(raw, 'ratio')
  65. return {
  66. value: numberish(rate.raw.value),
  67. numerator: numberish(rate.raw.numerator),
  68. denominator: numberish(rate.raw.denominator),
  69. state: rate.optionalStr('state'),
  70. reason: rate.optionalStr('reason'),
  71. }
  72. }
  73. /** 今日/昨日/差值(规格 §0:「较昨日」= 今日新增 − 昨日新增,可为负)。 */
  74. function toToday(raw) {
  75. const today = fieldReader(raw, 'today')
  76. return {
  77. newCount: numberish(today.raw.newCount),
  78. yesterdayCount: numberish(today.raw.yesterdayCount),
  79. delta: numberish(today.raw.delta),
  80. }
  81. }
  82. /**
  83. * 感知设备(规格 §2 `/overview/perception`)→ 领域对象。
  84. *
  85. * 交接说明(票 05):`types` 已按后端固定顺序(供水/排水/燃气/窨井)原样带出,
  86. * **本层不重排、不补项**;`note` 就是后端给的监测内容小字(规格 §2 的固定常量映射)。
  87. */
  88. export function toPerception(raw) {
  89. const reader = fieldReader(raw, 'overviewPerception')
  90. const totals = fieldReader(reader.raw.totals, 'overviewPerception.totals')
  91. const excluded = reader.raw.excluded || {}
  92. return {
  93. updatedAt: reader.optionalStr('updatedAt'),
  94. deviceCount: numberish(totals.raw.deviceCount),
  95. onlineCount: numberish(totals.raw.onlineCount),
  96. offlineCount: numberish(totals.raw.offlineCount),
  97. onlineRate: toRatio(totals.raw.onlineRate),
  98. // 类型卡:四项固定顺序由后端给;卡内小字 = `monitoringContent`。
  99. // 维护者 2026-10-23:供水/排水这两张卡下的小字「尽可能精简」——
  100. // 真实内容很长(供水 4 项、排水 8 项,如「排水瞬时流量监测 / 排水流速监测 / …」),
  101. // 所以展示层压缩成「最多两项 + 等」,**完整原文进 title 悬停可读**,不丢信息。
  102. types: reader.optionalList('byType').map((item) => {
  103. const row = fieldReader(item, 'overviewPerception.byType')
  104. const monitoringContent = row.optionalStr('monitoringContent')
  105. return {
  106. code: row.optionalStr('code'),
  107. label: row.optionalStr('name') || row.optionalStr('code'),
  108. count: numberish(row.raw.deviceCount) ?? 0,
  109. onlineCount: numberish(row.raw.onlineCount),
  110. offlineCount: numberish(row.raw.offlineCount),
  111. note: conciseMonitoring(monitoringContent),
  112. noteTitle: monitoringContent,
  113. }
  114. }),
  115. // 片区卡:三项固定(城南/城北/太常),无数据是 0。
  116. districts: reader.optionalList('byDistrict').map((item) => {
  117. const row = fieldReader(item, 'overviewPerception.byDistrict')
  118. const district = row.raw.district
  119. return {
  120. code: district === null || district === undefined ? 'UNASSIGNED' : String(district),
  121. label: row.optionalStr('name') || row.optionalStr('district'),
  122. count: numberish(row.raw.deviceCount) ?? 0,
  123. }
  124. }),
  125. excluded: {
  126. unknownTypeCount: numberish(excluded.unknownTypeCount),
  127. unassignedDistrictCount: numberish(excluded.unassignedDistrictCount),
  128. },
  129. missing: reader.missing,
  130. }
  131. }
  132. /** 基础设施(规格 §3 `/overview/pipe-network`)→ 领域对象。 */
  133. export function toPipeNetwork(raw) {
  134. const reader = fieldReader(raw, 'overviewPipeNetwork')
  135. const totals = fieldReader(reader.raw.totals, 'overviewPipeNetwork.totals')
  136. const excluded = reader.raw.excluded || {}
  137. return {
  138. updatedAt: reader.optionalStr('updatedAt'),
  139. pipeCount: numberish(totals.raw.pipeCount),
  140. lengthKm: numberish(totals.raw.lengthKm),
  141. // 三类固定顺序:供水/排水/燃气(后端已排好,本层不重排)。
  142. types: reader.optionalList('byPipeType').map((item) => {
  143. const row = fieldReader(item, 'overviewPipeNetwork.byPipeType')
  144. return {
  145. code: row.optionalStr('code'),
  146. label: row.optionalStr('name') || row.optionalStr('code'),
  147. count: numberish(row.raw.count) ?? 0,
  148. lengthKm: numberish(row.raw.lengthKm),
  149. ratio: numberish(row.raw.ratio),
  150. }
  151. }),
  152. excluded: { unclassifiedCount: numberish(excluded.unclassifiedCount) },
  153. missing: reader.missing,
  154. }
  155. }
  156. /** 预警研判(规格 §4 `/overview/warning-study`)→ 领域对象。 */
  157. export function toWarningStudy(raw) {
  158. const reader = fieldReader(raw, 'overviewWarningStudy')
  159. const unresolved = fieldReader(reader.raw.unresolved, 'overviewWarningStudy.unresolved')
  160. const statuses = fieldReader(unresolved.raw.statuses, 'overviewWarningStudy.unresolved.statuses')
  161. const ranking = fieldReader(reader.raw.typeRanking, 'overviewWarningStudy.typeRanking')
  162. return {
  163. updatedAt: reader.optionalStr('updatedAt'),
  164. today: toToday(reader.raw.today),
  165. unresolved: {
  166. count: numberish(unresolved.raw.count),
  167. // 固定四键(规格 §4);缺的给 0(后端契约固定铺满)。
  168. statuses: {
  169. PENDING: numberish(statuses.raw.PENDING) ?? 0,
  170. RECEIVED: numberish(statuses.raw.RECEIVED) ?? 0,
  171. PROCESSING: numberish(statuses.raw.PROCESSING) ?? 0,
  172. HANDLED: numberish(statuses.raw.HANDLED) ?? 0,
  173. },
  174. },
  175. // 等级卡:一级→四级固定顺序,无数据 0。
  176. levels: reader.optionalList('byLevel').map((item) => {
  177. const row = fieldReader(item, 'overviewWarningStudy.byLevel')
  178. return {
  179. code: String(row.raw.level ?? ''),
  180. label: row.optionalStr('name') || String(row.raw.level ?? ''),
  181. count: numberish(row.raw.count) ?? 0,
  182. }
  183. }),
  184. typeRanking: {
  185. rangeDays: numberish(ranking.raw.rangeDays),
  186. total: numberish(ranking.raw.total),
  187. // 后端已按计数降序且并列按码升序(规格 §4),本层不重排。
  188. top: ranking.optionalList('top').map((item) => {
  189. const row = fieldReader(item, 'overviewWarningStudy.typeRanking.top')
  190. return {
  191. code: row.optionalStr('code'),
  192. label: row.optionalStr('name') || row.optionalStr('code'),
  193. count: numberish(row.raw.count) ?? 0,
  194. }
  195. }),
  196. },
  197. missing: reader.missing,
  198. }
  199. }
  200. /** 时长读数(规格 §5:`{value, unit, sampleCount, invalidSampleCount, state, reason}`)→ 领域对象。 */
  201. function toDuration(raw) {
  202. const row = fieldReader(raw, 'duration')
  203. return {
  204. value: numberish(row.raw.value),
  205. unit: row.optionalStr('unit') || 'HOURS',
  206. sampleCount: numberish(row.raw.sampleCount),
  207. // 负时长被后端剔除的样本数(规格 §5 的 `invalidSampleCount`):只说"剔除了几个",
  208. // 不拿无效样本凑平均,也不静默丢。
  209. invalidSampleCount: numberish(row.raw.invalidSampleCount),
  210. state: row.optionalStr('state'),
  211. reason: row.optionalStr('reason'),
  212. }
  213. }
  214. /**
  215. * 报警处置(规格 §5 `/overview/alarm-disposal`)→ 领域对象。
  216. *
  217. * 票 96:第二个入参是**原始报警记录**(`/events/current?mode=ALARM`)。日积压不再取后端
  218. * `sevenDayTrend[].unhandledTotal` —— 它是"按当前状态回溯"算的,处置一条会让七天一起变
  219. * (维护者 2026-10-28 实测 `1,2,2,2,2,2,2` → `1,1,1,1,1,1,1`)。这里改用记录逐日还原历史。
  220. * @param {object} raw 端点载荷
  221. * @param {{events?: Array<object>, complete?: boolean}} [extras] 报警记录(取不到就不画第二条线)
  222. */
  223. export function toAlarmDisposal(raw, extras = {}) {
  224. const reader = fieldReader(raw, 'overviewAlarmDisposal')
  225. // 分桶边界必须与后端同一个时区(信封回显),否则整天错位。
  226. const timeZone = String((raw && raw.timezone) || '') || DEFAULT_BACKLOG_TIME_ZONE
  227. const conversion = fieldReader(reader.raw.workOrderConversion, 'overviewAlarmDisposal.workOrderConversion')
  228. const disposal = fieldReader(reader.raw.disposal, 'overviewAlarmDisposal.disposal')
  229. return {
  230. updatedAt: reader.optionalStr('updatedAt'),
  231. today: toToday(reader.raw.today),
  232. conversion: {
  233. convertedCount: numberish(conversion.raw.convertedCount),
  234. unconvertedCount: numberish(conversion.raw.unconvertedCount),
  235. totalCount: numberish(conversion.raw.totalCount),
  236. },
  237. // 处置率与两个时长都**带着 state**:分母/样本为 0 时不显示 0%,显示占位符(规格 §5/§6.7)。
  238. rate: toRatio(disposal.raw.rate),
  239. responseDuration: toDuration(disposal.raw.avgResponseDuration),
  240. disposalDuration: toDuration(disposal.raw.avgDisposalDuration),
  241. levels: reader.optionalList('byLevel').map((item) => {
  242. const row = fieldReader(item, 'overviewAlarmDisposal.byLevel')
  243. return {
  244. code: String(row.raw.level ?? ''),
  245. label: row.optionalStr('name') || String(row.raw.level ?? ''),
  246. count: numberish(row.raw.count) ?? 0,
  247. }
  248. }),
  249. // 近 7 日:固定 7 点、含 0 值、顺序从早到晚(后端保证;本层不补点)。
  250. // `count` = 当天新增(可信,来自事件时间分桶)。
  251. // `unhandledTotal` **只留作诊断**(后端按当前状态回溯算的值,不是历史)——
  252. // 票 96 起折线的第二条线不再消费它,改由下面的 `backlog` 逐日还原。
  253. sevenDayTrend: reader.optionalList('sevenDayTrend').map((point) => {
  254. const row = fieldReader(point, 'overviewAlarmDisposal.sevenDayTrend')
  255. return {
  256. date: row.optionalStr('date'),
  257. count: numberish(row.raw.count) ?? 0,
  258. unhandledTotal: numberish(row.raw.unhandledTotal),
  259. }
  260. }),
  261. // 票 96:真实日积压(counts=null ⇒ 不画这条线,reason 说明为什么)。
  262. // snapshotAt 透传出来只给口径行用("今天"这一点可能比 live 聚合晚一拍)。
  263. backlog: {
  264. ...alarmBacklogSeries({
  265. events: extras.events,
  266. complete: extras.complete !== false,
  267. dates: reader.optionalList('sevenDayTrend')
  268. .map((point) => fieldReader(point, 'overviewAlarmDisposal.sevenDayTrend').optionalStr('date')),
  269. timeZone,
  270. }),
  271. snapshotAt: String(extras.snapshotAt || ''),
  272. },
  273. missing: reader.missing,
  274. }
  275. }
  276. // ================================================================ 视图计划
  277. /**
  278. * 比例读数 → 界面文本:`state: EMPTY`(分母 0)显示占位符,**不显示 0%**(规格 §5 末句)。
  279. * 与票 18/20 的在线率判据同一条,不另写第二套。
  280. */
  281. function ratioView(rate) {
  282. const row = rate || {}
  283. const available = row.state !== 'EMPTY' && typeof row.denominator === 'number' && row.denominator > 0
  284. return available ? ratioText(row.value) : DETAIL_PLACEHOLDER
  285. }
  286. /**
  287. * 报警转单率(维护者 2026-10-29 新增的工单口径读数)。
  288. * 分母=已核实报警总数(后端给 totalCount,缺失时用 converted + unconverted 兜底,同源);
  289. * 分母为 0 或缺失时回占位符 —— 与处置率同一条纪律,绝不画 0%。
  290. */
  291. function conversionRateView(conversion) {
  292. const row = conversion || {}
  293. const converted = numberish(row.convertedCount)
  294. const unconverted = numberish(row.unconvertedCount)
  295. const total = numberish(row.totalCount) ?? (converted === null ? null : converted + (unconverted ?? 0))
  296. if (converted === null || total === null || total <= 0) return DETAIL_PLACEHOLDER
  297. return (Math.round((converted / total) * 1000) / 10) + '%'
  298. }
  299. /** 转单率的口径小字(分母为 0 时说明不适用,不编造解释)。 */
  300. function conversionRateHint(conversion) {
  301. const row = conversion || {}
  302. const converted = numberish(row.convertedCount)
  303. const unconverted = numberish(row.unconvertedCount)
  304. const total = numberish(row.totalCount) ?? (converted === null ? null : converted + (unconverted ?? 0))
  305. if (converted === null || total === null) return '后端未给出转单计数'
  306. if (total <= 0) return '当前窗口没有已核实报警,转单率不适用'
  307. return '已转 ' + converted + ' / 已核实 ' + total + ' 条'
  308. }
  309. /** 近30日类型集中度:只在总数有正分母时计算;缺失不冒充 0%。 */
  310. export function warningConcentrationRows(ranking) {
  311. const total = numberish(ranking && ranking.total)
  312. const rows = Array.isArray(ranking && ranking.top) ? ranking.top : []
  313. if (!(total > 0)) {
  314. return [
  315. { key: 'top1', label: '首位类型占比', value: DETAIL_PLACEHOLDER },
  316. { key: 'top3', label: '前三类型占比', value: DETAIL_PLACEHOLDER },
  317. ]
  318. }
  319. const valid = rows.map((row) => numberish(row && row.count)).filter((value) => value !== null)
  320. const percent = (value) => (Math.round((value / total) * 1000) / 10) + '%'
  321. return [
  322. { key: 'top1', label: '首位类型占比', value: valid.length ? percent(valid[0]) : DETAIL_PLACEHOLDER },
  323. { key: 'top3', label: '前三类型占比', value: valid.length ? percent(valid.slice(0, 3).reduce((sum, value) => sum + value, 0)) : DETAIL_PLACEHOLDER },
  324. { key: 'types', label: '本期类型数', value: String(rows.length) },
  325. ]
  326. }
  327. /**
  328. * 等级卡 → 带等级色的行(票 11 视觉对齐)。
  329. *
  330. * 等级色键 lv1..lv4 由**等级码 1..4** 直接给出(ADR 0006/0008 的既有调色板),
  331. * 不因为「一级」在预警里是最高优先、在报警里也是最高优先而另写一份映射。
  332. * 徽标(icon)不画:设计稿的等级卡只有数字 + 名称。
  333. */
  334. function withLevelTones(levels) {
  335. return levels.map((row) => ({ ...row, valueTone: LEVEL_TONES[row.code] || '' }))
  336. }
  337. /** 等级码 → 色键(两块的等级卡共用这一张表)。 */
  338. const LEVEL_TONES = { 1: 'lv1', 2: 'lv2', 3: 'lv3', 4: 'lv4' }
  339. /**
  340. * 把「监测内容」压成卡内一行小字(维护者 2026-10-23:供水/排水卡下的小字尽可能精简)。
  341. *
  342. * 原始内容来自库(`equipment_warning_type` 派生,实测供水 4 项、排水 8 项,最长约 90 字),
  343. * 直接上屏会撑满两行还被裁切。压缩规则都是**去冗余、不改变含义**:
  344. * 1. 按 `/` 切成条目;
  345. * 2. 去掉条目里的行业前缀(卡名已经是「供水设备」「排水设备」,前缀重复);
  346. * 3. 去掉每个条目结尾的「监测」("供水压力监测" → "压力");
  347. * 4. 最多留 **两项**,超出加「等」。
  348. * 例:供水 → `压力 / 瞬时流量 等`;排水 → `水位 / 瞬时流量 等`。
  349. *
  350. * 完整原文不进这里,由调用方放进 `noteTitle`(渲染层用作 title 悬停),所以没有信息丢失。
  351. */
  352. function conciseMonitoring(text) {
  353. const raw = String(text == null ? '' : text).trim()
  354. if (!raw) return ''
  355. const items = raw
  356. .split('/')
  357. .map((part) => part.trim())
  358. .map((part) => part.replace(/^(供水|排水|燃气|窨井)/, '').replace(/监测$/, '').trim())
  359. .filter(Boolean)
  360. if (!items.length) return ''
  361. const kept = items.slice(0, 2)
  362. return items.length > kept.length ? `${kept.join(' / ')} 等` : kept.join(' / ')
  363. }
  364. /** 折线点列 → 纯数值列表(多序列 API 只要值,日期标签共用主轴的 points)。 */
  365. function trendOf(sevenDayTrend) {
  366. return (sevenDayTrend || []).map((point) => numberish(point.count) || 0)
  367. }
  368. /**
  369. * 「未处理报警(截至当日)」序列(票 96 定稿):直接取 `alarmBacklogSeries()` 的逐日积压。
  370. *
  371. * 为什么不再用后端 `unhandledTotal`:它是"按当前状态回溯"算的 —— 今天处置一条,七天的值
  372. * 一起变(2026-10-28 实测 `1,2,2,2,2,2,2` → `1,1,1,1,1,1,1`),历史日不是历史。
  373. * 现在这条线由原始报警记录逐日还原:今天怎么处置,过去几天都不动。
  374. *
  375. * `counts === null` ⇒ 不画这条线(缺记录/缺时间戳/分页截断/未知状态),由 `backlogGapNote()` 说明。
  376. */
  377. function backlogOf(current) {
  378. const backlog = current && current.backlog
  379. return backlog && Array.isArray(backlog.counts) ? backlog.counts : []
  380. }
  381. /**
  382. * 第二条线的口径行(票 96)。三件事:
  383. * 1. 有积压线时说明**口径与限制**:未处理=报警状态未解除;处置时刻取"最近更新",积压只会偏高;
  384. * 2. 报警记录快照落后时点明快照时间(端点是每日快照,"今天"那点会晚一拍);
  385. * 3. 没画线时说明原因(缺记录/缺时间戳/分页截断/未知状态),不静默少一条线。
  386. */
  387. function backlogNote(current) {
  388. const backlog = (current && current.backlog) || {}
  389. if (backlog.reason) return backlogGapNote(backlog.reason)
  390. if (!Array.isArray(backlog.counts)) return ''
  391. return BACKLOG_CALIBER_NOTE
  392. + backlogSnapshotNote(backlog.snapshotAt, current && current.updatedAt)
  393. }
  394. /**
  395. * 未解除卡片的第三行小字:「处置中预警」(设计稿原句)。
  396. *
  397. * 只有**真的**取到处置中条数(>0)才报这个数;否则回落到「待处置预警总量」的口径说明——
  398. * 不编一个读数,也不把 0 写成「处置中 0 条」这种看起来像正常业务的假读数。
  399. */
  400. function unresolvedCaption(unresolved) {
  401. const processing = numberish((unresolved || {}).statuses && (unresolved || {}).statuses.PROCESSING)
  402. if (processing !== null && processing > 0) return `处置中预警 ${processing} 条`
  403. return '含待办 / 已接收 / 处置中 / 已处置'
  404. }
  405. /** 后端 `reason` 码 → 给人读的半句(认不出的回空串,不把接口词汇甩到大屏上) */
  406. const EMPTY_REASON_TEXT = {
  407. NO_DEVICES: '当前没有设备',
  408. NO_ALARMS: '当前没有已核实报警',
  409. NO_RESPONSE_LOGS: '没有接单日志',
  410. NO_DISPOSAL_LOGS: '没有验收通过日志',
  411. }
  412. function emptyReasonText(reason) {
  413. return Object.prototype.hasOwnProperty.call(EMPTY_REASON_TEXT, reason) ? EMPTY_REASON_TEXT[reason] : ''
  414. }
  415. /** 比例读数的口径说明(悬停读全:分子/分母,或"分母为 0 不适用")。 */
  416. function ratioHint(rate) {
  417. const row = rate || {}
  418. const available = row.state !== 'EMPTY' && typeof row.denominator === 'number' && row.denominator > 0
  419. if (!available) {
  420. const why = emptyReasonText(row.reason)
  421. return why ? `${why},该比例不适用(不显示 0%)` : '分母为 0,该比例不适用(不显示 0%)'
  422. }
  423. return `分子 ${valueText(row.numerator)} / 分母 ${valueText(row.denominator)}`
  424. }
  425. /** 单位码 → 人话(接口词汇不上大屏)。 */
  426. function durationUnitText(unit) {
  427. const dictionary = { HOURS: '小时', MINUTES: '分钟' }
  428. return dictionary[unit] || ''
  429. }
  430. /** 时长读数 → 界面文本(无有效样本 → 占位符,不显示 0 小时)。 */
  431. function durationView(duration) {
  432. const row = duration || {}
  433. if (row.state === 'EMPTY' || numberish(row.value) === null) return DETAIL_PLACEHOLDER
  434. return valueText(row.value)
  435. }
  436. /** 时长的口径说明:单位 + 样本数 + 被剔除的无效样本(规格 §5 的 `sampleCount/invalidSampleCount`)。 */
  437. function durationHint(duration) {
  438. const row = duration || {}
  439. if (row.state === 'EMPTY' || numberish(row.value) === null) {
  440. const why = emptyReasonText(row.reason)
  441. return why ? `${why},该时长不适用` : '无有效样本,该时长不适用'
  442. }
  443. const unit = durationUnitText(row.unit)
  444. const sample = typeof row.sampleCount === 'number' ? `,样本 ${row.sampleCount}` : ''
  445. const invalid = typeof row.invalidSampleCount === 'number' && row.invalidSampleCount > 0
  446. ? `(已剔除 ${row.invalidSampleCount} 个无效样本)`
  447. : ''
  448. return `单位 ${unit || row.unit}${sample}${invalid}`
  449. }
  450. /**
  451. * 本面板「有内容可画」的判据(规格 §6.7 的例外 + 盘点 §7.2)。
  452. *
  453. * 常规分区只有 SUCCESS/STALE 有内容可画;但**固定项面板**(类型卡/片区卡/等级卡)在
  454. * 「后端说没有数据、却仍给固定行」时必须照画 0 —— 否则「无数据 0」会被占位吞掉。
  455. * 触发形状固定为 `state = EMPTY` 且 `data != null`(fetcher 的空判据只认关键段缺失,
  456. * 不按计数为 0 判空,所以 EMPTY 也会带 data —— 两处判据是配套的)。
  457. *
  458. * 基础设施**不适用**这条例外:没有管道就不画假环(ticket 06 的验收原句)。
  459. */
  460. function fixedCardsSection(section) {
  461. if (sectionHasContent(section)) return true
  462. return !!section && section.state === SECTION_STATE.EMPTY && section.data !== null && section.data !== undefined
  463. }
  464. /** 排除项说明(规格 §2/§3 的 `excluded`:不静默丢,见 G9)。 */
  465. function excludedText(parts) {
  466. const text = parts.filter(Boolean).join(' · ')
  467. return text ? `口径剔除:${text}` : ''
  468. }
  469. /**
  470. * 感知设备面板(规格 §6.2)。
  471. *
  472. * 顶部 4 指标卡(总数/在线/离线/在线率)→ 4 张设备类型卡(含监测内容小字)→ 3 张片区卡。
  473. * 在线率分母为 0 时显示占位符;无状态记录的设备计离线(G7 裁定)。
  474. */
  475. export function perceptionDevicesPanel(data, section, extra) {
  476. const current = data || {}
  477. // 当前生效的全局行业筛选键(外壳喂的标量):只用来画类型卡的选中态。
  478. const activeIndustry = (extra && extra.industry) || ''
  479. const blocks = [
  480. // 顶部四卡(设计稿 2026-10-23 视觉对齐):读数在上、标签在下,每卡顶部一条语义色横条,
  481. // 读数按语义着色(在线绿 / 离线红 / 其余白)—— 色与横条都是 domain 给的 valueTone/accent。
  482. kpiBlock(
  483. [
  484. { key: 'deviceCount', label: '设备总数', value: valueText(current.deviceCount), unit: '台', accent: 'info' },
  485. { key: 'online', label: '在线', value: valueText(current.onlineCount), unit: '台', valueTone: 'lv4', accent: 'lv4' },
  486. { key: 'offline', label: '离线', value: valueText(current.offlineCount), unit: '台', valueTone: 'lv1', accent: 'lv1' },
  487. {
  488. key: 'onlineRate',
  489. label: '在线率',
  490. value: ratioView(current.onlineRate),
  491. hint: ratioHint(current.onlineRate),
  492. accent: 'info',
  493. },
  494. ],
  495. { layout: 'value-first' },
  496. ),
  497. // 类型卡 2x2(设计稿):卡内小字=后端的监测内容;行业图标 + 行业色边框;
  498. // 可点 → 写全局行业筛选(与条形图同一条 panel-action: industry 接缝,不新造交互)。
  499. cardsBlock(
  500. '按设备类型',
  501. (current.types || []).map((row) => ({
  502. ...row,
  503. tone: TYPE_TONES[row.code] || '',
  504. icon: TYPE_ICONS[row.code] || '',
  505. actionKey: TYPE_FILTER_KEYS[row.code] || '',
  506. // 选中态:当前行业筛选正好是这张卡代表的行业(再点一次即取消,走外壳既有 toggle 语义)。
  507. selected: Boolean(activeIndustry) && TYPE_FILTER_KEYS[row.code] === activeIndustry,
  508. })),
  509. // 维护者第 15 轮补充:还原 2x2(一行四张在正常分辨率下把卡压得太窄;
  510. // 「取消滚动条」不是正常分辨率的要求 —— 宽屏尽量减少即可)。
  511. { fixed: true, layout: 'two-by-two', action: 'industry', aside: '点击按行业筛选' },
  512. ),
  513. // 片区卡:城南/城北/太常固定三项,无数据画 0(规格 §6.2 第 3 条);一排三张。
  514. cardsBlock('按设备片区', current.districts || [], { fixed: true, layout: 'three', aside: '片区在网设备' }),
  515. // 维护者第 15 轮补充:还原为上下两块(并排在这种窄面板里把环图压得太小,
  516. // 环与排行都不好读)。高度问题按「宽屏尽量减少」处理,不追求任何分辨率都无滚动条。
  517. supplementalBlock(donutBlock('各类型在线设备', (current.types || [])
  518. .filter((row) => numberish(row.onlineCount) !== null)
  519. .map((row) => ({ code: row.code, label: row.label, count: row.onlineCount })), { layout: 'compact' })),
  520. supplementalBlock(rankingBarsBlock('类型在线率排行', (current.types || [])
  521. .filter((row) => numberish(row.onlineCount) !== null && numberish(row.offlineCount) !== null && row.onlineCount + row.offlineCount > 0)
  522. .map((row) => ({
  523. code: row.code, label: row.label, count: Math.round((row.onlineCount / (row.onlineCount + row.offlineCount)) * 1000) / 10,
  524. hint: `在线 ${row.onlineCount} / 状态可判 ${row.onlineCount + row.offlineCount}`,
  525. }))
  526. .sort((a, b) => b.count - a.count), { limit: 0, unit: '%', variant: 'rank' })),
  527. ]
  528. return {
  529. name: 'perceptionDevices',
  530. label: '感知设备',
  531. section,
  532. // 空态仍要画 4 类型卡 / 3 片区卡的 0(规格 §6.7 的例外)。
  533. hasContent: fixedCardsSection(section),
  534. blocks,
  535. excludedNote: excludedText([
  536. current.excluded && current.excluded.unknownTypeCount ? `类型未知 ${valueText(current.excluded.unknownTypeCount)} 台` : '',
  537. current.excluded && current.excluded.unassignedDistrictCount
  538. ? `未分片区 ${valueText(current.excluded.unassignedDistrictCount)} 台(不进片区卡)`
  539. : '',
  540. ]),
  541. note: '设备数取台账全量;无状态记录计离线',
  542. missing: panelMissingNote(current),
  543. placeholder: sectionPlaceholder(section),
  544. }
  545. }
  546. /**
  547. * 基础设施面板(规格 §6.3)。
  548. *
  549. * 顶部 2 指标卡(管道数/管线里程 km)→ 环形饼图(三类管道条数与占比,图例逐项带计数)。
  550. */
  551. export function pipeNetworkPanel(data, section) {
  552. const current = data || {}
  553. const blocks = [
  554. // 两卡按设计稿:图标+标签 → 大号数值+单位 → 口径小字(`caption`)。
  555. kpiBlock([
  556. {
  557. key: 'pipeCount',
  558. label: '管道数',
  559. value: valueText(current.pipeCount),
  560. unit: '根',
  561. caption: '供水 · 排水 · 燃气',
  562. },
  563. { key: 'lengthKm', label: '管线里程', value: valueText(current.lengthKm), unit: 'km', caption: '管网总长' },
  564. ], { layout: 'two' }),
  565. // 环形居中、图例在下横排。
  566. // 2026-10-23 维护者第 3 条:标题**不再重复管道数量**(上面两张指标卡已经给了),
  567. // 就叫「管道分类占比」—— 同一屏里同一个数说两遍只是噪音。
  568. donutBlock(
  569. '管道分类占比',
  570. (current.types || []).map((row) => ({
  571. code: row.code,
  572. label: row.label,
  573. count: row.count,
  574. // 环形几何按计数画;里程进悬停说明(图例仍逐项带条数)。
  575. hint: numberish(row.lengthKm) === null ? '' : `${row.lengthKm} km`,
  576. })),
  577. { layout: 'stack-below' },
  578. ),
  579. supplementalBlock(rankingBarsBlock('各类管线里程', (current.types || [])
  580. .filter((row) => numberish(row.lengthKm) !== null)
  581. .map((row) => ({ code: row.code, label: row.label, count: row.lengthKm }))
  582. .sort((a, b) => b.count - a.count), { limit: 0, unit: 'km', variant: 'rank' })),
  583. supplementalBlock(rankingBarsBlock('平均单管长度', (current.types || [])
  584. .filter((row) => numberish(row.lengthKm) !== null && numberish(row.count) > 0)
  585. .map((row) => ({
  586. code: row.code, label: row.label, count: Math.round((row.lengthKm * 1000 / row.count) * 10) / 10,
  587. hint: `${row.count} 根 · ${row.lengthKm} km`,
  588. }))
  589. .sort((a, b) => b.count - a.count), { limit: 0, unit: 'm/根', variant: 'rank' })),
  590. ]
  591. return {
  592. name: 'pipeNetwork',
  593. label: '基础设施',
  594. section,
  595. hasContent: sectionHasContent(section),
  596. blocks,
  597. excludedNote: excludedText([
  598. current.excluded && current.excluded.unclassifiedCount
  599. ? `未分类管线 ${valueText(current.excluded.unclassifiedCount)} 条(计入总数、不进饼图)`
  600. : '',
  601. ]),
  602. note: '里程按管长合计折算;占比按条数',
  603. missing: panelMissingNote(current),
  604. placeholder: sectionPlaceholder(section),
  605. }
  606. }
  607. /**
  608. * 运行监测-预警研判面板(规格 §6.4)。
  609. *
  610. * 顶部 2 指标卡(今日新增带差值、未解除)→ 4 张固定等级卡 → 类型排行 TOP3(可点)。
  611. * 排行标题严格为 `近30日 · 共XX起 · 点击筛选`(XX = 后端给的近 30 日总数)。
  612. */
  613. export function warningStudyPanel(data, section) {
  614. const current = data || {}
  615. const today = current.today || {}
  616. const ranking = current.typeRanking || {}
  617. // 排行标题按设计稿拆成两段:块标题「预警类型排行」+ 右上角小字「近30日 · 共XX起 · 点击筛选」。
  618. // 小字整句仍是需求原文的锁定文案(拆位置不拆字),闸门按整句断言。
  619. const rankingAside = `近30日 · 共${valueText(ranking.total)}起 · 点击筛选`
  620. const blocks = [
  621. kpiBlock([
  622. // 差值:正红负绿(规格 §6.6),块构造器按 `delta` 自动补文案与色调。
  623. { key: 'warningToday', label: '今日新增', value: valueText(today.newCount), unit: '条', delta: today.delta },
  624. // 未解除的第三行小字是「处置中预警」——处置中条数是本契约里可证实的读数(不再另编口径)。
  625. {
  626. key: 'warningUnresolved',
  627. label: '未解除',
  628. value: valueText((current.unresolved || {}).count),
  629. unit: '条',
  630. caption: unresolvedCaption(current.unresolved),
  631. },
  632. ], { layout: 'two' }),
  633. // 等级卡:一级→四级固定四项,无数据 0(规格 §6.4 第 2 条);数字与边框同等级色。
  634. cardsBlock(
  635. '未解除预警 · 分级',
  636. withLevelTones(current.levels || []),
  637. { fixed: true, layout: 'four' },
  638. ),
  639. // 全类型可点:动作键 `warningType`(落点:切「预警处置」模式并按类型过滤本地列表)。
  640. // 维护者 2026-10-23 第 4 条:不再只列前三,所有类型都排出来(limit: 0 = 全部)。
  641. rankingBarsBlock('预警类型排行', ranking.top || [], {
  642. limit: 0,
  643. action: 'warningType',
  644. variant: 'rank',
  645. unit: '起',
  646. aside: rankingAside,
  647. }),
  648. supplementalBlock(stackedBlock('未解除预警状态', [
  649. { key: 'PENDING', label: '待接收', count: current.unresolved?.statuses?.PENDING },
  650. { key: 'RECEIVED', label: '已接收', count: current.unresolved?.statuses?.RECEIVED },
  651. { key: 'PROCESSING', label: '处置中', count: current.unresolved?.statuses?.PROCESSING },
  652. { key: 'HANDLED', label: '已处置', count: current.unresolved?.statuses?.HANDLED },
  653. ])),
  654. supplementalBlock(donutBlock('未解除处置结构', [
  655. { code: 'todo', label: '待处置', count: ['PENDING', 'RECEIVED', 'PROCESSING'].reduce((sum, key) => sum + (Number(current.unresolved?.statuses?.[key]) || 0), 0) },
  656. { code: 'handled', label: '已处置', count: Number(current.unresolved?.statuses?.HANDLED) || 0 },
  657. ])),
  658. ]
  659. return {
  660. name: 'warningStudy',
  661. label: '运行监测-预警研判',
  662. section,
  663. // 无预警时等级卡要画 4 个 0(规格 §6.4 第 2 条 + §6.7 例外)。
  664. hasContent: fixedCardsSection(section),
  665. blocks,
  666. linkNote: '点类型排行会切到「预警处置」模式并按该预警类型过滤当前列表(规格 §6.4 第 4 条;类型筛选支持归票 07)',
  667. note: '未解除含待办/处置中/已处置',
  668. missing: panelMissingNote(current),
  669. placeholder: sectionPlaceholder(section),
  670. }
  671. }
  672. /**
  673. * 运行监测-报警处置面板(规格 §6.5)。
  674. *
  675. * 第一行 3 指标卡(今日新增带差值/已转工单/未转工单)→ 第二行 3 指标卡
  676. * (处置率/平均响应时长/平均处置时长)→ 4 张固定等级卡 → 近 7 日折线(标题【近7日报警数】)。
  677. * 比例与时长在分母/样本为 0 时显示占位符(规格 §5 末句 + §6.7)。
  678. */
  679. export function alarmDisposalPanel(data, section) {
  680. const current = data || {}
  681. const today = current.today || {}
  682. const conversion = current.conversion || {}
  683. const rate = current.rate || {}
  684. const response = current.responseDuration || {}
  685. const disposal = current.disposalDuration || {}
  686. const blocks = [
  687. // 第一行(设计稿):今日新增(带较昨日差值)、已转工单、未转工单;每卡第三行是口径小字。
  688. kpiBlock([
  689. { key: 'alarmToday', label: '今日新增', value: valueText(today.newCount), unit: '条', delta: today.delta },
  690. { key: 'alarmConverted', label: '已转工单', value: valueText(conversion.convertedCount), unit: '条', caption: '已派发处置' },
  691. { key: 'alarmUnconverted', label: '未转工单', value: valueText(conversion.unconvertedCount), unit: '条', caption: '待核实转派' },
  692. ], { layout: 'three' }),
  693. kpiBlock([
  694. { key: 'alarmRate', label: '报警处置率', value: ratioView(rate), hint: ratioHint(rate), caption: '已解除占比' },
  695. {
  696. key: 'responseDuration',
  697. label: '平均响应时长',
  698. value: durationView(response),
  699. unit: durationUnitText(response.unit),
  700. hint: durationHint(response),
  701. caption: '处置响应',
  702. },
  703. {
  704. key: 'disposalDuration',
  705. label: '平均处置时长',
  706. value: durationView(disposal),
  707. unit: durationUnitText(disposal.unit),
  708. hint: durationHint(disposal),
  709. caption: '处置完成',
  710. },
  711. ], { layout: 'three' }),
  712. // 等级卡:一级→四级固定四项,无数据 0(规格 §6.5 第 3 条);数字与边框同等级色。
  713. cardsBlock('已核实报警 · 分级', withLevelTones(current.levels || []), { fixed: true, layout: 'four' }),
  714. // 折线:标题严格为「【近7日报警数】」,X 轴 MM-DD、悬停读全日期(hint),含 0 点;
  715. // 线色按设计稿取 lv2(橙),tone 由 domain 给、色值仍只在 tokens.css 声明一份。
  716. trendBlock(
  717. '【近7日报警数】',
  718. (current.sevenDayTrend || []).map((point) => ({
  719. key: point.date,
  720. label: shortDate(point.date),
  721. count: point.count,
  722. hint: point.date,
  723. })),
  724. // 两条线并列(维护者 2026-10-23 反馈第 2 条):
  725. // ① 当天新增(当天 create_time 的条数);
  726. // ② 未处理报警(截至当天仍未处理的积压条数,`alarm_status = 0`)。
  727. // 两条线各按联合最大值归一并带图例,读者自己就能读出对照关系。
  728. //
  729. // 票 94 审查:第二条线**保留一句口径小字**(上一轮"不需要解释文案"的判定的例外)。
  730. // 原因不是"解释数据",而是**解歧义**:同一块面板上方 KPI 有「未转工单」(工单转化口径),
  731. // 折线这里是「未处理报警」(报警状态口径),两条读数会同时出现且数值不同
  732. // (2026-10-28 实测:未转工单 0 / 未处理报警 2,两者都真)。不点明,值班人员必然读成矛盾。
  733. // 小字放块右上角(`aside`),不改块标题【近7日报警数】(规格 §6.5 锁定标题)。
  734. {
  735. chart: 'line',
  736. compact: true,
  737. // 维护者第 16 轮:下方口径块压到两行后腾出的高度给这张折线(保底拉高一档)。
  738. tall: true,
  739. aside: '未处理=报警状态未解除,非工单口径',
  740. series: [
  741. { key: 'newAlarms', label: '当天新增', tone: 'lv2', counts: trendOf(current.sevenDayTrend) },
  742. // 票 96:由原始记录逐日还原(历史日不随今天的处置变化)。
  743. { key: 'unhandledTotal', label: '未处理报警(截至当日)', tone: 'lv1', counts: backlogOf(current) },
  744. ],
  745. },
  746. ),
  747. // 维护者 2026-10-29:折线下方补工单口径统计(转单构成 + 转单率),仍是真实字段。
  748. supplementalBlock(donutBlock('报警转工单构成', [
  749. { code: 'converted', label: '已转工单', count: conversion.convertedCount },
  750. { code: 'unconverted', label: '未转工单', count: conversion.unconvertedCount },
  751. ], { layout: 'compact' })),
  752. // 工单口径读数(只放上方还没有的读数:转单率与已核实报警总数)。
  753. // 处置率/平均时长**已经在上方 KPI 里**,这里重复就是噪音(同一屏说两遍)。
  754. // 维护者第 16 轮:这组读数「不那么重要」,压到**两行**即可 —— 原五行占了将近一块图的高度,
  755. // 把上面的「近7日报警数」折线挤成了细条。转单率与已核实总数保留(另两行是它们的分解,
  756. // 已在上方环图里表达),口径说明并进提示,不再单占一行。
  757. supplementalBlock(rowsBlock('工单转化口径', [
  758. { key: 'alarmConvertRate', label: '报警转单率', value: conversionRateView(conversion) },
  759. { key: 'verifiedAlarmCount', label: '已核实报警', value: valueText(conversion.totalCount) + ' 条' },
  760. ])),
  761. ]
  762. return {
  763. name: 'alarmDisposal',
  764. label: '运行监测-报警处置',
  765. section,
  766. // 无报警时等级卡要画 4 个 0、7 日折线画 7 个 0 点(规格 §6.5 + §6.7 例外)。
  767. hasContent: fixedCardsSection(section),
  768. blocks,
  769. // 面板口径说明(顶部折叠区)。**不再**把"上方全量 / 折线近7日"写成一句 ——
  770. // 维护者 2026-10-23 第 2 条明确不要那类多余说明;折线改成两条线 + 图例后,
  771. // "新增归零而积压不为零"这层关系读者自己看得出来,不需要一段文字去解释。
  772. // 口径行(票 94):第二条线撤下时把"为什么少一条线"写在这里,不静默丢。
  773. note: '基础集合为已核实报警;时长只计有日志的样本' + backlogNote(current),
  774. missing: panelMissingNote(current),
  775. placeholder: sectionPlaceholder(section),
  776. }
  777. }
  778. /** `YYYY-MM-DD` → 轴标签 `MM-DD`(悬停仍给完整日期,见上面折线的 `hint`)。 */
  779. function shortDate(date) {
  780. const text = typeof date === 'string' ? date.trim() : ''
  781. return text.length >= 10 && text[4] === '-' && text[7] === '-' ? text.slice(5) : text
  782. }
  783. /** panelId → 视图构造函数(本模式自己的四块)。 */
  784. export const OVERVIEW_PANEL_BUILDERS = {
  785. perceptionDevices: perceptionDevicesPanel,
  786. pipeNetwork: pipeNetworkPanel,
  787. warningStudy: warningStudyPanel,
  788. alarmDisposal: alarmDisposalPanel,
  789. }