dramaling-vocab-learning/docs/03_development/setup/README.md

專案設置文檔目錄

📚 當前有效文檔

✅ 環境設置

• env-setup.md - 環境變數設置指南 (.NET Core 版)
  • Supabase 連接配置 (前端 + 後端)
  • Google Gemini AI 設置
  • 常見問題解決方案
  • 狀態: ✅ 最新 (2025-09-16 更新)

✅ 專案結構

• folder-structure.md - 專案資料夾結構指南
  • 前後端分離架構說明
  • 檔案命名規範
  • 前端實作技術細節
  • 狀態: ✅ 最新 (已更新為當前架構)

📦 已歸檔文檔

🗂️ archive/ 目錄

• archive/initial-setup.md - 舊版初始設置 (Next.js 全棧版)
• archive/error-handling.md - 舊版錯誤處理 (TypeScript 版)

歸檔原因: 這些文檔基於 Next.js API Routes 架構，現已改為 .NET Core，內容不再適用。

🎯 設置流程

新開發者上手指南

1. 環境準備: 閱讀 env-setup.md
2. 專案結構: 了解 folder-structure.md
3. 開發計劃: 查看 /docs/03_development/dotnet-completion-plan.md

快速設置檢查清單

• 安裝 .NET 8 SDK
• 建立 Supabase 專案並獲取金鑰
• 獲取 Google Gemini API 金鑰
• 配置前端環境變數 (frontend/.env.local)
• 配置後端設定 (backend/DramaLing.Api/appsettings.Development.json)
• 測試前端啟動 (./start-frontend.sh)
• 測試後端啟動 (./start-dotnet-api.sh)

📞 需要幫助？

• 環境設置問題: 查看 env-setup.md
• 專案結構疑問: 查看 folder-structure.md
• 開發規劃: 查看 /docs/03_development/dotnet-completion-plan.md
• 整體架構: 查看 /docs/03_development/api/backend-development-plan.md

---

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