universal-dev-standards 3.5.1-beta.1 → 3.5.1-beta.11

package/bundled/locales/zh-CN/options/testing/e2e-testing.md

@@ -0,0 +1,207 @@
+---
+source: ../../../../options/testing/e2e-testing.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2025-12-30
+status: current
+---
+
+# 端对端 (E2E) 测试
+
+> **语言**: [English](../../../../options/testing/e2e-testing.md) | 繁体中文
+
+**上层标准**: [测试指南](../../core/testing.md)
+
+---
+
+## 概述
+
+端对端 (E2E) 测试验证从开始到结束的完整使用者流程，模拟真实使用者与应用程式的互动。这些测试验证所有整合元件能共同运作以提供预期的使用者体验。
+
+## 特性
+
+| 属性 | 值 |
+|------|------|
+| 范围 | 完整使用者旅程 |
+| 相依性 | 所有真实（类生产）|
+| 执行速度 | 每个测试数分钟 |
+| 环境 | 完整堆叠部署 |
+| 数量 | 仅关键路径 |
+
+## 适用情境
+
+- 关键业务流程（结帐、注册）
+- 使用者验收测试
+- 部署烟雾测试
+- 跨浏览器相容性
+- 无障碍验证
+
+## 何时撰写 E2E 测试
+
+### 应该撰写
+
+| 情境 | 范例 |
+|------|------|
+| 关键营收路径 | 结帐、订阅 |
+| 使用者验证 | 登入、注册、密码重设 |
+| 核心功能 | 主要产品功能 |
+| 法规遵循 | GDPR 同意、无障碍 |
+| 跨系统流程 | 多服务交易 |
+
+### 不应该撰写
+
+| 情境 | 更好的替代方案 |
+|------|----------------|
+| 边界案例 | 单元测试 |
+| API 验证 | 整合测试 |
+| 元件行为 | 元件测试 |
+| 错误讯息 | 单元测试 |
+
+## 框架范例
+
+### Playwright（推荐）
+
+```javascript
+// tests/e2e/checkout.spec.js
+import { test, expect } from '@playwright/test';
+
+test.describe('结帐流程', () => {
+  test.beforeEach(async ({ page }) => {
+    // 以测试使用者登入
+    await page.goto('/login');
+    await page.fill('[data-testid="email"]', 'test@example.com');
+    await page.fill('[data-testid="password"]', 'testpass123');
+    await page.click('[data-testid="login-button"]');
+    await expect(page).toHaveURL('/dashboard');
+  });
+
+  test('使用信用卡完成购买', async ({ page }) => {
+    // 加入购物车
+    await page.goto('/products/widget-pro');
+    await page.click('[data-testid="add-to-cart"]');
+    await expect(page.locator('[data-testid="cart-count"]')).toHaveText('1');
+
+    // 前往结帐
+    await page.click('[data-testid="checkout-button"]');
+    await expect(page).toHaveURL('/checkout');
+
+    // 填写配送资讯
+    await page.fill('[data-testid="address"]', '123 Test St');
+    await page.fill('[data-testid="city"]', 'Test City');
+    await page.fill('[data-testid="zip"]', '12345');
+    await page.click('[data-testid="continue-to-payment"]');
+
+    // 填写付款资讯（测试卡号）
+    await page.fill('[data-testid="card-number"]', '4242424242424242');
+    await page.fill('[data-testid="card-expiry"]', '12/25');
+    await page.fill('[data-testid="card-cvc"]', '123');
+
+    // 完成购买
+    await page.click('[data-testid="place-order"]');
+
+    // 验证成功
+    await expect(page).toHaveURL(/\/order-confirmation/);
+    await expect(page.locator('[data-testid="order-number"]')).toBeVisible();
+  });
+});
+```
+
+## Page Object 模式
+
+使用 page object 组织测试以提高可维护性：
+
+```javascript
+// pages/CheckoutPage.js
+export class CheckoutPage {
+  constructor(page) {
+    this.page = page;
+    this.addressInput = page.locator('[data-testid="address"]');
+    this.placeOrderButton = page.locator('[data-testid="place-order"]');
+  }
+
+  async fillShipping(address, city, zip) {
+    await this.addressInput.fill(address);
+    await this.page.fill('[data-testid="city"]', city);
+    await this.page.fill('[data-testid="zip"]', zip);
+  }
+
+  async placeOrder() {
+    await this.placeOrderButton.click();
+  }
+}
+```
+
+## 最佳实践
+
+### 1. 使用 Data-TestId 属性
+
+```html
+<!-- 好：稳定的选择器 -->
+<button data-testid="submit-order">下订单</button>
+
+<!-- 不好：脆弱的选择器 -->
+<button class="btn btn-primary order-btn">下订单</button>
+```
+
+### 2. 隔离测试资料
+
+```javascript
+test.beforeEach(async ({ request }) => {
+  // 透过 API 建立隔离的测试资料
+  const response = await request.post('/api/test/setup', {
+    data: { scenario: 'checkout-test' }
+  });
+  testData = await response.json();
+});
+```
+
+### 3. 处理不稳定性
+
+```javascript
+// 重试不稳定的断言
+await expect(async () => {
+  const count = await page.locator('.item').count();
+  expect(count).toBe(3);
+}).toPass({ timeout: 10000 });
+
+// 等待网路闲置
+await page.waitForLoadState('networkidle');
+```
+
+### 4. 平行执行测试
+
+```javascript
+// playwright.config.js
+export default {
+  workers: process.env.CI ? 4 : undefined,
+  fullyParallel: true,
+  projects: [
+    { name: 'chromium', use: { ...devices['Desktop Chrome'] } },
+    { name: 'firefox', use: { ...devices['Desktop Firefox'] } },
+    { name: 'mobile', use: { ...devices['iPhone 12'] } },
+  ],
+};
+```
+
+## 常见框架
+
+| 框架 | 语言 | 最适合 |
+|------|------|--------|
+| Playwright | JS/TS/Python/C# | 跨浏览器、现代 |
+| Cypress | JavaScript | 元件 + E2E |
+| Selenium | 多语言 | 旧系统、企业 |
+| Puppeteer | JavaScript | Chrome 专用 |
+
+## 相关选项
+
+- [单元测试](./unit-testing.md) - 测试个别元件
+- [整合测试](./integration-testing.md) - 测试元件互动
+- [系统测试](./system-testing.md) - 测试完整系统
+
+---
+
+## 授权条款
+
+本文件采用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权条款。
+
+**来源**：[universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)

