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

package/bundled/locales/zh-TW/ai/options/testing/e2e-testing.ai.yaml

@@ -0,0 +1,116 @@
+# 端對端測試 - AI 優化選項
+# 父項: testing
+
+id: e2e-testing
+meta:
+  parent: testing
+  version: "1.0.0"
+  description: 從使用者角度測試完整使用者旅程
+  language: zh-TW
+
+characteristics:
+  scope: 完整使用者旅程
+  speed: ">10 秒每個測試（可能更長）"
+  isolation: 無（真實環境）
+  pyramid_percentage: 3%
+
+rules:
+  - id: user-perspective
+    trigger: 設計 E2E 測試時
+    instruction: 從使用者角度撰寫測試，而非技術角度
+    priority: required
+
+  - id: critical-paths-only
+    trigger: 選擇測試案例時
+    instruction: 只測試關鍵使用者旅程
+    priority: required
+
+  - id: stable-selectors
+    trigger: 選擇元素時
+    instruction: 使用穩定的選擇器（data-testid、ARIA 角色）
+    priority: required
+
+  - id: handle-flakiness
+    trigger: 處理測試不穩定時
+    instruction: 實作重試和等待策略
+    priority: required
+
+when_to_write:
+  - 關鍵使用者旅程
+  - 付款流程
+  - 認證流程
+  - 核心業務工作流程
+  - 冒煙測試
+
+critical_user_journeys:
+  - name: 認證
+    steps: [註冊, 登入, 登出]
+  - name: 購買
+    steps: [瀏覽, 加入購物車, 結帳, 付款]
+  - name: 內容管理
+    steps: [建立, 編輯, 刪除, 發布]
+
+best_practices:
+  - name: 使用 Page Object 模式
+    example: |
+      class LoginPage {
+        async login(email, password) {
+          await this.emailInput.fill(email);
+          await this.passwordInput.fill(password);
+          await this.submitButton.click();
+        }
+      }
+
+  - name: 等待策略
+    example: |
+      // 不好：固定等待
+      await page.waitForTimeout(5000);
+
+      // 好：等待條件
+      await page.waitForSelector('[data-testid="success"]');
+
+  - name: 穩定選擇器
+    example: |
+      // 不好：脆弱的選擇器
+      await page.click('.btn.primary.large');
+
+      // 好：穩定的選擇器
+      await page.click('[data-testid="submit-button"]');
+
+tools:
+  browsers:
+    - Playwright（推薦）
+    - Cypress
+    - Selenium
+    - Puppeteer
+  mobile:
+    - Appium
+    - Detox
+    - XCUITest
+  visual:
+    - Percy
+    - Chromatic
+    - BackstopJS
+
+example_test: |
+  test('使用者可以完成購買', async ({ page }) => {
+    // 登入
+    await page.goto('/login');
+    await page.fill('[data-testid="email"]', 'user@example.com');
+    await page.fill('[data-testid="password"]', 'password');
+    await page.click('[data-testid="login-button"]');
+
+    // 加入購物車
+    await page.goto('/products/1');
+    await page.click('[data-testid="add-to-cart"]');
+
+    // 結帳
+    await page.goto('/cart');
+    await page.click('[data-testid="checkout"]');
+
+    // 驗證成功
+    await expect(page.locator('[data-testid="order-confirmation"]'))
+      .toBeVisible();
+  });
+
+coverage_target: "關鍵使用者旅程（前 3-5 個）"

package/bundled/locales/zh-TW/ai/options/testing/industry-pyramid.ai.yaml

