首页 / 使用说明书
GitHub
使用说明书 v1.0

问天台 · 完整操作指南

本文档覆盖问天台测试质量管理平台的全部功能模块,帮助您快速掌握从项目创建到报告生成的完整测试流程。

📦 适用版本:v1.0+ 🧑‍💻 适用角色:管理员 · 测试工程师 · 开发工程师 🕐 预计阅读:15 分钟

登录系统

访问系统地址后进入登录页。左侧为卡通质检工程师动画与《天问》典故介绍,右侧填写账号密码登录。

问天台 · 登录
登录页
默认管理员账号
账号:admin 密码:Admin@123

操作步骤

  1. 在「用户名 / 邮箱」输入框中填写账号
  2. 填写密码(支持回车键快捷提交)
  3. 点击「登录」按钮,验证成功后自动跳转至仪表盘
安全提示
连续登录失败 5 次后,账号将被自动锁定 15 分钟。锁定期间需联系管理员手动解锁或等待时间到期。

仪表盘

登录后首先进入仪表盘,展示当前用户可见的项目质量数据概览。

仪表盘
仪表盘
📁
项目总数

点击可跳转至项目管理列表

📋
测试用例

点击跳转至用例管理

🐛
缺陷总数 / 待处理

点击跳转至缺陷列表

▶️
测试任务

点击跳转至执行任务

已完成任务

统计已完成的执行任务

📊
图表分析

缺陷状态、严重程度分布

数据权限说明
右上角可切换「全部项目」或特定项目范围。数据权限为「个人参与」的用户只能看到自己参与的项目数据。

项目管理

项目是所有测试活动的顶层容器,测试计划、用例、缺陷均归属于具体项目。

项目管理
项目管理

新建项目

  1. 点击右上角「新建项目」按钮
  2. 填写项目名称、描述、当前版本号
  3. 保存后项目卡片出现在列表中

项目卡片

每张卡片展示:项目名称、描述、版本、成员数、用例通过率、缺陷数、任务进度。点击卡片进入项目详情。

非管理员用户(数据权限为「个人参与」)只能看到自己被添加为成员的项目。

测试计划

测试计划将用例组织起来,并生成可分配的执行任务,是串联用例与执行的核心枢纽。

测试计划
测试计划

完整操作流程

1
新建计划填写名称、关联项目、版本、起止日期
2
添加用例从用例库中选择用例,可按模块分组
3
生成任务点击「生成执行任务」,选择执行人,批量创建
4
跟踪进度计划详情页查看所有关联任务及整体通过率

计划状态

草稿 进行中 已完成 | 已逾期 (系统自动判断,到达结束日期未完成时触发)

测试用例

测试用例是核心资产,支持树形模块管理与 Excel 批量操作。

测试用例
测试用例

模块树操作

  1. 左侧模块树:右键可新增子模块、重命名、删除
  2. 点击某个模块,右侧表格只展示该模块下的用例
  3. 点击「全部」可查看所有模块的用例

新建用例字段说明

字段说明必填
标题用例名称,简洁描述测试目标
所属模块归属的模块节点
优先级P0(最高)/ P1 / P2 / P3
类型功能 / 性能 / 接口 / 安全
前置条件执行该用例前需满足的环境或状态
测试步骤详细操作步骤,支持附件/图片上传
预期结果每步操作的预期输出

Excel 批量导入导出

📥
批量导入

① 点击「导入」→ 下载模板
② 按模板填写用例数据
③ 上传文件,系统逐行反馈成功/失败及原因

📤
批量导出

按当前筛选条件(模块、优先级、关键字)导出为标准 Excel 文件

测试执行

测试任务由测试计划生成,每个任务包含一批待执行的用例。执行人按任务逐条记录结果。

测试执行
测试执行

执行结果说明

通过

用例执行符合预期

失败

执行结果与预期不符,可直接关联提交缺陷

⏭️
跳过

因某些原因本次不执行

🚫
阻塞

前置条件未满足,无法执行

操作步骤

  1. 打开任务,顶部进度条展示实时通过率
  2. 点击每条用例旁的状态按钮记录执行结果
  3. 可填写执行备注,上传附件截图作为执行证据
  4. 结果为「失败」时,点击「提交缺陷」直接关联创建缺陷
  5. 所有用例执行完毕后,任务状态自动变更为「已完成」

