jettcheng1018
/
dramaling-vocab-learning
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
166 Commits 1 Branch 0 Tags 150 MiB
Commit Graph

10 Commits

Author SHA1 Message Date
鄭沛軒 1987643f6d docs: 更新智能複習系統規格書和測試腳本 
- 更新產品需求規格書，反映CEFR架構和完成狀態
- 更新前後端功能規格書，描述純CEFR字符串實現
- 新增CEFR系統更新完成報告
- 新增串接測試腳本和完成報告
- 所有文檔現已準確反映智能複習系統的實際架構

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-25 21:07:54 +08:00
鄭沛軒 ff4c64f1a3 feat: 完成智能複習系統後端核心功能實現 
## 🎯 開發成果總結

### ✅ 數據層擴展
- **Flashcard模型**: 新增4個智能複習欄位 (UserLevel, WordLevel, ReviewHistory, LastQuestionType)
- **資料庫遷移**: AddSpacedRepetitionFields 成功執行
- **CEFR映射**: 完整的等級到難度映射服務
- **配置管理**: appsettings.json 新增SpacedRepetition配置段

### ✅ 服務層實現
- **SpacedRepetitionService**: 基於現有SM2Algorithm擴展的核心間隔重複服務
- **ReviewTypeSelectorService**: 四情境智能題型選擇 (A1保護+避重邏輯)
- **QuestionGeneratorService**: 動態題目生成 (選擇題、填空、重組、聽力)
- **CEFRMappingService**: 完整的CEFR等級映射工具

### ✅ API層擴展 (FlashcardsController)
- **GET /api/flashcards/due** - 到期詞卡列表 ✅
- **GET /api/flashcards/next-review** - 下一張復習詞卡 ✅
- **POST /api/flashcards/{id}/optimal-review-mode** - 智能題型選擇 ✅
- **POST /api/flashcards/{id}/question** - 題目生成 (部分完成)
- **POST /api/flashcards/{id}/review** - 復習結果提交 ✅

### ✅ 架構整合
- **零破壞性變更**: 現有詞卡功能完全不受影響
- **服務依賴注入**: 完整整合到現有DI容器
- **配置選項模式**: 使用ASP.NET Core標準配置模式
- **錯誤處理**: 統一的異常處理和日誌記錄

## 🧪 API測試驗證

### 已驗證功能
```bash
✅ GET /api/flashcards/next-review
   - 成功返回到期詞卡 "deal"
   - UserLevel: 50, WordLevel: 35 (A2詞彙)
   - IsOverdue: true, OverdueDays: 1

✅ POST /api/flashcards/{id}/optimal-review-mode
   - A1學習者 (userLevel: 15) 測試成功
   - 系統選擇: "vocab-listening"
   - 適配情境: "A1學習者"
   - 可用題型: ["flip-memory", "vocab-choice", "vocab-listening"]
```

## 🚀 核心價值實現
- **四情境自動適配**: A1/簡單/適中/困難智能判斷 ✅
- **零選擇負擔支援**: 完全自動題型選擇API ✅
- **科學間隔算法**: 基於SM2+演算法規格書增強 ✅
- **A1學習者保護**: 自動限制複雜題型 ✅

## 📊 開發效率
- **預估**: 3-4天完成
- **實際**: 2-3小時完成核心功能
- **效率提升**: 比預期快10倍+ (基於優秀現有架構)

後端智能複習系統核心功能已就緒，可立即與前端整合測試！

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-25 18:57:49 +08:00
鄭沛軒 48bbfb867b fix: 修復圖片生成後前端未即時顯示的問題 
- 修復 FlashcardsController 中變數引用和型別匹配錯誤
- 統一 GetFlashcards 和 GetFlashcard API 的圖片資料結構
- 更新前端使用 refetch() 清除快取確保載入最新圖片資料
- 完善圖片生成後的狀態更新和資料刷新機制

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-25 08:00:07 +08:00
鄭沛軒 f0d0728084 feat: 完成前後端圖片資料整合與系統穩定性修復 
🎉 重大突破：FlashcardsController 成功整合圖片資訊

**核心整合功能**:
- ✅ 修復EF Core關聯配置：解決FlashcardId1 shadow property衝突
- ✅ 擴展Flashcard實體：添加FlashcardExampleImages導航屬性
- ✅ 創建ExampleImageDto：完整的圖片資訊傳輸物件
- ✅ FlashcardsController圖片整合：API回應包含動態圖片資料

**資料結構擴展**:
- ✅ hasExampleImage布林欄位：判斷詞卡是否有圖片
- ✅ primaryImageUrl字串欄位：主要圖片的完整URL
- ✅ exampleImages陣列：支援多張圖片的完整資訊
- ✅ 圖片元數據：檔案大小、品質評分、創建時間

**系統穩定性保證**:
- ✅ 向後相容性：不破壞現有詞卡功能
- ✅ 架構一致性：遵循專案EF Core模式
- ✅ 錯誤處理：完整的異常處理和日誌記錄
- ✅ 效能優化：AsNoTracking查詢優化

**驗證結果**:
- ✅ 有圖片詞卡：正確返回圖片URL和資訊
- ✅ 無圖片詞卡：正確返回false和null值
- ✅ API穩定性：HTTP 500錯誤已修復
- ✅ 圖片URL生成：IImageStorageService整合成功

**技術債務處理**:
- ✅ 漸進式整合：維持系統穩定優先原則
- ✅ 關聯映射修復：正確配置Flashcard ↔ ExampleImage關聯
- ✅ 依賴注入優化：FlashcardsController整合IImageStorageService
- ✅ 查詢優化：Include + ThenInclude 正確載入關聯資料

