Admin/fquiz
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
8d6733a27c5aba66a5e939aa762cd66db6cda6a1
fquiz/memory/2026-04-26.md
T
chengkai3 c8ba704e40 chore: sync workspace changes
2026-04-29 23:10:25 +08:00

33 KiB
Raw Blame History

Work Log - 去除后台左侧菜单标题与底部角色状态文案（2026-04-26）

  • 背景：

    • 用户要求去掉左侧导航中的“系统菜单”文案，以及底部“当前角色：admin”“账号状态：active”两行。

  • 本次改动（最小闭环）：

    • web/src/app/admin/layout.tsx
      • 删除桌面端侧栏顶部文案“系统菜单”。
      • 删除桌面端侧栏底部角色/状态信息块。
      • 移动端左侧抽屉标题改为 null，不再显示“系统菜单”。
      • 菜单开关按钮 aria-label 同步调整为“打开菜单/展开菜单/收起菜单”。

  • 验证：

    • rg -n "系统菜单|当前角色：|账号状态：" web/src/app/admin/layout.tsx -S -> 无匹配。
    • npm --workspace web exec tsc --noEmit --pretty false -> 通过。

  • 风险与影响：

    • 仅影响后台左侧导航展示文案，不涉及菜单权限、路由与接口逻辑。

Work Log - 打包镜像并发布更新（2026-04-26）

  • 背景：

    • 用户要求执行“打包镜像并发布更新”。

  • 本次执行：

    • docker compose build
    • docker compose up -d

  • 验证：

    • docker compose ps：api/web/celery/db/redis/minio 均为 Up，api/db/redis healthy。
    • docker compose logs --tail=80 api：Uvicorn 启动完成，GET /health 返回 200。
    • docker compose logs --tail=80 web：Next.js Ready。
    • curl -fsS http://127.0.0.1:8000/health：返回 {"status":"ok","service":"fquiz-api","version":"0.1.0"}。
    • curl -I -fsS http://127.0.0.1:3000/：返回 HTTP/1.1 200 OK。

  • 风险与影响：

    • 本次为镜像重建与容器滚动重启，存在短时服务切换窗口；未执行数据库结构变更。

Work Log - 下线收件箱、提示词管理、代码评审与 Git管理（2026-04-26）

  • 背景：

    • 用户要求删除“收件箱、提示词管理、代码评审、Git管理”功能。

  • 本次改动：

    • 前端：
      • 删除后台页面入口：
        • web/src/app/admin/inbox/page.tsx
        • web/src/app/admin/prompt/page.tsx
        • web/src/app/admin/system-message/page.tsx
        • web/src/app/admin/code-review/page.tsx
        • web/src/app/admin/git-desktop/page.tsx
      • web/src/app/admin/page.tsx 删除对应后台首页卡片。
      • web/src/app/admin/menus/page.tsx 删除对应受保护菜单编码。
      • web/src/types/auth.ts 删除系统消息/提示词管理相关类型。
    • 后端：
      • 删除提示词管理 API、schema、service、model：
        • api/app/api/v1/system_messages.py
        • api/app/schemas/system_message.py
        • api/app/services/system_message_service.py
        • api/app/models/system_message.py
      • api/app/api/router.py 取消 /api/v1/admin/system-messages* 路由挂载。
      • api/app/core/database.py、api/app/models/__init__.py 取消 system_message 模型导入。
      • api/app/services/seed_service.py 删除默认权限、默认菜单和 admin 菜单绑定。
      • api/app/services/admin_service.py、api/app/services/legacy_admin_rbac_service.py、api/app/services/legacy_authz_service.py 将四个历史菜单编码纳入已下线过滤，避免存量菜单继续展示。
      • api/app/services/topic_registry.py 删除 admin.system-messages 订阅规则。

  • 验证：

    • python3 -m py_compile api/app/api/router.py api/app/core/database.py api/app/models/__init__.py api/app/services/seed_service.py api/app/services/admin_service.py api/app/services/legacy_admin_rbac_service.py api/app/services/legacy_authz_service.py api/app/services/topic_registry.py -> 通过。
    • npm --workspace web exec tsc --noEmit --pretty false -> 通过（清理 .next 后复跑）。
    • npx eslint src/app/admin/page.tsx src/app/admin/menus/page.tsx src/types/auth.ts -> 通过。
    • npm run build:web -> 通过，构建路由列表已不再包含 /admin/inbox、/admin/prompt、/admin/system-message、/admin/code-review、/admin/git-desktop。
    • git diff --check（命中文件）-> 通过。
    • npx @ant-design/cli lint src/app/admin/page.tsx --format json：默认 npx cache 报 ENOTEMPTY；改用 /tmp 独立 cache 后命令长时间无返回，已终止卡住进程，未得到有效 AntD CLI lint 结果。

  • 风险与影响：

    • 本次仅下线入口、路由、默认权限/菜单和提示词管理执行链路，不执行数据库 drop；存量 system_messages 表如果已存在，会作为历史数据保留。
    • admin.system_message、admin.inbox、admin.code_review、admin.git_desktop 被保留在 removed/disabled 集合中，仅用于过滤历史菜单。