package/bundled/locales/zh-CN/options/testing/integration-testing.md

@@ -0,0 +1,230 @@
+---
+source: ../../../../options/testing/integration-testing.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2025-12-30
+status: current
+---
+
+# 整合测试 (IT/SIT)
+
+> **语言**: [English](../../../../options/testing/integration-testing.md) | 繁体中文
+
+**上层标准**: [测试指南](../../core/testing.md)
+
+---
+
+## 缩写说明
+
+整合测试层级在业界有两种常见的缩写：
+
+| 缩写 | 全名 | 常见用法 |
+|------|------|----------|
+| **IT** | Integration Testing | 敏捷/DevOps 社群（Martin Fowler、Google Testing Blog） |
+| **SIT** | System Integration Testing | 企业/ISTQB 环境、传统 QA 环境 |
+
+两者指的是相同的测试概念。本文件交替使用 IT/SIT。
+
+---
+
+## 概述
+
+整合测试验证不同模组、服务或元件是否能正确地协同运作。这些测试验证整合单元之间的互动和资料流，同时可能使用真实的相依性如资料库或外部服务。
+
+## 特性
+
+| 属性 | 值 |
+|------|------|
+| 范围 | 多个元件协同运作 |
+| 相依性 | 真实与模拟混合 |
+| 执行速度 | 秒到分钟 |
+| 隔离性 | 部分——测试真实整合 |
+| 数量 | 中等数量的测试 |
+
+## 适用情境
+
+- 测试 API 端点与资料库
+- 验证服务间通讯
+- 验证层间资料流
+- 测试第三方整合
+- 验证设定和连线
+
+## 测试金字塔位置
+
+```
+        /\
+       /  \      E2E 测试（少）
+      /----\
+     / ★★★ \    整合测试 ← 这一层
+    /--------\
+   /          \  单元测试（多）
+  /------------\
+```
+
+## 整合测试类型
+
+### 1. 元件整合
+
+测试内部元件间的互动：
+
+```javascript
+// 测试：UserService + UserRepository + Database
+describe('UserService Integration', () => {
+  let userService;
+  let database;
+
+  beforeAll(async () => {
+    database = await TestDatabase.connect();
+    const userRepository = new UserRepository(database);
+    userService = new UserService(userRepository);
+  });
+
+  afterAll(async () => {
+    await database.disconnect();
+  });
+
+  it('should create and retrieve user', async () => {
+    const created = await userService.createUser({
+      name: 'John',
+      email: 'john@example.com'
+    });
+
+    const retrieved = await userService.getUser(created.id);
+
+    expect(retrieved.name).toBe('John');
+    expect(retrieved.email).toBe('john@example.com');
+  });
+});
+```
+
+### 2. API 整合
+
+使用真实服务测试 REST/GraphQL 端点：
+
+```python
+# Python/pytest 范例
+class TestUserAPI:
+    def test_create_user_endpoint(self, test_client, test_database):
+        # 执行
+        response = test_client.post('/api/users', json={
+            'name': 'John Doe',
+            'email': 'john@example.com'
+        })
+
+        # 验证
+        assert response.status_code == 201
+        assert response.json()['name'] == 'John Doe'
+
+        # 验证资料库
+        user = test_database.query(User).filter_by(email='john@example.com').first()
+        assert user is not None
+```
+
+### 3. 资料库整合
+
+使用真实资料库测试资料存取层：
+
+```java
+// Java/JUnit 范例
+@SpringBootTest
+@Transactional
+class UserRepositoryIntegrationTest {
+
+    @Autowired
+    private UserRepository userRepository;
+
+    @Test
+    void shouldFindUsersByRole() {
+        // 安排
+        userRepository.save(new User("admin", Role.ADMIN));
+        userRepository.save(new User("user1", Role.USER));
+
+        // 执行
+        List<User> admins = userRepository.findByRole(Role.ADMIN);
+
+        // 验证
+        assertThat(admins).hasSize(1);
+    }
+}
+```
+
+## 最佳实践
+
+### 1. 隔离测试资料
+
+```javascript
+describe('Order Integration', () => {
+  beforeEach(async () => {
+    // 每个测试都从干净状态开始
+    await database.truncate(['orders', 'order_items']);
+    await seedProducts();
+  });
+});
+```
+
+### 2. 使用交易进行清理
+
+```python
+@pytest.fixture
+def db_session():
+    """提供测试的交易范围。"""
+    connection = engine.connect()
+    transaction = connection.begin()
+    session = Session(bind=connection)
+
+    yield session
+
+    session.close()
+    transaction.rollback()
+    connection.close()
+```
+
+### 3. 测试真实情境
+
+```javascript
+it('should handle checkout with out-of-stock item', async () => {
+  // 设置：库存有限的产品
+  await inventory.setStock('SKU-001', 1);
+
+  // 第一笔订单成功
+  const order1 = await checkout.process({ sku: 'SKU-001', qty: 1 });
+  expect(order1.status).toBe('confirmed');
+
+  // 第二笔订单因库存不足失败
+  await expect(checkout.process({ sku: 'SKU-001', qty: 1 }))
+    .rejects.toThrow('Out of stock');
+});
+```
+
+## 应该测试什么
+
+| 情境 | 原因 |
+|------|------|
+| 资料库查询 | 验证 SQL/ORM 正确运作 |
+| API 端点 | 测试路由、中介软体、回应 |
+| 服务互动 | 验证服务间合约 |
+| 交易边界 | 确保资料一致性 |
+| 错误传播 | 测试跨层错误处理 |
+
+## 常见框架与工具
+
+| 类别 | 工具 |
+|------|------|
+| 测试容器 | Testcontainers、Docker Compose |
+| HTTP 模拟 | nock、WireMock、responses |
+| 资料库 | H2（Java）、SQLite（测试模式）|
+| API 测试 | Supertest、REST Assured、httpx |
+
+## 相关选项
+
+- [单元测试](./unit-testing.md) - 测试个别元件
+- [系统测试](./system-testing.md) - 测试完整系统
+- [E2E 测试](./e2e-testing.md) - 测试使用者流程
+
+---
+
+## 授权条款
+
+本文件采用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权条款。
+
+**来源**：[universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)

