docs(wiki): 全量项目健康度评估 + 技术债全景更新
- 新增 project-health.md — 项目评分/技术债全景/风险矩阵/改进路线图 - 更新 index.md — 代码量分布表/新发现技术债统计/新增症状条目 - 更新 architecture.md — Feature Flag 未实现状态/超大文件发现 - 更新 frontend.md — 状态管理不统一/SSE 端口/测试缺失等 11 项问题 - 更新 erp-diary.md — 代码量分布参考/班级码硬编码问题 基于 4 代理并行深度分析: 后端 Rust 51,459 行 + 前端 Flutter 18,398 行
This commit is contained in:
@@ -1,24 +1,48 @@
|
||||
---
|
||||
title: 暖记知识库首页
|
||||
updated: 2026-06-01
|
||||
status: active
|
||||
---
|
||||
|
||||
# 暖记 (Nuanji) — 知识库
|
||||
|
||||
> **温暖治愈风格的手写手账日记 App**,面向小学生首发,核心价值是保留真实笔迹。从 [[architecture]] 导航。
|
||||
|
||||
## 关键数字
|
||||
|
||||
> 最后更新: 2026-06-01 | 基线: main (2481c8f)
|
||||
> 最后更新: 2026-06-01 | 基线: main (c2a9579)
|
||||
|
||||
| 指标 | 值 |
|
||||
|------|-----|
|
||||
| Rust crate | 8 个(6 基座 + 1 入口 + erp-diary 新增) |
|
||||
| Rust 新增代码 | ~5,500 行(erp-diary) |
|
||||
| Dart 文件 | 70 个(~18,200 行,含生成代码) |
|
||||
| SeaORM Entity | 15 个(erp-diary) |
|
||||
| 数据库迁移 | 15 个(diary 相关) |
|
||||
| BLoC 模块 | 12 个 |
|
||||
| Rust crate | 8 个(6 基座 + 1 入口 + erp-diary) |
|
||||
| Rust 总代码 | ~51,459 行(256 个 .rs 文件) |
|
||||
| erp-diary 新增 | 5,108 行(41 个文件) |
|
||||
| Dart 文件 | 70 个(~18,398 行,含生成代码 6,128 行) |
|
||||
| SeaORM Entity | 15 个(erp-diary) + 50+(基座) |
|
||||
| 数据库迁移 | 56 个(41 基座 + 15 diary) |
|
||||
| BLoC 模块 | 12 个(5 flutter_bloc + 5 ChangeNotifier + 2 混合) |
|
||||
| Flutter features | 16 个 |
|
||||
| Isar Collection | 3 个(JournalEntry / JournalElement / PendingOperation) |
|
||||
| 后端测试 | ~50 个通过 |
|
||||
| flutter analyze | 0 error |
|
||||
| Git 提交 | 17 次 |
|
||||
| 前端测试 | **0 个**(最大技术债) |
|
||||
| flutter analyze | 0 error / 1 warning / 18 info |
|
||||
| Git 提交 | 20 次 |
|
||||
| 技术债 | 10 已记录 + 9 新发现 |
|
||||
|
||||
## 代码量分布
|
||||
|
||||
| 组件 | 代码行数 | 文件数 | 占比 |
|
||||
|------|---------|--------|------|
|
||||
| erp-plugin (WASM 插件运行时) | 11,312 | 28 | 16.2% |
|
||||
| erp-auth (认证/权限) | 7,458 | 39 | 10.6% |
|
||||
| erp-workflow (BPMN 引擎) | 5,410 | 27 | 7.7% |
|
||||
| erp-config (字典/菜单/设置) | 5,111 | 23 | 7.3% |
|
||||
| erp-diary (暖记业务) | 5,108 | 41 | 7.3% |
|
||||
| erp-server (入口/迁移) | ~10,414 | 72 | 14.9% |
|
||||
| erp-core (事件/加密/审计) | 2,774 | 27 | 4.0% |
|
||||
| erp-message (通知/SSE) | 3,872 | 19 | 5.5% |
|
||||
| Flutter 前端 | ~18,398 | 70 | 26.3% |
|
||||
| **合计** | **~69,857** | **~346** | **100%** |
|
||||
|
||||
## 系统数据流
|
||||
|
||||
@@ -54,6 +78,7 @@ JournalEntry RemoteJournalRepository
|
||||
- [[data-layer]] — Isar 本地存储、Repository 模式、SyncEngine 离线同步
|
||||
- [[frontend]] — Flutter BLoC、16 个功能模块、设计系统、响应式布局
|
||||
- [[erp-diary]] — Rust 后端业务模块、Entity/Service/Handler、API 端点、权限码
|
||||
- [[project-health]] — 🆕 项目健康度评估、技术债全景、风险矩阵、改进建议
|
||||
|
||||
## 症状导航
|
||||
|
||||
@@ -72,6 +97,8 @@ JournalEntry RemoteJournalRepository
|
||||
| 热重载后 Isar 崩溃 | [[data-layer]] | 初始化 | 未 close 就 re-open |
|
||||
| 编辑器加载空白 | [[frontend]] | EditorBloc | journalId 有值但未加载 Isar 数据 |
|
||||
| SyncEngine 队列丢失 | [[data-layer]] | 持久化 | 退出时未调 persistPendingQueue |
|
||||
| SSE 推送不工作 | [[frontend]] | 端口配置 | SSE 端口 8080 vs API 端口 3000 |
|
||||
| 班级码验证失败 | [[frontend]] | auth_bloc | 班级码后端验证 TODO 未实现 |
|
||||
|
||||
## 相关文档
|
||||
|
||||
@@ -81,4 +108,5 @@ JournalEntry RemoteJournalRepository
|
||||
| 实施规划 v2.1 | `plans/hazy-petting-lampson.md` |
|
||||
| 项目协作规则 | `CLAUDE.md` |
|
||||
| 技术债看板 | `docs/tech-debt-board.md` |
|
||||
| OpenDesign 原型 | `docs/opendesign/warm-notes-journal-app.md` |
|
||||
| 基座仓库 | https://git.stableeasy.com/iven/base.git |
|
||||
|
||||
Reference in New Issue
Block a user