fquiz/memory/2026-06-07.md

Work Log - 线路管理新建线路表单去掉塔型/状态（2026-06-07）

• 背景：

  • Issue FL-8 要求调整 /admin/power-lines 新建线路表单，去掉“塔型”“状态”表单项，并删除对应字段契约。
  • 代码排查确认影响不仅在前端表单，还包括线路公开 schema、线路列表筛选、线路卡片展示，以及 CSV 导入导出的线路元数据字段。
  • 仓库当前无显式 Alembic 迁移链路，因此本次不直接做数据库删列迁移，优先收口前后端公开契约与页面行为。

• 本次改动：

  • web/src/app/admin/power-lines/page.tsx
    • 删除线路表单中的 tower_shape、status 字段。
    • 删除线路列表状态筛选、线路卡片状态 Tag、线路卡片塔形展示。
    • 调整创建/更新请求体，仅提交 code、name、voltage_kv。
  • web/src/types/auth.ts
    • 删除 LineStatus 类型与 LineSummary 中的 tower_shape、status 字段。
  • api/app/schemas/line.py
    • 删除 LineSummary、LineCreateRequest、LineUpdateRequest 中的 tower_shape、status 字段。
  • api/app/api/v1/lines.py
    • 删除线路列表接口的 status 查询参数。
  • api/app/services/line_service.py
    • 删除线路序列化输出中的 tower_shape、status。
    • 删除线路列表状态筛选逻辑。
    • 删除创建/更新线路时对 tower_shape、status 的公开读写。
    • 删除杆塔 CSV 导出中的“塔形”列，以及 CSV 导入元数据对“塔形”的回填。
  • api/tests/test_line_contract.py
    • 新增 AST 级最小回归测试，校验线路公开 schema/接口/CSV 导出头中不再暴露上述字段。

• 验证：

  • python3 -m unittest api/tests/test_line_contract.py 通过。
  • npm --workspace web run lint -- src/app/admin/power-lines/page.tsx 仍失败，但失败项与修改前一致：
    • react-hooks/set-state-in-effect 2 处
    • react-hooks/exhaustive-deps warning 4 处
    • 本次未新增新的 lint 问题。

• 风险与关注点：

  • power_line 表中的 tower_shape / status 数据列仍保留为兼容字段，避免在缺少迁移链路时影响现网插入；当前仅前后端公开契约不再读写/展示这两个字段。

Work Log - 线路管理新建线路优化（2026-06-07）

• 背景：

  • Issue FL-10 要求优化 /admin/power-lines 的新建线路弹窗：
    • 去掉“线路编码将由系统自动生成”提示；
    • 将“电压等级”改为必填。
  • 代码排查确认目标仅命中前端页面 web/src/app/admin/power-lines/page.tsx；后端线路接口当前仍保留 voltage_kv 可空兼容，未在本次需求内扩展为全链路契约变更。

• 本次改动：

  • web/src/app/admin/power-lines/page.tsx
    • 删除新建线路弹窗顶部“线路编码将由系统自动生成”提示。
    • 为“电压等级”增加 AntD 表单必填规则，错误文案为“请选择电压等级”。
    • 去掉电压等级下拉的 allowClear，避免用户主动清空后提交空值。

• 验证：

  • 执行 npm_config_cache=/tmp/npm-cache npm ci，补齐 web 依赖。
  • 执行 npm_config_cache=/tmp/npm-cache npx eslint web/src/app/admin/power-lines/page.tsx：
    • 无新增 error；
    • 仍有 4 条既有 react-hooks/exhaustive-deps warning，与本次改动无关。

• 风险与关注点：

  • 当前“电压等级必填”仅收口在前端新建/编辑弹窗；若后续还有其他外部写入入口，需要单独评估是否同步收紧后端 LineCreateRequest 校验。

Work Log - 去掉线路管理页左侧提示文案（2026-06-07）

• 背景：

  • Issue FL-12 要求去掉 /admin/power-lines 页面左侧卡片里的说明文案“左侧选择线路，右侧查看线路分布图或塔杆列表。”。
  • 文案全局检索只命中 web/src/app/admin/power-lines/page.tsx 一处，未发现接口、类型或其他页面联动影响。