Work Log - 文件管理页去掉左侧挂载点（2026-04-26）

  • 背景：

    • 用户要求：文件管理仅会有本地/SFTP/S3 三种后端，不会出现多挂载点场景，去掉左侧挂载点。

  • 本次改动（最小闭环）：

    • web/src/app/admin/files/page.tsx
      • 删除左侧“挂载点”卡片与挂载点列表按钮组。
      • 删除前端挂载点切换状态与逻辑（mountCode、handleSelectMount）。
      • 文件列表查询改为仅按 path 拉取，由后端返回 current_mount 作为当前挂载上下文。
      • 保留文件操作接口参数 mount_code，统一使用当前响应中的 current_mount.code。

  • 验证：

    • npm --workspace web exec tsc --noEmit --pretty false -> 通过。

  • 风险与影响：

    • 前端不再支持多挂载点手动切换；若后续恢复多挂载点产品形态，需要补回挂载点切换入口。
    • 后端接口与数据模型未改动，仍兼容多挂载点能力。

Work Log - 任务监控功能彻底收口（2026-04-26）

  • 背景：

    • 用户要求“补充任务监控功能”并“彻底收口”。

  • 本次改动：

    • 后端接口对齐 Celery 监控语义：
      • api/app/api/v1/task_monitor.py
        • 查询参数统一为 task_limit / history_limit。
        • 权限校验统一为 celery.read / celery.manage。
        • 移除旧的需求/待办聚合参数与依赖（risk_limit / stale_hours）。
    • 前端页面按 Celery schema 重写：
      • web/src/app/admin/task-monitor/page.tsx
        • 请求参数改为 task_limit / history_limit。
        • 页面展示改为 Worker / Queue / Task 三块监控表格。
        • 统计卡片改为在线 Worker、总并发、队列待处理、采样任务数。
        • 状态分布改为任务状态桶（STARTED/RECEIVED/SCHEDULED/...）。
        • 页面权限改为 celery.read / celery.manage。
    • 后台首页入口口径同步：
      • web/src/app/admin/page.tsx
        • “任务监控”卡片文案改为 Celery 监控描述。
        • 可见权限改为 celery.read / celery.manage。

  • 验证：

    • npm --workspace web exec tsc --noEmit --pretty false -> 通过。
    • python3 -m compileall api/app/api/v1/task_monitor.py api/app/services/task_monitor_service.py api/app/schemas/task_monitor.py -> 通过。

  • 风险与影响：

    • 任务监控口径从“需求/待办风险聚合”切换为“Celery 运行态监控”；若历史调用仍传 risk_limit/stale_hours，将不再生效。
    • 页面和接口权限都已切至 celery.*，需要对应角色具备 Celery 权限才可访问。

Work Log - 任务监控补齐 Celery 队列积压与历史状态（2026-04-26）

  • 背景：

    • 用户确认“任务监控要监控 Celery 队列和任务状态”，需要从方案落到可运行实现。

  • 本次补齐：

    • 后端 api/app/services/task_monitor_service.py：
      • inspect.active/reserved/scheduled/active_queues/stats/ping 聚合 Worker 与实时任务。
      • Broker 为 Redis 时按队列执行 LLEN，输出真实 pending_count（不再用 reserved/scheduled 近似值）。
      • Result backend 为 Redis 时扫描 celery-task-meta-*，补齐 SUCCESS/FAILURE/RETRY/REVOKED 历史状态。
      • 任务明细按状态优先级 + 时间排序，支持 task_limit/history_limit。
    • 接口与权限：
      • api/app/api/v1/task_monitor.py 改为 task_limit/history_limit 参数。
      • 权限校验统一为 celery.read / celery.manage。
    • 权限映射与菜单：
      • api/app/services/seed_service.py 增加 celery.read/celery.manage，并将 admin.task_monitor 权限改为 celery.read。
      • api/app/services/legacy_authz_service.py 同步 admin.task_monitor -> celery.* 映射。
    • 前端 web/src/app/admin/task-monitor/page.tsx：
      • 展示 Worker/Queue/Task 三块监控视图；
      • 自动刷新、任务上限、历史扫描上限可配置；
      • 状态 Tag 与失败摘要展示。

  • 验证：

    • python3 -m py_compile api/app/schemas/task_monitor.py api/app/services/task_monitor_service.py api/app/api/v1/task_monitor.py api/app/services/seed_service.py api/app/services/legacy_authz_service.py -> 通过。
    • npm --workspace web exec tsc --noEmit --pretty false -> 通过。

  • 风险与影响：

    • Redis 扫描历史任务采用 SCAN + 限流（history_limit * 20）策略；历史量极大时仅展示采样窗口内数据。
    • 当前未新增 DB 持久化索引，历史任务名称在 result backend 未携带时会显示为 -。

