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

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

@@ -0,0 +1,272 @@
+# 效能測試 - AI 優化選項
+# 父層: testing
+
+id: performance-testing
+meta:
+  parent: testing
+  version: "1.0.0"
+  description: 效能測試標準與實踐
+  references:
+    - "ISTQB Performance Testing"
+    - "Google SRE Book"
+
+best_for:
+  - 高流量應用程式
+  - 即時系統
+  - 電子商務平台
+  - API 與微服務
+  - 資料庫密集型應用
+
+testing_types:
+  load_testing:
+    name: 負載測試
+    description: 測試系統在預期負載下的行為
+    purpose: 驗證系統能處理正常流量
+    metrics:
+      - 回應時間 (P50, P95, P99)
+      - 吞吐量 (TPS/RPS)
+      - 錯誤率
+    tools:
+      - name: k6
+        type: 開源
+        language: JavaScript
+      - name: JMeter
+        type: 開源
+        language: Java/XML
+      - name: Gatling
+        type: 開源
+        language: Scala
+      - name: Locust
+        type: 開源
+        language: Python
+
+  stress_testing:
+    name: 壓力測試
+    description: 測試系統超出正常負載的行為
+    purpose: 找出系統極限與故障模式
+    metrics:
+      - 最大容量
+      - 效能衰退曲線
+      - 恢復時間
+    approach:
+      - 逐步增加負載
+      - 監控錯誤與延遲
+      - 識別瓶頸
+      - 記錄故障閾值
+
+  spike_testing:
+    name: 尖峰測試
+    description: 測試流量突然增加的情況
+    purpose: 驗證系統處理流量尖峰的能力
+    scenarios:
+      - 限時搶購
+      - 病毒式傳播內容
+      - 行銷活動
+      - 定時事件
+
+  soak_testing:
+    name: 耐久測試
+    abbreviation: 穩定性測試
+    description: 測試系統長時間運行的穩定性
+    purpose: 發現記憶體洩漏和效能衰退
+    duration: 數小時至數天
+    watch_for:
+      - 記憶體洩漏
+      - 連線池耗盡
+      - 日誌檔案增長
+      - 漸進式效能衰退
+
+  capacity_testing:
+    name: 容量測試
+    description: 確定系統最大容量
+    purpose: 規劃擴展和基礎設施
+    output:
+      - 使用者容量上限
+      - 資源需求
+      - 擴展閾值
+
+key_metrics:
+  latency:
+    name: 延遲
+    description: 回應請求所需時間
+    percentiles:
+      - name: P50
+        description: 中位數回應時間
+        target: 基準值
+      - name: P95
+        description: 第 95 百分位
+        target: 基準值的 2-3 倍
+      - name: P99
+        description: 第 99 百分位
+        target: 最大不超過基準值 5 倍
+    note: "P99 對使用者體驗的影響通常比平均值更重要"
+
+  throughput:
+    name: 吞吐量
+    description: 單位時間處理的請求數
+    measurements:
+      - TPS (每秒交易數)
+      - RPS (每秒請求數)
+      - QPS (每秒查詢數)
+    considerations:
+      - 尖峰 vs 持續負載
+      - 併發使用者 vs 請求數
+
+  error_rate:
+    name: 錯誤率
+    description: 失敗請求的百分比
+    targets:
+      acceptable: "<0.1%"
+      degraded: "<1%"
+      critical: ">1%"
+
+  resource_utilization:
+    name: 資源使用率
+    description: 系統資源消耗
+    measurements:
+      - CPU 使用率
+      - 記憶體使用率
+      - 網路 I/O
+      - 磁碟 I/O
+      - 連線池使用率
+
+service_level_objectives:
+  name: 服務等級目標
+  description: 定義可量測的效能目標
+  template:
+    latency_slo: "P99 延遲 < 200ms"
+    availability_slo: "99.9% 可用性"
+    throughput_slo: "持續 1000 RPS"
+    error_slo: "錯誤率 < 0.1%"
+  note: "SLO 應基於使用者需求，而非系統能力"
+
+rules:
+  - id: baseline-first
+    trigger: 開始效能測試
+    instruction: 在優化前先建立基準指標
+    priority: required
+
+  - id: realistic-data
+    trigger: 設置測試環境
+    instruction: 使用接近生產環境的資料量和模式
+    priority: required
+
+  - id: isolate-environment
+    trigger: 執行效能測試
+    instruction: 使用隔離環境避免干擾
+    priority: required
+
+  - id: gradual-load
+    trigger: 執行負載測試
+    instruction: 逐步增加負載以識別閾值
+    priority: recommended
+
+  - id: monitor-resources
+    trigger: 測試執行期間
+    instruction: 監控所有系統資源 (CPU、記憶體、I/O)
+    priority: required
+
+  - id: percentile-focus
+    trigger: 分析結果
+    instruction: 關注 P95/P99 延遲，而非平均值
+    priority: required
+
+  - id: regression-testing
+    trigger: 程式碼變更後
+    instruction: 在 CI/CD 中包含效能回歸測試
+    priority: recommended
+
+test_phases:
+  phase_1_baseline:
+    name: 第一階段：基準測試
+    description: 建立當前效能基準
+    activities:
+      - 以最小負載執行測試
+      - 記錄當前指標
+      - 識別現有問題
+    duration: 1-2 天
+
+  phase_2_load:
+    name: 第二階段：負載測試
+    description: 正常負載測試
+    activities:
+      - 模擬預期流量
+      - 驗證 SLO 合規性
+      - 監控資源使用
+    duration: 2-3 天
+
+  phase_3_stress:
+    name: 第三階段：壓力測試
+    description: 超出正常容量測試
+    activities:
+      - 增加負載直到故障
+      - 記錄故障點
+      - 測試恢復程序
+    duration: 1-2 天
+
+  phase_4_soak:
+    name: 第四階段：耐久測試
+    description: 長時間測試
+    activities:
+      - 運行 24-72 小時
+      - 監控效能衰退
+      - 檢查記憶體洩漏
+    duration: 1-3 天
+
+ci_integration:
+  approach: 在 CI 中執行輕量級效能測試
+  example_k6: |
+    import http from 'k6/http';
+    import { check, sleep } from 'k6';
+
+    export const options = {
+      stages: [
+        { duration: '30s', target: 10 },
+        { duration: '1m', target: 10 },
+        { duration: '30s', target: 0 },
+      ],
+      thresholds: {
+        http_req_duration: ['p(95)<500'],
+        http_req_failed: ['rate<0.01'],
+      },
+    };
+
+    export default function () {
+      const res = http.get('https://api.example.com/health');
+      check(res, { 'status 200': (r) => r.status === 200 });
+      sleep(1);
+    }
+
+  github_actions: |
+    name: Performance Test
+    on:
+      pull_request:
+        branches: [main]
+    jobs:
+      k6:
+        runs-on: ubuntu-latest
+        steps:
+          - uses: actions/checkout@v4
+          - name: Run k6 test
+            uses: grafana/k6-action@v0.3.1
+            with:
+              filename: tests/performance/load-test.js
+
+quick_reference:
+  test_types:
+    columns: [類型, 目的, 時長, 時機]
+    rows:
+      - [負載測試, 正常流量, 分鐘, 每次發布]
+      - [壓力測試, 找出極限, 小時, 主要發布]
+      - [尖峰測試, 突發流量, 分鐘, 視需求]
+      - [耐久測試, 長期穩定性, 天, 每季]
+      - [容量測試, 最大容量, 小時, 規劃時]
+
+  key_metrics:
+    columns: [指標, 測量內容, 目標]
+    rows:
+      - [P50 延遲, 中位數回應, 基準值]
+      - [P95 延遲, 典型最差情況, "基準值 2-3 倍"]
+      - [P99 延遲, 極端情況, "最大基準值 5 倍"]
+      - [吞吐量, 每秒請求數, SLO 定義]
+      - [錯誤率, 失敗請求, "<0.1%"]

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