package/bundled/locales/zh-CN/options/testing/system-testing.md

@@ -0,0 +1,183 @@
+---
+source: ../../../../options/testing/system-testing.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2025-12-30
+status: current
+---
+
+# 系统测试
+
+> **语言**: [English](../../../../options/testing/system-testing.md) | 繁体中文
+
+**上层标准**: [测试指南](../../core/testing.md)
+
+---
+
+## 概述
+
+系统测试针对指定需求验证完整、整合的系统。它在接近生产环境的环境中测试整个应用程式，验证功能性和非功能性需求。
+
+## 特性
+
+| 属性 | 值 |
+|------|------|
+| 范围 | 整个应用系统 |
+| 相依性 | 所有真实元件 |
+| 执行速度 | 分钟到小时 |
+| 环境 | 类生产环境 |
+| 数量 | 精选的测试集 |
+
+## 适用情境
+
+- 验证完整使用者流程
+- 测试系统级需求
+- 效能和负载测试
+- 安全性测试
+- 发布前回归测试
+
+## 系统测试类型
+
+### 1. 功能测试
+
+验证系统符合功能需求：
+
+```gherkin
+# 行为驱动规格
+Feature: 使用者注册
+
+  Scenario: 使用有效资料成功注册
+    Given 我在注册页面
+    When 我输入有效的注册资料
+    And 我提交注册表单
+    Then 我应该收到确认邮件
+    And 我的帐户应该在资料库中建立
+    And 我应该被重导到欢迎页面
+```
+
+### 2. 效能测试
+
+验证系统在负载下的效能：
+
+```javascript
+// k6 负载测试范例
+export const options = {
+  stages: [
+    { duration: '2m', target: 100 },  // 升温
+    { duration: '5m', target: 100 },  // 维持 100 使用者
+    { duration: '2m', target: 200 },  // 尖峰到 200
+    { duration: '5m', target: 200 },  // 维持 200
+    { duration: '2m', target: 0 },    // 降温
+  ],
+  thresholds: {
+    http_req_duration: ['p(95)<500'],  // 95% 低于 500ms
+    http_req_failed: ['rate<0.01'],    // 错误率低于 1%
+  },
+};
+```
+
+### 3. 安全性测试
+
+测试系统安全控制：
+
+```yaml
+# 安全测试情境
+security_tests:
+  authentication:
+    - test: "暴力破解保护"
+      steps:
+        - 尝试 5 次失败登入
+        - 验证帐户锁定
+        - 验证锁定通知邮件
+
+    - test: "Session 管理"
+      steps:
+        - 登入并取得 session token
+        - 验证 token 在逾时后过期
+        - 验证登出时 token 失效
+```
+
+### 4. 可靠性测试
+
+测试系统在不利条件下的行为：
+
+```python
+# 混沌工程测试
+class ReliabilityTest:
+    def test_database_failover(self):
+        """系统应优雅处理资料库故障转移。"""
+        # 安排
+        app = TestApplication()
+        app.start()
+
+        # 执行：模拟主资料库故障
+        app.database.simulate_failure('primary')
+
+        # 验证：系统使用副本继续运作
+        response = app.client.get('/api/health')
+        assert response.status_code == 200
+        assert response.json()['database'] == 'degraded'
+```
+
+## 测试环境
+
+### 环境需求
+
+| 面向 | 需求 |
+|------|------|
+| 基础设施 | 镜像生产拓扑 |
+| 资料 | 真实、匿名化的生产资料 |
+| 规模 | 至少生产环境 10% 容量 |
+| 隔离 | 与开发/测试环境分离 |
+| 监控 | 启用完整可观测性 |
+
+## 测试报告
+
+### 报告结构
+
+```markdown
+# 系统测试报告
+
+## 摘要
+- **日期**: 2024-01-15
+- **版本**: v2.3.0
+- **环境**: system-test-01
+- **时长**: 4 小时 32 分钟
+
+## 结果总览
+| 类别 | 通过 | 失败 | 跳过 |
+|------|------|------|------|
+| 功能 | 145 | 3 | 2 |
+| 效能 | 12 | 0 | 0 |
+| 安全 | 28 | 1 | 0 |
+
+## 效能指标
+- 平均回应时间: 234ms
+- 95 百分位: 456ms
+- 错误率: 0.02%
+- 吞吐量: 1,200 req/sec
+```
+
+## 最佳实践
+
+1. **在类生产环境测试**
+2. **使用真实资料量**
+3. **包含非功能性需求**
+4. **自动化回归测试**
+5. **清楚记录测试情境**
+6. **执行期间监控**
+7. **执行后清理测试资料**
+
+## 相关选项
+
+- [单元测试](./unit-testing.md) - 测试个别元件
+- [整合测试](./integration-testing.md) - 测试元件互动
+- [E2E 测试](./e2e-testing.md) - 测试使用者流程
+
+---
+
+## 授权条款
+
+本文件采用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权条款。
+
+**来源**：[universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)