Work Log - 移除后台页面顶部标题与描述信息（2026-04-26）

  • 背景：

    • 用户要求去掉所有后台页面顶部的标题和描述信息（例如“线路管理”“按角色权限访问当前模块，完成查询、维护、协作与操作留痕”）。

  • 本次改动（最小闭环）：

    • web/src/app/admin/layout.tsx
      • 删除后台壳层内容区顶部公共信息块（Breadcrumb + 页面标题 + 页面描述）。
      • 同步清理对应的 breadcrumb/title 计算逻辑与无用导入。

  • 验证：

    • npm --workspace web exec tsc --noEmit --pretty false -> 通过。

  • 风险与影响：

    • 仅影响后台页面顶部展示，不涉及页面业务逻辑、接口、权限与路由行为。

Work Log - 下线 AI/编排/MCP/模型/API测试/知识集/图谱/需求/日程功能（2026-04-26）

  • 背景：

    • 用户要求删除“AI 聊天、编排管理、MCP管理、模型管理、API测试、知识集管理、流程图、思维导图、需求管理、日程管理”功能。

  • 本次改动：

    • 前端入口与页面删除：
      • 删除 /admin/chat、/admin/agent、/admin/orchestration、/admin/mcp-server、/admin/models、/admin/api-tester、/admin/files、/admin/knowledge-set、/admin/mermaid-mgr、/admin/mindmap、/admin/requirements、/admin/schedule 对应页面文件。
      • web/src/app/admin/page.tsx 删除对应后台首页卡片，仅保留用户/角色/菜单/系统参数/任务监控/线路/雷电/系统日志/Wine 执行器。
      • web/src/app/admin/menus/page.tsx 删除已下线菜单的前端受保护编码。
      • web/src/types/auth.ts 删除 File/Model/TokenUsage/Chat/MindMap/Mermaid/Requirement/Todo 等已下线前端 DTO 类型。
    • 后端公开 API 下线：
      • api/app/api/router.py 取消挂载 chat/admin-files/calendar/mermaid/mindmap/requirements/todos/project_requirement 等路由。
      • 删除对应 route/schema/service/model 文件：chat、file_storage、mermaid、mind_map；删除 public requirements/todos/calendar/project_requirement API。
      • api/app/api/v1/admin.py 删除模型管理与模型路由管理端点。
    • 默认权限/菜单收口：
      • api/app/services/seed_service.py 删除 chat.use、file.*、model.*、requirement.*、todo.* 默认权限，删除对应默认菜单与 admin 绑定。
      • api/app/services/admin_service.py、legacy_admin_rbac_service.py、legacy_authz_service.py 将已下线菜单编码放入 removed/disabled 过滤集合，屏蔽存量菜单。
      • api/app/services/topic_registry.py 删除已下线模块订阅规则。
    • 任务监控适配：
      • /admin/task-monitor 保留，但口径固定为 Celery Worker/Queue/Task 监控，不再读取需求/待办数据。
      • api/app/services/model_service.py 保留内部模型注册/路由基础设施，但移除已下线 /api/v1/admin/models* 刷新提示，并将 topic 改为内部 model.registry。

  • 验证：

    • python3 -m compileall api/app -> 通过。
    • npm --workspace web exec tsc --noEmit --pretty false -> 通过（删除 .next 后复跑，避免旧路由类型缓存）。
    • npx eslint src/app/admin/page.tsx src/app/admin/menus/page.tsx src/app/admin/task-monitor/page.tsx src/types/auth.ts -> 通过。
    • npm run build:web -> 通过；构建路由列表仅保留 /admin、/admin/users、/admin/roles、/admin/menus、/admin/system-params、/admin/task-monitor、/admin/power-lines、/admin/lightning-currents、/admin/lightning-distribution、/admin/syslog、/admin/wine-runner。
    • git diff --check -> 通过。

  • 风险与影响：

    • 本次不执行数据库 drop；历史表和历史数据保留。
    • 本机 Python 与 .venv 均缺少 FastAPI，PYTHONPATH=api python -c "from app.api.router import api_router" 无法作为导入验证；已用 compileall 覆盖语法级后端检查。
    • 模型注册表/路由表仍保留给内部 LLM 网关与寿命倒计时等内部能力使用，但后台模型管理/API 测试页面和 admin API 已移除。

