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

17 Commits

Author SHA1 Message Date
鄭沛軒 434d320377 refactor: 重構智能複習系統文檔架構並明確逾期時間基準 
## 文檔架構重構
- 將原始875行複雜規格書拆分為4個角色專用文檔
- 創建清晰的文檔索引，提升可讀性和維護性

### 📚 新增文檔結構
- **產品需求規格書** - 業務目標、用戶故事、KPI (~2頁)
- **技術規格書** - 系統架構、API設計、資料庫 (~3頁)
- **演算法規格書** - 數學模型、參數調優 (~3頁)
- **測試規格書** - 測試案例、負向測試 (~3頁)
- **文檔索引** - 導航和快速開始指南

## 明確逾期時間基準
- 解決關鍵歧義：下次復習時間以**復習行為當日**為基準
- 更新算法公式：下次復習日期 = 復習行為當日 + 新間隔
- 新增時間基準專項測試案例 (TC-004)
- 避免累積逾期問題，提升用戶體驗

## 文檔清理
- 移除過時的複習算法相關文檔
- 重新整理 note/智能複習/ 目錄結構
- 調整 check-architecture.sh 位置

## 技術改進
- 明確 actualReviewDate 概念和計算邏輯
- API 響應增加 isOverdue 和 overdueDays 欄位
- 完善邊界條件和測試覆蓋

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-25 15:37:33 +08:00
鄭沛軒 649246e540 feat: 完善智能複習系統需求規格書 v1.5 並新增驗證報告 
## 主要改進

### 📋 規格書升級 (v1.0 → v1.5)
- 新增 F-008 逾期復習處理機制，解決用戶延遲復習的重要場景
- 完善邊界條件處理和輸入驗證邏輯
- 新增監控指標與效果評估 (F-006)
- 新增配置參數管理系統 (F-007)
- 明確信心等級映射邏輯 (1-5 → 0.5-1.4)
- 移除反應時間相關參數，簡化 API 設計

### 🔍 新增驗證報告
- 完整的邏輯一致性評估 (評分 4/5)
- 演算法正確性數學驗證
- 34項負向測試案例分析
- 明確的驗證標準和改進建議

### 🧹 文檔清理
- 移除過時的範例文檔和設計文件
- 更新需求文檔和規劃筆記

## 技術亮點
- 逾期懲罰係數算法：1-3天(0.9) → 4-7天(0.75) → 8-30天(0.5) → >30天(0.3)
- 記憶衰減模型：每天5%衰減率，最多30天
- 完整的錯誤處理機制和 API 規範
- 階段式部署策略和監控告警

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-25 15:12:10 +08:00
鄭沛軒 ee150273d1 docs: 新增智能複習系統完整設計文檔集 
📋 新增文檔:
- 智能複習系統需求規格書.md - 業務導向的正式需求文檔
- 智能複習系統可行性分析報告.md - 技術可行性與風險評估
- 複習算法優化建議.md - 現有問題分析與改進建議
- 複習算法完整設計方案.md - 詳細技術設計與流程圖
- 複習算法簡化說明.md - 實作指南與代碼範例

🎯 文檔價值:
- 將技術分析轉化為業務需求規格
- 提供完整的實作指導和範例代碼
- 包含可行性評估和風險緩解策略
- 支援從MVP到完整版本的漸進開發

📊 核心改進:
- 替換過快的2^n算法為漸進式增長
- 引入階段性增長係數和表現回饋機制
- 重新設計熟悉度計算邏輯
- 確保與現有資料庫結構完全相容

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-25 13:41:05 +08:00
鄭沛軒 475b706d84 docs: 新增例句圖片生成AI提示詞設計文檔 
- 記錄AI提示詞設計思路和實作細節
- 包含Gemini和Replicate的提示詞優化策略
- 為後續提示詞調優提供參考依據

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-25 09:32:15 +08:00
鄭沛軒 4243528376 docs: 更新例句圖生成項目完整文檔 
🎯 同步最新開發進度到所有相關文檔

**新增完整文檔**:
- ✅ EXAMPLE_IMAGE_FRONTEND_BACKEND_INTEGRATION_PLAN.md：前後端整合計劃
- ✅ EXAMPLE_IMAGE_GENERATION_DEVELOPMENT_PROGRESS_REPORT.md：詳細進度報告
- ✅ 記錄實際vs預估的巨大差異 (20-40倍效率提升)

**更新現有文檔**:
- ✅ 後端開發計劃：更新實際完成狀態和里程碑
- ✅ PRD文檔：添加實現進度報告章節
- ✅ 技術文檔：反映最新架構調整和修復

**文檔重組**:
- ✅ 移動完成項目到note/done/目錄
- ✅ 保持根目錄整潔，只留活躍開發文檔

**進度同步**:
- ✅ 記錄圖片壓縮功能實現
- ✅ 記錄前後端資料整合成功
- ✅ 記錄系統穩定性修復過程
- ✅ 更新技術債務和下階段計劃

**實際成果文檔化**:
- 後端API 95%完成
- 前端整合準備就緒
- 圖片生成流程完全可用
- 系統架構穩定可靠

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-25 00:24:37 +08:00
鄭沛軒 fa0e74381b refactor: 重新組織專案文檔結構 
- 將完成的規劃文檔移動到 note/done/ 目錄
- 保持根目錄整潔，只保留當前活躍的開發文檔
- 包含以下文檔的重新組織：
  - 進階搜尋規劃、架構治理、後端API策略
  - 詞卡修復、前端架構、優化計劃等

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-24 18:31:24 +08:00
鄭沛軒 e1c666bec0 docs: 重組文檔結構並整理架構文件 
文檔重組:
- 📁 將 note/ 目錄內容遷移到 docs/02_design/
- 🏗️ AI 句子分析規格文件整理到專門目錄
- 📋 產品需求規格文檔結構化
- 🔧 技術實施計劃文檔歸檔