@@ -0,0 +1,160 @@
+# 安全測試 - AI 優化選項
+# 父項: testing
+
+id: security-testing
+meta:
+  parent: testing
+  version: "1.0.0"
+  description: 安全測試標準和實踐
+  language: zh-TW
+  references:
+    - "OWASP 測試指南"
+    - "NIST SP 800-115"
+
+best_for:
+  - 處理敏感資料的應用程式
+  - 金融服務
+  - 醫療應用程式
+  - 電子商務平台
+  - 任何面向公眾的應用程式
+
+testing_types:
+  static_analysis:
+    abbreviation: SAST
+    full_name: 靜態應用程式安全測試
+    description: 不執行程式碼分析原始碼
+    when_to_use: 開發早期、CI/CD 管線
+    tools:
+      - name: SonarQube
+        languages: 多語言
+      - name: Semgrep
+        languages: 多語言
+      - name: CodeQL
+        languages: 多語言
+      - name: Bandit
+        languages: Python
+
+  dynamic_analysis:
+    abbreviation: DAST
+    full_name: 動態應用程式安全測試
+    description: 測試執行中的應用程式以找出漏洞
+    when_to_use: 預備環境、正式上線前
+    tools:
+      - name: OWASP ZAP
+        type: 開源
+      - name: Burp Suite
+        type: 商業
+      - name: Nuclei
+        type: 開源
+
+  dependency_scanning:
+    abbreviation: SCA
+    full_name: 軟體組成分析
+    description: 檢查相依套件的已知漏洞
+    when_to_use: 每次建置、持續監控
+    tools:
+      - name: Snyk
+        type: SaaS/CLI
+      - name: Dependabot
+        type: GitHub 整合
+      - name: npm audit
+        type: CLI
+      - name: OWASP Dependency-Check
+        type: 開源
+
+  penetration_testing:
+    abbreviation: Pentest
+    full_name: 滲透測試
+    description: 由安全專業人員進行的模擬攻擊
+    when_to_use: 重大版本發布前、每年
+    types:
+      - 黑箱（無事先知識）
+      - 白箱（完整存取）
+      - 灰箱（部分知識）
+
+  secret_scanning:
+    full_name: 機密掃描
+    description: 偵測暴露的憑證和機密
+    tools:
+      - name: GitLeaks
+        type: 開源
+      - name: TruffleHog
+        type: 開源
+      - name: GitHub Secret Scanning
+        type: GitHub 整合
+
+owasp_top_10:
+  description: OWASP 十大網路應用程式安全風險
+  version: "2021"
+  risks:
+    - id: A01
+      name: 存取控制失效
+      test_focus: 授權檢查、權限提升
+    - id: A02
+      name: 加密失效
+      test_focus: 加密、金鑰管理、資料暴露
+    - id: A03
+      name: 注入攻擊
+      test_focus: SQL、NoSQL、OS、LDAP 注入
+    - id: A04
+      name: 不安全的設計
+      test_focus: 安全需求、威脅建模
+    - id: A05
+      name: 安全設定錯誤
+      test_focus: 預設設定、不必要的功能
+    - id: A06
+      name: 易受攻擊的元件
+      test_focus: 過時的相依套件、已知 CVE
+    - id: A07
+      name: 身分驗證失效
+      test_focus: 會話管理、憑證填充
+    - id: A08
+      name: 軟體和資料完整性失效
+      test_focus: CI/CD 管線安全、序列化
+    - id: A09
+      name: 安全日誌和監控失效
+      test_focus: 稽核日誌、警報
+    - id: A10
+      name: 伺服器端請求偽造
+      test_focus: URL 驗證、網路隔離
+
+rules:
+  - id: sast-in-ci
+    trigger: 設定 CI/CD 時
+    instruction: 在每個建置管線中包含 SAST
+    priority: required
+
+  - id: dependency-scanning
+    trigger: 新增相依套件時
+    instruction: 掃描所有相依套件的漏洞
+    priority: required
+
+  - id: secret-scanning
+    trigger: 提交程式碼時
+    instruction: 推送前掃描暴露的機密
+    priority: required
+
+  - id: dast-staging
+    trigger: 部署到預備環境時
+    instruction: 對預備環境執行 DAST
+    priority: recommended
+
+  - id: pentest-annually
+    trigger: 年度安全審查時
+    instruction: 每年至少進行一次滲透測試
+    priority: recommended
+
+  - id: owasp-checklist
+    trigger: 安全測試規劃時
+    instruction: 測試計畫涵蓋所有 OWASP 十大風險
+    priority: required
+
+quick_reference:
+  testing_types:
+    columns: [類型, 縮寫, 時機, 工具]
+    rows:
+      - [靜態分析, SAST, CI/CD, SonarQube/Semgrep]
+      - [動態分析, DAST, 預備環境, OWASP ZAP/Burp]
+      - [相依套件掃描, SCA, 每次建置, Snyk/Dependabot]
+      - [滲透測試, Pentest, 每年, 人工/專業]
+      - [機密掃描, -, 提交前, GitLeaks/TruffleHog]

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