Work Log - 打包镜像并发布功能下线更新（2026-04-26）

  • 背景：

    • 用户要求“打包镜像并发布更新”。

  • 本次执行：

    • docker compose build
      • fquiz-api、fquiz-web、fquiz-celery-worker、fquiz-celery-beat 构建完成。
      • Web 镜像构建阶段 next build 通过，路由列表仅保留当前有效后台模块。
    • docker compose up -d
      • 重建并启动 api/web/celery-worker/celery-beat。
      • db/redis/minio 继续复用运行中容器。

  • 验证：

    • docker compose ps：
      • fquiz-api Up 且 healthy。
      • fquiz-web Up。
      • fquiz-celery-worker Up。
      • fquiz-celery-beat Up。
      • fquiz-db、fquiz-redis healthy。
    • curl -fsS http://127.0.0.1:8000/health -> {"status":"ok","service":"fquiz-api","version":"0.1.0"}。
    • curl -I -fsS http://127.0.0.1:3000/ -> HTTP/1.1 200 OK。
    • docker compose logs --tail=120 api：Uvicorn 启动完成，/health 返回 200。
    • docker compose logs --tail=100 web：Next.js Ready。
    • docker compose logs --tail=80 celery-worker：worker 连接 Redis 并 ready。
    • docker compose logs --tail=80 celery-beat：beat 启动完成。
    • OpenAPI 运行态检查：/api/v1/chat、/api/v1/admin/files、/api/v1/calendar、/api/v1/mermaids、/api/v1/mindmap、/api/v1/requirements、/api/v1/todos、/api/project/requirement、/api/v1/admin/models、/api/v1/admin/model-routes 均无匹配。

  • 风险与影响：

    • 发布过程重启了 API、Web、Celery Worker、Celery Beat，存在短时服务切换窗口。
    • Celery Worker 日志仍有 root 用户运行的既有安全警告，服务状态正常但后续生产化可考虑设置非 root 用户。

Work Log - 还原文件管理模块（2026-04-26）

  • 背景：

    • 用户要求恢复系统文件管理模块，并延续此前“单挂载点交互”约束。

  • 本次改动：

    • 恢复文件管理核心代码：
      • api/app/api/v1/admin_files.py
      • api/app/models/file_storage.py
      • api/app/schemas/file_storage.py
      • api/app/services/file_service.py
      • api/app/services/storage_driver.py
      • web/src/app/admin/files/page.tsx
    • 恢复后端接线：
      • api/app/api/router.py 重新挂载 admin_files_router。
      • api/app/models/__init__.py、api/app/core/database.py 重新注册 file_storage 模型。
    • 恢复权限/菜单/订阅口径：
      • api/app/services/seed_service.py 恢复 file.read/file.manage、admin.files 菜单、默认存储后端与挂载 seed。
      • api/app/services/legacy_authz_service.py 恢复 admin.files 权限映射与 synthetic legacy menu。
      • api/app/services/topic_registry.py 恢复 admin.files topic 订阅规则。
      • api/app/services/admin_service.py / legacy_admin_rbac_service.py 恢复 admin.files 为受保护菜单，并从 removed/disabled 过滤中放开。
      • web/src/app/admin/menus/page.tsx 恢复 admin.files 为前端受保护菜单。
      • web/src/app/admin/page.tsx 恢复“文件管理”入口卡片。
      • web/src/types/auth.ts 恢复文件管理相关类型定义。
    • 文件管理页面按单挂载点收口：
      • 去掉左侧挂载点列表与挂载切换状态，仅保留当前挂载上下文下的目录浏览与文件操作。

  • 验证：

    • python3 -m compileall api/app/api/router.py api/app/api/v1/admin_files.py api/app/core/database.py api/app/models/__init__.py api/app/models/file_storage.py api/app/schemas/file_storage.py api/app/services/file_service.py api/app/services/storage_driver.py api/app/services/seed_service.py api/app/services/topic_registry.py api/app/services/legacy_authz_service.py api/app/services/legacy_admin_rbac_service.py api/app/services/admin_service.py -> 通过。
    • npm --workspace web exec tsc --noEmit --pretty false -> 通过。
    • npm --workspace web exec eslint src/app/admin/files/page.tsx src/app/admin/page.tsx src/app/admin/menus/page.tsx src/types/auth.ts --max-warnings=0 -> 通过。

  • 风险与影响：

    • 现有仓库仍包含大量其他未提交改动；本次仅在文件管理恢复相关文件完成闭环，未触及其他下线模块恢复。
    • 若现网数据库已经移除历史 menu/role_menu_rela 数据，需要重启后触发 seed 才能自动补齐 admin.files 菜单和默认挂载。

