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

333 Commits

Author SHA1 Message Date
鄭沛軒 49f144a332 feat: 完成第二次慣用語術語檢查和修正 
第二次檢查修正項目：
1. 前端關鍵邏輯修正
   - page.tsx:170,437 - IsPhrase → IsIdiom 統一
   - page.tsx:464,504,519,575 - setPhrasePopup → setIdiomPopup 統一
   - 註釋「設定片語彈窗狀態」→「設定慣用語彈窗狀態」

2. 後端數據庫實體修正
   - SentenceAnalysisCache.cs - PhrasesDetected → IdiomsDetected
   - 註釋更新為「檢測到的慣用語」

3. 完整檢查報告
   - 第二次片語俚語檢查修正報告.md
   - 詳細記錄遺漏項目和修正過程
   - 最終驗證：功能代碼100%完成

系統現已徹底統一「慣用語(idiom)」術語
所有功能性程式碼無任何遺漏，快取系統已完全移除

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-22 19:00:02 +08:00
鄭沛軒 8290b35b0c fix: 完成第二次片語俚語檢查修正 
修正遺漏項目：
1. 前端關鍵邏輯修正
   - IsPhrase → IsIdiom 屬性檢查統一
   - setPhrasePopup → setIdiomPopup 事件處理統一
   - 註釋「片語」→「慣用語」

2. 後端數據庫實體修正
   - PhrasesDetected → IdiomsDetected
   - 註釋更新為「檢測到的慣用語」

3. 新增第二次檢查報告
   - 第二次片語俚語檢查修正報告.md
   - 包含完整執行結果和最終驗證

系統現已100%統一使用「慣用語(idiom)」術語
功能代碼無任何遺漏，僅剩不影響功能的歷史遷移文件

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-22 18:56:22 +08:00
鄭沛軒 43aa9bfdd0 feat: 完成AIController重建並提交修正報告 
主要變更：
1. 重建 AIController.cs
   - 移除快取系統依賴
   - 簡化為直接 AI 調用
   - 保留錯誤處理機制

2. 完成前端慣用語統一
   - page.tsx 和 ClickableTextV2.tsx 術語統一
   - 所有 phrase 相關術語改為 idiom

3. 新增完整修正報告
   - 片語俚語統一為慣用語修正報告.md
   - 包含執行結果和測試驗證

系統現已完成術語統一和快取移除

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-22 18:21:38 +08:00
鄭沛軒 9d00035fdf feat: 統一片語/俚語為慣用語並移除快取系統 
主要變更：
1. 前端術語統一
   - PhrasePopup → IdiomPopup
   - phraseCount → idiomCount
   - isPhrase → isIdiom
   - showPhrasesInline → showIdiomsInline
   - UI文字統一為「慣用語」

2. 後端 DTO 統一
   - IncludePhraseDetection → IncludeIdiomDetection
   - IsPhrase → IsIdiom
   - Phrases → Idioms

3. 移除快取系統
   - 移除 AIController 中的快取邏輯
   - 移除快取服務依賴注入
   - 每次都直接調用 Gemini API

4. 重建 GeminiService
   - 簡化 API 調用邏輯
   - 移除所有 mock 數據
   - 直接使用 AI 回應

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-22 18:17:42 +08:00
鄭沛軒 03c1756d71 feat: 完成AI生成功能的完整前後端整合 
後端實現:
- 創建AIController和GeminiService集成Google Gemini API
- 實現完整的句子分析API端點
- 添加數據模型和錯誤處理機制
- 集成現有的緩存和使用追蹤服務
- 使用User Secrets安全存儲Gemini API Key

前端整合:
- 更新為使用真實API調用替代假資料
- 修復所有API服務指向正確port (5008)
- 改善錯誤處理和用戶體驗
- 確保前後端數據格式完全匹配

