jettcheng1018
/
dramaling-vocab-learning
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
dramaling-vocab-learning/docs/03_development/api
History
鄭沛軒 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
..
README.md feat: DramaLing 完整版本 - 韓劇單字學習應用 2025-09-16 23:06:47 +08:00
backend-development-plan.md feat: DramaLing 完整版本 - 韓劇單字學習應用 2025-09-16 23:06:47 +08:00

README.md

DramaLing API 文檔目錄

📚 當前有效文檔

🎯 主要開發文檔

  • backend-development-plan.md - 完整後端開發計劃

    • 包含資料庫設計、API 規格、AI 整合、安全措施等
    • 基於實際前端實作需求制定
    • 這是後端開發的主要參考文檔

  • phase1-implementation-guide.md - Phase 1 實作指南

    • 詳細的實作步驟和代碼範例
    • 包含資料庫 Schema、API 實作、錯誤處理
    • 立即可用的實作指南

🗂️ 文檔使用指南

開始後端開發

  1. 先閱讀 backend-development-plan.md 了解整體架構
  2. 按照 phase1-implementation-guide.md 開始實作
  3. 實作順序：資料庫 → 認證 → 詞卡 CRUD → AI 生成 → 錯誤處理

文檔狀態

  • ✅ 最新 - 基於完整前端實作和需求規格書制定
  • 🎯 實用 - 包含可直接使用的代碼範例
  • 🔄 持續更新 - 隨開發進度更新

📦 已歸檔文檔

舊版文檔已移至 archive/ 目錄：

  • archive/api-endpoints.md - 舊版 API 端點文檔
  • archive/supabase-schema.md - 舊版資料庫架構
  • archive/gemini-integration.md - 舊版 AI 整合文檔
  • archive/api-specification.md - 舊版 API 規格
  • archive/api-endpoints-detailed.md - 舊版詳細端點文檔

這些文檔已被新版本取代，保留僅供參考。

🚀 快速開始

如果您準備開始後端開發：

  1. 環境準備

    # 設定 Supabase 專案
# 取得 Gemini API Key
# 配置環境變數

  2. 執行 Schema

    • 複製 phase1-implementation-guide.md 中的 SQL 到 Supabase

  3. 實作 API

    • 按照指南逐步實作各個 API 端點

  4. 測試

    • 使用已有的前端頁面測試 API 功能

📞 需要幫助？

  • 查看具體實作問題：參考 phase1-implementation-guide.md
  • 了解整體架構：參考 backend-development-plan.md
  • 前端對應功能：查看 /app 目錄下的頁面實作