Work Log - ATP 仿真模型管理一期落地（2026-04-26）

  • 背景：

    • 用户确认按“ATPDraw 产物版本管理 + ATP 引擎调用”方案实现。

  • 本次改动：

    • 后端新增 ATP 模块（模型/版本/运行）：
      • 新增数据模型：
        • api/app/models/atp_model.py
          • atp_model（模型台账）
          • atp_model_version（版本与产物元数据）
          • atp_simulation_run（仿真运行记录）
      • 新增 schema：
        • api/app/schemas/atp_model.py
      • 新增服务：
        • api/app/services/atp_model_service.py
          • 模型 CRUD、版本管理、激活版本、运行记录查询
          • ATP 引擎状态检查与同步执行落库（支持 wine/native）
      • 新增 API：
        • api/app/api/v1/atp_models.py
        • 路由前缀：/api/v1/atp/models
        • 关键端点：
          • GET /engine/status
          • GET/POST/PATCH/DELETE /
          • GET/POST/PATCH /{model_id}/versions*
          • POST /{model_id}/versions/{version_id}/activate
          • GET/POST /{model_id}/runs*
    • 后端接线与权限菜单：
      • api/app/api/router.py 挂载 ATP 路由。
      • api/app/core/config.py 新增 ATP 引擎配置：
        • atp_engine_mode
        • atp_engine_executable
        • atp_storage_root
        • atp_engine_workdir
        • atp_engine_default_timeout_seconds
        • atp_engine_max_timeout_seconds
      • api/app/models/__init__.py、api/app/core/database.py 注册 ATP 模型。
      • api/app/services/seed_service.py 新增权限：
        • atp.read / atp.manage / atp.run
        • 新增默认菜单 admin.atp_models（/admin/power-lines/atp-viewer）
      • api/app/services/legacy_authz_service.py、legacy_admin_rbac_service.py、admin_service.py、topic_registry.py 同步 ATP 菜单权限映射、受保护菜单与订阅主题（admin.atp-models）。
    • 前端 ATP 页面升级：
      • web/src/app/admin/power-lines/atp-viewer/page.tsx
        • 从“纯查看器”升级为“模型台账 + 版本管理 + 仿真运行 + 文本转换预览”四块。
        • 支持模型创建/编辑/删除、版本创建/激活、版本加载回编辑区、运行任务执行与日志查看。
        • 保留 ATP 文本解析与 maxGraph 渲染能力。
      • web/src/types/auth.ts 增加 ATP 模块类型定义。
      • web/src/app/admin/page.tsx ATP 卡片升级为“ATP模型管理”，权限切到 atp.*。
      • web/src/app/admin/power-lines/page.tsx 线路页入口文案改为“ATP模型管理”，并按 atp.* 权限显示。
      • web/src/app/admin/menus/page.tsx 新增 admin.atp_models 受保护菜单码。

  • 验证：

    • 后端：
      • python3 -m compileall api/app -> 通过。
    • 前端：
      • npm --workspace web exec tsc --noEmit --pretty false -> 通过。
      • npm --workspace web exec eslint src/app/admin/power-lines/atp-viewer/page.tsx src/app/admin/page.tsx src/app/admin/menus/page.tsx src/types/auth.ts --max-warnings=0 -> 通过。
      • npm run build:web -> 通过；路由包含 /admin/power-lines/atp-viewer。

  • 风险与影响：

    • ATP 运行为同步执行（请求内完成），长耗时任务会占用 API worker；后续可升级为 Celery 异步执行。
    • atp_engine_executable 默认值仅为占位，实际运行需按部署环境配置可执行 ATP 引擎路径。

