# 智能複習系統 - 測試規格書 (TSP)

**目標讀者**: QA工程師、測試人員
**版本**: 1.0
**日期**: 2025-09-25

---

## 🎯 **測試範圍**

### **測試目標**
- 驗證間隔計算算法正確性
- 確保逾期處理邏輯合理
- 驗證API輸入輸出正確性
- 確保系統性能符合要求
- 驗證7種複習題型功能正確性
- 測試智能題型推薦算法準確性
- 確保音頻功能在不同設備上正常運作
- 驗證A1學習者專屬邏輯

### **不測試範圍**
- 前端UI/UX測試
- 第三方服務整合測試
- 語音識別準確度 (依賴第三方服務)
- 音頻品質主觀評價

---

## ✅ **功能測試案例**

### **TC-001: 基本間隔計算**
| 測試案例 | 輸入 | 預期輸出 | 優先級 |
|---------|------|---------|--------|
| 新詞答對 | interval=1, isCorrect=true | newInterval=2 | P0 |
| 新詞答錯 | interval=1, isCorrect=false | newInterval=1 | P0 |
| 短期答對 | interval=5, isCorrect=true | newInterval≈9 | P0 |
| 長期答對 | interval=100, isCorrect=true | newInterval≈110 | P1 |

### **TC-002: 信心等級測試**
| 信心等級 | 預期係數 | 測試數據 | 狀態 |
|---------|---------|---------|------|
| 1 (很不確定) | 0.5 | interval=10 → newInterval≈9 | ✅ |
| 3 (一般) | 0.9 | interval=10 → newInterval≈16 | ✅ |
| 5 (很確定) | 1.4 | interval=10 → newInterval≈25 | ✅ |

### **TC-003: 逾期復習測試**
```gherkin
Scenario: 輕度逾期復習 (時間基準驗證)
  Given 詞卡預定 2025-09-20 復習，原間隔7天
  When 用戶在 2025-09-23 復習 (逾期3天)
  And 用戶答對，信心等級4
  Then 逾期天數 = 3天，應該應用懲罰係數 0.9
  And 新間隔 = 7 × 1.8 × 1.1 × 0.9 = 12天
  And 下次復習日期 = 2025-09-23 + 12天 = 2025-10-05 (以復習當日為基準)

Scenario: 極度逾期復習
  Given 詞卡預定 2025-08-20 復習
  When 用戶在 2025-09-25 復習 (逾期36天)
  And 用戶答對
  Then 應該應用重度懲罰係數 0.3
  And 熟悉程度應該大幅衰減
```

### **TC-004: 時間基準專項測試**
```gherkin
Scenario: 驗證時間基準計算正確性
  Given 詞卡預定 2025-09-20 復習，原間隔14天
  When 用戶在 2025-09-25 復習 (逾期5天)
  And 用戶答對，信心等級4
  Then 逾期天數計算 = 5天
  And 新間隔 = 14 × 1.4 × 1.1 × 0.75 = 16天
  And 下次復習日期 = 2025-09-25 + 16天 = 2025-10-11
  And 而非錯誤的 = 2025-09-20 + 16天 = 2025-10-06

Scenario: 準時復習基準測試
  Given 詞卡預定 2025-09-20 復習，原間隔14天
  When 用戶在 2025-09-20 準時復習
  And 用戶答對，信心等級4
  Then 逾期天數 = 0天，無懲罰係數
  And 新間隔 = 14 × 1.4 × 1.1 = 21天
  And 下次復習日期 = 2025-09-20 + 21天 = 2025-10-11
```

### **TC-010: 複習題型選擇測試**
```gherkin
Scenario: A1學習者題型選擇
  Given 用戶是A1程度學習者 (userLevel = 15)
  When 系統為其推薦複習題型
  Then 推薦題型應限制為 ["flipcard", "multiple_choice", "vocabulary_listening"]
  And 不應推薦 ["fill_blank", "sentence_reconstruction", "sentence_speaking"]

Scenario: 簡單詞彙題型選擇
  Given 用戶程度60，詞彙難度40 (difficulty = -20)
  When 系統計算適合的複習題型
  Then 推薦題型應為 ["sentence_reconstruction", "fill_blank"]

Scenario: 困難詞彙題型選擇
  Given 用戶程度40，詞彙難度70 (difficulty = +30)
  When 系統計算適合的複習題型
  Then 推薦題型應為 ["flipcard", "multiple_choice"]
```

