# 暖记技术债看板

> 最后更新: 2026-06-01

## 指标概览

| 指标 | 当前值 | 目标 | 状态 |
|------|--------|------|------|
| flutter analyze 错误 | 0 | 0 | 🟢 健康 |
| flutter analyze 警告 | 1 | 0 | 🟡 需改进 |
| flutter analyze info | 18 | ≤10 | 🟡 需改进 |
| 后端测试 | ~50 | 80%+ 覆盖 | 🟡 需改进 |
| 前端测试 | 0 | 80%+ 覆盖 | 🔴 缺失 |
| CI/CD | 无 | 全自动化 | 🔴 缺失 |
| Docker 部署 | 未验证 | 可运行 | 🔴 缺失 |

## 高息技术债（按优先级排序）

### TD-1: editor_page.dart authorId 硬编码 [利息: HIGH]

- **现状**: `JournalEntry.create(authorId: 'local')` 硬编码
- **影响**: 无法关联真实用户，同步后数据混乱
- **修复成本**: 0.5 天
- **计划**: 接入 AuthBloc 获取当前用户 ID
- **文件**: `app/lib/features/editor/views/editor_page.dart:96`

### TD-2: CI/CD 未建立 [利息: HIGH]

- **现状**: 手动 `cargo check` + `flutter analyze`
- **影响**: 无法防止回归，无自动部署
- **修复成本**: 1 天
- **计划**: GitHub Actions / Gitea CI + 基础流水线

### TD-3: 后端 Docker 部署未验证 [利息: HIGH]

- **现状**: `docker/` 目录有 compose 文件但从未实际运行
- **影响**: 无法确认后端可正常启动
- **修复成本**: 0.5 天
- **计划**: docker-compose up + 健康检查验证

### TD-4: 笔画 toImage() 同步阻塞 [利息: MEDIUM]

- **现状**: `stroke_cache.dart` 中 `toImage()` 在主线程执行
- **影响**: 大笔画可能导致 UI 卡顿
- **修复成本**: 1 天
- **计划**: compute() isolate 异步光栅化

### TD-5: 前端测试为零 [利息: MEDIUM]

- **现状**: `app/test/` 目录空
- **影响**: 无回归保护，重构风险高
- **修复成本**: 3 天
- **计划**: Repository 单元测试 → BLoC 测试 → Widget 测试

### TD-6: 画布尺寸变化缓存过渡 [利息: MEDIUM]

- **现状**: 屏幕旋转时 ui.Image 缓存失效，需要重新光栅化
- **影响**: 旋转瞬间可能卡顿或空白
- **修复成本**: 1 天
- **计划**: 监听尺寸变化，异步重建缓存

### TD-7: SecureStorage token 未持久化 [利息: MEDIUM]

- **现状**: app.dart 中 token 设置为 TODO 注释
- **影响**: 每次重启需要重新登录
- **修复成本**: 0.5 天
- **计划**: flutter_secure_storage 存取 JWT

### TD-8: 编辑器不加载已有日记 [利息: MEDIUM]

- **现状**: journalId 非空时未从 Isar 读取数据
- **影响**: 编辑已有日记时显示空白
- **修复成本**: 1 天
- **计划**: EditorBloc 添加 LoadJournal event + Isar 查询

### TD-9: Isar FTS 搜索未实现 [利息: LOW]

- **现状**: search 模块是空壳
- **影响**: 无法搜索日记内容
- **修复成本**: 1 天
- **计划**: Isar FTS 索引 + 搜索结果页

### TD-10: SyncEngine 蜂窝数据未支持 [利息: LOW]

- **现状**: 仅 WiFi 自动同步
- **影响**: 无 WiFi 时无法同步
- **修复成本**: 0.5 天
- **计划**: 添加用户设置允许蜂窝数据同步

## 已偿还债务

| 债务 | 还清日期 | 投入 |
|------|---------|------|
| 手写引擎单层 Canvas 卡顿 | 2026-06-01 | 双层架构 + 光栅化缓存 |
| 编辑器 onSave 仅 debugPrint | 2026-06-01 | IsarJournalRepository 持久化 |
| SyncEngine 队列纯内存 | 2026-06-01 | Isar PendingOperation 持久化 |
| Isar 未初始化 | 2026-06-01 | main.dart init + Schema 注册 |
| 深色模式适配问题 | 2026-05-31 | F11 修复 + B7 测试套件 |

## 偿还优先级排名

| 优先级 | 债务 | 预估投入 | 预期效果 |
|--------|------|---------|---------|
| P0 | TD-1 authorId 硬编码 | 0.5 天 | 数据可关联真实用户 |
| P0 | TD-3 Docker 部署 | 0.5 天 | 后端可运行验证 |
| P1 | TD-7 token 持久化 | 0.5 天 | 免重复登录 |
| P1 | TD-8 加载已有日记 | 1 天 | 编辑器完整可用 |
| P1 | TD-4 toImage 异步 | 1 天 | 消除大笔画卡顿 |
| P2 | TD-2 CI/CD | 1 天 | 自动化质量守卫 |
| P2 | TD-5 前端测试 | 3 天 | 回归保护 |