缺陷管理

缺陷管理是问天台的核心模块,提供三种视图满足不同场景的使用需求,右上角可随时切换。

缺陷管理 · 列表视图
缺陷列表视图

列表视图

以表格形式展示所有缺陷,适合批量查阅、筛选与管理。

多字段筛选(状态/严重程度/优先级/处理人) 关键字搜索 点击行展开详情 快速变更状态 批量操作
字段说明
严重程度P0(致命)/ P1(严重)/ P2(一般)/ P3(轻微)
优先级紧急 / 高 / 中 / 低
状态新建 / 已指派 / 修复中 / 待验证 / 已关闭 / 已拒绝 / 重新打开
分类标签自定义颜色标签,支持多选
计划时间计划开始日期、计划结束日期、预计工时
缺陷管理 · 看板视图
缺陷看板视图

看板视图

以泳道卡片形式展示缺陷,按状态分为 7 列,直观反映各阶段缺陷分布。

新建
已指派
修复中
待验证
已关闭
已拒绝
重新打开
卡片展示严重程度、优先级、分类标签 卡片展示计划时间 点击卡片查看完整详情
每列标题旁显示该状态下的缺陷数量,便于快速了解各阶段积压情况。
缺陷管理 · 甘特图视图
缺陷甘特图视图

甘特图视图

以处理人为泳道,按时间轴展示缺陷的计划修复区间,适合排期规划与工期评估。

🎨
颜色编码

条形颜色对应缺陷严重程度:红色(P0)→ 橙色(P1)→ 黄色(P2)→ 绿色(P3)

📐
特殊标记

今日竖线标记当前日期,灰色背景标记周末,便于排期参考

前提:甘特图只展示填写了「计划开始日期」或「计划结束日期」的缺陷条目。未填写时间的缺陷不会出现在此视图。

状态流转规则

新建
已指派
修复中
待验证
已关闭
已拒绝
(处理人认为非缺陷时拒绝)
重新打开
(验证不通过时退回修复)
状态变更和缺陷指派操作会自动触发站内消息通知,相关人员可在右上角铃铛图标处查看未读消息。

操作日志 & 评论

缺陷详情页底部记录每次字段变更与状态流转的完整日志,支持嵌套回复评论,方便团队沟通协作。

测试报告

基于测试计划一键生成正式测试报告,包含多维度质量数据分析,支持对外分享。

测试报告
测试报告

生成步骤

  1. 进入测试计划详情页
  2. 点击右上角「生成报告」按钮
  3. 报告自动统计并跳转至报告详情

报告内容

📊
KPI 摘要

总用例数、通过/失败数、通过率、缺陷数、任务数

🍩
缺陷分布

严重程度分布、状态分布、分类分布饼图

📈
趋势分析

近 30 天缺陷新增趋势折线图

🏆
处理人排行

按缺陷处理数量排名展示

🔗
公开分享

生成无需登录即可访问的分享链接

系统管理

仅管理员可见,包含用户、角色、权限三个子模块,管理系统的访问控制体系。

系统管理 · 用户管理
系统管理
👤
用户管理

创建/编辑/禁用用户
重置用户密码
为用户分配角色

🏷️
角色管理

创建角色,配置数据权限
为角色绑定功能权限树

🔑
权限管理

树形结构管理
菜单与按钮级权限
支持增删改层级

数据权限说明

权限类型可见范围适用角色
全部数据可查看系统内所有项目、缺陷、用例等数据管理员、项目负责人
个人参与只能查看自己被添加为成员的项目及相关数据普通测试工程师

消息通知

问天台内置站内消息系统,关键操作自动触发通知,确保团队成员及时响应。

触发通知的操作

🐛
缺陷指派 — 被指派为处理人时收到通知
🔄
状态变更 — 缺陷状态发生变化时通知相关人员
💬
缺陷评论 — 有人在你参与的缺陷下评论时通知

查看通知

  1. 点击右上角铃铛图标,右侧弹出通知抽屉
  2. 未读消息数以红色角标显示
  3. 点击通知条目可直接跳转至对应缺陷详情页
  4. 点击「全部已读」可批量标记