### **TC-011: 翻卡題測試**
| 測試案例 | 輸入 | 預期輸出 | 優先級 |
|---------|------|---------|--------|
| 高信心翻卡 | confidenceLevel=5 | performanceFactor=1.4 | P0 |
| 低信心翻卡 | confidenceLevel=1 | performanceFactor=0.5 | P0 |
| 中等信心翻卡 | confidenceLevel=3 | performanceFactor=0.9 | P1 |

### **TC-012: 選擇題測試**
```gherkin
Scenario: 選擇題答對
  Given 詞卡 "apple" 定義 "a red fruit"
  When 用戶選擇正確答案 "apple"
  Then isCorrect = true
  And performanceFactor = 1.1

Scenario: 選擇題答錯
  Given 詞卡 "apple" 定義 "a red fruit"
  When 用戶選擇錯誤答案 "orange"
  Then isCorrect = false
  And performanceFactor = 0.6
```

### **TC-013: 填空題測試**
```gherkin
Scenario: 填空題拼字正確
  Given 例句 "I eat an ___ every day"
  And 正確答案 "apple"
  When 用戶填入 "apple"
  Then 答案應標記為正確

Scenario: 填空題大小寫不敏感
  Given 例句 "I eat an ___ every day"
  And 正確答案 "apple"
  When 用戶填入 "Apple" 或 "APPLE"
  Then 答案應標記為正確
```

### **TC-014: 例句重組測試**
```gherkin
Scenario: 句子重組正確
  Given 打亂的單字 ["I", "eat", "an", "apple"]
  And 正確順序 "I eat an apple"
  When 用戶重組為 "I eat an apple"
  Then 答案應標記為正確

Scenario: 句子重組順序錯誤
  Given 打亂的單字 ["I", "eat", "an", "apple"]
  When 用戶重組為 "apple eat I an"
  Then 答案應標記為錯誤
```

### **TC-015: 聽力題測試**
```gherkin
Scenario: 詞彙聽力題
  Given 音頻檔案播放 "apple"
  And 選項 ["apple", "orange", "banana"]
  When 用戶選擇 "apple"
  Then 答案應標記為正確

Scenario: 音頻載入失敗
  Given 音頻檔案不存在或損壞
  When 用戶嘗試播放音頻
  Then 系統應顯示錯誤訊息
  And 提供跳過此題的選項
```

### **TC-016: 口說題測試**
```gherkin
Scenario: 口說錄音成功
  Given 用戶設備支援麥克風
  When 用戶開始錄音並說話
  Then 應成功錄製音頻檔案
  And 檔案大小應 > 0

Scenario: 麥克風權限被拒絕
  Given 用戶拒絕麥克風權限
  When 系統嘗試開始錄音
  Then 應顯示權限請求提示
  And 提供手動授權指導
```

### **TC-017: 智能自動選擇系統測試**
```gherkin
Scenario: 自動避免連續重複題型
  Given 用戶最近3次都使用翻卡題
  When 系統自動選擇下一個題型
  Then 不應選擇翻卡題
  And 應自動從其他適配題型中選擇

Scenario: A1學習者自動保護測試
  Given A1學習者 (userLevel = 15)
  When 系統自動選擇題型100次
  Then 只應出現 ["flipcard", "multiple_choice", "vocabulary_listening"]
  And 不應出現任何高階題型

Scenario: 四情境自動適配測試
  Given 簡單詞彙情境 (userLevel=70, wordLevel=40)
  When 系統自動選擇題型
  Then 應選擇 ["sentence_reconstruction", "fill_blank"] 中的一種
  And 不應選擇基礎題型
```

### **TC-018: A1學習者無障礙體驗測試**
```gherkin
Scenario: A1學習者自動信心建立
  Given A1用戶 (userLevel ≤ 20)
  When 系統自動選擇並執行復習
  Then 應自動選擇成功率較高的基礎題型
  And 應提供鼓勵性反饋
  And 用戶無需了解題型複雜度

Scenario: A1學習者零選擇體驗
  Given A1用戶進入復習頁面
  When 用戶看到復習界面
  Then 不應顯示任何題型選擇選項
  And 應直接顯示適合的題目
  And 應顯示"系統智能選擇"提示
```

