docs: 新增架构解耦路线图文档

- 新增 docs/architecture/audit/01_decoupling_roadmap.md
  - 解耦原则: 单一职责 / 模块封装 / 分层单向依赖
  - 过耦合问题清单: 6 项 P0 + 6 项 P1 + 2 项 P2
  - 每项含问题/影响/解耦方案/迁移步骤
  - 三阶段执行优先级与验收标准
- 更新 docs/README.md 索引加入解耦路线图
- 更新 work_log 记录本次工作
This commit is contained in:
SpecialX
2026-06-17 21:56:44 +08:00
parent f8dfd1dddd
commit ee517f2b33
3 changed files with 479 additions and 1 deletions

View File

@@ -46,7 +46,30 @@
- 所有文档保持活跃维护与归档分离
#### 验证
- 待验证 lint + tsc
- tsc --noEmit: 0 errors
- npm run lint: 0 errors 0 warnings
- git commit: f8dfd1d
---
### 解耦路线图输出
#### 完成工作
- 创建 `docs/architecture/audit/01_decoupling_roadmap.md` 解耦路线图文档
- 解耦原则:单一职责 / 模块封装 / 分层单向依赖
- 过耦合问题清单6 项 P0 + 6 项 P1 + 2 项 P2每项含问题/影响/解耦方案/迁移步骤
- 解耦执行优先级三阶段P0 1-2 周 / P1 2-4 周 / P2 4-8 周)
- 验收标准:文件行数 / 模块封装 / 职责单一 / 架构文档可读性
- 预期效果:开发效率 / 文档质量 / 项目可维护性三方面提升
- 更新 `docs/README.md` 索引加入解耦路线图
#### 关键解耦项摘要
- P0-1: classes/data-access.ts 2104 行 → 按职责拆 4 个文件
- P0-2: homework/data-access.ts 1038 行 → 分离排名逻辑到 ranking-service.ts
- P0-3: shared/lib ↔ auth 循环依赖 → 依赖注入或抽取 session.ts
- P0-4: dashboard 直查 11 张表 → 各模块添加 getDashboardStats() 函数
- P0-5: messaging 绕过 notifications → 改用 dispatchNotification
- P0-6: classSchedule 三处写入口 → 统一到 scheduling/data-access
---