Work Log - 线路管理地图专题化为线路走向图（2026-04-26）

  • 背景：

    • 用户要求“线路管理页面的图用于展示线路在地图上的分布走向，不要通用地图功能”。

  • 本次改动（A 方案，最小闭环）：

    • web/src/components/power-line-cesium-map.tsx
      • Cesium Viewer 改为专题化初始化：显式 baseLayer: false，关闭 skyBox/skyAtmosphere，弱化通用地图能力。
      • 保留线路业务核心可视化：按杆塔 seq_no 连线、杆塔点位、起点/终点标识。
      • 新增线路走向专题控件：按风险着色、显示塔号、居中重置。
      • 新增走向统计信息：有效坐标数、缺失坐标数、断点段数、线路估算长度（Haversine）。
      • 对缺失坐标导致的序号断档按分段折线绘制，避免误连成单条连续线路。
    • web/src/app/admin/power-lines/page.tsx
      • 视图切换文案由“地图”改为“走向图”。
      • 当前视图状态文案同步改为“走向图”。

  • 验证：

    • npm --workspace web exec tsc --noEmit --pretty false -> 通过。

  • 风险与影响：

    • 本次仅修改前端展示逻辑，不涉及后端接口、权限、路由与数据库结构。
    • 因专题化禁用了默认底图，视觉上会更偏“线路走向专题视图”；若后续需要叠加真实底图，应单独评估并显式配置地图源。

Work Log - 打包镜像并发布线路走向图更新（2026-04-26）

  • 背景：

    • 用户要求执行“打包镜像并发布更新”。

  • 本次执行：

    • docker compose build
    • docker compose up -d

  • 验证：

    • docker compose ps：api/web/celery-worker/celery-beat/db/redis/minio 均为 Up，api/db/redis healthy。
    • curl -fsS http://127.0.0.1:8000/health：返回 {"status":"ok","service":"fquiz-api","version":"0.1.0"}。
    • curl -I -fsS http://127.0.0.1:3000/：返回 HTTP/1.1 200 OK。
    • docker compose logs --tail=120 api：Uvicorn 启动完成，/health 返回 200。
    • docker compose logs --tail=100 web：Next.js Ready。
    • docker compose logs --tail=80 celery-worker：worker 连接 Redis 并 ready（保留 root 运行警告）。
    • docker compose logs --tail=80 celery-beat：beat 启动完成。

  • 风险与影响：

    • 本次为镜像重建与容器重启，存在短时服务切换窗口。
    • celery-worker 仍以 root 运行，功能可用但生产化建议后续切换为非 root 用户。

Work Log - ATP 文本转 JSON 并用 maxGraph 查看（2026-04-26）

  • 背景：

    • 用户要求开发“ATP 转 JSON，然后给 maxGraph 渲染”的查看能力，重点是展示，不涉及仿真。

  • 本次改动（前端最小闭环）：

    • 新增依赖：
      • web/package.json 增加 @maxgraph/core。
    • 新增 ATP 解析能力：
      • web/src/lib/atp/types.ts：定义 ATP 图 JSON 结构（nodes/edges/stats/warnings）。
      • web/src/lib/atp/parse-atp-text.ts：实现 ATP 文本解析器（支持常见 R1 BUS_A BUS_B 10 与 BUS_A BUS_B R 10 两类行格式）。
      • web/src/lib/atp/sample.ts：提供可直接试跑的 ATP 示例文本。
    • 新增 maxGraph 只读渲染组件：
      • web/src/components/atp-maxgraph-viewer.tsx：渲染节点/正交连线，支持适配视图与缩放，不提供编辑能力。
    • 新增业务页面：
      • web/src/app/admin/power-lines/atp-viewer/page.tsx：提供上传 ATP 文本、转换 JSON、JSON 预览、maxGraph 图形查看、导出 JSON。
    • 增加入口：
      • web/src/app/admin/power-lines/page.tsx：在“线路管理”卡片增加 ATP查看器 入口按钮。
      • web/src/app/admin/page.tsx：后台首页新增 ATP查看器 卡片入口（沿用线路模块权限）。

  • 验证：

    • npm --workspace web exec tsc --noEmit --pretty false -> 通过。
    • cd web && npx eslint src/components/atp-maxgraph-viewer.tsx src/lib/atp/parse-atp-text.ts src/lib/atp/types.ts src/lib/atp/sample.ts src/app/admin/power-lines/atp-viewer/page.tsx -> 通过。
    • 构建产物确认：web/.next/server/app/admin/power-lines/atp-viewer/page.js 与相关 rsc/html 已生成。

  • 风险与影响：

    • 解析器当前是“查看优先”的通用文本解析，不覆盖 ATP/ATPDraw 全量语法；复杂模型卡、控制卡可能被忽略并进入 warnings。
    • 本次不涉及后端 API/数据库改动，不影响现有线路与雷电业务接口。