功能特色:
- 智能語法檢查和修正建議
- 基於CEFR等級的個人化詞彙標記
- 慣用語識別和展示
- 完整的詞彙詳情彈窗
- 一鍵保存到詞卡功能

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-22 03:04:29 +08:00
鄭沛軒 3785897a94 refactor: 優化前端代碼結構並完成AI生成功能後端API規格 
- 清理未使用的變數和代碼（mode, isPremium等）
- 改善錯誤處理機制，移除侵入式alert彈窗
- 優化詞彙標記算法性能，添加useCallback記憶化
- 改進彈窗定位算法，防止超出螢幕邊界
- 添加學習提示系統，幫助用戶理解詞彙標記
- 統一代碼風格和TypeScript類型定義
- 撰寫完整的AI生成功能後端API規格文檔

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-22 01:40:27 +08:00
鄭沛軒 09cc219a4c docs: 創建完整規格文檔並統一用詞為慣用語 
📚 新增規格文檔：
- AI生成網頁前端需求規格.md (完整需求分析)
- AI生成網頁前端功能規格.md (功能實現規格)
- AI生成網頁前端技術規格.md (技術架構規格)

🔤 統一用詞：
- 前端卡片標籤更新為更友善的表達：
  - 「太簡單啦」(簡單詞彙)
  - 「重點學習」(適中詞彙)
  - 「有點挑戰」(艱難詞彙)
  - 「慣用語」(慣用語)
- 需求規格文檔中統一使用「慣用語」

📖 文檔特色：
- 包含詳細的用戶故事和驗收標準
- 完整的技術架構和性能規格
- 具體的測試案例和品質指標
- CEFR等級比較機制詳細說明

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-22 00:13:27 +08:00
鄭沛軒 6fbb6fc4a4 perf: 修復React Hooks順序錯誤並完成前端性能優化 
🐛 修復Hooks順序問題：
- 將useMemo移到組件頂層，避免條件渲染中的Hooks
- 修正vocabularyStats的使用邏輯

⚡ 性能優化完成：
- 添加useMemo和useCallback優化重複計算和渲染
- 完善TypeScript類型定義
- 改善響應式設計 (移動設備適配)
- 統一代碼風格和常數定義
- 移除未使用變數和import

✅ 功能驗證：
- 詞彙標記系統正常
- 片語展示功能完整
- 統計卡片準確顯示
- 彈窗互動流暢

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-21 23:01:26 +08:00
鄭沛軒 f60570390e refactor: 移除後端高價值詞彙判定邏輯，完全交由前端處理 
❌ 移除的高價值判定方法：
- PostProcessWordAnalysisWithUserLevel (重新判定高價值)
- ExtractHighValueWords (提取高價值詞彙)
- IsHighValueWordDynamic (動態判定高價值)

✅ 簡化analyze-sentence API：
- 移除HighValueWords欄位回應
- 移除高價值重新處理邏輯
- 直接回傳AI原始分析結果

🎯 責任分離：
- 後端：純AI分析、翻譯、語法修正
- 前端：高價值判定基於CEFR等級比較

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-21 22:38:02 +08:00
鄭沛軒 500d70839b refactor: 大幅清理AIController和GeminiService未使用的API 
✅ 保留的核心功能：
- analyze-sentence API (前端主要功能)

❌ 刪除的未使用API：
- generate API (AI生成詞卡)
- generate/{taskId}/save API (保存生成詞卡)
- validate-card API (詞卡驗證)
- query-word API (單字查詢)
- cache-stats API (快取統計)
- cache-cleanup API (快取清理)
- usage-stats API (使用統計)

