Skip to content

TESTING.md

Latest commit

 

History

History
189 lines (141 loc) · 4.49 KB

TESTING.md

File metadata and controls

189 lines (141 loc) · 4.49 KB
Raw

Scintirete Manager UI 测试指南

🚀 快速启动

# 安装依赖
pnpm install

# 启动开发服务器
pnpm dev

# 运行基础测试
pnpm test

访问地址：http://localhost:3000

🧪 功能测试检查表

1. 连接配置页面 (首页)

✅ 基本显示测试

  • 页面正常加载，显示 "Scintirete Manager UI" 标题
  • 显示连接表单和已保存连接列表
  • Element Plus 组件正常渲染

✅ 连接表单测试

  • 可以输入连接名称（可选）
  • 服务器地址输入框，默认值为 127.0.0.1
  • HTTP端口输入框，默认值为 8080
  • 密码输入框，支持显示/隐藏
  • 连接模式单选：客户端直连 / 服务器转发
  • 当服务器转发被禁用时，选项显示为禁用状态

✅ 连接管理测试

  • 点击"添加连接"可以保存连接配置
  • 连接列表显示已保存的连接
  • 可以编辑现有连接
  • 可以删除连接（需要确认）

✅ 连接测试

  • 点击"连接"按钮时显示加载状态
  • 连接成功时跳转到数据库管理页
  • 连接失败时显示错误消息

2. 数据库管理页面

✅ 页面导航测试

  • 显示当前连接信息
  • "返回连接配置"按钮正常工作
  • 页面标题和面包屑正确显示

✅ 数据库列表测试

  • 正确显示数据库名称列表
  • "刷新"按钮可以重新加载数据
  • "管理集合"按钮跳转到集合管理页
  • 删除按钮根据配置显示/隐藏

3. 集合管理页面

✅ 集合信息显示

  • 显示集合名称、维度、向量数量等信息
  • 内存占用显示格式化的数值
  • 距离度量类型正确显示

✅ 向量操作测试

  • 插入向量：

    • 可以选择嵌入模型
    • 可以输入文本内容
    • 可以添加JSON格式的元数据
    • 插入成功后显示确认消息

  • 搜索向量：

    • 可以输入查询文本
    • 可以设置返回数量
    • 搜索结果正确显示
    • 显示距离和元数据

  • 删除向量：

    • 可以输入向量ID列表
    • 删除前需要确认
    • 删除成功后显示确认消息

4. 错误处理测试

✅ 网络错误

  • 连接超时时显示适当错误消息
  • 服务器不可达时的错误处理
  • 认证失败时返回连接页面

✅ 用户输入验证

  • 表单验证正确工作
  • 无效JSON元数据的错误提示
  • 必填字段的验证

5. 响应式设计测试

✅ 移动端适配

  • 在移动设备上布局正确
  • 表格在小屏幕上可以滚动
  • 按钮和输入框适合触摸操作

🔧 配置测试

运行时配置验证

检查 nuxt.config.ts 中的配置：

runtimeConfig: {
  public: {
    enableServerProxy: true,    // 服务器转发模式开关
    enableDbDelete: false,      // 数据库删除操作开关  
    enableCollDelete: false     // 集合删除操作开关
  }
}

✅ 配置影响测试

  • enableServerProxy: false 时，服务器转发选项被禁用
  • enableDbDelete: false 时，数据库删除按钮被隐藏
  • enableCollDelete: false 时，集合删除按钮被隐藏

🧰 调试工具

浏览器开发者工具

  • 打开控制台查看错误信息
  • 检查网络请求是否正常
  • 验证LocalStorage中的连接配置

服务器日志

  • 查看Nuxt开发服务器的输出
  • 检查API代理请求是否正确转发

📊 性能检查

加载时间

  • 首页加载时间 < 2秒
  • 页面切换流畅，无明显延迟
  • 大量数据时列表渲染性能良好

内存使用

  • 长时间使用后无明显内存泄漏
  • 页面切换后正确释放资源

🔐 安全测试

数据保护

  • 密码在界面中正确隐藏
  • LocalStorage数据不包含敏感信息
  • 网络请求使用HTTPS（生产环境）

权限控制

  • 危险操作需要二次确认
  • 配置禁用的功能无法绕过

🎯 测试通过标准

  • ✅ 所有基础功能正常工作
  • ✅ 错误处理健壮
  • ✅ 用户体验流畅
  • ✅ 响应式设计适配良好
  • ✅ 性能满足要求
  • ✅ 安全措施到位

📋 已知问题

目前无已知问题。

📝 测试报告模板

测试日期：____
测试环境：____
测试人员：____

通过项目：__ / __
失败项目：__ / __

主要问题：
1. ___________
2. ___________

改进建议：
1. ___________
2. ___________