[fix/feat]:[FL-60][线路管理中走向图渲染不出来]

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

memory/2026-06-09.md

@@ -30,3 +30,32 @@
 
 - 风险与关注点：
   - 本次修复只绕开 BuildKit builder 镜像对 Docker Hub 的依赖；后续若 `Dockerfile` 里的基础镜像或 `docker build --pull` 仍指向不稳定上游，构建阶段仍可能出现其他网络相关失败。
+
+## Work Log - 修复线路管理走向图在 `/fl` 子路径下无法渲染（2026-06-09）
+
+- 背景：
+  - Issue `FL-60` 反馈“线路管理中走向图渲染不出来”。
+  - 仓库部署默认启用 `NEXT_PUBLIC_APP_BASE_PATH=/fl`，但多个 Cesium 组件初始化时仍把 `window.CESIUM_BASE_URL` 硬编码为 `"/cesium"`。
+  - 这会导致页面在 `/fl/admin/power-lines` 等子路径下请求错误的静态资源地址，最终触发 Cesium Viewer 初始化失败。
+
+- 本次处理：
+  - `web/src/components/power-line-cesium-map.tsx`
+    - 将走向图 Cesium 静态资源根路径改为 `withBasePath("/cesium")`，修复线路管理走向图在 `/fl` 部署下的资源寻址。
+  - `web/src/components/elevation-preview-cesium-map.tsx`
+    - 同步改为 `withBasePath("/cesium")`，避免高程预览图在相同部署口径下继续空白。
+  - `web/src/components/lightning-distribution-map.tsx`
+    - 同步改为 `withBasePath("/cesium")`，保持雷电分布图与项目子路径部署口径一致。
+    - 顺手补齐 `Viewer` / `CesiumNamespace` / `Cartesian3[]` 显式类型，消除本地 lint 暴露的 `no-explicit-any` 问题。
+
+- 验证：
+  - 基线：
+    - 代码检查确认 `power-line-cesium-map.tsx`、`elevation-preview-cesium-map.tsx`、`lightning-distribution-map.tsx` 都存在 `window.CESIUM_BASE_URL = "/cesium"` 硬编码。
+    - 部署配置检查确认 `deploy/pro-deploy/.env` 与 compose / Dockerfile 默认均为 `NEXT_PUBLIC_APP_BASE_PATH=/fl`。
+    - 初次本地 lint 尝试因未安装前端依赖失败；补充执行 `NPM_CONFIG_CACHE=/tmp/npm-cache npm ci` 后继续验证。
+  - 修改后：
+    - `NPM_CONFIG_CACHE=/tmp/npm-cache npm --workspace web exec eslint src/components/power-line-cesium-map.tsx src/components/elevation-preview-cesium-map.tsx src/components/lightning-distribution-map.tsx src/app/admin/power-lines/page.tsx --max-warnings=0` -> 通过。
+    - `NEXT_PUBLIC_APP_BASE_PATH=/fl NPM_CONFIG_CACHE=/tmp/npm-cache npm run build:web` -> 通过。
+
+- 风险与关注点：
+  - 本次修复聚焦前端静态资源路径，不涉及后端接口、数据库或权限逻辑。
+  - 若后续新增 Cesium 页面，必须继续复用 `withBasePath("/cesium")`，不能再硬编码根路径。