---

## ❌ **負向測試案例**

### **輸入驗證測試**
| 測試案例 | 輸入值 | 預期結果 | 錯誤代碼 |
|---------|-------|---------|----------|
| 信心等級過高 | confidenceLevel=6 | 400錯誤 | VALUE_OUT_OF_RANGE |
| 信心等級過低 | confidenceLevel=0 | 400錯誤 | VALUE_OUT_OF_RANGE |
| 缺少必填欄位 | {} | 400錯誤 | MISSING_REQUIRED_FIELD |
| 錯誤資料類型 | isCorrect="yes" | 400錯誤 | INVALID_INPUT |
| 不存在詞卡ID | id=99999 | 404錯誤 | FLASHCARD_NOT_FOUND |
| 不支援的題型 | questionType="unknown" | 400錯誤 | INVALID_QUESTION_TYPE |
| 空白用戶答案 | userAnswer="" | 400錯誤 | EMPTY_ANSWER |
| 音頻檔案過大 | audioFile > 10MB | 413錯誤 | FILE_TOO_LARGE |
| 用戶程度異常 | userLevel = -1 | 400錯誤 | INVALID_USER_LEVEL |
| 詞彙程度異常 | wordLevel > 100 | 400錯誤 | INVALID_WORD_LEVEL |

### **邊界條件測試**
```
# 極值測試
- 間隔 = 0: 應設為最小值 1天
- 間隔 = 999: 應限制為最大值 365天
- timesCorrect > totalReviews: 應拋出異常
- totalReviews = 0: 熟悉程度應為 0%

# 自動選擇邊界測試
- userLevel = 20: 應為A1學習者邊界，限制基礎題型
- difficulty = -10: 簡單詞彙邊界，應選擇應用題型
- difficulty = 10: 適中詞彙邊界，應選擇全方位題型
- 無歷史記錄: 系統應能正常選擇題型
```

### **併發測試**
```
# 同一詞卡多客戶端同時更新
- 10個並發請求更新同一詞卡
- 驗證資料一致性，無競態條件
- 確保間隔計算結果正確
```

---

## ⚡ **性能測試**

### **響應時間測試**
| 測試場景 | 目標 | 測試方法 |
|---------|------|---------|
| 單次復習記錄 | < 100ms | 100次請求平均值 |
| 複習列表查詢 | < 500ms | 查詢50個到期詞卡 |
| 批量數據更新 | < 5s | 1000個詞卡批量更新 |
| 智能題型選擇算法 | < 10ms | 單次自動選擇響應時間 |
| 音頻檔案上傳 | < 3s | 5MB音頻檔案上傳 |
| 複習題目自動生成 | < 200ms | 包含題型選擇和題目生成 |
| A1用戶自動保護邏輯 | < 50ms | 程度檢查和題型自動篩選 |
| 四情境智能適配 | < 5ms | 難度計算和題型映射 |

### **併發測試**
```
負載測試場景:
- 100 併發用戶，持續5分鐘
- 1000 併發用戶，持續1分鐘
- 驗證: 響應時間不超過目標2倍，無錯誤
```

### **資源消耗測試**
- **記憶體**: 監控記憶體洩漏，增長 < 10MB
- **CPU**: 算法計算不應導致CPU過載
- **資料庫連線**: 連線池使用合理，無死鎖

---

## 🔧 **測試環境設定**

### **測試資料準備**
```sql
-- 創建測試用詞卡數據
INSERT INTO Flashcards (Word, Definition, Example, NextReviewDate, IntervalDays, TimesCorrect, TotalReviews, UserLevel, WordLevel)
VALUES
  ('test1', 'a test word', 'This is a test1 example', '2025-09-25', 1, 0, 0, 15, 20),      -- A1新詞卡
  ('test2', 'another test word', 'This is a test2 example', '2025-09-20', 7, 3, 4, 60, 40),      -- 簡單逾期詞卡
  ('test3', 'advanced test word', 'This is a test3 example', '2025-09-25', 30, 8, 10, 50, 50),    -- 適中詞卡
  ('test4', 'difficult test word', 'This is a test4 example', '2025-08-25', 90, 15, 15, 40, 70);   -- 困難逾期詞卡

-- 創建測試用音頻資料
INSERT INTO AudioFiles (FlashcardId, AudioType, FilePath)
VALUES
  (1, 'vocabulary', '/test-audio/test1-vocab.mp3'),
  (1, 'sentence', '/test-audio/test1-sentence.mp3'),
  (2, 'vocabulary', '/test-audio/test2-vocab.mp3');

-- 創建測試用選項資料 (選擇題用)
INSERT INTO QuestionOptions (FlashcardId, OptionText, IsCorrect)
VALUES
  (1, 'test1', true),
  (1, 'wrong1', false),
  (1, 'wrong2', false),
  (2, 'test2', true),
  (2, 'wrong3', false),
  (2, 'wrong4', false);
```

