Commit Graph

4 Commits

Author SHA1 Message Date
鄭沛軒 1fa8835e09 fix: 修正TypeScript類型錯誤 + 完善延遲計數系統
## TypeScript修正
- 🔧 修正所有filter函數的隱式any類型錯誤
- 📊 明確CardState類型聲明
-  保持功能完全正常運行

## 延遲計數系統完善
- 🎯 詞彙順序可視化完全可用
- 📊 真實狀態顏色顯示 (不被當前高亮遮蔽)
- 🔄 Skip功能統一重置邏輯
- 💾 進度自動保存和恢復

## 用戶體驗優化
-  選擇即提交 (無需確認)
- 🔄 Skip也會翻回正面 (統一行為)
- 🎨 狀態顏色便於驗證延遲計數效果
- 📍 第1個位置表示當前,顏色表示延遲狀態

MVP階段1完全完成,準備進入雙模式階段2

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-04 21:14:39 +08:00
鄭沛軒 546db58146 docs: 整理複習功能文檔結構 + 完成極簡MVP開發
## 文檔整理
- 📁 重新組織複習系統文檔到 note/複習系統/
- 🧹 清理舊的智能複習文檔到 _old 目錄
- 📋 新增產品需求規格書 (階段性開發版本)

## 極簡MVP最終優化
- 🔧 按鈕文字微調: "下一張" (用戶友好)
-  完整復用您的調教設計
-  真實API數據結構集成

## 項目里程碑
從複雜壞掉的功能 → 專業可用的極簡MVP
- 解決過度工程問題
- 保持設計品質
- 建立可迭代基礎

準備進入穩定使用和用戶驗證階段

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-04 15:22:36 +08:00
鄭沛軒 82a959863d feat: 完成智能複習系統7種複習方式整合與文檔更新
## 📋 主要更新內容

### 🎯 新增7種複習題型設計
- 翻卡題: 基於信心程度的主觀評估
- 選擇題: 定義匹配的客觀測試
- 填空題: 拼字練習和情境應用
- 例句重組: 語法和句型練習
- 詞彙聽力: 發音記憶強化
- 例句聽力: 聽力理解練習
- 例句口說: 發音和表達練習

### 🧠 智能題型推薦算法
- A1學習者專屬保護機制
- 根據學習程度vs詞彙難度適配題型
- 避免連續重複,確保學習多樣性
- 基於表現動態調整推薦策略

### 📚 文檔全面更新
- **前端功能規格書**: 新增完整React組件實現
- **產品需求規格書**: 擴展用戶故事和功能需求
- **測試規格書**: 新增8個複習題型測試案例
- **演算法規格書**: 完善複習方式選擇算法

### 🎨 用戶體驗優化
- A1初學者友好的學習路徑
- 音頻錄製和播放功能整合
- 程度適配的漸進式題型解鎖
- 智能推薦準確率>75%目標

## 🔧 技術實現亮點
- 7種題型的完整前端組件
- 複習方式選擇算法 (O(k)複雜度)
- A1學習者權重分配機制
- 音頻API跨瀏覽器兼容處理

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-25 16:40:36 +08:00
鄭沛軒 434d320377 refactor: 重構智能複習系統文檔架構並明確逾期時間基準
## 文檔架構重構
- 將原始875行複雜規格書拆分為4個角色專用文檔
- 創建清晰的文檔索引,提升可讀性和維護性

### 📚 新增文檔結構
- **產品需求規格書** - 業務目標、用戶故事、KPI (~2頁)
- **技術規格書** - 系統架構、API設計、資料庫 (~3頁)
- **演算法規格書** - 數學模型、參數調優 (~3頁)
- **測試規格書** - 測試案例、負向測試 (~3頁)
- **文檔索引** - 導航和快速開始指南

## 明確逾期時間基準
- 解決關鍵歧義:下次復習時間以**復習行為當日**為基準
- 更新算法公式:下次復習日期 = 復習行為當日 + 新間隔
- 新增時間基準專項測試案例 (TC-004)
- 避免累積逾期問題,提升用戶體驗

## 文檔清理
- 移除過時的複習算法相關文檔
- 重新整理 note/智能複習/ 目錄結構
- 調整 check-architecture.sh 位置

## 技術改進
- 明確 actualReviewDate 概念和計算邏輯
- API 響應增加 isOverdue 和 overdueDays 欄位
- 完善邊界條件和測試覆蓋

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-25 15:37:33 +08:00