04-integration-tests.md

整合測試規範 (Integration Tests)

目標讀者：QA 工程師與開發人員。
背景：驗證跨多個元件與資料來源的流程是否運作正常。

1. 整合流程 (約 12 個案例)

05-e2e-tests.md

端到端測試規範 (E2E Tests)

目標讀者：QA 工程師與 CI/CD 流程。
背景：實體裝置、全整合的使用者旅程測試，驗證完整的認證練習應用程式。

1. 端到端路徑 (約 6 個案例)

E2E-001：快樂路徑 (訪客升級至 Premium)

• 步驟：
  1. 首次開啟應用程式。
  2. 選擇「訪客登入」。
  3. 進入認證考試（例如標準網路題庫）。觸發 10 題付費牆限制。
  4. 前往設定 -> 使用 Google 登入。
  5. 前往訂閱 -> 透過 RevenueCat 沙盒購買 Premium。
  6. 返回測驗 -> 驗證現在可存取超過 10 題的題目。

E2E-002：管理員管理路徑

• 步驟：
  1. 使用管理員憑證登入。
  2. 前往管理面板 -> 管理使用者 -> 將 "pending" (待審核) 使用者升級為 "viewer" (檢視者)。
  3. 前往題目編輯器 -> 新增一題拖放題。
  4. 提交並核准該題目。
  5. 驗證新題目立即顯示在標準考試清單中。

E2E-003：安全防護路徑

• 步驟：
  1. 在已 Root 的模擬器上啟動應用程式。
  2. 驗證應用程式立即顯示「安全違規：偵測到 Root」並強制關閉。
  3. (在標準裝置上) 手動更改系統時間 (NTP 欺騙)。
  4. 驗證應用程式因時間驗證失敗而阻擋測驗存取。

E2E-004：離線可靠性路徑

• 步驟：
  1. 在連線狀態下成功登入。
  2. 下載考試資源以供離線使用 (PowerSync 快取)。
  3. 開啟飛航模式。
  4. 完成 50 題的模擬測驗。
  5. 重新連接 WiFi。
  6. 驗證儀表板進行同步，並在遠端伺服器更新「總答題數」指標。

E2E-005：多國語系 UI 路徑

• 步驟：
  1. 前往設定 -> 將語言切換為日文。
  2. 驗證側邊欄選單、測驗按鈕及詳解頁籤切換為日文 (JA)。
  3. 切換為繁體中文 (zh-TW)。
  4. 驗證網路術語嚴格使用在地詞彙（例如：路由器、預設閘道）。
  5. 切換為英文。驗證復原狀態。

E2E-006：AI 家教與語音 (TTS) 路徑

• 步驟：
  1. 開啟一道複雜的模擬題。
  2. 點擊 AI 家教懸浮按鈕 (FAB)。
  3. 詢問「為什麼這是正確答案？」並等待串流回應。
  4. 點擊 AI 回應上的 TTS (語音) 按鈕。
  5. 驗證語音播放至結束。
  6. 點擊「匯出至筆記」 -> 驗證詳解出現在筆記檢視器中。

06-test-matrix.md

測試矩陣規範 (Test Matrices)

目標讀者：QA 架構師與產品經理。
背景：概述練習測驗系統在各項功能、平台及使用者角色間的測試涵蓋對應關係。

1. 功能 × 測試類型矩陣

2. 平台 × 功能矩陣

3. 角色 × 功能矩陣