Просмотр исходного кода

docs(memory): 记录首页GIS点位颜色语义统一

Kazerin 1 месяц назад
Родитель
Сommit
1b95c47b56
2 измененных файлов с 33 добавлено и 0 удалено
  1. 1 0
      memory/index.md
  2. 32 0
      memory/sessions/2026-09-18.md

+ 1 - 0
memory/index.md

@@ -64,3 +64,4 @@ npm run dev       # 默认 http://localhost:80
 - [2026-09-10:WGS84→BD09 诊断与管理端工单生命周期共识更新](sessions/2026-09-10.md)
 - [2026-09-16:监测报警 GIS 接入统一画布(Ticket #4)](sessions/2026-09-16.md)
 - [2026-09-17:供水首页工作台 #58 四项修正收尾(前端呈现 + 后端实时报警根因)](sessions/2026-09-17.md)
+- [2026-09-18:首页 GIS 点位颜色语义统一(仅首页)](sessions/2026-09-18.md)

+ 32 - 0
memory/sessions/2026-09-18.md

@@ -0,0 +1,32 @@
+# 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` 存在语义重复;因后者未导出且设施一张图仍需按类型上色,为守住“仅首页”边界暂保持本地映射。
+
+## 后续行动
+
+- 待用户在首页人工验收设施状态颜色与图例;通过后再推送(当前仅本地提交)。