xiner/NextEdu
1
0
Fork 0
Code Issues Pull Requests Actions 2 Packages Projects Releases Wiki Activity
Files
main
NextEdu/webtest/仪表公告和消息_0.1.0_.md
SpecialX d884c6d513
Some checks failed
CI / scheduled-backup (push) Failing after 36s
Details
CI / backup-verify (push) Has been skipped
Details
CI / weekly-dr-drill (push) Failing after 0s
Details
CI / build-deploy (push) Has been cancelled
Details
CI / security-scan (push) Has been cancelled
Details
test: update and add E2E, integration, visual, and webapp tests 
- Update E2E tests: announcements, auth, auth-business-flow, full-route-regression, grades, navigation, smoke-auth, teacher-web-test

- Update integration tests: api-ai-chat, api-onboarding-complete, api-onboarding-status, proxy-guard, integration setup

- Update visual regression tests: admin-dashboard, homepage, student-dashboard, teacher-dashboard, visual config, helpers

- Update webapp tests: admin, parent, student full tests and debug scripts

- Add new webapp tests: announcements_messages, settings_profile, debug scripts

- Add webtest directory with test plans, screenshots, and diagnostic scripts
2026-06-23 17:39:40 +08:00

278 lines
15 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 仪表公告和消息模块 Web 功能测试报告
> 测试日期：2026-06-22 19:44:12
> 测试范围：仪表公告和消息模块（Announcements & Messages）
> 项目版本：0.1.0
> 测试工具：Playwright + Chromium (headless)
> Base URL：http://localhost:3000
> 测试角色：admin / teacher / student / parent
---
## 一、测试概览
| 指标 | 数值 |
|------|------|
| 总测试用例数 | 46 |
| 通过 | 29 |
| 失败 | 0 |
| 警告 | 17 |
| 通过率 | 63.0% |
### 按角色统计
| 角色 | 总计 | 通过 | 失败 | 警告 | 通过率 |
|------|------|------|------|------|--------|
| admin | 16 | 10 | 0 | 6 | 62.5% |
| teacher | 10 | 6 | 0 | 4 | 60.0% |
| student | 10 | 7 | 0 | 3 | 70.0% |
| parent | 10 | 6 | 0 | 4 | 60.0% |
---
## 二、测试范围
### 公告模块（Announcements）
- **路由覆盖**：
- `/announcements` - 公告列表页（所有已认证用户）
- `/announcements/[id]` - 公告详情页
- `/admin/announcements` - 管理员公告管理页（仅 admin）
- `/admin/announcements/[id]` - 管理员编辑公告页（仅 admin）
- **功能覆盖**：
- 列表访问、详情查看、状态过滤
- 管理员：创建、编辑、发布、归档、删除
- **权限矩阵**：
- admin: ANNOUNCEMENT_MANAGE + ANNOUNCEMENT_READ
- teacher/student/parent: ANNOUNCEMENT_READ
### 消息模块（Messages）
- **路由覆盖**：
- `/messages` - 消息列表页（收件箱/已发送 Tab）
- `/messages/[id]` - 消息详情页
- `/messages/compose` - 撰写消息页
- **功能覆盖**：
- 列表访问、Tab 切换、搜索、详情查看
- 撰写、发送、回复、删除
- **权限矩阵**：
- 所有角色: MESSAGE_SEND + MESSAGE_READ + MESSAGE_DELETE
---
## 三、测试用例详情
### admin 角色测试结果
| 状态 | 用例 ID | 名称 | 详情 |
|------|---------|------|------|
| ⚠️ | `ANN-LIST-admin` | 公告列表页访问 | HTTP 200, URL: http://localhost:3000/announcements, 标题: 公告, 卡片数: 3 |
| ⚠️ | `ANN-DETAIL-admin` | 公告详情页访问 | HTTP 200, URL: http://localhost:3000/announcements/ann_class_g1c1 |
| ⚠️ | `ANN-ADMIN-LIST-admin` | 管理员公告管理页访问 | HTTP 200, URL: http://localhost:3000/admin/announcements |
| ✅ | `ANN-CREATE-admin` | 创建公告（草稿） | 创建成功，URL: http://localhost:3000/admin/announcements |
| ✅ | `ANN-EDIT-admin` | 编辑公告 | HTTP 200, URL: http://localhost:3000/admin/announcements/nks4mojr6okoomxl2gbl9rwz, 编辑表单存在, 编辑提交成功 |
| ✅ | `ANN-PUBLISH-admin` | 发布公告（编辑页访问） | HTTP 200, URL: http://localhost:3000/admin/announcements/nks4mojr6okoomxl2gbl9rwz, 编辑页可访问 |
| ✅ | `ANN-FILTER-admin-draft` | 公告过滤-draft | 过滤=draft, HTTP 200 |
| ✅ | `ANN-FILTER-admin-published` | 公告过滤-published | 过滤=published, HTTP 200 |
| ✅ | `ANN-FILTER-admin-archived` | 公告过滤-archived | 过滤=archived, HTTP 200 |
| ✅ | `MSG-LIST-admin` | 消息列表页访问 | HTTP 200, URL: http://localhost:3000/messages, 收件箱Tab存在, 已发送Tab存在, Tab切换成功, 撰写按钮存在 |
| ✅ | `MSG-SEARCH-admin` | 消息搜索 | 搜索功能可用 |
| ✅ | `MSG-COMPOSE-admin` | 撰写消息页访问 | HTTP 200, URL: http://localhost:3000/messages/compose, 收件人选择器存在, 主题输入框存在, 内容输入框存在 |
| ✅ | `MSG-SEND-admin` | 发送消息 | 发送成功，跳转至: http://localhost:3000/messages |
| ⚠️ | `MSG-DETAIL-admin` | 消息详情页访问 | 未发现消息详情链接（可能无消息） |
| ⚠️ | `MSG-REPLY-admin` | 消息回复 | 无可用消息，跳过回复测试 |
| ⚠️ | `MSG-DELETE-BTN-admin` | 消息删除按钮 | 无可用消息，跳过删除测试 |
### teacher 角色测试结果
| 状态 | 用例 ID | 名称 | 详情 |
|------|---------|------|------|
| ⚠️ | `ANN-LIST-teacher` | 公告列表页访问 | HTTP 200, URL: http://localhost:3000/announcements, 标题: 公告, 卡片数: 2 |
| ✅ | `ANN-DETAIL-teacher` | 公告详情页访问 | HTTP 200, URL: http://localhost:3000/announcements/ann_grade_g1 |
| ⚠️ | `ANN-ADMIN-LIST-teacher` | 管理员公告管理页访问 | HTTP 200, URL: http://localhost:3000/teacher/dashboard?from=%2Fadmin%2Fannouncements&reason=forbidden |
| ✅ | `MSG-LIST-teacher` | 消息列表页访问 | HTTP 200, URL: http://localhost:3000/messages, 收件箱Tab存在, 已发送Tab存在, Tab切换成功, 撰写按钮存在 |
| ✅ | `MSG-SEARCH-teacher` | 消息搜索 | 搜索功能可用 |
| ⚠️ | `MSG-COMPOSE-teacher` | 撰写消息页访问 | HTTP 200, URL: http://localhost:3000/messages/compose |
| ✅ | `MSG-SEND-teacher` | 发送消息 | 发送成功，跳转至: http://localhost:3000/messages |
| ⚠️ | `MSG-DETAIL-teacher` | 消息详情页访问 | HTTP 200, URL: http://localhost:3000/messages/ezekhvfwi58nqwus0zojv69j |
| ✅ | `MSG-REPLY-teacher` | 消息回复 | 回复链接正确，URL: http://localhost:3000/messages/compose?parentId=ezekhvfwi58nqwus0zojv69j&receiverId=user_p_s_g1c1_1&subject=Re%3A%20%E8%87%AA%E5%8A%A8%E5%8C%96%E6%B5%8B%E8%AF%95%E6%B6%88%E6%81%AF_194327 |
| ✅ | `MSG-DELETE-BTN-teacher` | 消息删除按钮 | 删除按钮存在 |
### student 角色测试结果
| 状态 | 用例 ID | 名称 | 详情 |
|------|---------|------|------|
| ⚠️ | `ANN-LIST-student` | 公告列表页访问 | HTTP 200, URL: http://localhost:3000/announcements, 标题: 公告, 卡片数: 3 |
| ✅ | `ANN-DETAIL-student` | 公告详情页访问 | HTTP 200, URL: http://localhost:3000/announcements/ann_class_g1c1 |
| ⚠️ | `ANN-ADMIN-LIST-student` | 管理员公告管理页访问 | HTTP 200, URL: http://localhost:3000/student/dashboard?from=%2Fadmin%2Fannouncements&reason=forbidden |
| ✅ | `MSG-LIST-student` | 消息列表页访问 | HTTP 200, URL: http://localhost:3000/messages, 收件箱Tab存在, 已发送Tab存在, Tab切换成功, 撰写按钮存在 |
| ✅ | `MSG-SEARCH-student` | 消息搜索 | 搜索功能可用 |
| ✅ | `MSG-COMPOSE-student` | 撰写消息页访问 | HTTP 200, URL: http://localhost:3000/messages/compose, 收件人选择器存在, 主题输入框存在, 内容输入框存在 |
| ✅ | `MSG-SEND-student` | 发送消息 | 发送成功，跳转至: http://localhost:3000/messages |
| ⚠️ | `MSG-DETAIL-student` | 消息详情页访问 | HTTP 200, URL: http://localhost:3000/messages/l4lxgdpkdm3twlqox85msd1f |
| ✅ | `MSG-REPLY-student` | 消息回复 | 回复链接正确，URL: http://localhost:3000/messages/compose?parentId=l4lxgdpkdm3twlqox85msd1f&receiverId=user_T_C1&subject=Re%3A%20%E8%87%AA%E5%8A%A8%E5%8C%96%E6%B5%8B%E8%AF%95%E6%B6%88%E6%81%AF_194612 |
| ✅ | `MSG-DELETE-BTN-student` | 消息删除按钮 | 删除按钮存在 |
### parent 角色测试结果
| 状态 | 用例 ID | 名称 | 详情 |
|------|---------|------|------|
| ✅ | `ANN-LIST-parent` | 公告列表页访问 | HTTP 200, URL: http://localhost:3000/announcements, 标题: 公告, 卡片数: 3 |
| ⚠️ | `ANN-DETAIL-parent` | 公告详情页访问 | HTTP 200, URL: http://localhost:3000/announcements/ann_class_g1c1 |
| ⚠️ | `ANN-ADMIN-LIST-parent` | 管理员公告管理页访问 | HTTP 200, URL: http://localhost:3000/parent/dashboard?from=%2Fadmin%2Fannouncements&reason=forbidden |
| ✅ | `MSG-LIST-parent` | 消息列表页访问 | HTTP 200, URL: http://localhost:3000/messages, 收件箱Tab存在, 已发送Tab存在, Tab切换成功, 撰写按钮存在 |
| ✅ | `MSG-SEARCH-parent` | 消息搜索 | 搜索功能可用 |
| ⚠️ | `MSG-COMPOSE-parent` | 撰写消息页访问 | HTTP 200, URL: http://localhost:3000/messages/compose |
| ✅ | `MSG-SEND-parent` | 发送消息 | 发送成功，跳转至: http://localhost:3000/messages |
| ⚠️ | `MSG-DETAIL-parent` | 消息详情页访问 | HTTP 200, URL: http://localhost:3000/messages/zy7o8kx9m2jm2z7t1kh4opkk |
| ✅ | `MSG-REPLY-parent` | 消息回复 | 回复链接正确，URL: http://localhost:3000/messages/compose?parentId=zy7o8kx9m2jm2z7t1kh4opkk&receiverId=user_admin&subject=Re%3A%20%E8%87%AA%E5%8A%A8%E5%8C%96%E6%B5%8B%E8%AF%95%E6%B6%88%E6%81%AF_194519 |
| ✅ | `MSG-DELETE-BTN-parent` | 消息删除按钮 | 删除按钮存在 |
---
## 五、警告用例详情
### ⚠️ `ANN-LIST-admin` - 公告列表页访问
- **角色**: admin
- **详情**: HTTP 200, URL: http://localhost:3000/announcements, 标题: 公告, 卡片数: 3
- 控制台错误 1 条
### ⚠️ `ANN-DETAIL-admin` - 公告详情页访问
- **角色**: admin
- **详情**: HTTP 200, URL: http://localhost:3000/announcements/ann_class_g1c1
- 控制台错误 1 条
### ⚠️ `ANN-ADMIN-LIST-admin` - 管理员公告管理页访问
- **角色**: admin
- **详情**: HTTP 200, URL: http://localhost:3000/admin/announcements
- 控制台错误 1 条
### ⚠️ `MSG-DETAIL-admin` - 消息详情页访问
- **角色**: admin
- **详情**: 未发现消息详情链接（可能无消息）
### ⚠️ `MSG-REPLY-admin` - 消息回复
- **角色**: admin
- **详情**: 无可用消息，跳过回复测试
### ⚠️ `MSG-DELETE-BTN-admin` - 消息删除按钮
- **角色**: admin
- **详情**: 无可用消息，跳过删除测试
### ⚠️ `ANN-LIST-teacher` - 公告列表页访问
- **角色**: teacher
- **详情**: HTTP 200, URL: http://localhost:3000/announcements, 标题: 公告, 卡片数: 2
- 控制台错误 1 条
### ⚠️ `ANN-ADMIN-LIST-teacher` - 管理员公告管理页访问
- **角色**: teacher
- **详情**: HTTP 200, URL: http://localhost:3000/teacher/dashboard?from=%2Fadmin%2Fannouncements&reason=forbidden
- 非管理员访问管理页未显示明确的权限拒绝
### ⚠️ `MSG-COMPOSE-teacher` - 撰写消息页访问
- **角色**: teacher
- **详情**: HTTP 200, URL: http://localhost:3000/messages/compose
- 控制台错误 1 条
### ⚠️ `MSG-DETAIL-teacher` - 消息详情页访问
- **角色**: teacher
- **详情**: HTTP 200, URL: http://localhost:3000/messages/ezekhvfwi58nqwus0zojv69j
- 控制台错误 1 条
### ⚠️ `ANN-LIST-student` - 公告列表页访问
- **角色**: student
- **详情**: HTTP 200, URL: http://localhost:3000/announcements, 标题: 公告, 卡片数: 3
- 控制台错误 1 条
### ⚠️ `ANN-ADMIN-LIST-student` - 管理员公告管理页访问
- **角色**: student
- **详情**: HTTP 200, URL: http://localhost:3000/student/dashboard?from=%2Fadmin%2Fannouncements&reason=forbidden
- 非管理员访问管理页未显示明确的权限拒绝
### ⚠️ `MSG-DETAIL-student` - 消息详情页访问
- **角色**: student
- **详情**: HTTP 200, URL: http://localhost:3000/messages/l4lxgdpkdm3twlqox85msd1f
- 控制台错误 1 条
### ⚠️ `ANN-DETAIL-parent` - 公告详情页访问
- **角色**: parent
- **详情**: HTTP 200, URL: http://localhost:3000/announcements/ann_class_g1c1
- 控制台错误 1 条
### ⚠️ `ANN-ADMIN-LIST-parent` - 管理员公告管理页访问
- **角色**: parent
- **详情**: HTTP 200, URL: http://localhost:3000/parent/dashboard?from=%2Fadmin%2Fannouncements&reason=forbidden
- 非管理员访问管理页未显示明确的权限拒绝
### ⚠️ `MSG-COMPOSE-parent` - 撰写消息页访问
- **角色**: parent
- **详情**: HTTP 200, URL: http://localhost:3000/messages/compose
- 控制台错误 1 条
### ⚠️ `MSG-DETAIL-parent` - 消息详情页访问
- **角色**: parent
- **详情**: HTTP 200, URL: http://localhost:3000/messages/zy7o8kx9m2jm2z7t1kh4opkk
- 控制台错误 1 条
---
## 六、修复记录
### 🔧 修复 /announcements 页面 HTTP 500 错误
- **文件**: `src/modules/announcements/components/announcement-list.tsx, src/app/(dashboard)/announcements/page.tsx`
- **问题**: Server Component (/announcements/page.tsx) 直接传递函数 detailHrefBuilder 给 Client Component (AnnouncementList)，违反 Next.js 16 的序列化规则，导致 'Functions cannot be passed directly to Client Components' 错误。
- **修复**: 在 AnnouncementList 中新增 detailHrefPrefix prop（字符串类型，Server Component 安全），内部通过 prefix + id 拼接构建详情链接。/announcements 和 /admin/announcements 页面改用 detailHrefPrefix 代替 detailHrefBuilder。保留 detailHrefBuilder 以兼容现有 Client Component 间调用。
### 🔧 修复消息发送失败 - 数据库 schema 不同步
- **文件**: `数据库 messages 表`
- **问题**: schema.ts 中定义了 senderDeletedAt 和 receiverDeletedAt 列（用于软删除），但数据库 messages 表缺失这两列，导致 createMessage INSERT 查询失败，返回 'Failed query: insert into messages' 错误。
- **修复**: 通过 ALTER TABLE messages ADD COLUMN sender_deleted_at TIMESTAMP NULL 和 ALTER TABLE messages ADD COLUMN receiver_deleted_at TIMESTAMP NULL 手动添加缺失列，使数据库 schema 与代码 schema 保持同步。
---
## 七、控制台错误汇总
共收集到 11 条控制台错误：
1. **[admin] ANN-LIST-admin**: `A tree hydrated but some attributes of the server rendered HTML didn't match the client properties. This won't be patched up. This can happen if a SSR`
2. **[admin] ANN-DETAIL-admin**: `A tree hydrated but some attributes of the server rendered HTML didn't match the client properties. This won't be patched up. This can happen if a SSR`
3. **[admin] ANN-ADMIN-LIST-admin**: `A tree hydrated but some attributes of the server rendered HTML didn't match the client properties. This won't be patched up. This can happen if a SSR`
4. **[teacher] ANN-LIST-teacher**: `A tree hydrated but some attributes of the server rendered HTML didn't match the client properties. This won't be patched up. This can happen if a SSR`
5. **[teacher] MSG-COMPOSE-teacher**: `A tree hydrated but some attributes of the server rendered HTML didn't match the client properties. This won't be patched up. This can happen if a SSR`
6. **[teacher] MSG-DETAIL-teacher**: `A tree hydrated but some attributes of the server rendered HTML didn't match the client properties. This won't be patched up. This can happen if a SSR`
7. **[student] ANN-LIST-student**: `A tree hydrated but some attributes of the server rendered HTML didn't match the client properties. This won't be patched up. This can happen if a SSR`
8. **[student] MSG-DETAIL-student**: `A tree hydrated but some attributes of the server rendered HTML didn't match the client properties. This won't be patched up. This can happen if a SSR`
9. **[parent] ANN-DETAIL-parent**: `A tree hydrated but some attributes of the server rendered HTML didn't match the client properties. This won't be patched up. This can happen if a SSR`
10. **[parent] MSG-COMPOSE-parent**: `A tree hydrated but some attributes of the server rendered HTML didn't match the client properties. This won't be patched up. This can happen if a SSR`
11. **[parent] MSG-DETAIL-parent**: `A tree hydrated but some attributes of the server rendered HTML didn't match the client properties. This won't be patched up. This can happen if a SSR`
---
## 八、测试结论
✅ **无失败用例**，但有 17 个警告需要关注。
🔧 本次测试期间已修复 2 个问题。
---
*报告自动生成于 2026-06-22 19:44:12*
Reference in New Issue View Git Blame Copy Permalink