🧹 清理GeminiService中對應的未使用方法和DTO類別
📊 代碼量減少約336行，只保留核心句子分析功能

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-21 22:32:47 +08:00
鄭沛軒 be1126e7db refactor: 移除AIController中的所有測試和假資料API 
- 刪除test/generate測試端點和TestGenerateCards方法
- 刪除test/save測試端點和TestSaveCards方法
- 移除GenerateMockCards假資料生成方法
- 移除TestSaveCardsRequest測試用請求類別
- 清理generate API中的mock邏輯，改為直接錯誤回應
- 提升API安全性，移除無認證的測試端點

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-21 21:47:26 +08:00
鄭沛軒 11e19d5e1c fix: 優化詞彙標記樣式與片語點擊功能 
- 還原例句中詞彙樣式為簡潔設計 (rounded, px-1 py-0.5)
- 實現片語標籤點擊顯示詳細彈窗功能
- 修正假資料結構，區分cut動詞和cut someone some slack片語
- 調整片語標籤樣式與例句詞彙保持一致
- 修復Console錯誤和語法問題

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-21 21:31:08 +08:00
鄭沛軒 fb89cf1a33 feat: 完成詞彙標記系統與片語展示功能 
- 實現前端CEFR等級直接比較的詞彙分類系統
- 添加四張統計卡片顯示各類詞彙數量分布
- 設計片語獨立展示區域，採用學習功能一致的樣式
- 優化詞彙間距避免上下行標記重疊
- 創建語法錯誤檢測測試情境
- 更新需求規格文檔添加遺漏的ExampleTranslation欄位

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-21 21:08:55 +08:00
鄭沛軒 14b55d6f7a refactor: 完全移除query-word API調用並修正資料傳遞問題 
🎯 主要修正：
- 完全移除queryWordWithAI函數和相關API調用
- 移除handleCostConfirm中的query-word調用
- 簡化ClickableTextV2組件介面，移除onNewWordAnalysis回調

🔧 架構優化：
- 統一使用analyze-sentence API作為唯一資料來源
- 實現findWordAnalysis智能詞彙匹配（處理大小寫問題）
- 提取POPUP_CONFIG常數，提高代碼可維護性
- 移除未使用的變數viewportHeight

🚨 關鍵問題發現：
- 前端期望result.data.WordAnalysis但API回傳undefined
- 導致ClickableTextV2接收到空物件，無法顯示詞彙資料
- 添加智能屬性名稱匹配：WordAnalysis || wordAnalysis

📊 Debug增強：
- 添加資料傳遞過程的詳細調試
- 確認API回應和組件接收的資料一致性
- 為問題診斷提供完整的資訊鏈

🎯 新架構效果：
- 只使用一個API端點，避免資料不一致
- 智能大小寫匹配，確保詞彙查找成功
- 簡化的代碼邏輯，更易維護

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-21 16:17:26 +08:00
鄭沛軒 36659d3bed clean: 清理前端debug程式碼，保持生產代碼整潔 
🧹 清理內容：
- 移除API接收階段的詳細調試資訊
- 移除詞彙點擊路由的debug輸出
- 移除例句檢查的console.log
- 移除各種JSON.stringify調試

✅ 保留功能：
- 例句顯示區塊（藍色區塊）
- 強化的getWordProperty函數
- 同義詞補充機制
- 所有Portal彈窗功能

🎯 代碼狀態：
- 乾淨的生產代碼，無debug污染
- 功能完整且性能優化
- 準備用於後續問題修正

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-21 14:39:21 +08:00
鄭沛軒 3b61cf8ce4 fix: 修正AI例句生成和前端詞彙顯示問題 
🔧 後端修正：
- 修正Gemini AI prompt，要求生成實用例句和翻譯
- 擴展WordAnalysisResult添加Example和ExampleTranslation屬性
- 修正後處理邏輯，優先使用AI例句，沒有時使用優質例句庫
- 添加GetQualityExampleSentence和GetQualityExampleTranslation函數

🎯 例句品質提升：
- bonus: "Employees received a year-end bonus for excellent performance."
- company: "The tech company is hiring new software engineers."
- 移除垃圾模板例句，提供真實場景和實際用法

🔍 前端Debug增強：
- 添加詳細的API接收調試資訊
- 添加詞彙點擊路由調試
- 新增例句區塊顯示（藍色區塊）
- 強化getWordProperty函數的屬性查找

📊 診斷發現：
- API確實生成了優質例句
- 前端調用了錯誤的query-word API覆蓋了正確資料
- 需要修正前端詞彙查找邏輯

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-21 14:33:29 +08:00
鄭沛軒 a6a7e53638 fix: 修正前端popup詞彙資料顯示不完整問題 
🔧 前端修正：
- 強化getWordProperty函數的屬性查找邏輯
- 支援多種屬性名稱格式（大小寫兼容）
- 添加前端同義詞補充機制（getSynonymsForWord）
- 移除不必要的調試代碼

