refactor: 完成静态网站转换，移除所有 CMS 和动态功能
- 删除数据库相关代码 (src/db/) - 删除 API 路由 (src/app/api/) - 删除认证相关代码 (src/lib/auth/, src/providers/) - 删除监控和安全中间件 (src/lib/security/, src/lib/monitoring/) - 删除 hooks (use-news, use-products, use-services) - 更新组件为静态数据源 - 添加 nginx 静态配置和部署脚本 - 添加 static-link 组件
This commit is contained in:
张翔
@@ -1,295 +0,0 @@
|
||||
# 分层测试快速入门指南
|
||||
|
||||
## 什么是分层测试？
|
||||
|
||||
分层测试是一种测试策略，将测试按照执行时间和重要性分为三个层级：
|
||||
|
||||
- **快速层**：5分钟内完成，验证核心功能
|
||||
- **标准层**：30分钟内完成，验证大部分功能
|
||||
- **深度层**：可接受较长执行时间，进行全面验证
|
||||
|
||||
## 快速开始
|
||||
|
||||
### 1. 本地运行测试
|
||||
|
||||
#### 运行快速层测试（推荐日常开发使用）
|
||||
```bash
|
||||
npm run test:tier:fast
|
||||
```
|
||||
|
||||
#### 运行标准层测试
|
||||
```bash
|
||||
npm run test:tier:standard
|
||||
```
|
||||
|
||||
#### 运行深度层测试
|
||||
```bash
|
||||
npm run test:tier:deep
|
||||
```
|
||||
|
||||
#### 运行所有层级测试
|
||||
```bash
|
||||
npm run test:tier:all
|
||||
```
|
||||
|
||||
### 2. 编写分层测试
|
||||
|
||||
#### 快速层测试示例
|
||||
```typescript
|
||||
test.describe('API快速测试 @smoke @critical', () => {
|
||||
test('应该能够获取内容列表', async ({ request }) => {
|
||||
const response = await request.get('/api/admin/content');
|
||||
expect(response.status()).toBe(200);
|
||||
});
|
||||
});
|
||||
```
|
||||
|
||||
#### 标准层测试示例
|
||||
```typescript
|
||||
test.describe('管理后台功能测试 @admin @regression', () => {
|
||||
test('应该能够创建新闻', async ({ page }) => {
|
||||
await page.goto('/admin/news');
|
||||
await page.click('[data-testid="create-news-btn"]');
|
||||
await page.fill('[data-testid="news-title"]', '测试新闻');
|
||||
await page.click('[data-testid="save-btn"]');
|
||||
|
||||
await expect(page.locator('[data-testid="success-message"]')).toBeVisible();
|
||||
});
|
||||
});
|
||||
```
|
||||
|
||||
#### 深度层测试示例
|
||||
```typescript
|
||||
test.describe('首页视觉回归测试 @visual @regression', () => {
|
||||
test('桌面端首页应该与基准一致', async ({ page }) => {
|
||||
await page.setViewportSize({ width: 1280, height: 720 });
|
||||
await page.goto('/');
|
||||
|
||||
await expect(page).toHaveScreenshot('homepage-desktop.png');
|
||||
});
|
||||
});
|
||||
```
|
||||
|
||||
### 3. 使用测试标记
|
||||
|
||||
为测试添加标记以便分类和管理：
|
||||
|
||||
```typescript
|
||||
test.describe('测试套件 @smoke @critical', () => {
|
||||
test('测试用例 @api @regression', async ({ page }) => {
|
||||
// 测试逻辑
|
||||
});
|
||||
});
|
||||
```
|
||||
|
||||
**常用标记：**
|
||||
- `@smoke` - 冒烟测试
|
||||
- `@critical` - 关键测试
|
||||
- `@regression` - 回归测试
|
||||
- `@visual` - 视觉测试
|
||||
- `@api` - API测试
|
||||
- `@mobile` - 移动端测试
|
||||
|
||||
## CI/CD集成
|
||||
|
||||
项目已配置Woodpecker CI，自动执行分层测试：
|
||||
|
||||
### 分支策略
|
||||
|
||||
- **main分支**：执行所有层级测试
|
||||
- **develop分支**：执行快速层和标准层测试
|
||||
- **其他分支**：仅执行快速层测试
|
||||
|
||||
### 工作流程
|
||||
|
||||
1. 提交代码到分支
|
||||
2. Woodpecker CI自动触发
|
||||
3. 依次执行快速层、标准层、深度层测试
|
||||
4. 前一层失败则停止后续执行
|
||||
5. 生成测试报告并上传
|
||||
6. 发送通知
|
||||
|
||||
## 性能优化
|
||||
|
||||
### 识别慢速测试
|
||||
|
||||
运行性能优化工具：
|
||||
|
||||
```bash
|
||||
cd e2e && node test-optimizer-simple-test.js
|
||||
```
|
||||
|
||||
工具会生成优化报告，包含：
|
||||
- 慢速测试列表
|
||||
- 优化建议
|
||||
- 潜在时间节省
|
||||
|
||||
### 优化建议
|
||||
|
||||
1. **减少等待时间**
|
||||
```typescript
|
||||
// 不推荐
|
||||
await page.waitForTimeout(5000);
|
||||
|
||||
// 推荐
|
||||
await page.waitForSelector('[data-testid="result"]', { timeout: 5000 });
|
||||
```
|
||||
|
||||
2. **使用data-testid选择器**
|
||||
```typescript
|
||||
// 不推荐
|
||||
await page.click('div > div > button');
|
||||
|
||||
// 推荐
|
||||
await page.click('[data-testid="submit-btn"]');
|
||||
```
|
||||
|
||||
3. **拆分大测试**
|
||||
```typescript
|
||||
// 不推荐：单个大测试
|
||||
test('完整的用户注册流程', async ({ page }) => {
|
||||
// 100+ 行代码
|
||||
});
|
||||
|
||||
// 推荐：拆分为多个小测试
|
||||
test.describe('用户注册流程', () => {
|
||||
test('应该能够填写注册表单', async ({ page }) => {
|
||||
// 20 行代码
|
||||
});
|
||||
|
||||
test('应该能够提交注册', async ({ page }) => {
|
||||
// 20 行代码
|
||||
});
|
||||
});
|
||||
```
|
||||
|
||||
## 监控和告警
|
||||
|
||||
### 测试执行历史
|
||||
|
||||
系统自动记录测试执行历史，存储在 `e2e/test-history.json`。
|
||||
|
||||
### 告警规则
|
||||
|
||||
系统会根据以下规则触发告警：
|
||||
|
||||
1. 测试通过率低于80% (Critical)
|
||||
2. 测试通过率低于90% (High)
|
||||
3. 测试执行时间超过30分钟 (Medium)
|
||||
4. 失败测试数量超过10个 (High)
|
||||
5. 深度层测试存在失败 (Critical)
|
||||
|
||||
### 查看告警
|
||||
|
||||
告警信息会输出到控制台，并保存在 `test-results/alerts.json`。
|
||||
|
||||
## 常见问题
|
||||
|
||||
### Q: 测试超时怎么办？
|
||||
|
||||
A: 检查以下几点：
|
||||
1. 是否有不必要的等待时间
|
||||
2. 选择器是否正确
|
||||
3. 网络请求是否正常
|
||||
4. 是否需要增加超时时间
|
||||
|
||||
### Q: 测试不稳定怎么办？
|
||||
|
||||
A: 采用以下策略：
|
||||
1. 增加重试次数
|
||||
2. 使用更稳定的等待策略
|
||||
3. 检查是否有竞态条件
|
||||
4. 使用data-testid选择器
|
||||
|
||||
### Q: 如何确定测试应该放在哪一层？
|
||||
|
||||
A: 根据执行时间和重要性：
|
||||
- 执行时间<30秒且是关键功能 → 快速层
|
||||
- 执行时间<60秒 → 标准层
|
||||
- 执行时间>60秒或需要完整回归 → 深度层
|
||||
|
||||
### Q: 如何减少测试执行时间？
|
||||
|
||||
A: 采用以下策略：
|
||||
1. 并行执行测试
|
||||
2. 减少不必要的等待
|
||||
3. 优化选择器
|
||||
4. 拆分大测试
|
||||
5. 使用mock数据
|
||||
|
||||
## 进阶使用
|
||||
|
||||
### 自定义测试层级
|
||||
|
||||
编辑 `e2e/src/config/test-tiers.ts`：
|
||||
|
||||
```typescript
|
||||
export const TEST_TIERS: Record<string, TestTierConfig> = {
|
||||
fast: {
|
||||
name: '快速层',
|
||||
description: '冒烟测试、API测试、基础功能验证',
|
||||
testMatch: /.*\.smoke\.spec\.ts$|.*\.api\.spec\.ts$/,
|
||||
timeout: 30000,
|
||||
retries: 1,
|
||||
workers: process.env.CI ? 6 : '75%',
|
||||
fullyParallel: true,
|
||||
failFast: true,
|
||||
},
|
||||
// ... 其他层级
|
||||
};
|
||||
```
|
||||
|
||||
### 添加自定义告警规则
|
||||
|
||||
编辑 `e2e/src/utils/test-monitor.ts`：
|
||||
|
||||
```typescript
|
||||
this.alertRules.push({
|
||||
name: 'custom-alert',
|
||||
condition: (m) => m.failedTests > 5 && m.tier === 'fast',
|
||||
severity: 'critical',
|
||||
message: '快速层测试失败超过5个',
|
||||
});
|
||||
```
|
||||
|
||||
### 自定义优化规则
|
||||
|
||||
编辑 `e2e/src/utils/test-optimizer.ts`：
|
||||
|
||||
```typescript
|
||||
this.rules.push({
|
||||
name: 'custom-rule',
|
||||
condition: (p) => p.duration > 90000 && p.tier === 'standard',
|
||||
suggestions: [
|
||||
'标准层测试不应超过90秒',
|
||||
'考虑拆分测试或优化执行流程',
|
||||
],
|
||||
});
|
||||
```
|
||||
|
||||
## 文档资源
|
||||
|
||||
- [测试优化指南](./test-optimization-guide.md) - 详细的优化策略和技巧
|
||||
- [分层测试最佳实践](./test-tiering-best-practices.md) - 完整的最佳实践指南
|
||||
- [Playwright文档](https://playwright.dev/) - Playwright官方文档
|
||||
- [Woodpecker CI文档](https://woodpecker-ci.org/docs/) - Woodpecker CI官方文档
|
||||
|
||||
## 获取帮助
|
||||
|
||||
如果遇到问题：
|
||||
|
||||
1. 查看文档资源
|
||||
2. 检查测试日志
|
||||
3. 运行性能优化工具
|
||||
4. 联系团队成员
|
||||
|
||||
## 总结
|
||||
|
||||
分层测试系统通过以下方式提高测试效率：
|
||||
|
||||
1. **快速反馈**：快速层测试在5分钟内完成
|
||||
2. **合理分配**：根据重要性分配测试资源
|
||||
3. **持续优化**：通过历史数据持续优化
|
||||
4. **自动化**：CI/CD自动执行和报告
|
||||
|
||||
开始使用分层测试，提高测试效率，缩短反馈周期！
|
||||
Reference in New Issue
Block a user