dramaling-vocab-learning

Commit Graph

Author	SHA1	Message	Date
鄭沛軒	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
鄭沛軒	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

Author

SHA1

Message

Date

鄭沛軒

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

鄭沛軒

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

2 Commits