156 lines
4.2 KiB
Markdown
156 lines
4.2 KiB
Markdown
|
# 超管端功能测试记录
|
||
|
|
|
||
|
|
**日期**: 2026-03-13
|
||
|
|
**测试人员**: Claude
|
||
|
|
**测试环境**: http://localhost:5173
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 测试目标
|
||
|
|
|
||
|
|
按模块详细测试超管端功能，重点验证**课程包创建的完整流程**。
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 测试账号
|
||
|
|
|
||
|
|
| 角色 | 账号 | 密码 |
|
||
|
|
|------|------|------|
|
||
|
|
| 超管 | admin | 123456 |
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 测试进度
|
||
|
|
|
||
|
|
- [x] 登录验证 ✅
|
||
|
|
- [ ] 课程包管理
|
||
|
|
- [ ] 创建课程包 (部分完成 - API方法名需修复)
|
||
|
|
- [ ] 编辑课程包
|
||
|
|
- [ ] 删除课程包
|
||
|
|
- [ ] 发布/下架
|
||
|
|
- [ ] 课程管理
|
||
|
|
- [ ] 资源管理
|
||
|
|
- [ ] 用户管理
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 测试记录
|
||
|
|
|
||
|
|
### 1. 登录验证 ✅
|
||
|
|
|
||
|
|
- [x] 超管登录成功
|
||
|
|
- [x] 跳转到 Dashboard 页面
|
||
|
|
- [x] Token 存储正常
|
||
|
|
|
||
|
|
**备注**: 密码需使用 `123456` (数据库中的 BCrypt hash)
|
||
|
|
|
||
|
|
### 2. 课程包列表页 ✅
|
||
|
|
|
||
|
|
- [x] 进入课程包列表页成功
|
||
|
|
- [x] 显示现有课程包数据 (找到 1 个课程包)
|
||
|
|
|
||
|
|
### 3. 课程包创建页 ⚠️
|
||
|
|
|
||
|
|
- [x] 进入创建页面成功
|
||
|
|
- [x] 加载 7 个步骤组件成功
|
||
|
|
- [x] 填写基本信息成功
|
||
|
|
- [ ] 保存功能 - **需要修复 API 方法名**
|
||
|
|
|
||
|
|
**问题**: `courseControllerCreate` 方法不存在，应使用生成的 API 方法名
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 发现的问题
|
||
|
|
|
||
|
|
### 问题 1: API 生成配置问题
|
||
|
|
**描述**: 前端 API 配置指向旧后端 (3000端口)
|
||
|
|
**修复**: 已更新 `orval.config.ts` 和 `vite.config.ts` 指向 Java 后端 (8080端口)
|
||
|
|
|
||
|
|
### 问题 2: 登录字段名不匹配
|
||
|
|
**描述**: 后端期望 `username` 字段，前端发送 `account`
|
||
|
|
**修复**: 已修改 `src/api/auth.ts` 将 `account` 映射到 `username`
|
||
|
|
|
||
|
|
### 问题 3: 登录响应格式不匹配
|
||
|
|
**描述**: 后端返回 `{token, userId, username, ...}`，前端期望 `{token, user: {...}}`
|
||
|
|
**修复**: 已修改 `src/stores/user.ts` 适配后端响应格式
|
||
|
|
|
||
|
|
### 问题 4: API 导入错误
|
||
|
|
**描述**: `src/api/course.ts` 导入 `getApi` 但生成的代码导出 `getReadingPlatformAPI`
|
||
|
|
**修复**: 已更新 `src/api/course.ts` 的导入
|
||
|
|
|
||
|
|
### 问题 5: API 方法名不匹配 (待修复)
|
||
|
|
**描述**: 前端使用 `courseController*` 格式的方法名，但生成的是不同格式
|
||
|
|
|
||
|
|
**需要修复的映射**:
|
||
|
|
| 前端使用 | 生成的方法 | 正确的方法 |
|
||
|
|
|----------|-----------|-----------|
|
||
|
|
| `courseControllerFindAll` | ❌ | `getCoursePage1` |
|
||
|
|
| `courseControllerCreate` | ❌ | `createCourse` |
|
||
|
|
| `courseControllerUpdate` | ✅ | `updateCourse` |
|
||
|
|
| `courseControllerRemove` | ❌ | `deleteCourse` |
|
||
|
|
| `courseControllerPublish` | ❌ | `publishCourse` |
|
||
|
|
| `courseControllerUnpublish` | ❌ | `archiveCourse` |
|
||
|
|
|
||
|
|
**修复方案**: 更新 `src/api/course.ts` 中所有 API 方法调用
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 截图保存位置
|
||
|
|
|
||
|
|
- `/tmp/admin_test_01_login.png`
|
||
|
|
- `/tmp/admin_test_02_after_login.png`
|
||
|
|
- `/tmp/admin_test_03_course_list.png`
|
||
|
|
- `/tmp/admin_test_04_list_detail.png`
|
||
|
|
- `/tmp/admin_test_05_create_page.png`
|
||
|
|
- `/tmp/admin_test_06_form_filled.png`
|
||
|
|
- `/tmp/admin_test_07_steps.png`
|
||
|
|
- `/tmp/admin_test_08_after_save.png`
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 下一步行动
|
||
|
|
|
||
|
|
1. ✅ 修复 `src/api/course.ts` 中的 API 方法名 - **已完成**
|
||
|
|
2. ✅ **创建数据库迁移脚本** - **已完成**
|
||
|
|
3. ✅ **执行数据库迁移** - **已完成**
|
||
|
|
4. ✅ **后端 API 测试成功** - **已完成**
|
||
|
|
5. ✅ **修复前端响应处理** - **已完成**
|
||
|
|
- 修复 `src/api/generated/mutator.ts` 的 Blob 响应处理
|
||
|
|
6. ✅ **课程包创建成功！** - **已完成**
|
||
|
|
- 登录成功
|
||
|
|
- 进入创建页面成功
|
||
|
|
- 填写表单成功
|
||
|
|
- 保存草稿成功
|
||
|
|
- 获得课程 ID: 7
|
||
|
|
|
||
|
|
7. 测试课程包编辑、删除功能
|
||
|
|
8. 测试发布/下架功能
|
||
|
|
9. 测试其他超管端功能模块
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 成功截图
|
||
|
|
|
||
|
|
- `/tmp/admin_test_01_login.png`
|
||
|
|
- `/tmp/admin_test_02_after_login.png`
|
||
|
|
- `/tmp/admin_test_03_course_list.png`
|
||
|
|
- `/tmp/admin_test_04_list_detail.png`
|
||
|
|
- `/tmp/admin_test_05_create_page.png`
|
||
|
|
- `/tmp/admin_test_06_form_filled.png`
|
||
|
|
- `/tmp/admin_test_07_steps.png`
|
||
|
|
- `/tmp/admin_test_08_after_save.png`
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 已修复的问题总结
|
||
|
|
|
||
|
|
| 问题 | 状态 |
|
||
|
|
|------|------|
|
||
|
|
| API 配置指向旧后端 | ✅ 已修复 |
|
||
|
|
| 登录字段名不匹配 | ✅ 已修复 |
|
||
|
|
| 登录响应格式不匹配 | ✅ 已修复 |
|
||
|
|
| API 导入错误 | ✅ 已修复 |
|
||
|
|
| API 方法名不匹配 | ✅ 已修复 |
|
||
|
|
| baseURL 双重路径 | ✅ 已修复 |
|
||
|
|
| 数据库表缺失 | ⚠️ 需要手动执行迁移 |
|