@@ -0,0 +1,101 @@
+# 系統測試 - AI 優化選項
+# 父項: testing
+
+id: system-testing
+meta:
+  parent: testing
+  version: "1.0.0"
+  description: 測試完整系統作為黑盒
+  language: zh-TW
+
+characteristics:
+  scope: 完整系統
+  speed: "<10 秒每個測試"
+  isolation: 最小（類正式環境）
+  pyramid_percentage: 7%
+
+rules:
+  - id: production-like-environment
+    trigger: 設定系統測試時
+    instruction: 使用盡可能接近正式環境的設定
+    priority: required
+
+  - id: test-complete-flows
+    trigger: 設計系統測試時
+    instruction: 測試完整的業務流程，而非個別元件
+    priority: required
+
+  - id: external-service-stubs
+    trigger: 處理外部服務時
+    instruction: 只對無法控制的外部服務使用 stub
+    priority: recommended
+
+  - id: data-cleanup
+    trigger: 測試執行後
+    instruction: 確保測試資料在測試後清理
+    priority: required
+
+when_to_write:
+  - 測試完整業務工作流程
+  - 測試系統行為
+  - 測試元件互動
+  - 驗證配置
+  - 測試非功能需求
+
+environment_setup:
+  - name: Docker Compose
+    description: 編排所有服務
+    example: |
+      # docker-compose.test.yml
+      services:
+        app:
+          build: .
+        db:
+          image: postgres:15
+        redis:
+          image: redis:7
+
+  - name: Testcontainers
+    description: 程式化容器管理
+    example: |
+      const postgres = await new PostgreSqlContainer().start();
+      const redis = await new GenericContainer('redis:7').start();
+
+test_patterns:
+  - name: API 契約測試
+    description: 驗證 API 行為符合契約
+    example: |
+      describe('User API Contract', () => {
+        it('POST /users returns 201 with valid data', async () => {
+          const res = await api.post('/users').send(validUser);
+          expect(res.status).toBe(201);
+          expect(res.body).toMatchSchema(userSchema);
+        });
+      });
+
+  - name: 工作流程測試
+    description: 測試完整業務流程
+    example: |
+      describe('Order Workflow', () => {
+        it('completes purchase flow', async () => {
+          await createUser();
+          await addToCart(product);
+          await checkout();
+          await verifyOrder();
+        });
+      });
+
+tools:
+  orchestration:
+    - Docker Compose
+    - Kubernetes (minikube)
+    - Testcontainers
+  api_testing:
+    - Postman/Newman
+    - REST Assured
+    - Supertest
+  contract_testing:
+    - Pact
+    - Spring Cloud Contract
+
+coverage_target: "關鍵業務工作流程"

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

