fquiz/memory/2026-06-08.md

Work Log - 当前环境将线路管理菜单置顶（2026-06-08）

• 背景：

  • 仓库代码已支持 admin.power_lines 菜单，但默认排序仍落在其他后台一级菜单之后。
  • 用户要求在当前环境中让“线路管理”展示在后台菜单最前面。

• 本次处理：

  • 当前环境数据库：
    • 将 menus.code='admin.power_lines' 的 sort_order 调整为 0。
  • 仓库代码：
    • api/app/services/seed_service.py
      • 将默认种子菜单中 admin.power_lines 的 sort_order 同步改为 0，避免后续补种回退。
    • MEMORY.md
      • 补充“线路管理默认置顶”的长期口径。

• 验证：

  • 复核后台菜单排序后，线路管理 已位于一级菜单首位。

• 风险与关注点：

  • 已登录后台的浏览器会话需要刷新页面后才会看到最新菜单顺序。

Work Log - 放出后台剩余目录菜单并补齐保护（2026-06-08）

• 背景：

  • 当前仓库默认菜单集合缺少 admin.basic_data、admin.system_monitor、admin.system 3 个目录菜单。
  • admin.fl_analysis 已有完整页面，但旧权限映射与菜单保护集合仍未完全覆盖。

• 本次处理：

  • api/app/services/seed_service.py
    • 补齐上述 3 个目录菜单，并将其加入 admin 默认菜单绑定。
  • api/app/services/admin_service.py
    • 将 admin.system、admin.system_monitor、admin.basic_data、admin.fl_analysis、admin.fault_recurrence 加入现代菜单删除保护集合。
  • api/app/services/legacy_admin_rbac_service.py
    • 将 admin.system、admin.system_monitor、admin.basic_data、admin.fl_analysis 加入 legacy 受保护菜单集合。
  • api/app/services/legacy_authz_service.py
    • 补齐 admin.fl_analysis 的 legacy 权限映射。

• 验证：

  • git diff --check 通过。
  • npm --workspace web exec tsc --noEmit 通过。
  • npm --workspace web exec eslint src/app/admin/fl-analysis/page.tsx src/app/admin/fault-recurrence/page.tsx 通过。
  • Python 变更文件 AST 语法解析通过。

• 风险与关注点：

  • admin.basic_data、admin.system_monitor、admin.system 仍为无 path 的目录菜单，只承担菜单树占位与分组作用。

Work Log - 在共享后端镜像内置 Wine（2026-06-08）

• 背景：

  • 新需求要求把 Wine 安装到 fquiz-celery-worker。
  • 当前仓库中 celery-worker、api、celery-beat、flower 复用同一个 api/Dockerfile / ${API_IMAGE}，且后端已有 /api/v1/wine/* 直接探测与执行 Wine 的能力。

• 本次处理：

  • api/Dockerfile
    • 在系统依赖安装阶段加入 wine，并用 command -v wine 做镜像构建期存在性校验。
  • MEMORY.md
    • 将 Wine 口径从“运行环境自行安装”更新为“共享后端镜像已内置 Wine”。

• 验证：

  • python3 -c "import yaml; ..." 解析 deploy/dev-deploy/compose.yml、deploy/pro-deploy/compose.yml、.github/workflows/main.yml 通过。
  • git diff --check 通过。
  • python3 -m py_compile api/app/services/wine_service.py api/app/services/fl_analysis_external.py api/app/tasks/fl_analysis_tasks.py api/app/core/config.py 通过。
  • 当前执行环境无 docker 命令，未能本地实际跑 docker compose build / docker compose config。

• 风险与关注点：

  • 由于部署链路复用同一个后端镜像，本次会同时影响 api/celery-worker/celery-beat/flower 的基础镜像体积，而不只是 celery-worker。