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

package/bundled/locales/zh-CN/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-CN
+
+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-CN/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-CN
+  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-CN/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-CN
+
+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-CN/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-CN
+  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/持續交付重点
+    - 擔心文件負擔