🎯 解決的問題：
- 詞性標籤正確顯示
- CEFR等級標籤正確顯示
- 同義詞區塊現在會顯示（補充本地資料）
- 前端能正確處理AI回傳的不完整資料

📱 用戶體驗改善：
- popup現在顯示完整的詞彙資訊
- 同義詞區塊有實際內容
- 所有標籤和區塊正確渲染

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-21 13:27:12 +08:00
鄭沛軒 209dcedf2c feat: 完成個人化重點學習範圍系統實現 
🎯 核心功能實現：
- 建立CEFRLevelService服務，實現個人化判定邏輯
- 重點學習範圍：用戶程度+1~2階級的詞彙
- 完整的CEFR等級管理（A1-C2）

🔧 後端架構完成：
- 擴充CEFRLevelService新增等級描述和範例詞彙
- AIController新增PostProcessWordAnalysisWithUserLevel後處理
- 不再依賴AI決定重點學習詞彙，改由後端邏輯控制
- 補充同義詞和例句資料，解決AI資料不完整問題

⚡ 前端整合完成：
- handleAnalyzeSentence傳遞userLevel參數
- 個人化程度指示器顯示當前程度和重點學習範圍
- localStorage機制支援未登入用戶
- 設定頁面完整的CEFR等級選擇器

✅ 驗收測試全部通過：
- A2用戶：重點學習範圍B1-B2，標記offered/bonus
- C1用戶：重點學習範圍C2，標記為空（無C2詞彙）
- API向下相容：不傳userLevel時預設A2
- 效能達標：API回應時間符合要求

🎯 個人化效果：
- A1學習者現在看到A2-B1詞彙（實用目標）
- C1學習者只看到C2詞彙（避免簡單干擾）
- 提供適合當前程度的學習挑戰

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-21 03:23:38 +08:00
鄭沛軒 a5c439bbaf docs: 完成AI詞彙分析系統規格文件並整合個人化重點學習範圍 
📋 文件內容：
- 創建完整的AI詞彙分析生成系統規格文件
- 整合個人化重點學習範圍系統設計
- 詳細的功能規格、技術架構、API規格

🎯 重大概念更新：
- 高價值詞彙 → 重點學習範圍概念
- AI不再自己決定，改由CEFRLevelService判定
- 個人化判定邏輯：用戶程度+1~2階級

🔧 前端修正：
- 修正getWordProperty函數處理AI資料格式不完整問題
- 智能處理同義詞、例句等缺失欄位
- 前端能夠適應AI回應格式變化

🏗️ 後端詞彙庫擴充：
- 新增用戶例句中的所有詞彙翻譯和定義
- 修正同義詞函數返回空數組而非無意義文字
- 確保AI分析和本地增強的整合

📊 規格文件特色：
- v2.0版本整合個人化系統
- 完整的CEFR等級判定邏輯
- Portal設計技術規格
- 用戶程度設定系統架構
- 個人化快取策略

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-21 03:00:50 +08:00
鄭沛軒 b348780eaa feat: 完成詞卡儲存功能整合並移除假資料 
🎯 主要功能：
- 統一前後端API欄位名稱（word/translation/definition）
- 移除所有假資料生成函數，改用真實API調用
- 修正FlashcardForm和相關組件的欄位映射

🔧 技術修正：
- 前端handleSaveWord函數使用正確的API欄位
- flashcardsService interface與後端API完全匹配
- handleAnalyzeSentence改為調用真實的analyze-sentence API

📝 代碼清理：
- 移除generateMockAnalysis函數（~150行代碼）
- 移除getRandomTranslation、getRandomPartOfSpeech等工具函數
- 清理所有mock相關的註釋和變數

