docs: 同步架构文档 004/005/007/audit 反映 P1-2/P2-2 解耦修复

This commit is contained in:
SpecialX
2026-06-18 02:55:17 +08:00
parent 6588f7484f
commit 0423b2b984
5 changed files with 368 additions and 100 deletions

View File

@@ -72,9 +72,17 @@ shared/lib/{audit-logger, change-logger, auth-guard}
| `subjects` | 6+ | school | exams, homework, questions |
| `exams` | 5+ | exams | homework, grades, dashboard |
### 7. actions 层混入数据访问逻辑
### 7. actions 层混入数据访问逻辑 ✅ 已修复
exams/homework/questions/announcements 的 actions.ts 中存在直接 `db.insert/update/delete`,应该通过 data-access 层。
~~exams/homework/questions/announcements 的 actions.ts 中存在直接 `db.insert/update/delete`,应该通过 data-access 层。~~
**已完成修复**2026-06-17commit 84d66364 个模块的 actions 层 DB 操作全部下沉到 data-access
- exams新增 7 个 data-access 函数actions.ts 831→766 行data-access.ts 374→524 行
- homework新建 data-access-write.ts285 行10 个写函数actions.ts 387→239 行
- questions新增 4 个 data-access 函数actions.ts 294→177 行data-access.ts 138→299 行
- announcements新增 5 个 data-access 函数actions.ts 242→231 行data-access.ts 120→186 行
剩余未修复usersupdateUserProfileAction、schedulingapplyAutoScheduleAction/autoScheduleAction
### 8. auth.ts 混合 5 类职责
@@ -122,7 +130,7 @@ NextAuth 配置 + 密码安全 DB 操作 + 角色规范化 + IP 解析 + 回调
### 短期执行(P1)
6. 统一 classSchedule 写入口到 scheduling 模块
7. actions 层移除直接 DB 操作
7. ~~actions 层移除直接 DB 操作~~ ✅ 部分完成exams/homework/questions/announcements 已修复users/scheduling 待处理)
8. 拆分 auth.ts
9. 集成 proctoring/exam-mode-config 到考试表单
10. 拆分 users/import-export.ts
@@ -130,3 +138,4 @@ NextAuth 配置 + 密码安全 DB 操作 + 角色规范化 + IP 解析 + 回调
### 中期执行(P2)
11. 建立模块间数据访问规范(通过对方 data-access 或导出查询函数)
12. schema.ts 按业务域分节(加注释分隔)
13. ~~拆分 `shared/lib/ai.ts`~~ ✅ 已完成P2-2commit 6588f74拆分为 `ai/` 目录 6 个文件,原 ai.ts 保留为重导出)