docs: 更新路线图 — A+B+C 阶段完成，9 条链路 8 通过

plans/next-steps-roadmap.md

@@ -0,0 +1,306 @@
+# 暖记下一步工作路线图
+
+> **创建日期**: 2026-06-07
+> **状态**: 讨论稿，待确认优先级后逐一推进
+> **当前代码状态**: 工作区 26 个文件 +1051/-319 行未提交
+
+---
+
+## 当前快照
+
+| 指标 | 数值 |
+|------|------|
+| 后端测试 | 518 通过 |
+| 前端测试 | 116 新增 (Phase 4) |
+| 审计发现 | 345 项 (42 C / 90 H / 123 M / 90 L) |
+| 未提交改动 | Discover 全栈 + 编辑器增强 + 多页动态化 |
+| 未提交新文件 | discover_bloc / discover_models / discover_handler / discover_service |
+
+---
+
+## 方向 A — 当前改动收尾提交
+
+> **目标**: 把工作区 1000+ 行改动拆分成有意义的提交，保持 git 历史清晰
+> **预估**: 2-3h（拆分 + 验证 + 提交）
+> **优先级**: ⭐⭐⭐⭐⭐ — 做任何事之前先把当前工作落地
+
+### A.1 提交拆分建议
+
+| # | 提交内容 | 涉及文件 | scope |
+|---|---------|---------|-------|
+| 1 | Discover 后端 (DTO + Service + Handler + 路由注册) | crates/erp-diary 4 文件 + main.rs | `feat(diary)` |
+| 2 | Discover 前端 (BLoC + Models + Page 动态化) | app/features/discover/ 4 文件 | `feat(app)` |
+| 3 | 编辑器: 查看模式 + 图层排序 | editor_page + editor_bloc + draggable_element | `feat(app)` |
+| 4 | 编辑器: 标签面板动态化 + 贴纸选择器重构 | tag_panel + sticker_picker_sheet | `feat(app)` |
+| 5 | 搜索页动态化 (热搜词 + 模板搜索) | search_page | `feat(app)` |
+| 6 | 个人资料页动态化 (成就徽章 + 头像首字母) | profile_page | `feat(app)` |
+| 7 | 教师页班级码对话框 | teacher_page | `feat(app)` |
+| 8 | 贴纸库动态分类 | sticker_library_page | `feat(app)` |
+| 9 | Wiki 文档更新 | wiki/ 4 文件 | `docs` |
+
+### A.2 验证清单
+
+- [ ] `cargo check` 后端编译通过
+- [ ] `cargo test` 后端测试通过
+- [ ] `flutter analyze` 前端分析通过
+- [ ] 每个提交可独立编译
+
+### A.3 讨论点
+
+- Discover 功能是否属于 Phase 1 范围？审计报告 7b-H06 指出它属于 Phase 2
+- 编辑器查看模式是新增功能还是修复？影响提交类型选择 (feat vs fix)
+
+---
+
+## 方向 B — 审计修复路线图推进
+
+> **目标**: 按审计报告 345 项发现的修复路线图推进
+> **预估**: Phase 0 已完成 ~80%，Phase 1-3 待推进
+> **优先级**: ⭐⭐⭐⭐ — 安全和稳定性是上线的前提
+
+### B.1 Phase 0 紧急修复 — 已完成项 ✅
+
+| # | 修复项 | 状态 |
+|---|--------|------|
+| 1 | RLS 变量名 bug 修复 | ✅ 已修复 |
+| 2 | 内容安全词库填充 + 分享前检查 | ✅ 已修复 |
+| 3 | 日记列表 IDOR 修复 | 需确认 |
+| 4 | 审计日志 + 文件上传权限守卫 | 需确认 |
+| 5 | class_service unwrap() 安全处理 | 需确认 |
+| 6 | 事务添加 (create_class/join_class) | 需确认 |
+| 7 | 笔画缓存 use-after-dispose 修复 | ✅ 已修复 |
+
+### B.2 Phase 1 安全加固 (~31h)
+
+| # | 任务 | 预估 | 讨论点 |
+|---|------|------|--------|
+| 1 | 家长同意验证流程 | 8h | PIPL 合规法律要求，但 Phase 1 MVP 是否先跳过？ |
+| 2 | 家长绑定验证流程 | 4h | 同上 |
+| 3 | Token 黑名单改用 SHA-256 | 1h | 简单，可顺手做 |
+| 4 | **全部 DTO 添加 Validate + handler 调用** | 8h | 影响面最大，系统性修复 |
+| 5 | Flutter 强制 HTTPS + 证书固定 | 4h | 开发阶段 HTTP 方便调试，生产再强制？ |
+| 6 | 班级码改用字母数字混合 | 2h | 安全强度提升 3386 倍 |
+| 7 | Flutter Token 自动刷新 | 4h | 体验提升明显 |
+
+### B.3 Phase 2 性能优化 (~24h)
+
+| # | 任务 | 预估 |
+|---|------|------|
+| 1 | 后端 4 个 N+1 查询修复 | 8h |
+| 2 | Isar 索引 + 分页 + N+1 修复 | 6h |
+| 3 | mood_stats 改用 SQL GROUP BY | 2h |
+| 4 | 笔画光栅化改为 BBox 裁剪 (50 条笔画 1.6GB → 合理范围) | 4h |
+| 5 | SyncEngine 合并同资源操作 | 4h |
+
+### B.4 Phase 3 质量提升 (持续)
+
+| # | 任务 |
+|---|------|
+| 1 | 补充后端集成测试 + Flutter BLoC 测试 |
+| 2 | 统一同步协议 (Flutter ↔ Rust) |
+| 3 | 创建端点改返回 201 |
+| 4 | 添加 DiaryApiDoc OpenAPI 文档 |
+| 5 | 无障碍性 Semantics |
+| 6 | DiaryEvent 枚举接入 EventBus |
+
+### B.5 讨论点
+
+- Phase 1 的家长验证流程比较重，MVP 阶段是否可以用简化版（注册时勾选确认代替完整验证链）？
+- 性能优化在数据量小的时候感知不明显，是否延后到真实用户测试时再做？
+- 同步协议断裂是最严重的架构问题，但也是改动量最大的——何时投入？
+
+---
+
+## 方向 C — 端到端联调
+
+> **目标**: 确保 Flutter → Rust API 全链路数据流通
+> **预估**: 8-16h
+> **优先级**: ⭐⭐⭐⭐ — 不联调就不知道能不能跑
+
+### C.1 核心联调路径
+
+| # | 链路 | 前端模块 | 后端 API | 状态 |
+|---|------|---------|---------|------|
+| 1 | **注册 → 登录 → Token 获取** | AuthBloc | POST /auth/* | ✅ 通过 |
+| 2 | **创建日记 → 保存到后端** | EditorBloc → JournalRepository | POST /diary/journals | ✅ 通过 |
+| 3 | **日记列表加载** | HomeBloc | GET /diary/journals | ✅ 通过 |
+| 4 | **班级创建 → 加入 → 查看成员** | ClassBloc | POST/GET /diary/classes/* | ✅ 通过 |
+| 5 | **贴纸浏览 → 收藏** | StickerBloc | GET /diary/stickers/* | ✅ 通过 (空) |
+| 6 | **发现页数据加载** | DiscoverBloc | GET /diary/discover | ✅ 通过 |
+| 7 | **搜索日记/模板** | SearchBloc | GET /diary/journals?search= | ✅ 通过 |
+| 8 | **心情统计** | CalendarBloc | GET /diary/stats/mood | ✅ 通过 |
+| 9 | **同步 (离线→在线)** | SyncEngine | POST /diary/sync | ❌ 协议断裂 |
+
+### C.1b DTO 验证生效确认
+
+| 测试 | 结果 |
+|------|------|
+| 负版本号 `version: -1` | ✅ 拒绝: "版本号不能为负数" |
+| 标签过长 (50+ chars) | ✅ 拒绝: "超过 30 字符" |
+| 班级码非字母数字 `!!!!!!` | ✅ 拒绝: "仅允许字母和数字" |
+| 贴纸包负价格 `price: -100` | ✅ 拒绝: "价格不能为负数" |
+| 评语创建 (admin 角色) | ✅ 正确返回 403 (仅 teacher) |
+
+### C.2 联调方式讨论
+
+**方案 A — 手动联调（快速验证）**
+- 启动后端 + Flutter Web
+- 手动走一遍核心流程
+- 用 Chrome DevTools 看 Network 请求
+- 优点：快速、直观
+- 缺点：不可复现、覆盖不全
+
+**方案 B — 自动化集成测试（推荐）**
+- 后端：已有 9 个集成测试，扩展到覆盖所有 API
+- 前端：用 integration_test 包写 Flutter 集成测试
+- 优点：可复现、持续验证
+- 缺点：前期投入大
+
+**方案 C — Postman/HTTP 请求集**
+- 先用 Postman 验证所有后端 API
+- 再手动跑 Flutter 前端
+- 折中方案
+
+### C.3 讨论点
+
+- 同步功能 (链路 9) 已知断裂，联调时是否先跳过？
+- 先做后端 API 验证还是直接跑 Flutter？
+- 是否需要准备测试数据种子？
+
+---
+
+## 方向 D — 产品体验打磨
+
+> **目标**: 从小学生用户视角出发，打磨交互体验
+> **预估**: 持续迭代
+> **优先级**: ⭐⭐⭐ — 功能能跑之后的首要任务
+
+### D.1 体验问题清单
+
+| # | 问题 | 严重性 | 讨论点 |
+|---|------|--------|--------|
+| 1 | **首次使用引导** — 新用户打开 app 不知道干什么 | HIGH | 需要设计引导流程 |
+| 2 | **空状态设计** — 列表为空时显示什么？ | MEDIUM | 需要插画/文案 |
+| 3 | **加载状态** — 骨架屏 vs 转圈 vs 进度条？ | MEDIUM | 统一 Loading 策略 |
+| 4 | **错误提示** — 网络错误/服务器错误/离线 如何提示？ | HIGH | 儿童友好的错误文案 |
+| 5 | **手写反馈** — 写字时有声音/动画反馈吗？ | LOW | 增强沉浸感 |
+| 6 | **心情追踪可视化** — fl_chart 集成够好看吗？ | MEDIUM | 需要实际渲染验证 |
+| 7 | **成就/徽章系统** — 有雏形但完整吗？ | MEDIUM | 当前只有数据模型 |
+| 8 | **贴纸交互** — 拖拽/缩放/旋转手感如何？ | HIGH | 核心体验 |
+| 9 | **日历视图** — 月历和日记的关联够直观吗？ | MEDIUM | |
+| 10 | **班级动态** — 老师点评 → 学生能看到吗？ | HIGH | 核心社交功能 |
+
+### D.2 可能的新功能想法
+
+| # | 想法 | 复杂度 | 讨论点 |
+|---|------|--------|--------|
+| 1 | **每日写作提示** — "今天你吃了什么好吃的？" | 低 | 已有 Discover daily_inspiration，可扩展 |
+| 2 | **天气/心情自动检测** — 根据文字内容建议心情标签 | 中 | 需要 NLP 或关键词匹配 |
+| 3 | **日记模板市场** — 下载别人分享的日记模板 | 高 | Phase 2 功能？ |
+| 4 | **语音输入** — 口述转文字辅助写作 | 高 | 技术选型待定 |
+| 5 | **涂鸦动画回放** — 把绘画过程做成短视频 | 中 | 技术上可行 (已有时间戳数据) |
+| 6 | **多页日记** — 一篇日记可以有很多页 | 中 | 编辑器需要支持翻页 |
+| 7 | **日记封面** — 自动/手动生成好看的封面 | 低 | 取日记第一张图或涂鸦 |
+| 8 | **分享到班级圈** — 类似朋友圈的班级动态流 | 高 | Phase 2 功能？ |
+
+### D.3 讨论点
+
+- 哪些体验问题必须在 MVP 之前解决？
+- 新功能想法中哪些值得现在就开始探索？
+- 是否需要做一轮真实的用户测试（找几个小学生试用）？
+
+---
+
+## 方向 E — 上线准备 / DevOps
+
+> **目标**: 从开发环境走向可发布的 App
+> **预估**: 20-40h (取决于目标平台)
+> **优先级**: ⭐⭐ — 功能稳定后再做
+
+### E.1 短期目标：可内测的 APK
+
+| # | 任务 | 预估 | 状态 |
+|---|------|------|------|
+| 1 | Flutter Android 构建 + 签名 | 4h | 未开始 |
+| 2 | 生产环境配置 (HTTPS, 密钥管理) | 4h | 未开始 |
+| 3 | 服务器部署 (Docker Compose 生产配置) | 4h | 未开始 |
+| 4 | 环境变量管理 (.env → 生产密钥注入) | 2h | 未开始 |
+
+### E.2 中期目标：应用商店
+
+| # | 任务 | 预估 |
+|---|------|------|
+| 1 | App Store / Google Play 开发者账号 | 1h |
+| 2 | 应用图标 + 启动页设计 | 4h |
+| 3 | 隐私政策 + 用户协议 (PIPL 合规) | 4h |
+| 4 | 应用截图 + 描述文案 | 2h |
+| 5 | 内部测试轨道分发 | 2h |
+| 6 | iOS 打包准备 (Mac + Xcode + 证书) | 8h |
+
+### E.3 CI/CD 流水线
+
+| # | 任务 | 预估 |
+|---|------|------|
+| 1 | GitHub Actions / Gitea CI 配置 | 4h |
+| 2 | 后端: cargo test + clippy + Docker build | 2h |
+| 3 | 前端: flutter analyze + test + build | 2h |
+| 4 | 管理端: pnpm lint + build | 1h |
+| 5 | 自动部署到测试服务器 | 4h |
+
+### E.4 讨论点
+
+- 先做 Android APK（开发者模式安装）给内部测试？
+- 服务器是用现有机器还是云服务器？
+- CI/CD 用 Gitea 内置的还是 GitHub Actions？
+- iOS 是否需要购买 Mac 设备？
+
+---
+
+## 方向间的依赖关系
+
+```
+A (提交收尾)
+ │
+ ├─→ B (审计修复) ─→ E (上线准备)
+ │                   │
+ ├─→ C (端到端联调)  │
+ │     │             │
+ │     └─→ D (体验打磨)
+ │
+ └─────────────────────────────→ 时间线
+```
+
+**关键路径**: A → C → D → E（先提交 → 再联调 → 再打磨 → 再上线）
+**安全路径**: A → B → E（先提交 → 再修 bug → 再上线）
+**混合路径**: A → B+C 并行 → D → E（推荐）
+
+---
+
+## 建议的推进顺序
+
+1. **A — 收尾提交** ✅ (已完成) — 7 个提交已推送
+2. **B — 安全加固** ✅ (已完成) — DTO 验证 + Token 刷新 + 班级码
+3. **C — 端到端联调** ✅ (已完成) — 8/9 条链路通过
+4. **D.1 体验问题修复** (下一步) — 好用
+5. **B.3 性能优化** (2-3 天) — 快
+6. **E.1 内测 APK** (1-2 天) — 可分享
+7. **D.2 新功能探索** (持续) — 有趣
+8. **E.2-E.3 应用商店 + CI/CD** (1-2 周) — 正式上线
+
+---
+
+## 开放讨论
+
+> 以下问题需要在推进前达成共识：
+
+1. **Phase 范围**: Discover 功能属于 Phase 1 还是 Phase 2？审计报告标记为 Phase 2 违规
+2. **MVP 定义**: 最小可用版本的边界在哪？哪些功能必须有，哪些可以等？
+3. **家长验证**: 完整 PIPL 流程 vs 注册勾选确认，MVP 选哪个？
+4. **同步策略**: 修复现有协议 vs 重新设计 vs MVP 先不支持同步？
+5. **测试设备**: 有没有 Android 设备可以用来真机测试？
+6. **目标用户验证**: 有没有机会找真实小学生试用收集反馈？
+7. **时间预期**: 从现在到"可内测"你期望多久？
+
+---
+
+*文档结束 — 确认方向后按优先级逐一推进*