补充高程预览诊断面板记录

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

memory/2026-05-03.md

@@ -90,6 +90,36 @@
   - 信息：`改造高程预览为地形网格渲染`
   - 已推送到 `origin/dev`。
 
+## Work Log - 新增高程预览诊断信息面板（2026-05-03）
+
+- 背景：
+  - 用户要求在预览弹窗补充“诊断信息”面板，便于快速定位“未提取到有效地形网格”的根因。
+
+- 本次改动：
+  - 后端预览响应扩展 `diagnostics` 字段：
+    - 文件：`api/app/schemas/elevation.py`
+    - 新增模型：`ElevationDatasetPreviewDiagnostics`
+    - 字段覆盖：
+      - 源数据信息：`source_crs`、源边界（min/max x/y）
+      - WGS84 边界：`wgs84_bounds_*`
+      - 采样参数：`target_samples`、`sampling_step`
+      - 统计：`scanned_candidates`、`valid_preview_count`
+      - 跳过计数：读失败、masked、nodata、非有限值、样本/网格坐标转换失败、越界
+  - 后端预览逻辑补充诊断采集：
+    - 文件：`api/app/services/elevation_service.py`
+    - CSV 模式：返回基础范围与采样统计。
+    - 栅格模式：返回 CRS/边界（含可转换时的 WGS84 边界）与逐类跳过计数。
+  - 前端新增诊断面板展示：
+    - 文件：`web/src/app/admin/elevation/page.tsx`
+    - 在预览弹窗中新增“诊断信息”卡片（`Descriptions`），展示上述关键字段。
+  - 前端类型同步：
+    - 文件：`web/src/types/auth.ts`
+    - 新增 `ElevationDatasetPreviewDiagnostics` 并挂载到 `ElevationDatasetPreviewResponse.diagnostics`。
+
+- 交付：
+  - 提交：`ba1b83f`（rebase 后推送到 `dev` 的提交为 `4b0c7ed`）
+  - 信息：`新增高程预览诊断信息面板`
+
 ## Work Log - 高程数据集支持删除（2026-05-03）
 
 - 背景：
@@ -116,4 +146,3 @@
 - 风险与影响：
   - 删除数据集会同时删除其关联的回填任务记录（仅记录，不会回滚已写入杆塔的高程值）。
   - 若数据集存在运行中任务，接口会拒绝删除并提示先等待任务结束。
-