2026-08-22.md 2.2 KB

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