@@ -0,0 +1,144 @@
+# 業界測試金字塔 - AI 優化選項
+# 父標準: testing
+# 參考來源: Martin Fowler's Testing Pyramid, Google Testing Blog
+
+id: industry-pyramid
+meta:
+  parent: testing
+  version: "1.0.0"
+  language: zh-TW
+  description: 業界標準 3 層測試金字塔，適合敏捷團隊
+  sources:
+    - "Martin Fowler's Testing Pyramid (https://martinfowler.com/bliki/TestPyramid.html)"
+    - "Google Testing Blog (https://testing.googleblog.com)"
+
+best_for:
+  - 敏捷/Scrum 開發團隊
+  - CI/CD 導向環境
+  - 中小型專案
+  - DevOps 實踐
+  - 快速迭代週期
+
+pyramid:
+  visual: |
+    ┌─────────┐
+    │   E2E   │  ← 10% (慢、成本高)
+    ├─────────┤
+    │   IT    │  ← 20% (中等速度)
+    ├─────────┤
+    │   UT    │  ← 70% (快速、數量多)
+    └─────────┘
+  ratio: "70/20/10"
+  rationale: |
+    - 更多單元測試 = 更快回饋
+    - 較少 E2E 測試 = 較低維護成本
+    - 整合測試捕捉介面問題
+
+levels:
+  - name: 單元測試
+    abbreviation: UT
+    percentage: 70
+    definition: 針對個別函數、方法或類別的隔離測試
+    scope: 單一函數/方法/類別
+    speed: "每個測試 < 100ms"
+    dependencies: 全部模擬
+    characteristics:
+      - 快速執行
+      - 確定性結果
+      - 無 I/O 操作
+      - 測試單一行為單元
+
+  - name: 整合測試
+    abbreviation: IT
+    alternative_abbreviation: SIT
+    percentage: 20
+    definition: 測試元件互動和資料流
+    scope: 多個元件協同運作
+    speed: "每個測試 1-10 秒"
+    dependencies: 真實與模擬混合
+    note: |
+      縮寫慣例因環境而異：
+      - IT: 敏捷/DevOps 社群常用 (Martin Fowler, Google)
+      - SIT: 企業/傳統 QA 環境常用
+      兩者指的是相同的測試概念
+    characteristics:
+      - 測試真實整合
+      - 可使用容器 (Testcontainers)
+      - 驗證資料流
+
+  - name: 端對端測試
+    abbreviation: E2E
+    percentage: 10
+    definition: 從 UI 到資料庫測試完整使用者工作流程
+    scope: 從使用者角度測試完整系統
+    speed: "每個測試 30 秒到數分鐘"
+    dependencies: 全部真實
+    characteristics:
+      - 模擬真實使用者行為
+      - 只測試關鍵路徑
+      - 維護成本最高
+
+coverage_targets:
+  columns: [指標, 最低, 建議]
+  rows:
+    - [行覆蓋率, 70%, 85%]
+    - [分支覆蓋率, 60%, 80%]
+    - [函數覆蓋率, 80%, 90%]
+
+rules:
+  - id: follow-pyramid-ratio
+    trigger: 使用業界金字塔規劃測試策略
+    instruction: 目標 UT/IT/E2E 比例為 70/20/10
+    priority: required
+
+  - id: test-at-lowest-level
+    trigger: 決定在哪裡新增測試
+    instruction: 在能提供信心的最低層級撰寫測試
+    priority: recommended
+
+  - id: avoid-e2e-for-edge-cases
+    trigger: 測試邊界情況
+    instruction: 使用單元測試測試邊界情況，而非 E2E
+    priority: recommended
+
+  - id: integration-for-boundaries
+    trigger: 測試元件邊界
+    instruction: 使用整合測試驗證介面契約
+    priority: recommended
+
+comparison_with_istqb:
+  columns: [業界層級, ISTQB 對應, 說明]
+  rows:
+    - [單元測試 (UT), 元件測試, 相同概念]
+    - [整合測試 (IT), 整合測試, 相同概念，IT vs SIT 縮寫]
+    - [E2E 測試, 系統測試 + 驗收測試, 業界將這些層級合併]
+
+when_to_choose:
+  choose_industry_when:
+    - 實踐敏捷/Scrum 方法論
+    - CI/CD 流程是關鍵
+    - 快速回饋是優先事項
+    - 團隊小且跨職能
+    - 期望最小化文件負擔
+  avoid_industry_when:
+    - 需要正式 QA 認證
+    - 企業合規需求
+    - 專門 QA 團隊偏好 ISTQB
+    - 需要稽核文件
+
+tools_by_level:
+  unit_testing:
+    javascript: [Jest, Vitest, Mocha]
+    python: [pytest, unittest]
+    java: [JUnit, TestNG]
+    csharp: [xUnit, NUnit, MSTest]
+    go: [testing package, testify]
+  integration_testing:
+    javascript: [Supertest, Testcontainers]
+    python: [pytest, Testcontainers]
+    java: [Spring Boot Test, Testcontainers]
+    csharp: [WebApplicationFactory, Testcontainers]
+  e2e_testing:
+    javascript: [Playwright, Cypress, Puppeteer]
+    python: [Playwright, Selenium]
+    java: [Selenium, Playwright]

