52 lines
1.8 KiB
Markdown
52 lines
1.8 KiB
Markdown
# 專案設置文檔目錄
|
||
|
||
## 📚 當前有效文檔
|
||
|
||
### ✅ **環境設置**
|
||
- **[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`
|
||
|
||
---
|
||
|
||
> **注意**: 所有歸檔的文檔僅供參考，請以當前有效文檔為準。 |