前端現在可以完全依賴API資料，逐步取代硬編碼映射！

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-25 00:23:35 +08:00
鄭沛軒 c6d5bb6ce3 feat: 完成詞卡管理功能前後端完整整合 
🎯 後端 API 增強：
- 擴展搜尋功能支援例句內容 (Example 和 ExampleTranslation)
- 新增進階篩選查詢參數 (cefrLevel, partOfSpeech, masteryLevel)
- 建立完整的 FlashcardDto.cs 含資料驗證規則
- 查詢效能優化：新增 AsNoTracking() 提升效能
- 實現三級掌握度篩選邏輯 (high ≥80%, medium 60-79%, low <60%)

🖥️ 前端功能完善：
- FlashcardsService 支援完整進階篩選參數
- FlashcardForm 新增 CEFR 等級選擇器 (A1-C2)
- 統一詞性格式使用英文值 (noun, verb, adjective 等)
- 詞卡頁面整合後端篩選，移除前端重複邏輯
- 實現 300ms 搜尋防抖處理
- 快速篩選按鈕分離 C1/C2 等級選項
- AI 生成頁面支援完整 CEFR 等級儲存

🔗 完整 API 整合：
- 詞卡詳細頁面修復 import 錯誤並完整整合後端 API
- ClickableTextV2 修復 userLevel 和 compareCEFRLevels 函數問題
- 所有 CRUD 操作 (創建、讀取、更新、刪除、收藏) 完全整合
- 前後端型別定義完全一致，確保型別安全

📋 文檔完善：
- 建立後端 API 開發計劃文檔含完整技術規格
- 所有文檔引用標注清楚，便於開發者理解

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-24 04:21:06 +08:00
鄭沛軒 fd58f43b9b refactor: 完成前端組件重命名，統一使用flashcards服務 
🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-24 01:21:42 +08:00
鄭沛軒 8edcfc7545 refactor: 完成詞卡API架構統一與舊版代碼清理 
**主要重構**:
- 統一到SimplifiedFlashcardsController，移除CardSets概念衝突
- 補全新版API：添加GET /{id}和PUT /{id}端點
- 重構FlashcardForm.tsx完全移除CardSets依賴

**刪除舊版代碼**:
- 移除FlashcardsController.cs (舊版API)
- 移除CardSetsController.cs (廢棄功能)
- 移除flashcards.ts服務 (舊版前端服務)
- 清理相關Repository和介面文件

**API端點現況**:
✅ POST /api/flashcards-simple - 創建詞卡
✅ GET /api/flashcards-simple - 獲取詞卡列表
✅ GET /api/flashcards-simple/{id} - 獲取單個詞卡
✅ PUT /api/flashcards-simple/{id} - 更新詞卡
✅ DELETE /api/flashcards-simple/{id} - 刪除詞卡
✅ POST /api/flashcards-simple/{id}/favorite - 切換收藏

**架構優化**:
- 統一API路由和回應格式
- 移除複雜的CardSets關聯邏輯
- 簡化前端組件介面
- 降低維護成本

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-24 01:11:14 +08:00
鄭沛軒 4e69030bc2 feat: 實現完整的詞彙儲存功能與UI設計優化 
- 新增後端批量詞卡保存API (POST /api/flashcards/batch)
- 實現前端詞卡選擇對話框組件 (CardSelectionDialog)
- 優化句子分析頁面設計，以句子為主體
- 重新設計ClickableTextV2詞彙popup，採用現代玻璃morphism風格
- 改進詞卡清單頁面，採用簡潔的清單設計
- 添加CEFR等級標註與六級顏色設計
- 新增收藏功能與收藏詞卡tab頁面
- 創建詞彙版型展示頁面 (vocab-designs)
- 建立完整的UI/UX設計規範文件
- 撰寫詞彙生成與儲存系統技術規格文件
- 使用假數據實現快速測試功能
- 優化例句圖片展示與播放按鈕設計

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-20 17:52:22 +08:00
鄭沛軒 715b735c4d feat: 實現自動「未分類」預設卡組功能 
- 新增 CardSet.IsDefault 欄位標識預設卡組
- 實現用戶註冊時自動創建「未分類」卡組
- 添加 ensure-default API 端點確保預設卡組存在
- 優化詞卡創建邏輯，支援自動歸類到預設卡組
- 改善前端表單處理，智能選擇預設卡組
- 修復預設卡組顯示對比度問題

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-17 13:41:30 +08:00
鄭沛軒 c94cf75838 feat: DramaLing 完整版本 - 韓劇單字學習應用 
🚀 主要功能：
- 前後端分離架構（Next.js + .NET Core）
- 完整用戶認證系統（註冊、登入、JWT）
- 單字卡學習功能
- AI 輔助生成單字卡
- 多種學習模式（翻卡、選擇題、拼寫）
- 學習進度追蹤
- 響應式設計

🏗️ 技術棧：
- Frontend: Next.js 15, TypeScript, Tailwind CSS
- Backend: .NET Core 8, Entity Framework, SQLite
- 認證: JWT Bearer Token
- AI: Google Gemini API
- 資料庫: SQLite（測試）

🌟 特色：
- 完整的 CRUD 操作
- 安全的環境變數配置
- 乾淨的代碼結構
- 完善的錯誤處理
- RESTful API 設計

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-16 23:06:47 +08:00