fquiz/memory/2026-06-16.md

Work Log - 修复系统消息查看 500（2026-06-16）

• 背景：

  • /api/v1/system-messages/me 返回系统消息列表时，对 SQLAlchemy ORM 对象执行 SystemMessagePublic.model_validate()，Pydantic v2 未启用属性读取，导致 500。

• 本次处理：

  • 为 SystemMessagePublic 增加 ConfigDict(from_attributes=True)，允许响应 schema 从 ORM/属性对象读取字段。
  • 新增系统消息 schema 回归测试，覆盖属性对象序列化路径。

• 验证：

  • 基线：未启用 from_attributes 时，属性对象 model_validate 复现 Pydantic model_type 校验失败。
  • 修改后：属性对象 model_validate 可正常输出。
  • pytest api/tests/test_system_message_schema.py 通过。

• 风险与关注点：

  • 改动仅影响系统消息公开响应 schema 的序列化方式，不改变接口字段、数据库结构或查询逻辑。

Work Log - 系统消息支持删除（FL-145）

• 背景：

  • 系统消息管理页已有创建、查看、标记已读能力，但缺少删除入口。

• 本次处理：

  • 后端新增 DELETE /api/v1/system-messages/{message_id}，复用 admin.system_message 权限，删除系统消息记录。
  • 前端系统消息列表新增删除操作，使用二次确认，并在删除后刷新列表与未读统计。
  • 新增系统消息删除服务测试，覆盖存在记录删除与缺失记录返回 False。

• 验证：

  • UV_CACHE_DIR=/tmp/fquiz-uv-cache uv run --with pytest --with sqlalchemy --with pydantic --with pydantic-settings --with email-validator python -m pytest api/tests/test_system_message_schema.py api/tests/test_system_message_service.py 通过。
  • npm --workspace web exec eslint src/app/admin/system-messages/page.tsx 通过。
  • npm --workspace web run build 通过。

• 风险与关注点：

  • 当前删除为管理端物理删除系统消息记录；广播消息删除后对所有用户不可见。

Work Log - 系统消息页面布局与 Markdown 支持（2026-06-16）

• 背景：

  • FL-144 要求参考用户管理页面改造系统消息页面：发送消息改为按钮点击后弹出表单，并支持 Markdown 编辑与展示。

• 本次处理：

  • 将系统消息页面收敛为“消息列表”卡片布局，顶部动作区提供刷新、全部已读、发送消息入口，筛选项改为与用户管理页面一致的行内表单风格。
  • 将发送消息表单迁移到 Ant Design Modal，内容输入支持 Markdown，并提供实时预览。
  • 列表内容与详情弹窗使用安全的本地 Markdown 渲染，支持标题、列表、引用、代码块、强调、行内代码和安全链接。

• 验证：

  • 基线：npx eslint src/app/admin/system-messages/page.tsx src/app/admin/users/page.tsx 通过，存在 users/page.tsx 既有 3 条 warning。
  • 修改后：npx eslint src/app/admin/system-messages/page.tsx src/app/admin/users/page.tsx 通过，仍仅存在同样 3 条既有 warning。
  • 修改后：npx tsc --noEmit 通过。

• 风险与关注点：

  • 改动仅涉及前端系统消息页面，不改变 API 字段、数据库结构或消息存储格式；Markdown 作为普通文本存储并在前端渲染。