• 本次改动：

  • web/src/app/admin/power-lines/page.tsx
    • 删除线路管理左侧卡片顶部的提示文案，仅保留筛选输入框和线路列表。

• 验证：

  • 基线：npm --workspace web run lint -- src/app/admin/power-lines/page.tsx 通过。
  • 修改后：npm --workspace web run lint -- src/app/admin/power-lines/page.tsx 通过。

• 风险与关注点：

  • 本次仅调整前端展示文案，不涉及页面交互、数据请求或接口契约。

Work Log - 迁移故障复现工具（2026-06-07）

• 背景：

  • Issue FL-18 要求把源端 /home/ck/fl-knowledge/LP/Form7_GuZhangFuXian.cs 与 LP/FuXian.cs 的“故障复现”能力迁入 fquiz。
  • 源端工具是一个独立分析器：上传基础数据文件后，按波形、类型和耐雷水平做复现计算，并返回最可能的波头/波尾组合。
  • 目标仓库现有 fl-analysis 聚焦任务化风险评估，不适合硬塞入同一任务模型；因此本次采用独立无状态工具页 + 上传接口的最小闭环接入。

• 本次改动：

  • 后端
    • api/app/services/fault_recurrence_service.py
      • 纯 Python 迁移 FuXian 核心逻辑：文件解码、源端分段文本/普通 CSV 双格式解析、2.6/50 基准点判断、按同波头分组插值、KDE 概率密度比选。
    • api/app/schemas/fault_recurrence.py
      • 新增故障复现结果 schema，统一前端契约。
    • api/app/api/v1/fault_recurrence.py
      • 新增 POST /api/v1/fault-recurrence/analyze，接收 multipart/form-data 上传并返回结构化结果。
    • api/app/api/router.py
      • 注册故障复现路由。
    • api/app/services/seed_service.py
      • 新增默认菜单 admin.fault_recurrence，路径 /admin/fault-recurrence，并加入 admin 默认菜单绑定。
    • api/app/services/legacy_authz_service.py
      • 补 legacy 权限映射与 synthetic menu，兼容旧菜单表场景。
    • api/app/services/legacy_admin_rbac_service.py
      • 将 admin.fault_recurrence 加入受保护菜单集合。
  • 前端
    • web/src/app/admin/fault-recurrence/page.tsx
      • 新增独立 admin 工具页，支持选择基础数据文件、配置波形/类型/耐雷水平、执行复现、展示结构化结果与基础数据表格预览。
    • web/src/types/auth.ts
      • 新增故障复现前端类型定义。
  • 测试
    • api/tests/test_fault_recurrence_service.py
      • 新增纯 Python 服务测试，覆盖分段文本解析、No need! 分支、插值结果与缺基准点 warning。
    • api/tests/test_fault_recurrence_contract.py
      • 新增 AST 契约测试，覆盖 router 注册与菜单/权限落点。

• 验证：

  • 基线：
    • python3 -m unittest tests.test_line_contract 通过。
  • 迁移后：
    • python3 -m unittest tests.test_fault_recurrence_service tests.test_fault_recurrence_contract 通过。
    • python3 -m unittest tests.test_line_contract 通过。
    • npm --workspace web run lint -- src/app/admin/fault-recurrence/page.tsx 通过。
    • npm --workspace web exec tsc --noEmit 通过。
    • npm --workspace web run build 未完成，进程被环境以 code 137 杀掉；构建日志未给出新增代码级报错，更像资源限制。

• 风险与关注点：

  • 当前工具仍是“上传文件即时计算”模式，未与现有线路台账做持久化绑定；若后续需要从已导入线路直接发起故障复现，需要再评估与 line/tower profile 的联动入口。
  • 前端完整 next build 在当前执行环境被 SIGKILL/137 中断，虽然 lint 与 tsc --noEmit 已通过，但仍需在资源更充足的 CI/部署环境再确认一次全量构建。