Files
novalon-website/e2e/MIGRATION.md
T
张翔 498bb3a3c8 refactor: reorganize project structure and improve code quality
- Move CI/CD configs to config/ci/ directory
- Reorganize scripts into categorized directories (deployment, monitoring, testing, utils)
- Consolidate documentation into docs/ directory with proper structure
- Update linting and testing configurations
- Remove obsolete test reports and performance summaries
- Add new documentation for code quality tools and contact form security
- Improve project organization and maintainability
- Fix lint-staged config to only lint JS/TS files
- Disable react/react-in-jsx-scope rule for Next.js compatibility
- Ignore scripts and test config directories in ESLint
2026-03-24 13:38:58 +08:00

2.9 KiB

测试框架整合说明

背景

项目原本存在三个独立的测试框架:

  1. e2e/ - Playwright TypeScript测试框架(主要框架)
  2. e2e-tests/ - Python Playwright测试框架(已废弃)
  3. test-framework/ - 共享测试框架(已废弃)

整合决策

保留的测试框架

  • e2e/ - 作为主要测试框架
    • 完整的测试套件(冒烟、回归、性能、可访问性、安全、视觉、移动端、响应式、API、集成、管理后台等)
    • TypeScript与项目技术栈一致
    • 完善的配置和工具链
    • 丰富的测试用例和Page Object模型

废弃的测试框架

  • e2e-tests/ - Python Playwright测试框架

    • 基础测试套件
    • 与项目技术栈不一致
    • 维护成本高
  • test-framework/ - 共享测试框架

    • 简单的E2E测试
    • 功能重复
    • 缺少维护

迁移说明

已迁移的内容

以下测试用例已从废弃框架迁移到e2e/:

从e2e-tests/迁移

  • 基础页面测试(首页、联系页面)
  • 导航测试
  • 性能测试(基础)
  • 响应式测试(基础)

从test-framework/迁移

  • 可访问性测试
  • 性能测试
  • SEO测试
  • 联系页面测试

未迁移的内容

以下内容未迁移,因为e2e/中已有更完善的实现:

e2e-tests/中未迁移

  • Python特定的测试工具和辅助函数
  • Python报告生成器
  • Python日志系统

test-framework/中未迁移

  • 简单的测试用例(e2e/中已有更完善的版本)
  • 共享的页面对象(已整合到e2e/中)

使用指南

运行测试

# 运行所有E2E测试
npm run test

# 运行冒烟测试
npm run test:smoke

# 运行回归测试
npm run test:tier:standard

# 运行性能测试
npm run test:performance

# 运行可访问性测试
cd e2e && npx playwright test --grep @accessibility

# 运行安全测试
cd e2e && npx playwright test --grep @security

# 运行视觉回归测试
cd e2e && npx playwright test --grep @visual

测试配置

主要配置文件位于e2e/目录:

  • playwright.config.ts - 主配置文件
  • playwright.config.admin.ts - 管理后台测试配置
  • playwright.config.tiered.ts - 分层测试配置
  • playwright.coverage.config.ts - 覆盖率测试配置

测试报告

测试报告位于e2e/playwright-report/目录:

# 查看测试报告
cd e2e && npm run test:report

废弃框架处理

e2e-tests/目录

  • 状态: 已废弃
  • 操作: 已添加到.gitignore
  • 保留原因: 保留历史记录,便于参考

test-framework/目录

  • 状态: 已废弃
  • 操作: 已添加到.gitignore
  • 保留原因: 保留历史记录,便于参考

迁移日期

2026-03-24

相关文档

问题反馈

如有测试相关问题,请联系开发团队。