 鄭沛軒
|
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 |
|
鄭沛軒
|
5a9e7f727c
|
feat: 統一所有選擇題組件的選項布局和圖片功能
## 主要改動
### 響應式選項布局統一
- VocabChoiceTest: 改為2x2網格布局，支援響應式設計
- VocabListeningTest: 添加響應式斷點 (grid-cols-1 sm:grid-cols-2)
- SentenceListeningTest: 改為響應式2x2網格，移除選項標籤
### 圖片功能完善
- SentenceListeningTest: 新增exampleImage和onImageClick支援
- 添加完整的圖片顯示區塊和點擊處理
- review-design頁面: 為SentenceListeningTest傳遞圖片屬性
### 視覺一致性提升
- 所有選擇題組件採用相同的按鈕樣式和網格布局
- 統一文字置中對齊和font-medium字重
- 手機版自動切換為單列布局，提升觸控體驗
- 桌面版使用2x2網格，充分利用屏幕空間
### 響應式設計
- 小屏幕 (< 640px): 選項垂直單列排列
- 中等以上屏幕 (≥ 640px): 選項2x2網格排列
- 保持所有組件一致的響應式行為
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
|
2025-09-28 00:18:10 +08:00 |
|
鄭沛軒
|
ceaf61c89b
|
feat: 實現FlipMemoryTest動態高度自適應
- 移除固定600px高度限制，改為根據背面內容動態計算
- 新增useEffect監聽內容變化並自動調整卡片高度
- 實現響應式設計，不同屏幕尺寸有對應的最小高度
- 移除背面滾動條，改為完全展示所有內容
- 優化CSS動畫過渡效果，提升翻卡體驗
- 新增底部留白避免內容貼邊
- 清理舊的備份測試文件
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
|
2025-09-27 21:57:47 +08:00 |
|
鄭沛軒
|
a1cf784805
|
feat: 優化FlipMemoryTest組件用戶體驗
- 將信心等級按鈕移到翻卡外面，裸露在背景上
- 移除按鈕數字，只顯示文字描述且字體更大
- 修復音頻播放按鈕點擊會觸發翻面的問題
- 增加翻卡容器高度至600px提供更多內容空間
- 翻卡背面只保留純學習內容（定義、例句、同義詞）
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
|
2025-09-27 21:42:37 +08:00 |
|
鄭沛軒
|
4aee37540b
|
fix: 修復FlipMemoryTest翻卡組件顯示問題
- 修正翻卡容器結構，讓整個卡片翻轉而非僅內容
- 將卡片樣式從外層容器移到翻轉容器
- 增加容器高度從400px到500px以容納背面更多內容
- 為背面內容添加overflow-y-auto防止內容溢出
- 移除重複的卡片樣式，統一視覺效果
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
|
2025-09-27 21:18:22 +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 |
|
鄭沛軒
|
52ae910276
|
feat: 實現純CEFR字符串智能複習系統和完整四情境對照表
- 將雙欄位架構改為純CEFR字符串架構，消除資料冗余
- 後端API改為接收CEFR字符串，使用即時轉換進行計算
- 前端完全使用CEFR等級進行智能選擇和顯示
- 新增完整四情境對照表，突出顯示當前情境和建議複習方式
- 優化沒有到期詞卡時的用戶體驗，提供專用提示頁面
- 修復例句重組結果閃爍重置問題
- 修復AudioPlayer在p標籤內的HTML結構錯誤
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
|
2025-09-25 21:05:54 +08:00 |
|
鄭沛軒
|
3ef5ea8ffe
|
feat: 實現智能複習系統前端核心重構
## 🎯 重構完成項目
### ✅ 移除手動模式切換
- 刪除7個手動切換按鈕 (lines 337-410)
- 改為系統自動選擇模式
- 保留所有優秀的UI設計和互動邏輯
### ✅ 新增智能化組件
- **ReviewTypeIndicator**: 純顯示當前系統選擇的題型
- **MasteryIndicator**: 實時熟悉度顯示，支援衰減指示
- **masteryCalculator**: 四情境適配邏輯 + 熟悉度計算
### ✅ API服務擴展
- 擴展 flashcardsService 新增6個智能複習方法
- getDueFlashcards: 取得到期詞卡
- getNextReviewCard: 取得下一張復習詞卡
- getOptimalReviewMode: 系統自動選擇題型
- submitReview: 提交復習結果並更新間隔
- generateQuestionOptions: 生成題目選項
### ✅ 狀態管理升級
- 從固定 mock data 改為動態 API 數據
- 新增 ExtendedFlashcard 接口支援智能複習欄位
- 實現自動選擇邏輯和四情境適配
- 整合復習結果提交和熟悉度更新
### ✅ 例句聽力功能補完
- 新增例句選項自動生成邏輯
- 實現例句聽力答題和結果反饋
- 移除"開發中"標記，功能正式可用
## 🌟 核心價值實現
- **零選擇負擔**: 用戶無需手動選擇，系統自動提供最適合的題型
- **四情境適配**: A1學習者自動保護，簡單/適中/困難詞彙智能匹配
- **7種題型完整**: 所有複習方法UI和邏輯都已完成
- **實時熟悉度**: 動態計算和顯示學習進度
## 🎨 UI設計保留
- ✅ 精美的3D翻卡動畫
- ✅ 完整的音頻播放和錄音功能
- ✅ 響應式設計和流暢互動
- ✅ 詳細的答題反饋和錯誤處理
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
|
2025-09-25 18:01:25 +08:00 |