补充高程预览改造记录

Co-authored-by: multica-agent <github@multica.ai>

memory/2026-05-03.md

@@ -57,3 +57,35 @@
 - 风险与影响：
   - 预览为采样结果，不等同于全量像元/点集展示；用于可视化核验分布与高程层级，不用于精确统计。
   - 栅格数据在大范围/高分辨率场景下，预览点位受 `max_points` 控制（默认 1500），避免接口与前端负载过高。
+
+## Work Log - 高程预览改造为地形网格渲染（2026-05-03）
+
+- 背景：
+  - 用户反馈“预览应直接基于高程数据展示区域地形高低，与杆塔无关”。
+  - 旧实现以采样点云为主，语义偏“数据采样校验”，不符合地形预览预期。
+
+- 本次改造：
+  - 后端预览响应扩展为双模式：
+    - `preview_mode = point_cloud | terrain_grid`
+    - 新增 `cells`（网格单元边界 + 高程）字段
+    - 文件：`api/app/schemas/elevation.py`
+  - 栅格预览改造为地形网格输出（默认）：
+    - 栅格按步长下采样后输出网格单元边界（WGS84）和单元高程
+    - 保留 `points` 作为兼容信息，但前端优先用 `cells` 渲染色带
+    - 告警文案去除“回填/杆塔”语境，改为“预览渲染自动转 WGS84”
+    - 文件：`api/app/services/elevation_service.py`
+  - 前端 Cesium 组件改造：
+    - 栅格数据优先渲染 `rectangle` 地形网格色带（蓝低红高）
+    - 点云模式作为 CSV/兜底展示
+    - 文件：`web/src/components/elevation-preview-cesium-map.tsx`
+  - 预览弹窗文案与模式展示更新：
+    - 明确显示当前模式“地形网格/点云”
+    - 页面提示改为“IMG/TIF/TIFF 预览为地形网格高低色带（与杆塔无关）”
+    - 文件：`web/src/app/admin/elevation/page.tsx`
+  - 前端类型同步：
+    - `web/src/types/auth.ts`
+
+- 交付：
+  - 提交：`556da5c`
+  - 信息：`改造高程预览为地形网格渲染`
+  - 已推送到 `origin/dev`。