Work Log - 雷电模块补齐地面倾角计算链路（2026-04-26）

  • 背景：

    • 用户要求按“高程+坐标+3x3 邻域（Horn）”方案改造雷电分布统计中的地形倾角能力。

  • 本次改动：

    • 后端 schema 与响应扩展：
      • api/app/schemas/lightning.py
        • 新增 LightningTowerTerrainMetrics
        • 新增 LightningTowerTerrainComputeRequest/Response
        • LightningTowerBufferStatsResponse 增加 terrain_metrics
        • 新增 dem_grid_m 的 3x3 校验
    • 后端服务能力补齐：
      • api/app/services/lightning_service.py
        • 补齐 Horn 梯度、坡向、邻域坡度统计、分位数、线路方向纵横坡、质量评分、角差/方向导数等辅助函数。
        • 新增 compute_tower_terrain_metrics(...)，支持：
          • 基于 3x3 DEM 计算倾角/坡向/纵横坡/起伏量/暴露指数
          • 可选按权限持久化到 power_line_tower.raw_extra_json.terrain_metrics
        • get_tower_buffer_stats(...) 增加地形指标读取与风险修正（地形暴露指数参与 Ng 风险权重）
    • 后端 API 新增：
      • api/app/api/v1/lightning.py
        • 新增 POST /api/v1/lightning-currents/stats/tower-terrain
        • 权限：读权限可计算，persist=true 需 tower.manage 或 lightning.manage（或 admin）
    • 前端类型与展示：
      • web/src/types/auth.ts
        • 新增 LightningTowerTerrainMetrics
        • 新增 LightningTowerTerrainComputeRequest/Response
        • 扩展 LightningTowerBufferStatsResponse.terrain_metrics
      • web/src/app/admin/lightning-currents/page.tsx
        • 杆塔缓冲区结果区新增地形字段展示：倾角、坡向、暴露指数、纵/横坡、质量等级/评分、DEM 分辨率与来源

  • 验证：

    • python3 -m py_compile api/app/services/lightning_service.py api/app/api/v1/lightning.py api/app/schemas/lightning.py -> 通过。
    • npm --workspace web exec tsc --noEmit --pretty false -> 通过。

  • 风险与影响：

    • 当前计算输入 DEM 由调用方提供（3x3 高程矩阵），尚未接入自动 DEM 切片检索；生产精度仍依赖上游 DEM 分辨率与采样质量。
    • 杆塔缓冲区风险等级已引入地形暴露权重，可能导致部分杆塔风险分级相对旧口径发生变化。

Work Log - 飞书需求管理多维表格（下拉版）创建（2026-04-26）

  • 背景：

    • 用户要求“重新创建一个需求管理多维表格，能够用下拉的用下拉”。

  • 本次执行：

    • 通过 lark-cli base 新建 Base：需求管理多维表格。
    • 将默认表重命名为 需求管理。
    • 字段下拉化（type=select）并配置选项：
      • 优先级：P0/P1/P2/P3
      • 状态：待开始/进行中/评审中/已完成/阻塞
      • 需求类型：功能需求/缺陷修复/优化改进/技术债务
      • 需求来源：产品/运营/客户反馈/内部改进
      • 负责人：程凯/待分配
      • 风险等级：低/中/高/紧急
      • 进度：0%/25%/50%/75%/100%
      • 标签（多选）：前端/后端/测试/接口/高优先
    • 文本/日期字段：需求ID、需求名称、开始日期、截止日期、备注（保留 附件 字段）。
    • 写入 3 条示例需求记录，验证下拉与日期写入均正常。

  • 验证：

    • HOME=/tmp lark-cli base +field-list --as user --base-token Xpsgb3jEUaZHlksbnY1cEXMrnpd --table-id tbleJyrScpTGtRdR -> 下拉字段及选项已生效。
    • HOME=/tmp lark-cli base +record-batch-create ... -> 返回 ok: true，成功写入 3 条记录。
    • Base 地址：https://my.feishu.cn/base/Xpsgb3jEUaZHlksbnY1cEXMrnpd

  • 风险与影响：

    • 飞书 field-update 接口存在频控（800004135），本次采用“删除默认字段 + 重建字段”兜底策略完成配置。
    • 保留了系统默认 附件 字段；若需极简字段集，可后续删除该列。