package/bundled/locales/zh-TW/ai/options/testing/integration-testing.ai.yaml

@@ -0,0 +1,90 @@
+# 整合測試 (IT/SIT) - AI 優化選項
+# 父項: testing
+
+id: integration-testing
+meta:
+  parent: testing
+  version: "1.1.0"
+  description: 測試元件之間的互動
+  language: zh-TW
+
+abbreviation_note: |
+  整合測試層級有兩種常見的縮寫：
+  - IT (Integration Testing)：敏捷/DevOps 社群常用（Martin Fowler、Google）
+  - SIT (System Integration Testing)：企業/ISTQB 環境常用
+  兩者指的是相同的測試概念。
+
+characteristics:
+  scope: 多個元件一起運作
+  speed: "<1 秒每個測試"
+  isolation: 部分隔離（可能使用真實相依性）
+  pyramid_percentage: 20%
+
+rules:
+  - id: test-integration-points
+    trigger: 撰寫整合測試時
+    instruction: 專注於元件之間的邊界
+    priority: required
+
+  - id: use-real-dependencies
+    trigger: 設定整合測試時
+    instruction: 盡可能使用真實實作，外部服務使用測試替身
+    priority: recommended
+
+  - id: test-data-management
+    trigger: 設定測試資料時
+    instruction: 使用 fixtures 或 factories，測試後清理
+    priority: required
+
+  - id: database-isolation
+    trigger: 測試資料庫時
+    instruction: 使用測試資料庫，測試之間回滾或清空
+    priority: required
+
+when_to_write:
+  - 測試 API 端點
+  - 測試資料庫操作
+  - 測試服務互動
+  - 測試訊息佇列
+  - 測試快取行為
+
+integration_points:
+  - name: 資料庫
+    approach: 使用 Testcontainers 或記憶體資料庫的測試資料庫
+    example: |
+      const db = await TestcontainersDb.start();
+      const repo = new UserRepository(db);
+      await repo.save(user);
+      const found = await repo.findById(user.id);
+      expect(found).toEqual(user);
+
+  - name: HTTP API
+    approach: 使用真實 HTTP 客戶端，模擬外部服務
+    example: |
+      const response = await request(app)
+        .post('/api/users')
+        .send({ name: 'Test User' });
+      expect(response.status).toBe(201);
+
+  - name: 訊息佇列
+    approach: 使用嵌入式佇列或 Testcontainers
+    example: |
+      await publisher.send('user.created', event);
+      const received = await consumer.receive();
+      expect(received.payload).toEqual(event);
+
+tools:
+  database:
+    - Testcontainers
+    - Docker Compose
+    - 記憶體資料庫 (H2, SQLite)
+  http:
+    - Supertest (Node.js)
+    - RestAssured (Java)
+    - requests (Python)
+  mocking:
+    - WireMock
+    - MockServer
+    - nock (Node.js)
+
+coverage_target: "關鍵路徑和整合點"

package/bundled/locales/zh-TW/ai/options/testing/istqb-framework.ai.yaml

