dramaling-vocab-learning/docs/03_development
鄭沛軒 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
..
api docs: 重新組織架構文檔體系並建立完整的詞卡管理 API 規格 2025-09-24 03:56:26 +08:00
setup feat: DramaLing 完整版本 - 韓劇單字學習應用 2025-09-16 23:06:47 +08:00
DramaLing AI句子分析功能前後端串接實施計劃.md docs: 重新組織架構文檔體系並建立完整的詞卡管理 API 規格 2025-09-24 03:56:26 +08:00
README.md feat: DramaLing 完整版本 - 韓劇單字學習應用 2025-09-16 23:06:47 +08:00
backend-api-development-plan.md feat: 完成詞卡管理功能前後端完整整合 2025-09-24 04:21:06 +08:00
claude-code-development-sop.md feat: DramaLing 完整版本 - 韓劇單字學習應用 2025-09-16 23:06:47 +08:00
dotnet-completion-plan.md feat: DramaLing 完整版本 - 韓劇單字學習應用 2025-09-16 23:06:47 +08:00
error-logging-guide.md docs: 新增後端錯誤日誌監控指南 2025-09-17 00:49:57 +08:00
git-workflow.md feat: DramaLing 完整版本 - 韓劇單字學習應用 2025-09-16 23:06:47 +08:00
next-phase-development-plan.md docs: 新增下一階段開發計劃 2025-09-17 01:47:32 +08:00
simple-dev-workflow.md feat: DramaLing 完整版本 - 韓劇單字學習應用 2025-09-16 23:06:47 +08:00

README.md

DramaLing 開發文檔總覽

📚 文檔結構

🎯 當前有效文檔

API 開發文檔

專案設定文檔

開發流程文檔

🎯 開發指南

後端開發

  1. 主要參考: api/backend-development-plan.md
  2. 實作指南: api/phase1-implementation-guide.md
  3. 當前進度: Phase 1 開發中

前端開發

  • 前端已實作完成,代碼位於 /app 目錄
  • 使用 Next.js 14 App Router
  • 狀態管理React hooks (useState, useEffect)
  • UI 框架Tailwind CSS + shadcn/ui

專案設定

  • 環境設定: setup/env-setup.md
  • 資料夾結構: setup/folder-structure.md
  • 錯誤處理: setup/error-handling.md

🚀 快速開始

1. 後端開發

# 查看後端開發計劃
cat docs/03_development/api/backend-development-plan.md

# 開始 Phase 1 實作
cat docs/03_development/api/phase1-implementation-guide.md

2. 環境設定

# 查看環境設定指南
cat docs/03_development/setup/env-setup.md

3. 專案結構

# 查看資料夾結構指南
cat docs/03_development/setup/folder-structure.md

📊 文檔更新狀態

  • 最新 - 基於實際前端實作和需求規格書
  • 🔄 持續更新 - 隨開發進度同步更新
  • 📦 已清理 - 移除過時和衝突的文檔

📞 需要幫助?

  • 後端開發問題: 查看 api/ 目錄下的文檔
  • 環境設定問題: 查看 setup/ 目錄下的文檔
  • 開發流程問題: 查看根目錄下的工作流程文檔

注意: 所有歸檔的文檔僅供參考,請以當前有效文檔為準。