Commit Graph

2 Commits

Author SHA1 Message Date
鄭沛軒 491f184c4e docs: 新增智能填空題系統設計規格書
建立完整的系統重構規格,解決當前填空題挖空邏輯的限制:

## 核心設計
- 將挖空邏輯從前端移至後端統一處理
- 新增 FilledQuestionText 欄位儲存挖空後的題目
- 建立程式碼挖空 + AI輔助的雙重回退機制

## 解決問題
- 支援詞彙變形挖空 (eat/ate, go/went 等)
- 處理複數、比較級、過去分詞等語法變化
- 提供AI輔助確保挖空準確性

## 系統架構
- 後端: BlankGenerationService + API端點強化
- 前端: 簡化SentenceFillTest組件邏輯
- 資料庫: Migration添加新欄位

## 實施計劃
分4個階段: 資料庫結構 → 後端服務 → 前端優化 → 測試優化

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-28 00:37:25 +08:00
鄭沛軒 afd0e660ef refactor: 完成Learn→Review重命名和Navigation死代碼清理
## Learn → Review 語義重命名
- 目錄結構: learn/ → review/ (內部架構)
- 測驗組件目錄: tests/ → review-tests/
- 狀態管理: useLearnStore → useReviewStore
- 服務層: LearnService → ReviewService
- 核心組件: TestRunner → ReviewRunner

## Navigation.tsx 死代碼清理
- 移除從未使用的 showExitLearning 和 onExitLearning props
- 刪除永不顯示的「結束複習」按鈕邏輯
- 簡化函數簽名,提升代碼可讀性
- 更新導航文字:「學習」→「複習」

## 架構優化成果
- 語義更精確:review(複習) 比 learn(學習) 更準確描述功能
- 代碼更清潔:移除16行左右的死代碼
- 用戶體驗保持:/learn 路由依然正常運作
- 維護性提升:組件職責更明確,擴展更容易

## 技術改進
- 保持完整的企業級4層架構
- 7種測驗組件完整重命名
- Zustand狀態管理語義優化
- 路由兼容性確保用戶無感知

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-27 18:18:43 +08:00