前端框架修改

memory/2026-04-19.md

@@ -1323,3 +1323,37 @@
   - 本次按任务约束未执行构建/编译与额外回归测试。
   - 当前仓库存在多需求并行改动；技能脚本 `changedFiles` 为工作区整体视图，不仅限热搜模块。
   - 已同步更新长期记忆 `MEMORY.md`：补充 `热搜` 菜单迁移口径（入口复用 + 后端能力底座）。
+
+## Work Log - Radix 菜单改造（Phase A + Phase B）
+
+- 背景：
+  - 按需求“先落地 Phase A + Phase B”推进后台菜单交互改造，目标是在不改接口契约的前提下统一菜单交互形态。
+  - 执行策略：最小改动，仅替换前端交互承载组件，不调整既有业务逻辑与权限判断。
+
+- 本次改动：
+  - Phase A（后台壳层菜单）
+    - `web/src/app/admin/layout.tsx`
+      - 引入 `DropdownMenu`。
+      - 左侧菜单改为 `md` 及以上显示；移动端新增“菜单”下拉入口，基于 `menuTree` 扁平化列表展示可访问菜单项。
+      - 顶部账号区将“返回首页/退出登录”按钮收口为“账号”下拉菜单。
+  - Phase B（操作列统一）
+    - 新增 `web/src/components/row-action-menu.tsx`
+      - 封装基于 `@radix-ui/themes` 的通用行操作下拉组件 `RowActionMenu`。
+    - `web/src/app/admin/users/page.tsx`
+      - 将“启用/禁用、改密码、删除”并排按钮改为 `RowActionMenu`。
+    - `web/src/app/admin/requirements/page.tsx`
+      - 将“领取、开始处理/标记完成、删除”操作改为 `RowActionMenu`，保留原状态流转与删除确认逻辑。
+    - `web/src/app/admin/menus/page.tsx`
+      - 将“编辑/删除”操作改为 `RowActionMenu`，保留受保护菜单删除拦截逻辑。
+
+- 验证：
+  - `npm run build:web`：通过（Next.js 16，TypeScript 阶段通过，页面静态生成完成）。
+  - `npm run lint:web`：失败，存在仓库既有问题（非本次改动引入）：
+    - `web/src/app/admin/hot-search/page.tsx`：`react-hooks/set-state-in-effect`、`react-hooks/exhaustive-deps`
+    - `web/src/app/admin/jwt-generator/page.tsx`：`react-hooks/preserve-manual-memoization`
+    - `web/src/app/admin/life-countdown/page.tsx`：`react-hooks/set-state-in-effect`
+    - `web/src/app/admin/password/page.tsx`：`react-hooks/exhaustive-deps`
+
+- 风险与影响：
+  - 行操作从直出按钮改为二次点击菜单，短期用户习惯需要适配。
+  - 移动端后台导航改为下拉入口后，首屏更紧凑；但需要依赖菜单数据加载成功才可展开跳转项。

memory/2026-04-22.md

