# 專案設置文檔目錄

## 📚 當前有效文檔

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

### ✅ **專案結構**
- **[folder-structure.md](./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`

---

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