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

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

## Question

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

## Answer

### 一、范围

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

### 二、异常统计（Q1 / Q4 / Q26 / Q29 / Q22）

- **监测点异常统计**：`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）。

### 三、处置率（Q2 / Q24 / Q25 / Q30）

- 分子＝状态 `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（无需再次迁移）。

### 四、管理字段与片区/行业统一语义（Q5 / Q7 / Q8 / Q9 / Q10 / Q11 / Q12 / Q13 / Q14 / Q17 / Q18 / Q23 / Q27 / Q28）

- 本项目**分析维度只有两个**：
  - **片区**：`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）。

### 五、回写与边界（Q19 / Q20 / Q21）

- 票 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` 决策按本票修订。