@@ -0,0 +1,320 @@
+## Work Log - 外部 PostgreSQL 连接切换（2026-04-22）
+
+- 背景：按“改成连外部 PG 库”要求，将 API 默认数据库连接从 compose 内 `db` 服务切换为外部 PostgreSQL，并保留本地 `db` 容器为可选能力。
+
+- 本次改动（最小闭环）：
+  - `api/app/core/config.py`
+    - 新增 `DB_HOST/DB_PORT/DB_NAME/DB_SCHEMA/DB_USERNAME/DB_PASSWORD` 配置项。
+    - `DATABASE_URL` 改为可选覆盖项；未设置时自动由 `DB_*` 组装 PostgreSQL DSN。
+  - `api/app/core/database.py`
+    - 统一使用 `settings.resolved_database_url` 建连。
+    - PostgreSQL 场景注入 `options=-csearch_path=<DB_SCHEMA>`，对齐 `currentSchema` 语义。
+  - `docker-compose.yml`
+    - `api` 移除对 `db` 的强依赖（不再 `depends_on db`）。
+    - `api` 注入 `DB_*` 外部库环境变量，`DATABASE_URL` 作为可选覆盖。
+    - `db` 服务改为 `profiles: [local-db]`，默认不启动。
+  - `.env.example`
+    - 数据库示例变量切换为外部库口径（含 `DB_*`）。
+  - `README.md`
+    - 更新 compose 启动说明：默认外部库；本地 DB 需显式 `--profile local-db`。
+
+- 验证：
+  - `python3 -m py_compile api/app/core/config.py api/app/core/database.py` -> `py_compile_ok`
+  - `docker compose config` -> `compose_config_ok`，解析结果含 `DB_HOST/DB_PORT/DB_NAME/DB_SCHEMA/DB_USERNAME` 且 `DATABASE_URL` 允许为空覆盖。
+
+- 风险与影响：
+  - 默认 `docker compose up --build -d` 不再自动启动本地 DB；需要本地库时必须显式启用 `local-db` profile。
+  - 若外部库网络不通或凭据错误，API 启动后会因数据库不可达报错；可通过设置 `DATABASE_URL` 快速回退到其他连接串。
+
+## Work Log - 登录页动效改造（2026-04-22）
+
+- 背景：用户要求登录页增强动效，增加“动态小怪兽 + 眼睛跟随鼠标 + 输入密码时挪开视线”的交互。
+
+- 本次改动（最小闭环，仅改前台首页）：
+  - `web/src/app/page.tsx`
+    - 保留既有登录/注册提交链路（`login/register`）、记住密码逻辑与错误处理，不改接口契约。
+    - 新增怪兽视线状态：`gaze` + `monsterRef` + `pointermove` 监听，实现眼球跟随鼠标。
+    - 新增密码聚焦状态：`passwordFocused`；密码输入框 `onFocus/onBlur` 驱动怪兽“挪开视线”（瞳孔偏移 + 眼睑下落 + 身体倾斜）。
+    - 重做未登录页视觉：浮动渐变背景、怪兽悬浮动画、阴影脉冲动画，并保持桌面/移动端自适应布局。
+
+- 验证：
+  - `cd web && npx eslint src/app/page.tsx` -> 通过（0 error）。
+  - `npm run lint:web` -> 失败（仓库已有历史问题，集中在 `admin/hot-search`、`admin/jwt-generator`、`admin/life-countdown`，与本次登录页改动无关）。
+
+- 风险与影响：
+  - 本次改动将动画样式内联在 `web/src/app/page.tsx` 的 `style jsx` 中，后续若首页风格继续扩展，建议再抽离到独立样式模块以降低单文件复杂度。
+
+## Work Log - 前端组件库从 Radix UI 迁移到 Ant Design（2026-04-22）
+
+- 背景：按“弃用 Radix UI，改成 Ant Design”要求，前端在不改业务逻辑前提下完成组件层迁移。
+
+- 本次改动（最小闭环）：
+  - 依赖迁移：
+    - `web/package.json` 移除 `@radix-ui/themes`、`@radix-ui/react-dialog`、`@radix-ui/react-select`。
+    - 新增 `antd` 依赖；根 `package-lock.json` 同步更新。
+  - 兼容层落地：
+    - 新增 `web/src/components/ui-antd.tsx`，提供 `Button/Card/Flex/Text/Heading/TextField/TextArea/Select/Dialog/DropdownMenu/Callout/Table/Checkbox/Theme` 兼容导出，底层改由 Ant Design 承接。
+    - 新增 `web/src/types/antd.d.ts`（当前安装源下 `antd` 包不含 `.d.ts` 时的类型声明兜底）。
+  - 批量替换：
+    - `web/src/app/**` 与 `web/src/components/row-action-menu.tsx` 的 `@radix-ui/themes` 导入统一替换为 `@/components/ui-antd`。
+    - `web/src/app/layout.tsx` 移除 `@radix-ui/themes/styles.css`，改为 `antd/dist/reset.css`，`Theme` 改由兼容层提供。
+
+- 验证：
+  - `npm run build:web` -> 通过（Next.js build + TypeScript + 静态页面生成全部成功）。
+
+- 风险与影响：
+  - 兼容层采用“Radix API 形态 + AntD 实现”策略，短期可稳定过渡；后续若需发挥 AntD 原生能力（如 Table 高级功能、Form 生态），建议分阶段把页面改为直接使用 AntD 原生 API，逐步下线兼容层。
+
+## Work Log - 前端依赖残留清理（2026-04-22）
+
+- 背景：用户要求“清理”组件库迁移后的残留依赖。
+
+- 本次处理：
+  - 清理校验范围统一为源码导入 + `web/package.json` + 根/子锁文件。
+  - `web/package-lock.json` 已重新对齐 `web/package.json`，移除 `@radix-ui/*` 残留并保留 `antd` 依赖树。
+  - 根 `package-lock.json` 未检出 `@radix-ui/*` 残留。
+  - 已删除本地 `node_modules` 与 `web/node_modules`，避免此前安装异常产生的脏依赖目录影响后续排查。
+
+- 验证：
+  - `rg -n "@radix-ui/..." web/src web/package.json web/package-lock.json package-lock.json` 无命中。
+
+- 说明：
+  - 当前环境下多次 `npm install` 出现 `TAR_ENTRY_ERROR ENOENT`（Next 解包阶段），属于本地依赖安装层异常，不影响仓库内代码与锁文件的残留清理结论。
+
+## Work Log - 需求管理兼容老工程表与逻辑（2026-04-22）
+
+- 背景：按“用老工程 `quiz` 的需求表结构与流程逻辑改造 `fquiz`”要求，目标是在保留现有 `/api/v1/requirements` 可用的前提下，切换底层到老表并补齐老接口兼容。
+
+- 本次改动（最小闭环）：
+  - ORM 表结构改造（对齐老工程）：
+    - `api/app/models/requirement.py`
+      - `Requirement` 主表由 `requirements` 切换为 `project_requirement`。
+      - 字段改为老口径：`title/project_name/git_url/branch/descr/result_msg/progress_percent/status/priority/create_date/create_user/update_date/update_user`。
+      - 生命周期事件表切到 `project_requirement_log`（`RequirementEvent`）。
+      - 保留 `requirement_comments` 作为现有 API 注释能力的兼容扩展，外键改指向 `project_requirement.id`。
+  - 服务层逻辑改造（参考老工程）：
+    - `api/app/services/requirement_service.py`
+      - 状态集改为老口径：`PENDING_ANALYSIS/PENDING_REVIEW/PENDING_REVISION/OPEN/IN_PROGRESS/COMPLETED/CLOSED`。
+      - 兼容映射：`CANCELLED -> CLOSED`。
+      - 进度规则对齐老逻辑：`COMPLETED=100`；`PENDING_ANALYSIS/PENDING_REVIEW/PENDING_REVISION/OPEN=0`；其余区间归一化到 `0-100`。
+      - `/api/v1/requirements` 仍可用：序列化层将老表字段映射回现有前端字段（`description<-descr`、`source<-git_url`、`module_name<-branch` 等）。
+      - 事件列表改读 `project_requirement_log`，并将 `before_descr/after_descr/remark` 投影为 `payload_json`。
+      - 新增 legacy 业务函数：`search/get/pending/update_status/analyze/review/lifecycle/history-options`。
+  - 旧接口兼容层新增：
+    - 新增 `api/app/api/project_requirement.py`，提供：
+      - `POST /api/project/requirement/search`
+      - `GET /api/project/requirement/get/{id}`
+      - `GET /api/project/requirement/pending`
+      - `POST /api/project/requirement/{id}/status`
+      - `POST /api/project/requirement/{id}/analyze`
+      - `POST /api/project/requirement/{id}/review`
+      - `GET /api/project/requirement/{id}/lifecycle`
+      - `GET /api/project/requirement/history-options`
+    - `api/app/api/router.py` 改为组合路由：保留 `/api/v1/*`，并额外挂载 `/api/project/requirement/*`。
+  - 前端类型与状态枚举兼容：
+    - `web/src/types/auth.ts`：`RequirementStatus` 新增 `PENDING_REVIEW/CLOSED`；`RequirementEvent.id` 改为 `string`；`RequirementSummary` 补充 `result_msg/progress_percent/git_url/branch`。
+    - `web/src/app/admin/requirements/page.tsx`
+    - `web/src/app/admin/requirements/new/page.tsx`
+    - `web/src/app/admin/requirements/[id]/page.tsx`
+      - 状态文案/选项新增 `PENDING_REVIEW`、`CLOSED`；详情页状态流转映射同步老逻辑。
+
+- 验证：
+  - `python3 -m compileall api/app/services/requirement_service.py api/app/api/project_requirement.py api/app/models/requirement.py api/app/schemas/requirement.py api/app/api/router.py` -> 通过。
+  - `npm --workspace web exec -- eslint src/app/admin/requirements/page.tsx src/app/admin/requirements/new/page.tsx src/app/admin/requirements/[id]/page.tsx src/types/auth.ts` -> 通过。
+  - `npm run -s lint:web` -> 失败（仓库既有问题：`hot-search/jwt-generator/life-countdown` 等页面，非本次改造引入）。
+  - 运行态接口自检未执行：当前环境缺少 `fastapi` 运行依赖（`ModuleNotFoundError: fastapi`），因此未做本地启动路由验证。
+
+- 风险与影响：
+  - 该改造面向“老表兼容”，若数据库中同时存在新旧两套需求表，后续数据归一需额外迁移策略。
+  - 由于老表无显式 `assignee/reviewer/due_at` 字段，`/api/v1/requirements` 中对应字段目前为兼容占位（多数返回 `null`）。
+  - `project_requirement_log` 在历史库中若字段口径有差异（例如时间列名或类型差异），需按实际库结构微调 ORM 映射。
+- 增补兼容接口：`POST /api/project/requirement/{id}/design`（对应老工程 DESIGN 流程，保持 `PENDING_ANALYSIS` 并写入生命周期日志）。
+
+## Work Log - 待办管理按 quiz 表与页面重构（2026-04-22）
+
+- 背景：按“改用 quiz 的表，照抄 quiz 逻辑和页面”要求，对 `fquiz` 待办模块做整链路重构（后端表结构/状态机/API + 前端页面交互）。
+
+- 本次改动（最小闭环）：
+  - 后端表结构与字段口径对齐 `quiz`：
+    - `api/app/models/todo.py`
+      - 表名由 `todos` 改为 `todo`。
+      - 主键改为 32 位 hex 字符串（`uuid4().hex`）。
+      - 字段切换为 `title/descr/status/priority/start_time/due_date/expire_time/calendar_event_id/create_date/create_user/update_date/update_user`。
+      - 索引对齐：`idx_todo_status/idx_todo_priority/idx_todo_due_date/idx_todo_expire_time`。
+  - 后端 schema 与服务逻辑重构：
+    - `api/app/schemas/todo.py`
+      - 状态改为 `SCHEDULED/IN_PROGRESS/COMPLETED/CANCELLED/EXPIRED`。
+      - 优先级改为 `LOW/MEDIUM/HIGH`。
+      - 请求/响应字段改为 quiz 风格（`descr/start_time/due_date/expire_time`）。
+      - 新增 `TodoMindMapInitResponse`。
+    - `api/app/services/todo_service.py`
+      - 列表查询改为 quiz 逻辑：按当前登录用户名过滤 `create_user`，支持 `title/status/priority`，并支持分页参数 `page_num/page_size`。
+      - 新增 owner 校验（非创建人不可读写删改）。
+      - 新增 `complete_todo` 与 `init_todo_mindmap`。
+      - 保留/兼容 `transition_todo`，状态流转规则切换到新状态机。
+  - 后端路由补齐：
+    - `api/app/api/v1/todos.py`
+      - 列表接口支持 `title/status/priority/page_num/page_size`（兼容 `keyword`）。
+      - 新增 `POST /api/v1/todos/{todo_id}/complete`。
+      - 新增 `POST /api/v1/todos/{todo_id}/init-mindmap`。
+  - 前端类型与页面重构：
+    - `web/src/types/auth.ts`
+      - `TodoStatus/TodoPriority/TodoSummary` 改为 quiz 字段与状态口径。
+    - `web/src/app/admin/todos/page.tsx`
+      - 页面按 quiz 交互重写：默认筛选 `SCHEDULED`、查询/重置、分页、新增、编辑、详情、完成、删除、分析（init-mindmap）。
+      - 状态与优先级中文标签、完成态/过期态禁用“完成”按钮，行为与 quiz 页面一致。
+
+- 验证：
+  - `python3 -m py_compile api/app/models/todo.py api/app/schemas/todo.py api/app/services/todo_service.py api/app/api/v1/todos.py` -> 通过。
+  - `cd web && npx eslint src/app/admin/todos/page.tsx src/types/auth.ts` -> 通过。
+
+- 风险与影响：
+  - 表名从 `todos` 切到 `todo`，若现网已落 `todos` 数据，需做数据迁移或并行兼容策略；当前实现按“以 quiz 表为准”直接切换。
+  - `init-mindmap` 当前仅返回初始化结构（fquiz 目前无独立 mindmap 存储与编辑链路），页面侧做成功反馈，不做跳转编辑。
+
+## Work Log - 思维导图按 quiz 表与逻辑落地（2026-04-22）
+
+- 背景：按“用老工程表，参考老工程逻辑改造当前工程思维导图功能”要求，将 `fquiz` 的 `/admin/mindmap` 从题库统计复用页切回独立思维导图模块。
+
+- 本次改动（最小闭环）：
+  - 后端模型与路由新增：
+    - `api/app/models/mind_map.py`
+      - 新增老工程口径主表 `mind_map`（字段：`id/map_name/descr/map_data/create_date/create_user/update_date/update_user`）。
+      - 索引对齐：`idx_mind_map_name`、`idx_mind_map_create_date`。
+    - `api/app/schemas/mind_map.py`
+      - 新增 `MindMapQueryRequest/MindMapCreateRequest/MindMapBasicInfoUpdateRequest/MindMapDataUpdateRequest`。
+      - 新增 `MindMapSummary/MindMapPageResponse`。
+    - `api/app/services/mind_map_service.py`
+      - 新增 search/get/create/update-basic-info/update-data/delete 业务逻辑。
+      - 新增 AI 流式生成：`stream_generate_mind_map`，输出 `[PARSE_RESULT]` + `[MINDMAP]{json}` 标记。
+      - 新增初始化模板构造：`build_initial_mind_map_data(title)`。
+    - `api/app/api/v1/mind_map.py`
+      - 新增接口：
+        - `POST /api/v1/mindmap/search`
+        - `GET /api/v1/mindmap/get/{id}`
+        - `POST /api/v1/mindmap/create`
+        - `PUT /api/v1/mindmap/update-basic-info`
+        - `PUT /api/v1/mindmap/update-data`
+        - `DELETE /api/v1/mindmap/delete/{id}`
+        - `GET /api/v1/mindmap/generate/stream`
+      - 读接口权限：`question_bank.read | question_bank.manage`；
+      - 写接口权限：`question_bank.manage`。
+    - `api/app/api/router.py`、`api/app/core/database.py`、`api/app/models/__init__.py`
+      - 注册 `mind_map` 模块与路由，确保启动建表与路由生效。
+
+  - Todo 联动改造：
+    - `api/app/services/todo_service.py`
+      - `init_todo_mindmap` 从“仅返回初始化 JSON”改为“真实落库到 `mind_map`”：
+        - 若同 `todo.id` 的导图存在则直接返回；
+        - 不存在则按老逻辑以 `todo.id` 创建导图并返回。
+    - `web/src/app/admin/todos/page.tsx`
+      - `分析` 后改为跳转 `/admin/mindmap/edit/{id}`，与老工程链路一致。
+
+  - 前端页面切换为独立思维导图：
+    - `web/src/app/admin/question-bank/page.tsx`
+      - 固化为原题库页面实现（不再从 `../mindmap/page` 复用导出）。
+    - `web/src/app/admin/mindmap/page.tsx`
+      - 改为思维导图列表页：查询、分页、新建、编辑基础信息、删除、进入绘图页。
+    - `web/src/app/admin/mindmap/_components/mindmap-editor.tsx`
+      - 新增编辑器：基础信息编辑、JSON 编辑、树预览、保存、导出 JSON/Markdown、AI 流式生成。
+    - `web/src/app/admin/mindmap/edit/page.tsx`
+    - `web/src/app/admin/mindmap/edit/[id]/page.tsx`
+      - 新增新建/编辑路由承载页。
+    - `web/src/types/auth.ts`
+      - 新增 `MindMapSummary/MindMapListResponse` 类型。
+
+  - 菜单与入口文案对齐：
+    - `api/app/services/seed_service.py`
+      - `admin.mindmap` 菜单名从“题库统计”改为“思维导图”。
+    - `web/src/app/admin/page.tsx`
+      - 后台首页入口文案改为“思维导图”。
+
+- 验证：
+  - `python3 -m py_compile api/app/models/mind_map.py api/app/schemas/mind_map.py api/app/services/mind_map_service.py api/app/api/v1/mind_map.py api/app/services/todo_service.py api/app/api/router.py api/app/core/database.py api/app/models/__init__.py` -> 通过。
+  - `python3 -m compileall api/app` -> 通过。
+  - 前端 lint/build 未完成：
+    - `npx eslint ...` 受当前环境 npm 依赖解析影响失败（`Cannot find module 'next/dist/compiled/babel-packages'`）；
+    - `npm run build:web` 受当前环境缺失 `next` 可执行文件影响失败（`next: not found`）。
+
+- 风险与影响：
+  - 当前编辑页采用 JSON 编辑 + 树预览实现，未引入老工程 `mind-elixir` 可视化拖拽编辑能力；若后续需要“节点拖拽/工具栏”体验，需单独引入前端图库并做适配。
+  - 思维导图分组/标签/向量同步链路（老工程中的 group/tag/vector）本次未迁入，当前闭环聚焦 `mind_map` 主表与 Todo 联动。
+
+## Work Log - Mermaid 按 quiz 表与页面重构（2026-04-22）
+
+- 背景：按“改用 quiz 的表，照抄 guiz/quiz 逻辑和页面，重新改造 mermaid 功能”要求，将 `fquiz` 的 Mermaid 模块从“菜单复用 mdresolve”升级为独立 Mermaid 管理与编辑链路。
+
+- 本次改动（最小闭环）：
+  - 后端 Mermaid 接口落地（对齐 quiz 路径语义）
+    - 新增 `api/app/api/v1/mermaids.py`：
+      - `POST /api/v1/mermaids/diagrams/search`
+      - `GET /api/v1/mermaids/diagrams/groups`
+      - `GET /api/v1/mermaids/diagrams/get/{id}`
+      - `POST /api/v1/mermaids/diagrams/create`
+      - `PUT /api/v1/mermaids/diagrams/update`
+      - `DELETE /api/v1/mermaids/diagrams/delete/{id}`
+      - `PATCH /api/v1/mermaids/diagrams/{id}/data`
+      - `GET /api/v1/mermaids/diagrams/generate/stream`
+      - `POST /api/v1/mermaids/diagrams/chat/stream`
+    - `api/app/api/router.py` 挂载 `mermaids_router` 到 `/api/v1`，并新增 legacy 兼容前缀 `/api/mermaids/diagrams/*`（对齐老页面直连习惯）。
+  - Mermaid schema 兼容 quiz 请求字段
+    - `api/app/schemas/mermaid.py`：为请求 DTO 增加 `validation_alias`，兼容 `camelCase` 与 `snake_case`（如 `diagramName/diagram_name`、`pageNum/page_num`、`diagramData/diagram_data`、`modelName/model_name`）。
+  - Mermaid service 修正与增强
+    - `api/app/services/mermaid_service.py`
+      - 新增 `get_mermaid_diagram_summary`，统一单条详情序列化。
+      - `create/update/patch-data` 统一复用 summary 返回。
+      - 修复流式聊天系统提示组装缺陷（历史版本曾出现重复关键字问题）。
+  - 前端页面重构（按 quiz 交互拆分管理页 + 编辑页）
+    - `web/src/app/admin/mermaid-mgr/page.tsx`
+      - 从 `mdresolve` 复用页改为独立 Mermaid 管理页。
+      - 支持关键字/分组筛选、分页、新建、编辑、删除、详情预览、进入绘图。
+    - `web/src/app/admin/mermaid-mgr/[id]/page.tsx`
+      - 新增 Mermaid 编辑路由。
+    - `web/src/app/admin/mermaid-mgr/_components/mermaid-editor.tsx`
+      - 左侧 AI 对话流式改图，右侧预览，抽屉源码编辑，保存回写 `PATCH /{id}/data`。
+    - `web/src/components/mermaid-viewer.tsx`
+      - 新增 Mermaid 预览组件（通过 `mermaid.ink` SVG 渲染，避免本地依赖安装阻塞）。
+  - 前端类型补齐
+    - `web/src/types/auth.ts` 新增 Mermaid 相关类型：分组、图表摘要、分页响应、聊天消息。
+
+- 验证：
+  - `python3 -m py_compile api/app/schemas/mermaid.py api/app/models/mermaid_diagram.py api/app/models/object_group.py api/app/services/mermaid_service.py api/app/api/v1/mermaids.py api/app/api/router.py` -> 通过。
+  - 前端 ESLint 未执行成功：当前环境 `eslint` 二进制缺失（`sh: 1: eslint: not found`），且 `npm --workspace web install` 过程中出现大量 tarball 校验重试，未形成可用依赖环境。
+
+- 风险与影响：
+  - Mermaid 预览当前走 `mermaid.ink` 在线渲染；若运行环境外网受限，预览图可能加载失败，但源码编辑与保存链路不受影响。
+  - 当前工作区存在大量历史未提交改动；本次仅在 Mermaid 相关文件范围内追加改造，未处理既有脏改动。
+
+## Work Log - 日程管理按 quiz 表与页面重构（2026-04-22）
+
+- 背景：按“改用 quiz 的表结构，照抄 quiz 的逻辑和页面”要求，把 `fquiz` 的日程管理从“菜单复用 todo 页面”升级为独立日程模块。
+
+- 本次改动（最小闭环）：
+  - 后端表结构与接口落地：
+    - 新增 `api/app/models/calendar_event.py`，表名 `calendar_event`，字段对齐 quiz：`title/descr/status/priority/start_time/end_time/expire_time/all_day/completed_at/todo_id/create_date/create_user/update_date/update_user`。
+    - 新增 `api/app/schemas/calendar_event.py`（查询/创建/更新/分页响应 DTO）。
+    - 新增 `api/app/services/calendar_event_service.py`（查询、增改删、完成、AI 流式生成、过期自动置 `EXPIRED`、与 todo 双向同步）。
+    - 新增 `api/app/api/v1/calendar.py`，提供：
+      - `POST /api/v1/calendar/search`
+      - `GET /api/v1/calendar/get/{id}`
+      - `POST /api/v1/calendar/create`
+      - `PUT /api/v1/calendar/update`
+      - `DELETE /api/v1/calendar/delete/{id}`
+      - `POST /api/v1/calendar/{id}/complete`
+      - `GET /api/v1/calendar/generate/stream`
+    - `api/app/api/router.py` 挂载 `calendar_router`；`api/app/models/__init__.py` 与 `api/app/core/database.py` 增加 `calendar_event` 模型注册。
+  - Todo 双向同步补齐：
+    - `api/app/schemas/todo.py` 为 `TodoUpdateRequest/TodoTransitionRequest` 增加 `is_sync` 标记。
+    - `api/app/services/todo_service.py` 的 `create/update/transition/complete/delete` 增加 `syncing` 参数并接入 `calendar_event_service` 同步函数，防止 schedule<->todo 循环调用。
+  - 前端页面改造：
+    - `web/src/app/admin/schedule/page.tsx` 从复用导出改为独立页面，实现 quiz 风格年/月/周视图、创建/编辑/删除/完成、AI 流式生成并回填表单。
+
+- 验证：
+  - `python3 -m compileall api/app/models/calendar_event.py api/app/schemas/calendar_event.py api/app/services/calendar_event_service.py api/app/api/v1/calendar.py api/app/services/todo_service.py api/app/schemas/todo.py api/app/api/v1/todos.py` -> 通过。
+  - 前端 lint/build 未完全通过环境验证：
+    - `cd web && npx eslint src/app/admin/schedule/page.tsx src/types/auth.ts` -> 失败（`eslint: not found`）。
+    - `npm --workspace web install` 持续出现 `next` 解包 `TAR_ENTRY_ERROR ENOENT`，依赖环境未恢复，暂无法给出有效前端构建结论。
+
+- 风险与影响：
+  - 依赖环境异常会阻断前端 lint/build 验证，但不影响本次后端与页面代码改造落地。
+  - 当前工作区存在大量历史脏改动；本次仅在日程与 todo 相关范围内追加改造，未触及其余模块。

