docs: 更新CHANGELOG - 记录代码合规性审查修复

- P0 三层架构违规修复(4项)
- P1 API 路径统一(8项)
- P2 文档规范更新(5项)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Claude Opus 4.6 2026-03-13 14:14:51 +08:00
parent 066b1f2257
commit c0b465dcea

View File

@ -6,6 +6,44 @@
## [Unreleased]
### 代码合规性审查修复 ✅ (2026-03-13)
**P0 - 三层架构违规修复 (4项)**
- ✅ 创建 `SchoolStatsService` - 移除 SchoolStatsController 直接调用 Mapper
- ✅ 创建 `TeacherStatsService` - 移除 TeacherStatsController 直接调用 Mapper
- ✅ 修复 `AdminCourseController` - 使用 `CourseService.createSystemCourse()` 方法
- ✅ 修复 `TeacherCourseController` - 使用 `ClassService.getActiveClassesByTenantId()` 方法
- ✅ 新增 `ClassService.getActiveClassesByTenantId()` - 获取活跃班级列表
- ✅ 新增 `CourseService.createSystemCourse()` - 创建系统课程专用方法
**P1 - API 路径统一 (8项)**
后端路径统一:
- ✅ `AdminCourseController`: `/api/admin/courses``/api/v1/admin/courses`
- ✅ `AdminTenantController`: `/api/admin/tenants``/api/v1/admin/tenants`
前端配置调整:
- ✅ `vite.config.ts`: 移除代理重写规则,直接透传 `/api/*`
- ✅ `src/api/index.ts`: baseURL `/api/v1``/api`
- ✅ `src/api/admin.ts`: 更新所有路径为 `/v1/admin/*`
- ✅ `src/api/lesson.ts`: 更新所有路径为 `/v1/admin/courses/*`
- ✅ `src/api/package.ts`: 更新所有路径为 `/v1/admin/packages/*`
- ✅ `src/api/theme.ts`: 更新所有路径为 `/v1/admin/themes/*`
**P2 - 文档规范更新 (5项)**
- ✅ 更新 `.claude/CLAUDE.md` 前端 API 调用文档
- ✅ 新增三种调用方式说明http 方法 / 业务适配层 / Orval 客户端)
- ✅ 新增 API 路径规范表格(超管/学校/教师/家长/认证)
- ✅ 更新前端目录结构说明(`client.ts` → `index.ts`
- ✅ 更新 Controller 层路径约定说明
**变更统计:**
- 修改文件16 个
- 新增文件4 个 Service 类
- 代码变更:+592 行,-305 行
---
### 课程包三端全链路测试完成 ✅ (2026-03-13)
**核心修复:**