[T.16] 团队项目：Beta 阶段测试报告

团队项目：Beta 阶段测试报告

这个作业属于哪个课程	北航2026年春季软件工程
这个作业的要求在哪里	[T.16] 团队项目：Beta 阶段测试报告
我在这个课程的目标是	体验完整软件开发流程，交付一款真正解决科研阅读痛点的软件产品
这个作业在哪个具体方面帮助我实现目标	完成 Beta 阶段测试报告

一、Bug 统计与处理情况

Beta 阶段我们一共发现了 40 个 Bug，其中 P0 阻塞级 Bug 7 个，P1 严重级 Bug 15 个，P2 一般级 Bug 13 个，P3 建议级 Bug 5 个。
下表选取其中具有代表性的关键 Bug 进行详细说明（覆盖全部 7 个 P0 级 Bug 及主要 P1/P2 级问题），未在表中列出的其余 Bug 主要为同类偶发问题及 UI 细节优化，均已同步在飞书项目管理中追踪处理

Bug 描述	严重程度	状态	处理情况
图谱交互中拖动节点时信息弹窗与节点分离偏移	P0 阻塞级	已修复	重构弹窗定位逻辑，使用相对 Canvas 坐标配合 getBoundingClientRect 实时计算节点位置，绑定拖拽事件并结合 requestAnimationFrame 优化
上传重复 PDF 后流程未正确终止	P0 阻塞级	已修复	前端使用 Pinia 管理上传状态，组件卸载时调用 uploadStore.clearState() 并执行 abortController?.abort()
数据库在服务器的版本与后端不匹配	P0 阻塞级	已修复	修复数据库版本兼容性问题
批量上传 Celery 并发池与异步数据库冲突导致部分 PDF 解析失败	P0 阻塞级	已修复	增加同步数据库 CRUD 操作解决并发冲突
JWT 刷新失败导致 Token 过期后无法续期	P0 阻塞级	已修复	完善 Token 刷新机制
用户数据隔离漏洞（水平/垂直越权）	P0 阻塞级	已修复	后端视图层校验 request.user.id 与资源所属用户一致性
知识图谱全屏模式下节点详情侧边栏位置偏移	P0 阻塞级	已修复	侧边栏改为相对定位并监听窗口 resize 事件
“最近论文”筛选导致语义关联连线消失	P1 严重	已修复	采用 D3 的 enter-update-exit 模式重构力导向图边数据绑定，筛选后无残留连线
扫描版 PDF 解析失败，仅支持文本提取	P1 严重	已修复	增加提示说明，后续计划引入 OCR 支持
后端 LLM 图结构生成 JSON 格式校验不通过	P1 严重	已修复	设计 Prompt 模板约束输出格式，定义 cluster 字段用于前端颜色映射
图谱编辑后端仅支持自定义内容，系统生成内容无法编辑	P1 严重	已修复	修改后端实现对系统生成内容的基础编辑
论文检索功能失效	P1 严重	已修复	修复检索接口调用逻辑
Celery 异步任务 PDF 解析状态流转异常	P1 严重	已修复	完善“待解析→解析中→待确认→已确认”状态流转逻辑
笔记与 PDF 联动响应时间偏慢	P2 一般	未修复	需优化联动响应逻辑，目标 <500ms
富文本编辑器跨浏览器 LaTeX 渲染不一致	P2 一般	未修复	Safari 下部分 LaTeX 渲染异常，计划优化
高亮批注数据持久化保存偶发失败	P2 一般	已修复	完善标注数据的存储与回显逻辑
前端单元测试覆盖率未达预期	P2 一般	已修复	补充 PDF 预览、知识图谱可视化等关键组件测试
后端 API 集成测试未覆盖全部 P0 接口	P2 一般	已修复	补充密码重置、JWT 刷新、LLM 图结构生成等接口测试

二、场景测试

场景一：研一新生张三的文献调研

张三刚拿到毕业设计题目，对方向还很陌生，导师给了他几篇种子论文，让他先摸清领域脉络。他需要快速注册、检索、导入论文、提取要点，再通过图谱理解论文之间的关联。

操作步骤	预期结果	实际结果	涉及功能
打开 Scider，用邮箱注册并登录	注册成功，自动跳转首页	通过	邮箱注册、JWT 登录
在“发现论文”页面进行关键词检索	返回语义匹配的论文列表，含标题、作者、年份、摘要	通过（检索功能曾失效，已在 Meeting 15 前修复）	关键词检索、Semantic Scholar 对接
从列表中选 3 篇论文，逐一点击“导入”	论文进入解析队列，状态显示“解析中”，完成后跳转“我的文库”	通过	单篇导入、异步解析触发
等待解析完成，在“我的文库”中查看论文详情	四要素（背景/方法/创新点/结论）提取完成，状态变为“待确认”	通过	PDF 解析、四要素提取
进入知识图谱查看论文聚类	节点按研究主题自动聚类，不同颜色区分	通过	LLM 图结构生成与聚类展示
在 PDF 阅读器中使用文本搜索定位关键内容	搜索结果高亮显示，支持跳转到匹配位置	通过	PDF 内文字搜索
在阅读过程中添加高亮批注和笔记	标注数据持久化保存，重新打开后仍可见	部分通过（偶发保存失败已修复）	文本高亮批注、笔记存储

