06: 异常统计、工单处置率与管理字段词汇

Type: grilling Status: resolved Labels: wayfinder:grilling Blocked by: None

Question

把已确认的跨模式业务口径写成可执行的契约，避免真实接线时沿用旧 mock 语义：异常统计桶、工单处置率口径、管理字段词汇与片区/行业统一语义。

锁定五组口径：①监测点异常统计桶 ②设备/指标异常统计桶 ③异常点可见性 ④处置率口径 ⑤管理字段词汇与片区/行业统一语义 + E1「责任区域」最终裁定。

监测点异常统计：ALARM / WARNING / OFFLINE / EMPTY；WORK_ORDER 不进入。
设备/指标异常统计：WARNING / ALARM / EXPIRED / OFFLINE / UNKNOWN；按对象分别计数，不把点位与设备重复相加、不合并为单一「异常总数」。
预警处置地图「异常点」：只由设备 WARNING / ALARM 回联决定。abnormalEquipment 清单可含 EXPIRED / OFFLINE（宽清单），但地图可见性只认 WARNING / ALARM（窄地图）；清单与地图计数分开（Q26=A）。
桶定义收在一处 domain 纯函数，不新增专用端点（Q4=A）。
成功响应时缺失桶显示 0；整个分区无数据才走 EMPTY / UNAVAILABLE——「0」是真实业务结果（当前没有该类异常），不是“没有数据”（Q29=A）。
统计口径保持数字（如 district 编码 0/1/2），页面展示层才映射中文（Q22）。

分子＝状态 5（已结案）计数；分母＝状态 0–6 工单数之和；状态 7（取消）排除。
工单范围＝当前行业/片区/时间范围内的全部工单（状态 0–6），不要求关联报警/事件（Q24=A）。
分母为 0 → 显示“—/不适用”，提示「当前范围没有可计入工单，处置率不适用」，不显示 0%（Q25=A）。
basis 改为明确的工单分母语义（如 CLOSED_WORK_ORDERS_OVER_ELIGIBLE_WORK_ORDERS，eligible=[0..6]）；旧 CLOSED_WORK_ORDERS_OVER_TOTAL_EVENTS（工单数 ÷ 事件总数）与旧“状态 6 / 全部事件”口径必须废止（Q30=A）。
前端不直接展示原始 basis 码；工单字典前端已实测对齐后端 0–7（无需再次迁移）。

本项目分析维度只有两个：
- 片区：district 编码 0/1/2 → 城南/城北/太常；空值、乱码与未识别值统一显示为「未分区」。district 是片区唯一权威来源（取代 organization；统计保留数字，展示层映射中文）。
- 行业：供水 / 排水 / 燃气 / 窨井（MANHOLE）。窨井为界面显示词，取代原「井盖」，MANHOLE 映射不变。
后端统一按 district 过滤与回显；旧自由串 region 不再作为正式范围契约——#02 的 regionMap 决策按此修订（Q17/Q9）：范围条件正式为片区（城南/城北/太常/未分区），脏值不参与筛选。
管理信息面板：保留原 panelId/布局位置（Q15），改为片区 × 行业的设施/设备计数视图；原「管理单位 / 权属构成 / 责任区域」内容移除（Q10）。
后端 organizations / ownershipDistribution / unmaintained 字段从响应中删除（Q28=B）。
设备档案 ownershipUnit / maintainer / maintainerPhone 保留为静态档案信息，不参与筛选、统计与业务口径（Q11/Q16）。
「责任区域」＝片区的展示别名，不是独立业务概念（Q23=B）；本项目不存在独立“责任区域”字段。历史票 17 的「责任区域」验收文字作废，不用管理单位、权属单位、行业或任何字段冒充（Q12/Q18）。

票 25 回写：E1 责任区域 → out-of-scope / 产品不提供；处置率按 5 / (0–6)；异常统计口径冻结；其余契约/执行拆分仍由后续执行票承接。
deck_context 本轮仍可用性未确认（读取额度被闸）→ 继续本地 Markdown tracker 落盘（Q20）。
本轮不运行 build / debug 或浏览器走查（AGENTS.md 规则）；异常桶、处置率与 district 的契约验证列入后续执行票（Q21）。

已解决。 异常统计三套口径、处置率 5/(0–6) 与 basis 修订、片区(dictrict)/行业(含窨井)统一语义、管理信息面板片区化、责任区域别名化、档案静态字段保留、票 25 回写内容等全部确认。执行票按本票结论接线；#02 的 regionMap 决策按本票修订。