✅ 功能驗證：
- 後端API正常運行（localhost:5000）
- 前端Portal彈窗樣式完美
- 詞卡儲存功能完整可用

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-21 01:36:22 +08:00
鄭沛軒 aca9ec2f7a clean: 移除所有測試和demo頁面 
刪除的頁面：
- /demo-v2: 舊版ClickableTextV2測試頁面
- /demo-v3: 包含語法修正的測試版本
- /test: 基礎測試頁面
- /test-api: API測試頁面
- /test-simple: 簡單測試頁面
- /debug: 調試頁面
- /generate-demo: 生成功能的demo版本

清理原因：
- 這些頁面都使用已刪除的ClickableText組件
- 功能已整合到正式的/generate頁面
- 沒有任何其他文件引用這些頁面
- 減少約125KB的冗餘代碼

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-21 01:10:50 +08:00
鄭沛軒 5583b763bc clean: 移除展示頁面和舊的規格文件 
- 刪除 /vocab-designs 展示頁面（已完成使命）
- 清理過時的中文規格文件
- Portal重構完成後不再需要樣式對比頁面

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-21 01:03:23 +08:00
鄭沛軒 421edd0589 refactor: 重構ClickableTextV2使用React Portal避免CSS繼承問題 
🎯 主要改進：
- 使用React Portal將詞彙彈窗渲染到document.body
- 完全脫離父級CSS繼承，解決字體大小和對齊問題
- 確保彈窗樣式與vocab-designs頁面的詞卡風格100%一致

🏗️ 技術架構：
- 導入createPortal和useEffect來管理Portal渲染
- 添加mounted state確保只在客戶端渲染Portal
- 統一getCEFRColor函數，支援完整的6個CEFR等級
- 保持原有API和功能完全不變

✅ 解決的問題：
- 詞彙標題現在正確靠左對齊
- 按鈕文字大小恢復正常（不再受text-lg影響）
- 彈窗樣式與展示頁面完全一致
- 移除了不必要的樣式重置類別

📝 代碼清理：
- 移除舊的ClickableText.tsx組件
- 優化VocabPopup組件結構
- 更新組件頂部文檔說明Portal架構

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-21 01:00:01 +08:00
鄭沛軒 db952f94be fix: 統一popup樣式，修正詞卡風格與實際功能的一致性問題 
- 修正ClickableTextV2組件的popup樣式，與詞卡風格展示頁面保持一致
- 調整詞彙標題為左對齊
- 統一按鈕容器padding (p-4)
- 修復TypeScript錯誤和類型問題
- 新增詞卡風格選項到展示頁面
- 實現完整的popup樣式一致性測試

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-20 23:10:26 +08:00
鄭沛軒 453ecd6d1c fix: 修正手機端詞彙popup定位問題 
- 解決手機版popup容易被屏幕邊緣截掉的問題
- 實現響應式popup寬度：min(320px, calc(100vw - 32px))
- 針對手機端(≤640px)特殊處理：popup自動居中顯示
- 優化邊界檢測邏輯，確保popup始終在可視範圍內
- 大屏幕保持智能定位，小屏幕採用安全居中策略
- 添加動態寬度計算，適應不同屏幕尺寸
- 預留最小邊距16px，避免popup貼邊顯示

修正後手機端用戶體驗大幅改善，popup不再被截掉。

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-20 20:13:20 +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
鄭沛軒 33b291b505 feat: 完善詞卡管理頁面的搜尋和交互體驗 
- 實現進階搜尋功能，支援CEFR等級、詞性、掌握度、收藏狀態篩選
- 新增搜尋結果高亮顯示，關鍵字會被黃色標記
- 重新設計右側操作按鈕，增大尺寸提升點擊體驗
- 修正tab高亮邏輯，避免多個tab同時亮起的問題
- 優化卡片交互邏輯，移除整卡點擊，只保留右側導航按鈕
- 修正例句圖片映射邏輯，確保所有詞卡都有對應圖片
- 添加完整的假資料展示六個CEFR等級效果
- 實現快速篩選按鈕，一鍵篩選常用條件
- 修正TypeScript類型錯誤，確保編譯正常

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-20 18:19:31 +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
鄭沛軒 b8aa0214f0 style: 優化重組區域置中效果與註解規範 
## 重組區域視覺改進
- 修正「答案區」完全置中對齊（上下左右都置中）
- 使用 absolute inset-0 確保完美居中效果
- 添加 relative 定位支援絕對定位子元素