@@ -0,0 +1,108 @@
+# ISTQB 測試框架 - AI 優化選項
+# 父標準: testing
+# 參考來源: ISTQB Glossary v4.0
+
+id: istqb-framework
+meta:
+  parent: testing
+  version: "1.0.0"
+  language: zh-TW
+  description: ISTQB 標準測試框架，包含 4 個測試層級
+  source: "ISTQB Glossary v4.0 (https://glossary.istqb.org)"
+
+best_for:
+  - 需要正式 QA 流程的企業專案
+  - 需要認證或合規的專案
+  - 擁有專門 QA 團隊的組織
+  - 瀑布式或混合開發方法論
+  - 需要嚴格稽核紀錄的專案
+
+levels:
+  - name: 單元測試 (Unit Testing)
+    abbreviation: UT
+    istqb_term: "元件測試 (Component Testing)"
+    definition: 隔離測試個別軟體元件
+    purpose: 驗證程式碼單元運作正確
+    performed_by: 開發人員
+
+  - name: 整合測試 (Integration Testing)
+    abbreviation: IT 或 SIT
+    istqb_term: "整合測試 (Integration Testing)"
+    definition: 測試整合元件之間的介面和互動
+    purpose: 驗證元件互動
+    performed_by: 開發人員或 QA
+    note: |
+      - IT (Integration Testing): 敏捷/DevOps 常用
+      - SIT (System Integration Testing): 企業/ISTQB 環境常用
+      兩個術語指的是同一個測試層級
+
+  - name: 系統測試 (System Testing)
+    abbreviation: ST
+    istqb_term: "系統測試 (System Testing)"
+    definition: 測試完整整合的系統以驗證是否符合需求
+    purpose: 驗證系統符合功能和非功能需求
+    performed_by: QA 團隊
+
+  - name: 驗收測試 (Acceptance Testing)
+    abbreviation: AT 或 UAT
+    istqb_term: "驗收測試 (Acceptance Testing)"
+    definition: 測試以判斷系統是否滿足業務需求
+    purpose: 驗證系統符合業務需求
+    performed_by: 終端使用者或業務利益相關者
+    subtypes:
+      - name: 使用者驗收測試 (UAT)
+        description: 由實際使用者進行驗證
+      - name: 合約驗收測試
+        description: 根據合約標準進行驗證
+      - name: 法規驗收測試
+        description: 合規性驗證
+
+test_types:
+  functional:
+    - 功能測試
+    - 使用者介面測試
+    - 回歸測試
+  non_functional:
+    - 效能測試
+    - 安全測試
+    - 可用性測試
+    - 可靠性測試
+
+rules:
+  - id: four-level-structure
+    trigger: 使用 ISTQB 規劃測試策略
+    instruction: |
+      使用 4 個層級: UT → IT/SIT → ST → AT/UAT
+      每個層級都有特定的進入/退出條件
+    priority: required
+
+  - id: requirement-traceability
+    trigger: 建立測試案例
+    instruction: 每個測試案例應該追溯到一個需求
+    priority: required
+
+  - id: defect-classification
+    trigger: 回報缺陷
+    instruction: 根據 ISTQB 指南按嚴重程度和優先順序分類缺陷
+    priority: recommended
+
+comparison_with_industry:
+  columns: [ISTQB 層級, 業界對應, 主要差異]
+  rows:
+    - [單元測試, 單元測試 (UT), 相同概念]
+    - [整合測試, 整合測試 (IT/SIT), 相同概念，不同縮寫慣例]
+    - [系統測試, 通常與 E2E 合併, ISTQB 將系統驗證與使用者驗收分開]
+    - [驗收測試, E2E 的一部分, ISTQB 有專門層級用於業務驗證]
+
+when_to_choose:
+  choose_istqb_when:
+    - 需要正式測試文件
+    - 與 QA 認證機構合作
+    - 有合規需求的企業環境
+    - 團隊包含 ISTQB 認證專業人員
+    - 稽核軌跡很重要
+  avoid_istqb_when:
+    - 快速迭代是優先事項
+    - 沒有專門 QA 的小團隊
+    - 純 DevOps/持續交付重點
+    - 擔心文件負擔