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

16 Commits

Author SHA1 Message Date
鄭沛軒 5fae8c0ddf feat: 完成詞卡詳情頁第三階段UI組件重構 - 累計減少27.3% 
• UI組件模組化:
  - FlashcardDetailHeader.tsx: 標題區組件 (75行)
  - FlashcardContentBlocks.tsx: 內容區塊組件 (139行)
  - 移除標題區複雜UI: 62行標題、統計、TTS邏輯

• 詞卡詳情頁面優化:
  - 原始: 737行 → 當前: 536行 (減少27.3%)
  - 架構: 3個Hook + 2個UI組件完成
  - 編輯邏輯: 統一handleEditChange處理函數

• 第三階段進展:
  - UI組件模組化基礎建立
  - TTSButton集成，提升組件一致性
  - 為後續完整組件替換奠定基礎

• 累計兩大頁面重構成果:
  - 主頁面: 878行 → 305行 (減少65.3%)
  - 詳情頁面: 737行 → 536行 (減少27.3%)
  - 總體架構: 6個Hook + 7個組件體系

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-10-01 23:49:04 +08:00
鄭沛軒 fa9da1366b feat: 完成詞卡詳情頁面Hook重構 - 第二階段優化減少19.5% 
• Hook體系擴展:
  - useTTSPlayer.ts: 統一語音播放邏輯 (81行)
  - useFlashcardDetailData.ts: 數據載入專用管理 (98行)
  - TTSButton.tsx: 可重用語音播放組件 (49行)

• 詞卡詳情頁面優化:
  - 移除重複TTS邏輯: 66行
  - 移除假資料定義: 47行
  - 移除數據載入邏輯: 39行
  - 總計: 737行 → 593行 (減少19.5%)

• 架構價值提升:
  - 代碼重用: TTS邏輯全專案共用
  - 責任分離: 數據管理與UI邏輯分離
  - 維護性: 問題定位更精確

• 累計重構成果:
  - 主頁面: 878行 → 305行 (減少65.3%)
  - 詳情頁面: 737行 → 593行 (減少19.5%)
  - Hook體系: 6個專業Hook完成

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-10-01 23:30:03 +08:00
鄭沛軒 2edd8d03ce feat: 完成前端工具函數提取與圖片生成功能修復 
## 工具函數庫建立

### 🛠️ **統一Flashcard工具庫**
- 新建 `/lib/utils/flashcardUtils.ts` (94行)
- 提取重複的工具函數：詞性轉換、CEFR顏色、熟練度處理
- 統一圖片URL處理邏輯、時間格式化、統計計算

### 🧹 **代碼重複消除**
- flashcards/page.tsx: 898行 → 878行 (清理重複函數)
- flashcards/[id]/page.tsx: 移除重複的工具函數定義
- 建立代碼復用機制，減少維護成本

### 🔧 **圖片生成功能修復**
- 修正API端點路徑: `/api/imagegeneration/` → `/api/ImageGeneration/`
- 修復生成、狀態查詢、取消請求三個端點
- 後端API測試通過，功能恢復正常

### ✅ **架構改善成果**
- 編譯100%成功，無TypeScript錯誤
- 建立統一的工具函數管理機制
- 為後續大規模組件重構奠定基礎
- 提升代碼可維護性和復用性

前端工具層優化完成，準備進行組件層重構！

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-10-01 19:20:52 +08:00
鄭沛軒 9011f93dfe feat: 完成前端大規模架構重組與術語統一 
## 主要完成項目

### 🏗️ Hooks架構重組
- 刪除62.5%死代碼hooks (5個檔案)
- 重組為功能性資料夾結構 (flashcards/, review/)
- 修復所有import路徑和類型錯誤

### 🧹 Lib資料夾優化
- 移除未使用檔案：cn.ts, performance/, errors/, studySession.ts
- 統一API配置管理，建立中央化配置
- 清理硬編碼URL，提升可維護性