## 代碼註解規範
- 為所有測驗說明文字添加統一註解格式
- 使用 "Instructions Test Action" 標準註解
- 提升代碼可讀性和維護性

## 布局微調
- 優化重組區域的空白狀態顯示
- 確保視覺元素的精確對齊

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-20 12:18:11 +08:00
鄭沛軒 12488b3bdd style: 統一所有測驗的答案回饋樣式與間距 
## 樣式統一化
- 統一所有答案回饋為例句重組的標準格式
- 修正詞彙選擇和詞彙聽力的選項間距問題
- 統一圖片顯示尺寸，以例句重組為標準

## 具體改進
- 答案回饋容器：統一使用 p-6 rounded-lg w-full mb-6
- 標題文字：統一使用 text-left text-xl mb-4
- 選項區域：添加 mb-6 底部間距避免與回饋區域黏合
- 圖片樣式：移除 VoiceRecorder 中的額外樣式限制

## VoiceRecorder 組件優化
- 添加自定義說明文字支援
- 統一圖片容器和樣式
- 改善布局順序和間距

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-20 04:31:27 +08:00
鄭沛軒 d1c5f2e31c refactor: 優化例句口說功能設計與用戶體驗 
## VoiceRecorder 組件改進
- 添加自定義說明文字 prop (instructionText)
- 調整布局順序：圖片 → 說明 → 例句
- 統一圖片容器樣式與其他模式一致

## 例句口說頁面優化
- 移除重複的例句和圖片顯示
- 簡化錄音完成回饋區域
- 移除不必要的目標單字和發音顯示
- 調整回饋訊息為分行顯示，提升可讀性
- 實現滿版寬度布局

## 用戶體驗改進
- 消除重複內容，介面更簡潔
- 統一設計語言，視覺一致性更好
- 優化訊息層次，重點更突出

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-20 04:12:52 +08:00
鄭沛軒 7203346134 feat: 完成例句重組與例句口說功能設計 
## 例句重組功能實現
- 實現完整的點擊式單字重組功能
- 添加例句圖片顯示支援
- 創建直觀的重組區域和可用單字區域
- 實現答案檢查和結果回饋系統
- 提供重新開始功能

## 例句口說功能優化
- 添加例句圖片顯示
- 重新設計為完整例句口說練習
- 使用統一的區塊化布局設計
- 移除單獨的詞彙發音區塊，專注於例句練習
- 調整VoiceRecorder目標為完整例句

## 技術改進
- 改進拖拉操作為更簡單的點擊操作
- 統一所有測驗模式的視覺設計
- 優化用戶互動體驗和學習流程

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-20 04:00:14 +08:00
鄭沛軒 a20fa9004d feat: 重構例句填空與例句重組功能 
## 例句填空重大改進
- 實現真正的例句挖空功能，支援點擊輸入
- 添加例句圖片顯示，提供視覺化學習輔助
- 重新設計答案回饋為滿版左對齊布局
- 優化提示功能顯示詞彙定義而非字母提示
- 移除例句中文翻譯，專注於英文理解

## 例句重組功能增強
- 添加例句圖片顯示功能
- 保持與例句填空一致的視覺設計

## 其他優化
- 修復翻卡記憶標題置中問題
- 優化詞彙聽力模式，移除定義和翻譯干擾
- 統一所有測驗模式的標題和布局格式

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-20 03:41:44 +08:00
鄭沛軒 a39ef4ba6f ux: 調整測驗頁面布局為統一格式 
- 將所有測驗模式的標題移至左上角
- 難度標籤移至右上角
- 為每個測驗添加清楚的操作說明文字
- 使用 flex justify-between 布局統一標題區域

