217 lines
6.2 KiB
Markdown
217 lines
6.2 KiB
Markdown
# 智能複習系統 - 測試規格書 (TSP)
|
||
|
||
**目標讀者**: QA工程師、測試人員
|
||
**版本**: 1.0
|
||
**日期**: 2025-09-25
|
||
|
||
---
|
||
|
||
## 🎯 **測試範圍**
|
||
|
||
### **測試目標**
|
||
- 驗證間隔計算算法正確性
|
||
- 確保逾期處理邏輯合理
|
||
- 驗證API輸入輸出正確性
|
||
- 確保系統性能符合要求
|
||
|
||
### **不測試範圍**
|
||
- 前端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
|
||
```
|
||
|
||
---
|
||
|
||
## ❌ **負向測試案例**
|
||
|
||
### **輸入驗證測試**
|
||
| 測試案例 | 輸入值 | 預期結果 | 錯誤代碼 |
|
||
|---------|-------|---------|----------|
|
||
| 信心等級過高 | 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 |
|
||
|
||
### **邊界條件測試**
|
||
```
|
||
# 極值測試
|
||
- 間隔 = 0: 應設為最小值 1天
|
||
- 間隔 = 999: 應限制為最大值 365天
|
||
- timesCorrect > totalReviews: 應拋出異常
|
||
- totalReviews = 0: 熟悉程度應為 0%
|
||
```
|
||
|
||
### **併發測試**
|
||
```
|
||
# 同一詞卡多客戶端同時更新
|
||
- 10個並發請求更新同一詞卡
|
||
- 驗證資料一致性，無競態條件
|
||
- 確保間隔計算結果正確
|
||
```
|
||
|
||
---
|
||
|
||
## ⚡ **性能測試**
|
||
|
||
### **響應時間測試**
|
||
| 測試場景 | 目標 | 測試方法 |
|
||
|---------|------|---------|
|
||
| 單次復習記錄 | < 100ms | 100次請求平均值 |
|
||
| 複習列表查詢 | < 500ms | 查詢50個到期詞卡 |
|
||
| 批量數據更新 | < 5s | 1000個詞卡批量更新 |
|
||
|
||
### **併發測試**
|
||
```
|
||
負載測試場景:
|
||
- 100 併發用戶，持續5分鐘
|
||
- 1000 併發用戶，持續1分鐘
|
||
- 驗證: 響應時間不超過目標2倍，無錯誤
|
||
```
|
||
|
||
### **資源消耗測試**
|
||
- **記憶體**: 監控記憶體洩漏，增長 < 10MB
|
||
- **CPU**: 算法計算不應導致CPU過載
|
||
- **資料庫連線**: 連線池使用合理，無死鎖
|
||
|
||
---
|
||
|
||
## 🔧 **測試環境設定**
|
||
|
||
### **測試資料準備**
|
||
```sql
|
||
-- 創建測試用詞卡數據
|
||
INSERT INTO Flashcards (Word, NextReviewDate, IntervalDays, TimesCorrect, TotalReviews)
|
||
VALUES
|
||
('test1', '2025-09-25', 1, 0, 0), -- 新詞卡
|
||
('test2', '2025-09-20', 7, 3, 4), -- 逾期詞卡
|
||
('test3', '2025-09-25', 30, 8, 10), -- 正常詞卡
|
||
('test4', '2025-08-25', 90, 15, 15); -- 極度逾期
|
||
```
|
||
|
||
### **測試工具**
|
||
- **單元測試**: xUnit/NUnit
|
||
- **API測試**: Postman/Newman
|
||
- **負載測試**: JMeter/k6
|
||
- **資料庫測試**: 直接SQL驗證
|
||
|
||
---
|
||
|
||
## 📋 **測試檢查清單**
|
||
|
||
### **功能測試 (必須100%通過)**
|
||
- [ ] 所有間隔計算測試案例
|
||
- [ ] 信心等級映射正確
|
||
- [ ] 逾期處理邏輯正確
|
||
- [ ] 熟悉程度計算準確
|
||
- [ ] API輸入驗證完整
|
||
|
||
### **非功能測試**
|
||
- [ ] 響應時間符合要求
|
||
- [ ] 併發測試無錯誤
|
||
- [ ] 記憶體使用穩定
|
||
- [ ] 負向測試全部通過
|
||
|
||
### **整合測試**
|
||
- [ ] 與現有系統相容
|
||
- [ ] 資料庫操作正確
|
||
- [ ] 錯誤處理機制有效
|
||
|
||
---
|
||
|
||
## 🐛 **缺陷分類**
|
||
|
||
### **嚴重等級定義**
|
||
- **P0 (Blocker)**: 算法計算錯誤、系統崩潰
|
||
- **P1 (Critical)**: 逾期處理錯誤、性能不達標
|
||
- **P2 (Major)**: 輸入驗證缺失、錯誤訊息不準確
|
||
- **P3 (Minor)**: 日誌格式、響應字段缺失
|
||
|
||
### **測試報告模板**
|
||
```
|
||
缺陷標題: [模組] 簡短描述
|
||
重現步驟:
|
||
1. 準備測試數據
|
||
2. 發送API請求
|
||
3. 檢查響應結果
|
||
預期結果: XX
|
||
實際結果: XX
|
||
影響範圍: XX用戶功能
|
||
```
|
||
|
||
---
|
||
|
||
## 📊 **測試完成標準**
|
||
|
||
### **通過標準**
|
||
- 功能測試用例通過率 = 100%
|
||
- 性能測試通過率 ≥ 95%
|
||
- 負向測試覆蓋率 ≥ 90%
|
||
- P0/P1缺陷數量 = 0
|
||
|
||
### **測試報告**
|
||
- 測試執行總結
|
||
- 缺陷統計和分析
|
||
- 性能測試結果
|
||
- 風險評估和建議
|
||
|
||
---
|
||
|
||
**測試負責人**: [待指派]
|
||
**測試週期**: 1個工作日
|
||
**發布建議**: 所有P0/P1缺陷修復後可發布 |