### 📝 術語統一 Study→Review
- API端點：/study/* → /review/*
- 客戶端：studyApiClient → reviewApiClient
- 配置項：STUDY → REVIEW
- 註釋更新：StudyRecord → ReviewRecord

### ✅ 技術成果
- 前端編譯100%成功，無錯誤
- 減少檔案數量31% (lib資料夾)
- 消除重複代碼和架構冗餘
- 建立企業級前端架構標準

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-10-01 16:15:17 +08:00
鄭沛軒 121437afe5 feat: 完成前端架構優化與類型安全重構 
## 前端架構重構
- 重構flashcardsService，統一數據轉換邏輯確保類型安全
- 移除詞卡頁面中的as any類型斷言，使用正確的Flashcard類型
- 修復generate頁面的CEFR提取邏輯，優先使用analysis.cefr欄位
- 統一前端服務層的認證處理，移除無效JWT token

## 類型安全改進
- 確保所有flashcard相關組件使用標準Flashcard介面
- 修復getDueFlashcards方法的TypeScript類型錯誤
- 統一使用cefr欄位替代difficultyLevel，保持前後端一致性
- 完善ClickableTextV2組件的詞彙保存功能

## 技術改進
- 優化前端API服務的錯誤處理和回應格式處理
- 完善智能複習系統的數據格式轉換
- 改進圖片生成和學習會話服務的認證邏輯

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-10-01 02:33:24 +08:00
鄭沛軒 95952621ee docs: 新增選項詞彙庫功能完整文檔與測試指南 
- 創建選項詞彙庫功能開發計劃書
- 新增完整的功能測試指南
- 建立測試專案結構 (DramaLing.Api.Tests)
- 統一前端與文檔的詞性標準化處理
- 完成系統整合與部署準備文檔

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-29 17:24:58 +08:00
鄭沛軒 74932e58ff fix: 修復Flashcards頁面TypeScript類型錯誤 
- 添加imageGenerationService導入修復未定義錯誤
- 修正getExampleImage和hasExampleImage函數類型簽名
- 添加缺失的generatingCards和generationProgress屬性
- 移除未使用的hasExampleImage函數
- 為status參數添加類型註解

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-27 18:50:41 +08:00
鄭沛軒 6c83316467 feat: 統一全前端播放按鈕為精美圓形TTS設計 
- 完全重構AudioPlayer組件，移除後端依賴，改用純TTS
- 統一播放按鈕設計：圓形漸變、播放中波紋動畫、懸停特效
- 實現獨立播放狀態：詞彙和例句播放按鈕各自管理狀態
- 添加完整無障礙支援：aria-label、title提示、鍵盤支援
- 優化播放控制：點擊播放/暫停、互斥播放、錯誤處理
- 現在所有頁面的播放按鈕都使用統一的精美圓形設計

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-25 23:51:41 +08:00
鄭沛軒 1661eccf24 feat: 改進詞卡編輯流程，從列表導航到詳細頁面編輯 
✨ UX改進:
- 點擊列表中的編輯按鈕直接導航到詳細頁面
- 詳細頁面自動開啟編輯模式，提供專注的編輯環境
- 移除列表頁面底部的編輯表單，簡化界面

🔧 技術實作:
- 使用URL參數(?edit=true)傳遞編輯狀態
- 詳細頁面檢查URL參數自動開啟編輯模式
- 清理不必要的編輯表單狀態管理

🚀 編輯體驗提升:
- 在詳細頁面編輯，享有完整功能(圖片生成、統計資訊等)
- 避免在列表頁面編輯時的干擾和空間限制
- 統一所有編輯操作在同一位置進行

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-25 09:09:17 +08:00
鄭沛軒 cb3309295b feat: 完成前端詞卡圖片整合與詞性簡寫顯示 
🎉 前端詞卡管理功能完全整合後端圖片資料

**圖片整合功能**:
- ✅ 更新Flashcard介面：添加exampleImages、hasExampleImage、primaryImageUrl欄位
- ✅ 取代硬編碼映射：getExampleImage和hasExampleImage改用API資料
- ✅ 詞卡列表頁面：完全使用動態圖片資料顯示
- ✅ 詞卡詳細頁面：修復資料載入邏輯使用列表API獲取圖片資訊

**詞性簡寫顯示**:
- ✅ 全域詞性轉換函數：getPartOfSpeechDisplay()
- ✅ 標準英語縮寫：noun→n., verb→v., adjective→adj.等
- ✅ 複合詞性處理：preposition/adverb→prep./adv.
- ✅ 應用到所有詞性顯示位置：列表和詳細頁面

**系統整合成果**:
- ✅ 完全移除硬編碼圖片映射依賴
- ✅ 前端直接使用後端API返回的圖片URL
- ✅ 支援AI生成圖片的即時顯示
- ✅ Mock資料相容性：添加圖片欄位避免錯誤

前端詞卡管理系統現已完全整合AI圖片生成功能！

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-25 01:57:04 +08:00
鄭沛軒 724ba391b2 feat: 實現優雅的角落通知系統取代惱人的 alert 彈窗 
🎨 新增 Toast 通知組件：
- 位置：右上角固定位置，不阻擋主要內容
- 動畫：優雅的滑入/滑出動畫 (300ms)
- 自動消失：3秒後自動消失，無需手動點擊
- 手動關閉：可點擊 X 按鈕立即關閉
- 響應式設計：在手機上自動調整寬度

🎯 支援多種通知類型：
- success: ✅ 綠色成功通知（收藏、保存、刪除成功）
- error: ❌ 紅色錯誤通知（操作失敗、網路錯誤）
- warning: ⚠️ 黃色警告通知（重複詞卡、數據警告）
- info: ℹ️ 藍色資訊通知（提示信息）

🔄 全面替換所有 alert 調用：
- 詞卡管理頁面：收藏切換、創建、刪除、編輯操作
- AI 生成頁面：詞卡保存成功、重複檢測、錯誤處理
- 詞卡詳細頁面：更新、刪除、收藏操作反饋

🚀 用戶體驗大幅提升：
- 移除煩人的阻擋式 alert 彈窗
- 實現非侵入式的操作反饋
- 保持操作流程的連續性和流暢度
- 提供視覺上更加現代和優雅的交互體驗

修復編譯問題並重新啟動前端，確保所有功能正常運作。

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-24 04:55:31 +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
鄭沛軒 be236f7216 refactor: 移除卡組功能，簡化詞卡管理系統 
- 完全移除卡組分類功能，簡化詞卡管理邏輯
- 詞卡管理頁面只保留"所有詞卡"和"收藏詞卡"兩個tab
- 移除卡組相關界面元素和統計信息
- 詞卡列表顯示創建時間取代卡組信息
- 詞卡詳細頁面移除開始學習按鈕
- CEFR標籤移至卡片右上角，移除"CEFR"文字前綴
- 底部操作按鈕採用平均延展布局(flex-1)
- 強化搜尋和收藏功能作為主要組織方式
- 創建詞卡管理系統簡化規格文檔
- 專注詞彙學習本質，降低管理複雜度

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-20 19:29:00 +08:00
鄭沛軒 080cbe14a6 refactor: 優化詞卡詳細頁面設計並修正TypeScript錯誤 
- 刪除左上角藍色圓圈頭像，讓詞彙標題更突出
- 調整詞性位置到音標左邊，邏輯順序更合理
- 統一播放按鈕樣式，參考學習功能翻卡模式設計
- 刪除右上角多餘的收藏星星，保持CEFR標籤純粹
- 修正TypeScript類型錯誤，確保編譯正常
- 簡化API邏輯，使用假資料確保穩定展示
- 統一詞彙和例句的播放按鈕為學習功能風格

設計現在更加簡潔清晰，與學習功能完全一致。

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-20 18:52:08 +08:00
鄭沛軒 0b871a9301 feat: 創建詞卡詳細頁面與完善導航功能 
- 新增詞卡詳細頁面 (/flashcards/[id]) 採用學習功能風格設計
- 實現完整的詞卡詳細展示，包含學習統計、內聯編輯功能
- 修正Next.js 15的params處理，使用React.use()解包Promise
- 更新詞卡列表的導航邏輯，點擊詳細按鈕跳轉到詳細頁面
- 添加假資料支援，確保所有詞卡都能正常顯示詳細頁面
- 實現內聯編輯功能，支援翻譯、定義、例句的即時編輯
- 整合收藏功能到詞卡詳細頁面
- 提供開始學習和刪除詞卡的快速操作
- 採用漸層背景和彩色區塊設計，與學習功能保持一致

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-20 18:40:39 +08:00