### **測試工具**
- **單元測試**: xUnit/NUnit
- **API測試**: Postman/Newman
- **負載測試**: JMeter/k6
- **資料庫測試**: 直接SQL驗證
- **音頻測試**:
  - 瀏覽器相容性測試: BrowserStack
  - 音頻檔案驗證: FFmpeg
  - 錄音功能測試: MediaRecorder API
- **演算法測試**:
  - 題型推薦準確性: 自訂測試框架
  - A1邏輯驗證: 單元測試 + 模擬資料
- **前端整合測試**: Cypress/Playwright (UI互動)

---

## 📋 **測試檢查清單**

### **功能測試 (必須100%通過)**
- [ ] 所有間隔計算測試案例
- [ ] 信心等級映射正確
- [ ] 逾期處理邏輯正確
- [ ] 熟悉程度計算準確
- [ ] API輸入驗證完整
- [ ] 7種複習題型功能正確
- [ ] 智能題型自動選擇準確
- [ ] A1學習者自動保護邏輯正確
- [ ] 四情境自動適配正確
- [ ] 音頻播放和錄製功能正常

### **複習題型專項測試**
- [ ] 翻卡題信心等級處理
- [ ] 選擇題答案驗證
- [ ] 填空題大小寫處理
- [ ] 例句重組邏輯正確
- [ ] 詞彙聽力音頻播放
- [ ] 例句聽力選項生成
- [ ] 口說題錄音和上傳

### **非功能測試**
- [ ] 響應時間符合要求
- [ ] 併發測試無錯誤
- [ ] 記憶體使用穩定
- [ ] 負向測試全部通過
- [ ] 音頻處理性能達標
- [ ] 題型推薦算法效能

### **整合測試**
- [ ] 與現有系統相容
- [ ] 資料庫操作正確
- [ ] 錯誤處理機制有效
- [ ] 前端題型組件整合
- [ ] 音頻API跨瀏覽器相容

### **零選擇體驗測試**
- [ ] 用戶無需進行任何題型選擇
- [ ] 系統自動選擇提示清晰
- [ ] A1學習者完全無障礙體驗
- [ ] 四情境自動適配透明化

### **用戶體驗測試**
- [ ] A1學習者友好性
- [ ] 自動選擇流暢性
- [ ] 音頻品質可接受
- [ ] 錯誤訊息清晰易懂

---

## 🐛 **缺陷分類**

### **嚴重等級定義**
- **P0 (Blocker)**: 算法計算錯誤、系統崩潰、主要題型無法使用
- **P1 (Critical)**: 逾期處理錯誤、性能不達標、音頻功能完全失效
- **P2 (Major)**: 輸入驗證缺失、錯誤訊息不準確、特定題型功能異常
- **P3 (Minor)**: 日誌格式、響應字段缺失、音頻品質次佳
- **P4 (Trivial)**: 題型推薦不夠精準、A1用戶體驗可優化

### **測試報告模板**
```
缺陷標題: [模組] 簡短描述
重現步驟:
1. 準備測試數據
2. 發送API請求
3. 檢查響應結果
預期結果: XX
實際結果: XX
影響範圍: XX用戶功能
```

---

## 📊 **測試完成標準**

### **通過標準**
- 功能測試用例通過率 = 100%
- 性能測試通過率 ≥ 95%
- 負向測試覆蓋率 ≥ 90%
- P0/P1缺陷數量 = 0

### **測試報告**
- 測試執行總結
- 缺陷統計和分析
- 性能測試結果
- 風險評估和建議

---

**測試負責人**: [待指派]
**測試週期**: 1個工作日
**發布建議**: 所有P0/P1缺陷修復後可發布