2026-09-18.md 2.4 KB

2026-09-18:首页 GIS 点位颜色语义统一(仅首页)

目标

按用户要求统一供水首页“全域态势”GIS 点位颜色语义:保留设备五态(红-报警、蓝-工单、黄-预警、灰-离线、绿-正常),设施点位从“按设施类型上色”改为“按设施状态上色”,并补充顶部图例。

结论与变更

  • 提交 65a332c:src/utils/waterHomeModel.js 新增 HOME_FACILITY_STATUS_META,设施状态映射为共享 statusKey:
    • 水源地:0 正常(绿)、1 异常(红)
    • 水厂:0 正常(绿)、1 停产(红)
    • 泵站:0 正常(绿)、1 故障停运(红)、2 检修中(蓝)
    • 用水户:0 正常(绿)、1 欠费(黄)、2 停用(红)
  • 设施点位图标改用 getMonitoringPointIcon({ statusKey })(与设备同一套红/蓝/黄/灰/绿图标),并携带 statusText 供详情抽屉展示业务化状态文案;状态缺失按正常处理。
  • 管网(pipe 类型)不落点位、不加图标,仍以黄色管线呈现(#f1c40f 保持不变)。
  • 首页顶部图例改为组合文案:报警/异常、工单/检修中、预警/欠费、离线、正常;图例色值改为直接引用 gisPointStatusColors,与 GIS 点位调色板同源。
  • 详情抽屉状态标签优先显示 overviewDetail.statusText(设施业务状态),无该字段时回落 gisStatusLabel(设备状态)。
  • 设施 GIS 一张图、设备 GIS 一张图等其他页面不受影响,仍按各自规范上色。

验证结果

  • TDD:新增模型测试“设施点位按状态共享设备色语义”(先红后绿)与首页契约测试“图例与详情覆盖统一状态色”。
  • 前端全量 node --test tests/*.test.mjs 159/159 通过;vite build --logLevel error 通过。

审查备注

  • Spec 审查另提出两条历史遗留项,均不在本次 diff 内、未处理:首页蓝白主题的装饰性渐变(#48 已验收交付)、工单处理中状态沿用橙色而非青绿色。如需调整建议另立票。
  • Standards 判断项:HOME_FACILITY_STATUS_META 的状态文案与 waterFacilityGisModel.js 的 facilityStatusLabels 存在语义重复;因后者未导出且设施一张图仍需按类型上色,为守住“仅首页”边界暂保持本地映射。

后续行动

  • 待用户在首页人工验收设施状态颜色与图例;通过后再推送(当前仅本地提交)。