@@ -0,0 +1,82 @@
+# 單元測試 - AI 優化選項
+# 父項: testing
+
+id: unit-testing
+meta:
+  parent: testing
+  version: "1.0.0"
+  description: 隔離測試個別函式和方法
+  language: zh-TW
+
+characteristics:
+  scope: 單一函式或方法
+  speed: "<100ms 每個測試"
+  isolation: 完全隔離（無外部相依性）
+  pyramid_percentage: 70%
+
+rules:
+  - id: test-one-thing
+    trigger: 撰寫單元測試時
+    instruction: 每個測試應只驗證一個行為
+    priority: required
+
+  - id: isolate-dependencies
+    trigger: 測試有相依性時
+    instruction: 對外部相依性使用 stub/mock
+    priority: required
+
+  - id: fast-execution
+    trigger: 撰寫單元測試時
+    instruction: 單元測試必須在 100ms 內執行完成
+    priority: required
+
+  - id: naming-convention
+    trigger: 命名單元測試時
+    instruction: 使用模式 methodName_scenario_expectedResult
+    priority: recommended
+    examples:
+      good:
+        - "calculateTotal_withEmptyCart_returnsZero"
+        - "validateEmail_withInvalidFormat_returnsFalse"
+      bad:
+        - "test1"
+        - "testCalculate"
+
+  - id: arrange-act-assert
+    trigger: 組織測試結構時
+    instruction: 在測試內文中遵循 AAA 模式
+    priority: required
+
+structure:
+  pattern: "Arrange-Act-Assert"
+  example: |
+    // Arrange - 準備
+    const calculator = new Calculator();
+    const input = 5;
+
+    // Act - 執行
+    const result = calculator.square(input);
+
+    // Assert - 驗證
+    expect(result).toBe(25);
+
+when_to_write:
+  - 測試純函式
+  - 測試商業邏輯
+  - 測試資料轉換
+  - 測試驗證規則
+  - 測試邊緣案例和邊界
+
+when_not_to_write:
+  - 測試框架程式碼
+  - 測試簡單的 getter/setter
+  - 測試第三方函式庫
+
+coverage_target: "商業邏輯的 80%"
+
+tools:
+  javascript: [Jest, Vitest, Mocha]
+  python: [pytest, unittest]
+  java: [JUnit, TestNG]
+  csharp: [xUnit, NUnit, MSTest]
+  go: [testing package, testify]