场景二：研二李四的系统性文献综述

李四正在撰写文献综述，需要从宏观上把握某一研究方向的全景，同时深度阅读关键论文并沉淀笔记。他需要批量导入、图谱编辑、AI 问答和笔记导出。

操作步骤	预期结果	实际结果	涉及功能
登录后进入“发现论文”，按研究方向检索	返回相关论文列表	通过	方向推荐、论文检索
批量导入 10 篇论文	论文进入解析队列，全部完成四要素提取	部分通过（批量上传并发冲突已修复）	批量上传、异步解析
进入知识图谱，拖拽节点调整布局、缩放查看细节	力导向图交互流畅，节点位置实时更新	通过	D3.js 图谱交互
手动添加新节点、删除无关节点、编辑节点属性	图谱编辑实时生效并持久化存储	通过	图谱编辑功能（增删改节点/边）
在 PDF 阅读界面使用 AI 问答助手提问	返回基于当前论文全文内容的 RAG 回答	通过	PDF 场景 RAG 问答
在知识图谱界面使用 AI 问答助手提问	返回基于图谱结构与论文关联信息的 GraphRAG 回答	通过	知识图谱场景问答
将当前知识图谱视图导出为 PNG 图片	导出成功，图片清晰	通过	图谱导出
将笔记导出为 Markdown 文件	导出格式正确，含 LaTeX 公式	通过	笔记导出

场景三：忘记密码的王五

王五有一段时间没用 Scider，忘记了密码。他需要通过邮箱重置密码，重新获得账号访问权限。

操作步骤	预期结果	实际结果	涉及功能
点击登录页面的“忘记密码”链接	跳转到密码重置页面，显示三步流程界面	通过	密码重置前端页面
输入注册邮箱，点击“获取验证码”	验证码发送到邮箱，防刷机制生效（限制每分钟请求次数）	通过	邮箱验证码发送、API 限流防刷
输入收到的验证码，设置新密码并确认提交	密码重置成功，跳转回登录页	通过	密码重置接口
使用新密码登录	登录成功，进入首页	通过	JWT 登录

三、测试矩阵

以下是在不同平台、硬件配置和浏览器上对 Scider 进行的兼容性测试结果。

平台	硬件配置	浏览器	PDF 阅读器	图谱交互	富文本编辑器	测试结果
Windows 11	Intel i7 / 16GB RAM / SSD	Chrome 124+	✅	✅	✅	通过
Windows 10	Intel i5 / 8GB RAM / HDD	Edge 124+	✅	✅	✅	通过
macOS 14 (Sonoma)	Apple M2 / 16GB RAM	Chrome 124+	✅	✅	✅	通过
macOS 14 (Sonoma)	Apple M2 / 16GB RAM	Firefox 125+	✅	✅	✅	通过
Ubuntu 22.04 LTS	Intel i5 / 16GB RAM	Chrome 124+	✅	✅	✅	通过

四、Beta 版本出口条件

Scider Beta 版本的发布需满足以下条件：

出口条件描述	达成情况	说明
Alpha 阶段遗留的 3 个中等 Bug（图谱拖动弹窗分离、上传重复 PDF 流程未终止、"最近论文"筛选导致连线消失）全部修复	已达成	3 个 Bug 均在 Beta 阶段修复并通过回归验证
Beta 阶段发现的 7 个 P0 阻塞级 Bug 修复率达到 100%	已达成	7 个 P0 Bug 全部修复并通过回归验证
核心功能模块（用户认证、文库管理、PDF 阅读与标注、笔记与知识管理、知识图谱、AI 问答助手）测试通过率 ≥ 95%	已达成	实测通过率 96.8%
前端单元测试（Vitest）覆盖 PDF 预览、图谱可视化等关键组件	已达成	覆盖率 ≥ 70%
后端 API 集成测试（pytest + httpx）覆盖密码重置、JWT 刷新、LLM 图结构生成等接口	已达成	全部 P0 接口已覆盖
端到端全流程回归测试（Playwright）通过	已达成	完整路径：注册→上传→解析→图谱→笔记→问答→密码重置，全部通过
安全测试（越权、XSS/CSRF 防护、API 限流防刷）全部通过	已达成	水平/垂直越权测试、输入点恶意脚本过滤、验证码/登录/AI 问答接口限流策略均通过
跨浏览器（Chrome/Firefox/Edge）与跨操作系统（Windows/macOS/Linux）完整矩阵测试通过	已达成	主流操作系统与浏览器全部通过
后端一键部署脚本完成（环境初始化、依赖安装、数据库迁移、启动服务）；生产环境部署演练与回滚验证通过	已达成	部署脚本含 rollback 分支逻辑，回滚验证数据无损、服务快速恢复

综上，Scider 已达到 Beta 版本的发布标准。Beta 版本定于 2026 年 6 月 14 日发布，面向目标用户（本科生和低年级研究生）开放测试。剩余 P2/P3 级问题及已知限制将在 Beta 阶段持续迭代优化。