# 心願星河 - 數據清空指南

⚠️ **重要警告**：以下操作將永久刪除所有數據，請謹慎使用！

## 可用的清空腳本

### 1. 綜合清空腳本（推薦）
```bash
node scripts/clear-all.js
```
**功能**：一次性清空所有數據
- 清空 Supabase Storage 中的所有圖片
- 清空資料庫中的所有表格
- 重置自增序列
- 重新插入初始數據
- 驗證清空結果

### 2. 單獨清空 Storage
```bash
node scripts/clear-storage.js
```
**功能**：僅清空圖片存儲
- 清空 `wish-images` 存儲桶
- 清空 `wish-thumbnails` 存儲桶

### 3. 單獨清空資料庫
在 Supabase Dashboard 的 SQL Editor 中執行：
```sql
-- 執行 scripts/clear-all-data.sql 文件的內容
```

## 使用前準備

### 1. 確認環境變數
確保以下環境變數已正確設置（在 `.env.local` 文件中）：
```env
NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_anon_key
SUPABASE_SERVICE_ROLE_KEY=your_service_role_key  # 可選，但建議設置
```

### 2. 安裝依賴
```bash
npm install
# 或
pnpm install
```

## 使用步驟

### 方案 A：一鍵清空（推薦）
```bash
# 執行綜合清空腳本
node scripts/clear-all.js

# 腳本會顯示 10 秒倒計時，按 Ctrl+C 可以取消
```

### 方案 B：分步驟清空
```bash
# 1. 先清空 Storage
node scripts/clear-storage.js

# 2. 再清空資料庫（在 Supabase Dashboard 中執行）
# 將 scripts/clear-all-data.sql 的內容貼到 SQL Editor 中執行
```

## 清空後的檢查

### 1. 驗證 Storage
在 Supabase Dashboard → Storage 中檢查：
- `wish-images` 桶應該是空的
- `wish-thumbnails` 桶應該是空的

### 2. 驗證資料庫
在 Supabase Dashboard → Table Editor 中檢查：
- `wishes` 表應該沒有記錄
- `wish_likes` 表應該沒有記錄
- `user_settings` 表應該沒有記錄
- 其他管理表格會有基礎的初始記錄

### 3. 測試應用程式
```bash
# 重新啟動開發服務器
npm run dev
# 或
pnpm dev
```

在瀏覽器中：
1. 清除 localStorage（開發者工具 → Application → Local Storage → Clear All）
2. 重新載入頁面
3. 測試提交新的困擾案例
4. 確認功能正常運行

## 故障排除

### 1. 權限錯誤
```
Error: Insufficient permissions
```
**解決方案**：確保使用 `SUPABASE_SERVICE_ROLE_KEY` 而不是 `ANON_KEY`

### 2. 存儲桶不存在
```
Error: Bucket does not exist
```
**解決方案**：正常現象，腳本會自動跳過不存在的存儲桶

### 3. 網路錯誤
```
Error: fetch failed
```
**解決方案**：檢查網路連接和 Supabase URL 是否正確

### 4. 資料庫連接錯誤
**解決方案**：
1. 檢查 Supabase 專案是否暫停
2. 驗證 URL 和密鑰是否正確
3. 確認專案是否有足夠的配額

## 注意事項

1. **備份重要數據**：在生產環境中執行前，請先備份重要數據
2. **測試環境優先**：建議先在測試環境中驗證腳本功能
3. **瀏覽器清除**：清空數據後記得清除瀏覽器的 localStorage
4. **應用重啟**：清空後建議重新啟動應用程式

## 聯絡支援

如果遇到問題，請檢查：
1. 控制台錯誤訊息
2. Supabase Dashboard 中的 Logs
3. 網路連接狀態
4. 環境變數配置