# 超管端功能测试记录

**日期**: 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 双重路径 | ✅ 已修复 |
| 数据库表缺失 | ⚠️ 需要手动执行迁移 |
