docs: 更新 Wiki 文档 — 数据层/前端/后端/健康/索引同步至最新
This commit is contained in:
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Flutter 前端
|
||||
updated: 2026-06-01
|
||||
updated: 2026-06-07
|
||||
status: active
|
||||
tags: [flutter, bloc, design-system, responsive]
|
||||
---
|
||||
@@ -43,9 +43,10 @@ Stroke/StrokePoint 是热路径高频创建对象,freezed 生成的代码有
|
||||
| stickers | StickerBloc | 贴纸库浏览 + 选择 |
|
||||
| templates | TemplateBloc | 模板画廊 |
|
||||
| profile | SettingsBloc | 主题切换 + 个人设置 |
|
||||
| search | — | 日记搜索 (Isar FTS 待实现) |
|
||||
| search | SearchBloc | 日记搜索(按心情/标签/关键词) |
|
||||
| teacher | — | 老师主题发布 + 批改 |
|
||||
| parent | — | 家长监护 + 数据管理 |
|
||||
| parent | ParentBloc | 家长监护 + 数据管理 |
|
||||
| discover | DiscoverBloc | 发现页(每日推荐/热门话题/精选模板/达人日记) |
|
||||
| settings | — | 设置页面 UI |
|
||||
|
||||
### 注入链 (app.dart)
|
||||
@@ -100,10 +101,12 @@ AppTheme.light() / AppTheme.dark()
|
||||
|
||||
| 问题 | 级别 | 状态 | 说明 |
|
||||
|------|------|------|------|
|
||||
| 编辑器不加载已有数据 | HIGH | 待做 | journalId 非空时需从 Isar 读取 |
|
||||
| SSE 端口不一致 | HIGH | 待修 | SSE 用 8080,API 用 3000,推送必然失败 |
|
||||
| ~~编辑器不加载已有数据~~ | ~~HIGH~~ | ✅ 已修复 | _loadExistingJournal 从 Isar 读取日记 + 元素 + 笔画 |
|
||||
| ~~SSE 端口不一致~~ | ~~HIGH~~ | ✅ 已修复 | AppConfig 统一管理 apiBaseUrl/sseBaseUrl,均指向 3000 |
|
||||
| ~~编辑器打开即弹出画笔~~ | ~~HIGH~~ | ✅ 已修复 | 打开已有日记默认查看模式,点"编辑"才进入编辑模式 |
|
||||
| API base URL 硬编码 | HIGH | 待修 | localhost:3000 硬编码,生产环境需配置化 |
|
||||
| 前端测试为零 | HIGH | 待做 | 70 个 Dart 文件无任何测试覆盖 |
|
||||
| 多处硬编码数据未对接 API | HIGH | 部分修复 | 见下方「硬编码数据清单」 |
|
||||
| 前端测试覆盖不足 | MEDIUM | 持续 | 15 个测试文件 203 个用例,auth_bloc 有 1 个失败待修 |
|
||||
| 状态管理不统一 | MEDIUM | 待规划 | 5 模块用 BLoC,5 模块用 ChangeNotifier |
|
||||
| freezed 声明未使用 | MEDIUM | 待清理 | pubspec 声明了但全部手写不可变类 |
|
||||
| SyncEngine 缺少网络监听 | MEDIUM | 待做 | 只有 trySync() 方法,无自动触发 |
|
||||
@@ -112,6 +115,44 @@ AppTheme.light() / AppTheme.dark()
|
||||
| core/utils/ 空目录 | LOW | 待填充 | 缺少日期格式化、颜色解析等通用工具 |
|
||||
| 深色模式细节 | LOW | 持续 | 部分组件深色适配需检查 |
|
||||
|
||||
### 硬编码数据清单
|
||||
|
||||
> 2026-06-07 全面排查结果。标记 ✅ 已修复 / ❌ 待修复。
|
||||
|
||||
**HIGH — 已有 API,应直接替换:**
|
||||
|
||||
| 页面 | 文件 | 硬编码内容 | 后端 API | 状态 |
|
||||
|------|------|-----------|----------|------|
|
||||
| 首页 | home_page.dart | 用户名 `'小暖'` | AuthBloc.user | ❌ |
|
||||
| 个人 | profile_page.dart | 头像 emoji `'😊'` | AuthBloc.user | ❌ |
|
||||
| 个人 | profile_page.dart | 6 个固定成就徽章 | AchievementBloc | ❌ |
|
||||
| 搜索 | search_page.dart | 4 个假模板名称 | TemplateBloc | ❌ |
|
||||
| 贴纸 | sticker_library_page.dart | 精选贴纸包"治愈小动物" | StickerBloc | ❌ |
|
||||
| 教师 | teacher_page.dart | 班级码 `'a1b2c3'` | ClassBloc | ❌ |
|
||||
| 班级 | class_page.dart | 头像首字固定 `'同'` | JournalEntry.authorId | ❌ |
|
||||
| 发现 | discover_page.dart | 全部 4 板块假数据 | GET /diary/discover | ✅ |
|
||||
|
||||
**MEDIUM — 需要 API 或可延后:**
|
||||
|
||||
| 页面 | 文件 | 硬编码内容 | 备注 |
|
||||
|------|------|-----------|------|
|
||||
| 搜索 | search_page.dart | 热门搜索 8 个关键词 | 需新增后端 API |
|
||||
| 编辑器 | sticker_picker_sheet.dart | 60 个内置 emoji 贴纸 | Phase 1 占位,贴纸包 API 已有 |
|
||||
| 编辑器 | tag_panel.dart | 10 个推荐标签 | 可从用户历史标签推导 |
|
||||
| 贴纸 | sticker_library_page.dart | 8 个固定分类名 | StickerBloc 已有分类数据 |
|
||||
| 模板 | template_gallery_page.dart | 每张卡片固定"学生专属"/"简约"标签 | 模板 API 已有 |
|
||||
| 个人 | profile_page.dart | 贴纸数 `'--'` | 需新增统计 API |
|
||||
|
||||
**LOW — 可接受的 UI 设计常量:**
|
||||
|
||||
| 页面 | 内容 | 说明 |
|
||||
|------|------|------|
|
||||
| 编辑器 | 画笔/文本颜色面板 | 设计工具调色板 |
|
||||
| 编辑器 | 字号选项 [小/中/大] | 编辑器选项 |
|
||||
| 首页/日历 | 心情/天气 emoji 映射 | enum → UI 展示映射 |
|
||||
| 引导页 | 3 步引导内容 | 静态引导文案 |
|
||||
| 班级 | 快捷评语模板 7 条 | 内置教学工具 |
|
||||
|
||||
### 历史教训
|
||||
|
||||
- F11 深色模式修复需要 bloat bloc 测试套件同步更新 (05317d5)
|
||||
@@ -123,6 +164,10 @@ AppTheme.light() / AppTheme.dark()
|
||||
|
||||
| 日期 | 变更 |
|
||||
|------|------|
|
||||
| 2026-06-07 | 发现页全链路打通:DiscoverBloc + GET /diary/discover,替换全部硬编码 |
|
||||
| 2026-06-07 | 全面排查硬编码数据,新增「硬编码数据清单」章节 |
|
||||
| 2026-06-07 | 编辑器新增查看模式(打开已有日记默认只读)、元素图层调整(置顶/置底)|
|
||||
| 2026-06-07 | 日历页面修复:初始加载自动填充 selectedDayJournals |
|
||||
| 2026-06-01 | 补充状态管理不统一、SSE 端口问题、测试缺失等新发现 |
|
||||
| 2026-06-01 | IsarJournalRepository 注入为主 JournalRepository (2481c8f) |
|
||||
| 2026-06-01 | 设置页 UI + Mood/成就/贴纸 BLoC (8331db6) |
|
||||
|
||||
Reference in New Issue
Block a user