Work Log - 需求多维表优先级改为英文四档（2026-04-26）

  • 背景：

    • 用户要求将“优先级”下拉改为 Urgent/High/Medium/Low。

  • 本次改动：

    • 多维表：https://my.feishu.cn/base/Xpsgb3jEUaZHlksbnY1cEXMrnpd
    • 表：需求管理（tbleJyrScpTGtRdR）
    • 字段 优先级（fld02jCtl7）下拉选项更新为：Urgent、High、Medium、Low。
    • 将现有 3 条示例记录优先级同步为：
      • REQ-001 -> High
      • REQ-002 -> Medium
      • REQ-003 -> Urgent

  • 验证：

    • HOME=/tmp lark-cli base +record-list --as user --base-token Xpsgb3jEUaZHlksbnY1cEXMrnpd --table-id tbleJyrScpTGtRdR --limit 20
    • 返回数据中三条记录优先级分别为 High/Medium/Urgent。

  • 风险与影响：

    • 飞书 record-batch-update 存在短时限频（800004135），本次通过串行+间隔重试完成。

Work Log - 需求多维表新增 issue 关联表（2026-04-26）

  • 背景：

    • 用户要求将主表名改为“需求列表”，并在同一 Base 中新增“issue列表”，且 issue 可关联到需求。

  • 本次改动：

    • Base：https://my.feishu.cn/base/Xpsgb3jEUaZHlksbnY1cEXMrnpd
    • 表改名：
      • 需求管理 -> 需求列表（tbleJyrScpTGtRdR）
    • 新增表：
      • issue列表（tblkI3rjksLcef67）
    • issue列表 字段：
      • Issue标题（text）
      • 状态（select: Open/In Progress/Resolved/Closed）
      • 严重级别（select: P0/P1/P2/P3）
      • 指派给（select: 程凯/待分配）
      • 截止日期（datetime）
      • 备注（text）
      • 关联需求（link -> tbleJyrScpTGtRdR）
    • 新增 2 条 issue 示例，并已关联到需求记录：
      • 登录页按钮样式偏差 -> REQ-001
      • 导出接口返回字段缺失 -> REQ-002

  • 验证：

    • HOME=/tmp lark-cli base +table-list --as user --base-token Xpsgb3jEUaZHlksbnY1cEXMrnpd -> 表列表包含 需求列表 与 issue列表。
    • HOME=/tmp lark-cli base +record-list --as user --base-token Xpsgb3jEUaZHlksbnY1cEXMrnpd --table-id tblkI3rjksLcef67 --limit 20 -> 关联需求 字段返回目标需求 record id。

  • 风险与影响：

    • 当前 link 字段为单向关联（bidirectional=false）；需求表未自动新增反向聚合列。如需在需求表中直接看 issue 明细，可后续补一个双向/反向展示字段。

Work Log - 接入 WebSocket STOMP 机制（2026-04-26）

  • 背景：

    • 用户要求在当前 fquiz 系统落地 Socket STOMP 机制。

  • 本次改动（最小闭环）：

    • 后端新增 STOMP 协议支持：
      • 新增 api/app/services/stomp_protocol.py，提供 STOMP 帧编解码、版本协商与 topic/destination 映射。
      • api/app/api/v1/ws.py 新增 GET /api/v1/ws/stomp WebSocket 端点（ticket 鉴权保持不变），支持：
        • CONNECT/STOMP
        • SUBSCRIBE/UNSUBSCRIBE
        • DISCONNECT
        • SEND /app/ping（收据语义）
      • 保留原有 /api/v1/ws JSON 协议端点，确保兼容。
    • 推送管理器双协议化：
      • api/app/services/ws_manager.py 扩展为 JSON/STOMP 双协议连接管理与事件分发。
      • 新增 STOMP 订阅 id 到 topic 的映射处理，保证 MESSAGE.subscription 可回填对应订阅。
      • 现有 publish_topic/publish_to_user 调用链不变。
    • 前端切换到 STOMP：
      • web/src/components/ws-provider.tsx 改为通过 /api/v1/ws/stomp 连接并发送 STOMP 帧。
      • 保持 useWS / useTopicSubscription 现有 API 不变，业务页面无须改动。
      • 新增 web/src/lib/stomp.ts 作为前端 STOMP 帧编解码工具。

  • 验证：

    • python3 -m py_compile api/app/services/stomp_protocol.py api/app/services/ws_manager.py api/app/api/v1/ws.py -> 通过。
    • npm --workspace web exec tsc --noEmit --pretty false -> 通过。

  • 风险与影响：

    • 目前后端 STOMP 路径已支持核心命令（CONNECT/SUBSCRIBE/UNSUBSCRIBE/DISCONNECT）；事务相关命令仅做兼容性接收，不做事务语义实现。
    • 权限变化后，STOMP 连接上的非法 topic 会被后台移除但不再下发 JSON unsubscribed 提示；前端依赖重连后重新协商订阅。
Reference in New Issue View Git Blame Copy Permalink