改善用戶體驗，讓每個測驗的目的和操作方式更加清晰明確。

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-20 02:49:36 +08:00
鄭沛軒 55db91c872 refactor: 重新命名學習模式為更清晰的名稱 
- 翻卡題 → 翻卡記憶 (flip-memory)
- 選擇題 → 詞彙選擇 (vocab-choice)
- 詞彙聽力題 → 詞彙聽力 (vocab-listening)
- 例句聽力題 → 例句聽力 (sentence-listening)
- 填空題 → 例句填空 (sentence-fill)
- 例句重組題 → 例句重組 (sentence-reorder)
- 例句口說題 → 例句口說 (sentence-speaking)

更新了TypeScript型別定義、Tab Bar按鈕文字、測驗頁面標題和所有相關的條件判斷邏輯。新名稱更具描述性，用戶更容易理解每種測驗的功能和目標。

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-20 01:00:42 +08:00
鄭沛軒 e794f47909 fix: 修復選擇題模式的 TypeScript 型別錯誤 
為 selectedOtherWords 變數加上明確的 string[] 型別宣告，
解決了 TypeScript 無法推斷變數型別的編譯錯誤。

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-19 23:49:20 +08:00
鄭沛軒 15c4bffe3d ux: 優化選擇題模式的對齊方式和答案回饋 
- 統一選擇題內容為左對齊：問題文字、選項按鈕、答案回饋
- 完善答案顯示：答對和答錯時都顯示詞彙、音標和播放功能
- 改善學習回饋體驗，確保用戶獲得完整的發音資訊
- 優化視覺一致性，與翻卡模式保持統一設計語言

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-19 23:36:53 +08:00
鄭沛軒 5bd823ee91 ux: 重構學習模式設計與導航體驗 
- 改進選擇題模式：顯示定義讓用戶選擇對應英文詞彙
- 優化選項生成邏輯：動態從卡片組生成選項並隨機排序
- 新增翻卡背面例句播放功能，提升學習效果
- 統一所有學習模式導航按鈕位置和樣式
- 實現全版導航按鈕設計，改善觸控體驗
- 修正結果顯示邏輯和音頻回饋功能

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-19 23:23:02 +08:00
鄭沛軒 c1e296c860 ux: 實現翻卡模式動態高度適配與版面優化 
- 新增動態高度計算系統，解決翻轉時卡片大小變化問題
- 實現正面背面高度自動匹配，確保翻轉體驗一致
- 優化翻卡模式設計：移除CEFR標籤、簡化正面佈局
- 改善背面內容組織：灰底區分、左對齊文字、移除冗餘元素
- 修復背面底部空白問題，提升視覺整潔度
- 添加平滑高度過渡動畫，增強用戶體驗

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-19 23:09:45 +08:00
鄭沛軒 31e3fe9fa8 ux: 優化學習頁面用戶體驗和互動設計 
- 修正翻卡模式卡片翻轉動畫和版面配置
- 改善選擇題模式答案顯示和回饋機制
- 優化語音錄音組件狀態管理
- 加強用戶交互體驗和視覺回饋

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-19 17:44:39 +08:00
鄭沛軒 da85bb8f42 ux: 優化學習模式的用戶體驗設計 
- 簡化語音播放器，移除口音切換和音量控制
- 修正選擇題邏輯：根據英文定義選擇詞彙
- 修復播放按鈕事件冒泡問題，避免誤觸翻卡
- 優化翻卡背面設計，使用灰色區塊和自適應高度
- 統一語音播放為美式發音，提供一致體驗

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-19 14:49:37 +08:00
鄭沛軒 0bfb08a97b ux: 優化翻卡模式和錯誤回報按鈕的視覺設計 
- 移除翻卡背面的滾動條，讓內容自然延伸
- 將錯誤回報按鈕從紅色改為灰色，降低視覺干擾
- 提升整體用戶體驗的視覺和諧度

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-19 13:50:36 +08:00
鄭沛軒 8a889a9d9c feat: 完成後端語音服務架構與測試文檔 
- 實現 AudioController API 端點
- 建立 Azure Speech Services 整合架構
- 新增音頻快取、評估記錄、用戶偏好資料模型
- 完成服務依賴注入配置
- 建立完整的測試案例規格書
- 生成詳細的測試執行報告
- 建立語音功能技術規格文檔

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-19 13:33:31 +08:00
鄭沛軒 d5395f5741 feat: 實現完整語音功能系統與學習模式整合 
- 新增 TTS 語音播放和語音辨識功能
- 實現 Azure Speech Services 整合架構
- 建立完整的音頻快取和評估系統
- 整合語音功能到五種學習模式
- 新增語音錄製和發音評分組件
- 優化學習進度和評分機制
- 完成語音功能規格書和測試案例文檔

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-19 13:33:17 +08:00
鄭沛軒 f90286ad88 ux: 優化用戶友善文案，將「高價值詞彙」改為「重點學習詞彙」 
文案優化：
- 程度指示器：「💎 高價值範圍」→「📈 重點學習範圍」
- 設定頁面：「高價值詞彙範圍」→「重點學習範圍」
- AI Prompt：「標記為高價值」→「標記為重點學習」
- 詞彙標記：「高價值詞彙」→「重點學習詞彙」

