資料庫改為 mySQL

DATA-MIGRATION-GUIDE.md

@@ -0,0 +1,269 @@
+# 數據遷移指南 - 從 Supabase 到 MySQL
+
+## 📋 概述
+
+本指南將幫助您將現有的 Supabase 數據遷移到 MySQL 資料庫，並設置相應的統計功能。
+
+## 🔧 前置準備
+
+### 1. 獲取 Supabase 連接資訊
+
+1. 登入 [Supabase Dashboard](https://app.supabase.com)
+2. 選擇您的專案
+3. 前往 **Settings** → **API**
+4. 複製以下資訊：
+   - **Project URL** (NEXT_PUBLIC_SUPABASE_URL)
+   - **anon public** key (NEXT_PUBLIC_SUPABASE_ANON_KEY)
+
+### 2. 確認 MySQL 資料庫已設置
+
+確保您已經執行過：
+```bash
+node scripts/create-basic-tables.js
+node scripts/create-views-procedures.js
+```
+
+## 🚀 執行數據遷移
+
+### 方法一：使用環境變數（推薦）
+
+#### Windows:
+```cmd
+set NEXT_PUBLIC_SUPABASE_URL=https://your-project-id.supabase.co
+set NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key-here
+node scripts/migrate-with-env.js
+```
+
+#### Linux/Mac:
+```bash
+export NEXT_PUBLIC_SUPABASE_URL=https://your-project-id.supabase.co
+export NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key-here
+node scripts/migrate-with-env.js
+```
+
+### 方法二：直接在命令中設定
+
+```bash
+NEXT_PUBLIC_SUPABASE_URL=https://your-project-id.supabase.co NEXT_PUBLIC_SUPABASE_ANON_KEY=your-key node scripts/migrate-with-env.js
+```
+
+## 📊 遷移內容
+
+遷移腳本會處理以下數據：
+
+1. **困擾案例 (wishes)**
+   - 標題、描述、解決方案
+   - 公開/私密狀態
+   - 分類和優先級
+   - 圖片數據
+   - 創建和更新時間
+
+2. **點讚記錄 (wish_likes)**
+   - 用戶會話 ID
+   - IP 地址和用戶代理
+   - 創建時間
+
+3. **用戶設定 (user_settings)**
+   - 音樂偏好
+   - 主題設定
+   - 語言偏好
+   - 通知設定
+
+4. **系統統計 (system_stats)**
+   - 日統計數據
+   - 困擾案例數量
+   - 點讚數量
+   - 活躍用戶數
+
+## 🔄 統計功能替代方案
+
+由於 MySQL 觸發器需要 SUPER 權限，我們提供了應用程式層面的統計服務：
+
+### 自動統計更新
+
+- **困擾案例創建/更新/刪除**：自動更新統計數據
+- **點讚/取消點讚**：自動更新點讚統計
+- **用戶設定更新**：更新活躍用戶統計
+
+### 手動重新計算統計
+
+如果需要重新計算所有統計數據：
+
+```typescript
+import { StatisticsService } from '@/lib/statistics-service'
+
+// 重新計算所有統計
+const stats = await StatisticsService.recalculateAllStats()
+console.log('統計數據:', stats)
+```
+
+## 🧪 測試遷移結果
+
+### 1. 檢查數據完整性
+
+```bash
+node scripts/test-mysql-connection.js
+```
+
+### 2. 驗證統計數據
+
+```typescript
+import { StatisticsService } from '@/lib/statistics-service'
+
+// 獲取當前統計
+const stats = await StatisticsService.getStatistics()
+console.log('當前統計:', stats)
+```
+
+### 3. 檢查應用程式功能
+
+1. 啟動開發服務器：`npm run dev`
+2. 測試困擾案例創建
+3. 測試點讚功能
+4. 檢查分析頁面
+
+## 🔧 故障排除
+
+### 常見問題
+
+#### 1. 環境變數未設定
+```
+❌ 請設定 Supabase 環境變數
+```
+**解決方案**：按照上述方法設定環境變數
+
+#### 2. 連接失敗
+```
+❌ 資料庫連接失敗
+```
+**解決方案**：
+- 檢查 Supabase URL 和 Key 是否正確
+- 確認 MySQL 資料庫連接正常
+- 檢查網路連接
+
+#### 3. 數據重複
+```
+⚠️ 遷移完成，但有 X 個項目失敗
+```
+**解決方案**：
+- 檢查錯誤詳情
+- 清理重複數據
+- 重新執行遷移
+
+#### 4. 統計數據不準確
+**解決方案**：
+```typescript
+// 重新計算統計數據
+await StatisticsService.recalculateAllStats()
+```
+
+### 調試工具
+
+#### 檢查 Supabase 數據
+```typescript
+import { createClient } from '@supabase/supabase-js'
+
+const supabase = createClient(url, key)
+
+// 檢查困擾案例數量
+const { count } = await supabase
+  .from('wishes')
+  .select('*', { count: 'exact', head: true })
+
+console.log('Supabase 困擾案例數量:', count)
+```
+
+#### 檢查 MySQL 數據
+```typescript
+import { PrismaClient } from '@prisma/client'
+
+const prisma = new PrismaClient()
+
+// 檢查困擾案例數量
+const count = await prisma.wish.count()
+console.log('MySQL 困擾案例數量:', count)
+```
+
+## 📈 性能優化
+
+### 1. 批量遷移
+
+對於大量數據，可以修改遷移腳本使用批量插入：
+
+```typescript
+// 批量插入困擾案例
+await prisma.wish.createMany({
+  data: wishes.map(wish => ({
+    title: wish.title,
+    currentPain: wish.current_pain,
+    // ... 其他字段
+  }))
+})
+```
+
+### 2. 並行處理
+
+```typescript
+// 並行遷移不同類型的數據
+await Promise.all([
+  migrateWishes(),
+  migrateLikes(),
+  migrateUserSettings(),
+  migrateSystemStats()
+])
+```
+
+### 3. 進度追蹤
+
+```typescript
+// 添加進度條
+const total = wishes.length
+let processed = 0
+
+for (const wish of wishes) {
+  // 遷移邏輯
+  processed++
+  console.log(`進度: ${processed}/${total} (${Math.round(processed/total*100)}%)`)
+}
+```
+
+## 🔒 安全注意事項
+
+1. **環境變數安全**
+   - 不要在代碼中硬編碼 Supabase 密鑰
+   - 使用 `.env.local` 文件（已被 .gitignore 忽略）
+   - 生產環境使用安全的環境變數管理
+
+2. **數據備份**
+   - 遷移前備份 Supabase 數據
+   - 遷移後驗證數據完整性
+   - 保留原始數據直到確認遷移成功
+
+3. **權限控制**
+   - 確保 MySQL 用戶只有必要的權限
+   - 定期檢查和更新密碼
+
+## ✅ 完成檢查清單
+
+- [ ] Supabase 連接資訊已獲取
+- [ ] MySQL 資料庫結構已創建
+- [ ] 環境變數已設定
+- [ ] 數據遷移已執行
+- [ ] 遷移結果已驗證
+- [ ] 統計功能已測試
+- [ ] 應用程式功能已確認
+- [ ] 數據備份已完成
+
+## 📞 支援
+
+如果遇到問題：
+
+1. 檢查錯誤日誌
+2. 確認環境變數設定
+3. 驗證資料庫連接
+4. 查看遷移報告
+5. 重新計算統計數據
+
+---
+
+**注意**：遷移過程中請確保有穩定的網路連接，並在非高峰時段執行以避免影響正常使用。