memory/2026-04-23.md

@@ -0,0 +1,58 @@
+## Work Log - 日记管理按 quiz 表与逻辑重构（2026-04-23）
+
+- 背景：按“用老工程表，参考老工程逻辑改造当前工程日记管理功能”要求，将 `fquiz` 的 `/admin/diary` 从系统日志复用页切换为独立 Diary 模块。
+
+- 本次改动（最小闭环）：
+  - 后端模型与接口落地（对齐 quiz 口径）：
+    - `api/app/models/diary.py`
+      - 新增主表 `diary`，字段：
+        - `id/title/content/diary_date/mood/weather/archived/create_date/create_user/update_date/update_user`
+      - 索引：`idx_diary_create_user/idx_diary_diary_date/idx_diary_mood/idx_diary_archived`。
+    - `api/app/schemas/diary.py`
+      - 新增 `DiaryMood` 枚举：`HAPPY/CALM/SAD/ANGRY/TIRED/EXCITED`。
+      - 新增 `DiaryQueryRequest/DiaryCreateRequest/DiaryUpdateRequest/DiarySummary/DiaryPageResponse`。
+    - `api/app/services/diary_service.py`
+      - 新增 create/search/get/update/delete/archive 逻辑。
+      - 查询逻辑对齐 quiz：按 `create_user` 隔离数据，支持 `title/mood/diary_date_start/diary_date_end/archived` 过滤，排序 `diary_date DESC, create_date DESC`。
+      - 归档逻辑对齐 quiz：`archive` 仅修改 `archived` 状态，保留原记录。
+    - `api/app/api/v1/diary.py`
+      - 新增接口：
+        - `POST /api/v1/diary/search`
+        - `GET /api/v1/diary/get/{id}`
+        - `POST /api/v1/diary/create`
+        - `PUT /api/v1/diary/update`
+        - `DELETE /api/v1/diary/delete/{id}`
+        - `POST /api/v1/diary/{id}/archive?archived=...`
+      - 权限口径：
+        - 读：`menu.read | menu.manage`
+        - 写：`menu.manage`
+    - 路由与建表注册：
+      - `api/app/api/router.py` 挂载 `diary` 路由。
+      - `api/app/models/__init__.py`、`api/app/core/database.py` 注册 `diary` 模型，确保 `create_all` 生效。
+
+  - 前端页面改造（替换 syslog 复用）：
+    - `web/src/app/admin/diary/page.tsx`
+      - 改为独立 Diary 页面：
+        - 列表分页
+        - 条件查询（标题、心情、日期范围、归档状态）
+        - 新增 / 编辑 / 删除
+        - 归档 / 取消归档
+        - 详情弹窗
+      - API 调整到新后端接口 `/api/v1/diary/*`。
+    - `web/src/types/auth.ts`
+      - 新增 `DiaryMood/DiarySummary/DiaryListResponse` 类型。
+    - `web/src/app/admin/page.tsx`
+      - 首页卡片文案从“上帝视角”调整为“日记管理”。
+    - `api/app/services/seed_service.py`
+      - 菜单 `admin.diary` 名称更新为“日记管理”（路径保持 `/admin/diary`）。
+
+- 验证：
+  - `python3 -m py_compile api/app/models/diary.py api/app/schemas/diary.py api/app/services/diary_service.py api/app/api/v1/diary.py api/app/api/router.py api/app/models/__init__.py api/app/core/database.py api/app/services/seed_service.py` -> 通过。
+  - `python3 -m compileall api/app` -> 通过。
+  - 前端 ESLint 未完成（环境依赖缺失）：
+    - `npm run lint` 提示 `eslint: not found`；
+    - 直接执行 eslint 后提示缺少 `typescript` 依赖（`Cannot find module 'typescript'`）。
+
+- 风险与影响：
+  - `admin.diary` 保留 `menu.read/menu.manage` 权限体系（未引入独立 `diary.read/diary.manage`），属于兼容方案；后续若需要更细权限边界，可单独拆分权限码。
+  - 本次仅对齐了老工程 diary 主链路，不包含分组/tag 维度扩展（老工程该模块本身也未强依赖）。