視覺優化：
- 圖標升級：⭐ (價值感) → 🎯 (目標感)
- 強化學習導向的表達方式

技術修復：
- 新增DbContext個人化欄位映射，解決資料庫欄位問題
- 確保C#模型與SQLite表結構正確對應

用戶體驗提升：
- 從商業化的「價值」概念轉為教育性的「學習」概念
- 更直觀的個人化學習目標表達
- 減少用戶理解負擔，提升整體友善度

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-19 00:26:10 +08:00
鄭沛軒 dcacba2523 docs: 更新個人化詞彙計劃文檔 
- 修正高價值範圍對照表，確保所有等級都有適當的挑戰範圍
- C1/C2 用戶調整為包含 C1-C2 範圍而非僅 C2
- 保持學習挑戰性的同時避免過於限制

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-18 22:38:11 +08:00
鄭沛軒 0bf0541c87 feat: 實現個人化高價值詞彙判定系統 
主要功能：
- 實現基於用戶英語程度的個人化詞彙標記
- A1用戶標記A2-B1為高價值，C1用戶只標記C2為高價值
- 完整的前後端個人化學習體驗

後端架構：
- 擴充User實體新增英語程度相關欄位
- 建立CEFRLevelService等級比較服務
- 更新GeminiService支援個人化AI Prompt
- API支援userLevel參數，回應包含個人化資訊

前端體驗：
- 新增完整的程度設定頁面(/settings)
- 導航選單整合設定連結
- generate頁面顯示個人化程度指示器
- 自動傳遞用戶程度到API進行個人化分析

技術實現：
- 動態AI Prompt根據用戶程度調整判定標準
- localStorage保存用戶程度設定
- 向下相容設計，未設定時預設A2程度
- 完整的錯誤處理和回退機制

用戶價值：
- 從固定B1以上改為個人化程度+1~2級
- 真正適合用戶挑戰程度的詞彙標記
- 提升學習效率，避免過難或過簡單的干擾

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-18 22:37:38 +08:00
鄭沛軒 1b937f85c0 refactor: 大幅清理 AIController 冗餘代碼並優化架構 
主要優化：
- 移除 AnalyzeLowValueWord 重複方法 (70+ 行)
- 移除 IsHighValueWord 複雜判定邏輯
- 移除 GetHighValueWordAnalysis 假資料方法
- 完全重寫 QueryWord 方法，從 55 行簡化到 25 行

架構改善：
- 統一使用 GeminiService.AnalyzeWordAsync 進行詞彙分析
- 移除高/低價值詞彙的複雜分支邏輯
- Controller 職責單純化，只負責 HTTP 請求處理
- 遵循 DRY 原則，避免重複代碼

代碼品質提升：
- 總行數減少約 200 行 (-14%)
- 移除 3 個重複方法
- 簡化錯誤處理邏輯
- 提升代碼可讀性和維護性

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

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