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

package/bundled/locales/zh-TW/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-TW/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-TW/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)