docs: 新增架构解耦路线图文档
- 新增 docs/architecture/audit/01_decoupling_roadmap.md - 解耦原则: 单一职责 / 模块封装 / 分层单向依赖 - 过耦合问题清单: 6 项 P0 + 6 项 P1 + 2 项 P2 - 每项含问题/影响/解耦方案/迁移步骤 - 三阶段执行优先级与验收标准 - 更新 docs/README.md 索引加入解耦路线图 - 更新 work_log 记录本次工作
This commit is contained in:
@@ -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
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user