iven/nj
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: 更新 Wiki 文档 — 数据层/前端/后端/健康/索引同步至最新

Browse Source
This commit is contained in:
iven
2026-06-07 10:44:26 +08:00
parent 41ef28f20b
commit ed8252d7c8
5 changed files with 87 additions and 36 deletions
Download Patch File Download Diff File Expand all files Collapse all files

18
wiki/erp-diary.md
View File

@@ -1,6 +1,6 @@
---
title: erp-diary 后端模块
updated: 2026-06-01
updated: 2026-06-07
status: active
tags: [rust, axum, seaorm, diary, api]
---
@@ -29,23 +29,23 @@ tags: [rust, axum, seaorm, diary, api]
```
crates/erp-diary/src/
├── lib.rs (206 行) — DiaryModule 实现 + Feature Flag 注册
├── dto.rs (569 行) — 请求/响应 DTO + Validate 注解
├── lib.rs (280 行) — DiaryModule 实现 + Feature Flag 注册
├── dto.rs (640 行) — 请求/响应 DTO + Validate 注解
├── error.rs (193 行) — DiaryError 15 种变体 → HTTP 状态码
├── event.rs (61 行) — 事件定义 (diary.created 等)
├── state.rs (13 行) — DiaryState (DiaryModule 专用状态)
├── entity/ (15 文件) — SeaORM Entity
├── service/ (10 文件) — 业务逻辑
└── handler/ (8 文件) — HTTP Handler + utoipa 注解
├── service/ (12 文件) — 业务逻辑
└── handler/ (10 文件) — HTTP Handler + utoipa 注解
```
### Entity 清单 (15 个)
achievement, class_member, comment, handwriting_stroke, journal_element, journal_entry, parent_child_binding, school_class, sticker, sticker_pack, teacher_profile, template, topic_assignment, user_achievement, user_settings
### Service 清单 (10 个)
### Service 清单 (12 个)
journal, class, comment, content_safety, achievement, mood_stats, notification, sticker, sync, topic
journal, class, comment, content_safety, achievement, mood_stats, notification, sticker, sync, topic, **parent**, **discover**
### API 端点
@@ -60,6 +60,8 @@ journal, class, comment, content_safety, achievement, mood_stats, notification,
| `/api/v1/diary/stickers` | sticker_handler | 贴纸管理 |
| `/api/v1/diary/stats` | stats_handler | 心情/写作统计 |
| `/api/v1/diary/sync` | sync_handler | 增量同步 API |
| `/api/v1/diary/discover` | discover_handler | 发现页聚合（每日推荐/热门话题/精选模板/达人日记） |
| `/api/v1/diary/parent` | parent_handler | 家长绑定 + 数据管理 |
### 集成契约
@@ -95,6 +97,7 @@ journal, class, comment, content_safety, achievement, mood_stats, notification,
| 文件上传未实现 | MEDIUM | 待做 | 照片/贴纸文件上传参考健康模块 |
| 代码分布 | INFO | 参考 | service 层 51.7%、handler 20.1%、entity 15.6%、dto 11.1% |
| 班级码硬编码 | LOW | 待修 | 前端 teacher 模块班级码 'a1b2c3' 未接入后端 |
| 发现页硬编码 | — | ✅ 已修复 | DiscoverBloc + GET /diary/discover 全链路打通 |
### 代码量参考
@@ -111,5 +114,6 @@ journal, class, comment, content_safety, achievement, mood_stats, notification,
| 日期 | 变更 |
|------|------|
| 2026-06-07 | 新增 discover_service + discover_handler (GET /diary/discover)、parent_handler 补充文档 |
| 2026-06-01 | 补充代码量分布、班级码硬编码问题 |
| 2026-06-01 | 初始创建 — Entity/Service/Handler 清单、API 端点、集成契约 |