# 2026-08-22：供水报警与工单前端适配设计

## 本次目标

在分发前端执行任务前，确认供水设备异常、报警、工单处置和相关页面视觉重构规范。

## 已完成

- 探索供水设备、报警管理、报警审核和统一工单页面的复用关系及现有接口。
- 对照燃气与窨井工单页面，确定采用紧凑的主从工作台，而非照搬旧页面。
- 新建根目录 `CONTEXT.md`，统一报警、设备状态、接单责任人和工单处置术语。
- 确认设备报警状态、报警记录状态和工单处置状态为三个独立概念。
- 确认报警管理负责态势与派单，报警审核负责供水故障维修工单完整流程，供水工单总览展示全部供水类型工单。
- 确认巡检和保养工单由其他系统创建与首次派发，被派给当前用户后可在供水工单总览继续处置。
- 确认同设备同报警编码同时只能存在一个未结束工单，不同报警编码可分别生成。
- 确认工单验收不直接清警；运行系统根据全部有效报警原因执行自动清警。
- 完成五个页面、共享责任人选择器、供水菜单图标和响应式验收规范。

## 重要发现

- 当前报警转工单接口只创建待派单工单，不接收责任人，符合两阶段流程，但前端需要随后调用统一工单派发。
- 当前后端按单条报警 ID 去重，尚不满足“设备 + 报警编码”的活动工单唯一性。
- 当前误报审核只更新报警记录状态，不会联动终止关联工单。
- 当前统一工单派发仍使用多人 ID 列表，需先补充唯一责任人的后端契约。
- 供水菜单主要来自后端动态菜单，完整图标覆盖需要同步更新后端菜单配置。

## 后续顺序

1. 用户最终确认设计摘要。
2. 使用隔离 worktree 和 `gpt-5.6-terra` 分发后端契约任务，执行者不得合并或推送。
3. 当前对话完成后端代码审查与验收。
4. 后端验收通过后，以同样约束分发前端适配与视觉重构任务。
5. 当前对话依据构建、测试和多宽度截图完成前端验收。

## 设计文档

- `docs/design/2026-08-22-water-supply-work-order-ui.md`