 鄭沛軒
|
c8330d2b78
|
feat: 新增複習系統完整架構 + 前端重構統一命名
主要新增:
- FlashcardReview 實體 + ReviewDTOs (後端複習系統基礎)
- DbContext 配置複習記錄關聯和唯一約束
- 前端技術規格實作版文檔 (含完整SA圖表)
- 後端規格v2.0 (基於前端需求更新)
前端重構:
- TestItem → QuizItem 統一命名
- testType → quizType 屬性統一
- 所有組件和Hook命名保持一致
- QuizProgress 組件增強視覺化顯示
架構改善:
- 數據庫設計支援間隔重複算法 (2^n天)
- API端點設計配合前端需求
- 完整的狀態管理和持久化策略
- 詳細的前端架構圖表和流程說明
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
|
2025-10-06 19:48:15 +08:00 |
|
鄭沛軒
|
51e5870390
|
feat: 實現線性雙測驗流程系統
## 主要功能
- 實現線性複習流程：A翻卡 → A選擇 → B翻卡 → B選擇...
- 測驗項目級別的狀態管理和進度追蹤
- 自動測驗類型切換，無需用戶選擇
## 核心改進
- 新增 TestItem 數據結構支援線性流程
- 重構 useReviewSession Hook 管理測驗項目
- 修正延遲計數系統優先級排序邏輯
- 統一兩種測驗的跳過按鈕位置
## 評分標準修正
- 翻卡記憶：一般(1分)以上算答對
- 詞彙選擇：正確選擇算答對
- 答錯的測驗項目不標記完成，會重新出現
## 用戶體驗改善
- 進入頁面自動開始線性測驗
- 清楚的測驗類型和進度指示
- 測驗項目序列可視化
- 延遲計數系統視覺反饋
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
|
2025-10-05 04:06:54 +08:00 |
|
鄭沛軒
|
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 |
|
鄭沛軒
|
57b653139e
|
feat: 完成延遲計數系統和MVP功能完善
## 核心功能實作
- 🎯 完整實作延遲計數系統 (skipCount + wrongCount + 智能排序)
- ⏭️ 添加跳過功能和按鈕
- 🎨 修正信心度為3選項 (模糊/一般/熟悉)
- 💾 實作localStorage進度自動保存和恢復
## 延遲計數邏輯
- 跳過操作: skipCount++ → 影響卡片排序優先級
- 答錯操作: wrongCount++ → 同樣影響排序
- 智能排序: 延遲分數越少越前面 (不排除，只是重新排序)
- 答對操作: 標記完成 → 不再出現在練習隊列
## UI/UX優化
- 跳過和確認按鈕並排設計
- 進度顯示包含延遲統計 (跳過次數、困難卡片)
- 信心度按鈕改為3欄布局
- 進度自動保存，重新載入不丟失
## 技術改善
- CardState接口擴展完整
- TypeScript錯誤完全修正
- 排序算法符合技術規格
- 保持極簡React架構
完整實現技術規格的延遲計數需求，MVP功能完善！
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
|
2025-10-04 19:25:48 +08:00 |
|
鄭沛軒
|
1b13429fc8
|
feat: 完善複習系統規格書 - 補充API呼叫策略和簡化設計
## 核心改進
- 💻 前端規格補充明確的API呼叫策略 (各階段何時呼叫)
- 🌐 後端規格大幅簡化 (移除過度複雜的統計分析)
- ⏰ 補充核心的間隔重複算法實作 (2^成功次數公式)
- 🧪 新增延遲計數系統測試規格 (TDD準備)
## API呼叫策略明確化
- 階段1: 完全不呼叫API (純靜態數據)
- 階段2: 仍不呼叫API (localStorage持久化)
- 階段3: 才開始API呼叫 (有明確的判斷邏輯)
- 錯誤降級: API失敗時自動使用靜態數據
## 後端設計簡化
- 移除複雜的ReviewSessions/ReviewAttempts表設計
- 只保留核心的FlashcardReviews表 (SuccessCount + NextReviewDate)
- 簡化Service層，專注間隔重複算法
- 避免過度工程的統計分析功能
## 技術細節完整性
- ✅ 信心度簡化為3選項 (模糊/一般/熟悉)
- ✅ 延遲計數系統測試案例完整
- ✅ 前後端協作邏輯清晰
- ✅ 符合極簡MVP理念
完整的6層文檔架構: 需求/技術/前端/後端/測試/控制
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
|
2025-10-04 17:55:33 +08:00 |
|
鄭沛軒
|
07a72da006
|
feat: 完整記錄詞彙選擇題設計規格 - 為階段2擴展做準備
## 技術實作規格增強
- 🎨 完整記錄您設計的 VocabChoiceTest 組件架構
- 📋 詳細的 ChoiceGrid 響應式網格設計
- 🎯 完整的 ChoiceOption 狀態樣式系統
- 🔧 三區域設計: 問題顯示/選項網格/結果顯示
## 設計規格詳情
- 組件接口: VocabChoiceTestProps 完整定義
- 狀態管理: selectedAnswer + showResult 邏輯
- 樣式系統: 正確(綠)/錯誤(紅)/選中(藍)/默認(灰)
- 響應式: grid-cols-1 sm:grid-cols-2 自適應布局
## 階段2擴展準備
- ✅ 有完整設計規格可參考實作
- ✅ 有明確的組件分工和職責
- ✅ 有詳細的UI樣式和交互邏輯
- ✅ 受開發控制規範約束避免過度工程
為未來的階段2詞彙選擇功能提供完整的實作指南
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
|
2025-10-04 16:19:23 +08:00 |
|
鄭沛軒
|
9307cb593d
|
docs: 建立複習系統三層文檔架構 - 解決實作細節歸屬問題
## 核心成就
- 📚 建立專業的三層文檔架構
- 📋 產品需求規格.md - 用戶故事和業務目標
- 🔧 技術實作規格.md - 具體算法、公式、UI規格
- 🛡️ 開發控制規範.md - 防過度工程的約束規則
- 📖 README.md - 文檔使用指南和關聯索引
## 解決的問題
- ✅ 實作細節有專門歸屬 (技術實作規格)
- ✅ 開發控制有明確約束 (開發控制規範)
- ✅ 產品需求保持高層次 (產品需求規格)
- ✅ 防止開發失控有具體機制
## 實作細節完整保留
- 進度條計算公式: (今日完成)/(今日完成+今日到期)
- 延遲註記機制: 跳過/答錯 → 延遲標記
- 複習時間算法: 2^成功複習次數
- 詞彙選擇題方案: 固定apple/orange/banana選項
## 過度工程防護
- 複雜度上限、禁止功能、檢查點機制
- 基於實際失敗經驗的約束規則
- 階段性擴展的決策框架
完美平衡: 詳細技術規格 + 有效開發控制
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
|
2025-10-04 15:55:41 +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 |