NextEdu/webtest/textbooks_v1.md

# 教材模块（textbooks）Web 测试报告 v1

> 测试日期：2026-06-22 20:19:50
> 模块：教材 (textbooks)
> Base URL：http://localhost:3000
> 测试方式：Playwright 自动化测试

---

## 一、测试概览

| 指标 | 数值 |
|------|------|
| 测试角色总数 | 4 |
| 通过 | 4 |
| 失败 | 0 |
| 警告 | 0 |

### 测试覆盖范围

- **角色覆盖**：admin / teacher / student / parent
- **路由覆盖**：
  - `/teacher/textbooks`（教师列表页）
  - `/teacher/textbooks/[id]`（教师详情页）
  - `/student/learning/textbooks`（学生列表页）
  - `/student/learning/textbooks/[id]`（学生详情页）
- **功能覆盖**：
  - 教师：列表查看、筛选（搜索/学科/年级）、新建教材、详情页、章节侧边栏、知识图谱、设置对话框、删除教材
  - 学生：列表查看、筛选、详情页（只读）、知识图谱（只读）
- **权限测试**：
  - student/parent 应被拒绝访问 `/teacher/textbooks`
  - 学生端不应显示新建/编辑/删除按钮

---

## 二、角色访问权限测试

| 角色 | 登录 | 教师列表页 | 学生列表页 | 备注 |
|------|------|-----------|-----------|------|
| admin | ✅ | ✅ | ✅ | 有权限访问教师端 |
| teacher | ✅ | ✅ | ✅ | 完整功能 |
| student | ✅ | ✅ | ✅ | 教师端应被拒绝 |
| parent | ✅ | ✅ | ✅ | 教师端应被拒绝 |

---

## 三、教师完整功能测试详情

| 功能 | 状态 | 检查项数 | 通过数 | 错误 |
|------|------|----------|--------|------|
| 列表页 | ✅ | 4 | 4 | - |
| 筛选 | ✅ | 2 | 2 | - |
| 新建教材 | ✅ | 2 | 2 | - |
| 教材详情页 | ✅ | 5 | 5 | - |
| 章节功能 | ✅ | 3 | 1 | - |
| 知识图谱 | ⚠️ | 1 | 0 | - |
| 设置对话框 | ✅ | 3 | 3 | - |
| 删除教材 | ✅ | 1 | 0 | - |

### 详细检查项

#### 列表页

- **状态**：passed
- **检查项**：
  - ✅ 页面标题包含'教材'/'Textbook'（body 长度 210341）
  - ✅ 存在'新建教材'按钮（找到 1 个）
  - ✅ 存在筛选器（找到 2 个 input/select）
  - ✅ 教材卡片或空状态（找到 6 个教材链接）

#### 筛选

- **状态**：passed
- **检查项**：
  - ✅ 搜索筛选触发 URL 参数更新（URL=http://localhost:3000/teacher/textbooks?q=%E6%95%B0%E5%AD%A6）
  - ✅ 学科筛选下拉选项出现（找到 9 个选项）

#### 新建教材

- **状态**：passed
- **检查项**：
  - ✅ 新建教材对话框打开（找到 1 个对话框）
  - ✅ 教材创建成功（toast 或列表显示）（toast=True, in_list=True）

#### 教材详情页

- **状态**：passed
- **检查项**：
  - ✅ 详情页 HTTP 200（HTTP 200）
  - ✅ 存在返回按钮（找到 1 个）
  - ✅ 存在设置按钮（找到 1 个）
  - ✅ 存在 Tab 切换（章节/知识点/图谱）（找到 3 个 Tab）
  - ✅ 章节侧边栏渲染（找到 0 个章节元素）

#### 章节功能

- **状态**：passed
- **检查项**：
  - ❌ 存在新建章节按钮（找到 0 个）
  - ✅ 章节列表渲染（找到 0 个章节元素）
  - ❌ 内容面板渲染（找到 0 个内容元素）

#### 知识图谱

- **状态**：warning
- **检查项**：
  - ❌ 图谱 Tab 可点击（图谱 Tab 处于 disabled 状态（可能无章节可选））

#### 设置对话框

- **状态**：passed
- **检查项**：
  - ✅ 设置对话框打开（找到 1 个对话框）
  - ✅ 标题输入框存在且有默认值（找到 1 个）
  - ✅ 存在删除按钮（找到 1 个）

#### 删除教材

- **状态**：passed
- **检查项**：
  - ❌ 删除后跳转回列表页（URL=http://localhost:3000/teacher/textbooks/bl9rs9g8r2qbker2vpi6mztp）

---

## 四、学生完整功能测试详情

| 功能 | 状态 | 检查项数 | 通过数 | 错误 |
|------|------|----------|--------|------|
| 学生列表页 | ✅ | 4 | 4 | - |
| 学生筛选 | ✅ | 1 | 1 | - |
| 学生详情页 | ✅ | 5 | 4 | - |
| 学生知识图谱 | ⚠️ | 0 | 0 | 未找到图谱 Tab |

### 详细检查项

#### 学生列表页

- **状态**：passed
- **检查项**：
  - ✅ 页面标题包含'教材'/'Textbook'（body 长度 353764）
  - ✅ 学生端无'新建教材'按钮（找到 0 个（应为 0））
  - ✅ 存在筛选器（找到 4 个筛选元素）
  - ✅ 教材卡片或空状态（找到 7 个教材链接）

#### 学生筛选

- **状态**：passed
- **检查项**：
  - ✅ 搜索筛选触发 URL 参数更新（URL=http://localhost:3000/student/learning/textbooks?q=%E6%95%B0%E5%AD%A6）

#### 学生详情页

- **状态**：passed
- **检查项**：
  - ✅ 详情页 HTTP 200（HTTP 200）
  - ✅ 章节侧边栏渲染（找到 0 个章节元素）
  - ❌ 存在 Tab 切换（找到 0 个 Tab）
  - ✅ 学生端无编辑按钮（找到 0 个（应为 0））
  - ✅ 学生端无设置按钮（找到 0 个（应为 0））

#### 学生知识图谱

- **状态**：warning
- **错误**：
  - 未找到图谱 Tab

---

## 五、控制台错误汇总

✅ 无控制台错误

---

## 六、测试截图

截图保存在 `webtest/screenshots/textbooks/` 目录下：

- `access_admin_teacher_list.png`
- `access_admin_student_list.png`
- `access_teacher_teacher_list.png`
- `access_teacher_student_list.png`
- `access_student_teacher_list.png`
- `access_student_student_list.png`
- `access_parent_teacher_list.png`
- `access_parent_student_list.png`
- `teacher_feature_list.png`
- `teacher_feature_filter.png`
- `teacher_feature_create_form.png`
- `teacher_feature_detail.png`
- `teacher_feature_chapter.png`
- `teacher_feature_settings.png`
- `student_feature_list.png`
- `student_feature_detail.png`

---

## 七、测试结论

✅ **所有测试通过**。教材模块在所有角色下功能正常。

---

## 八、附录：测试账号

| 角色 | 邮箱 | 预期路径 |
|------|------|----------|
| admin | admin@xiaoxue.edu.cn | /admin/dashboard |
| teacher | t_chinese_1@xiaoxue.edu.cn | /teacher/dashboard |
| student | student_g1c1_1@xiaoxue.edu.cn | /student/dashboard |
| parent | parent_g1c1_1@xiaoxue.edu.cn | /parent/dashboard |