架構文檔整理:
- 🏛️ 架構治理指南和檢查清單
- 📊 Services 層優化總結
- 🛡️ 架構防護系統文檔
- 🔍 自動化檢查工具

文件組織改善:
- 更清晰的文檔分類
- 便於維護的目錄結構
- 完整的架構文檔體系
- 開發者友好的指南

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-23 20:27:05 +08:00
鄭沛軒 a2ac3d35fd feat: 實現常用詞彙星星標記功能 
- 在WordAnalysis介面新增frequency屬性支援
- 在ClickableTextV2組件實現詞彙星星顯示邏輯
- 在generate頁面為慣用語加入星星標記
- 當frequency為"high"時顯示⭐emoji於右上角
- 優化星星位置避免遮擋文字內容
- 實現完整的容錯處理機制
- 更新實施計劃文件和產品需求規格

🎯 功能驗證: API回傳high頻率詞彙正確顯示星星
🎨 視覺優化: 星星位於框外右上角不影響可讀性
🛡️ 容錯處理: 資料缺失時安全降級不影響其他功能

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-23 04:05:39 +08:00
鄭沛軒 add6e2a3dc docs: 更新產品需求規格並添加待辦清單 
📝 文檔更新:
• 在AI句子分析功能產品需求規格.md中添加待辦清單
• 記錄需要進一步實現的功能需求

📋 待辦項目:
• 顯示常用詞彙功能
• 確保所有詞彙都進行分析
• 點擊圖+生成例句圖功能
• 點播放生成語音功能
• 儲存詞彙的後端API整合

🎯 改善效果:
• 明確下一步開發方向
• 追蹤功能完整性
• 提升產品規劃清晰度

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-23 02:51:04 +08:00
鄭沛軒 ad919ec5b7 docs: 整理AI句子分析功能規格文檔到note目錄 
📁 文檔重組:
• 將AI句子分析相關規格文檔移至note/AI句子分析規格目錄
• 統一文檔管理和版本控制
• 提升文檔可讀性和查找效率

📋 包含文檔:
• AI分析API技術實現規格.md - 技術實現細節
• AI句子分析功能產品需求規格.md - 產品需求與用戶故事
• DramaLing AI句子分析功能前後端串接實施計劃.md - 實施計劃與進度
• 文件結構說明.md - 文檔結構說明
• 系統整合與部署規格.md - 部署和整合指南

🎯 改善效果:
• 文檔結構清晰化
• 便於開發團隊查閱
• 支援未來功能擴展

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-23 02:44:21 +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
鄭沛軒 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
鄭沛軒 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
鄭沛軒 4311c1c3b5 chore: 清理並重新組織項目文檔結構 
- 移除根目錄下的散亂文檔檔案
- 將文檔重新組織到 note/plan/ 和 note/spec/ 目錄
- 改善項目文檔的可維護性和查找性

文檔重新分類：
- note/plan/ - 開發計劃和規劃文檔
- note/spec/ - 技術規格和實現文檔
- 根目錄 - 核心 API 文檔和快取規格

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-18 19:42:19 +08:00
鄭沛軒 255adc62c9 feat: 簡化句子分析功能並實現全詞彙可點擊 
主要變更：
- 移除句子分析中的冗長解釋，只保留翻譯
- 修改 AI Prompt 簡化回應格式
- 實現所有單字都可點擊的互動功能
- 無預存資料的詞彙支援即時 AI 查詢
- 移除付費限制，提供完全免費的詞彙查詢體驗
- 新增詞彙快取機制技術規格文檔

技術改善：
- 優化 ClickableTextV2 組件支援全詞彙點擊
- 新增動態詞彙資料更新機制
- 改善視覺提示，區分有/無預存資料的詞彙
- 整理項目文檔結構，移除過時檔案

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-18 19:41:48 +08:00
鄭沛軒 e940d86f4a feat: 暫時關閉使用次數限制系統 
- 修改前端 isPremium 設定為 true，跳過使用次數檢查
- 修改後端 UsageService 調用參數為 premium 用戶
- 修復後端編譯錯誤，添加 System.Text.Json using
- 更新使用限制實施報告，添加完整修改記錄和復原步驟
- 驗證系統可無限制調用分析功能

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-18 15:10:54 +08:00
鄭沛軒 1fb7cadd52 feat: 新增完整的系統分析文檔和前端快取狀態顯示 
前端改善:
- 新增快取狀態視覺化標籤 (💾 快取結果 / 🤖 AI 分析)
- 完善ClickableTextV2組件的大小寫屬性相容性
- 修復互動式單字查詢功能在快取場景下的顯示問題
- 改善載入狀態提示，增加時間預期說明
- 新增getWordProperty輔助函數，統一處理屬性讀取

系統文檔:
- 新增完整的功能規格文檔 (User Flow + 測試案例)
- 生成快取機制分析報告 (前端+後端)
- 建立使用限制功能實現報告
- 記錄所有檢查方法和問題解決過程

清理:
- 移除過時的環境設定文檔
- 整理專案結構

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-18 14:44:48 +08:00