# 資料庫遷移說明

## 問題描述
競賽管理系統在創建競賽時出現以下錯誤：
1. `competition_award_types` 表缺少 `order_index` 欄位
2. `competition_teams` 表缺少 `registered_at` 欄位
3. 外鍵約束失敗，存在孤立的關聯記錄

## 解決方案

### 方法一：使用智能檢查腳本（推薦）
```bash
mysql -u your_username -p your_database_name < add-missing-columns.sql
```

### 方法二：使用簡化腳本
```bash
mysql -u your_username -p your_database_name < add-missing-columns-simple.sql
```

## 腳本內容

### 1. 添加缺失欄位
- 為 `competition_award_types` 表添加 `order_index` 欄位
- 為 `competition_teams` 表添加 `registered_at` 欄位

### 2. 清理孤立記錄
- 刪除所有關聯表中不存在的 `competition_id` 記錄

### 3. 添加必要索引
- 為所有關聯表添加適當的索引以提升查詢性能

## 執行前注意事項

1. **備份資料庫**：
   ```bash
   mysqldump -u your_username -p your_database_name > backup_before_migration.sql
   ```

2. **確認資料庫名稱**：
   - 將 `your_database_name` 替換為實際的資料庫名稱
   - 將 `your_username` 替換為實際的用戶名

3. **檢查權限**：
   - 確保用戶有 ALTER TABLE 和 DELETE 權限

## 執行後驗證

執行完成後，可以運行以下查詢來驗證：

```sql
-- 檢查欄位是否添加成功
DESCRIBE competition_award_types;
DESCRIBE competition_teams;

-- 檢查索引是否創建成功
SHOW INDEX FROM competition_award_types;
SHOW INDEX FROM competition_teams;

-- 檢查孤立記錄是否已清理
SELECT COUNT(*) as orphaned_judges FROM competition_judges 
WHERE competition_id NOT IN (SELECT id FROM competitions);
```

## 如果遇到錯誤

如果執行過程中遇到 "column already exists" 或 "index already exists" 錯誤，這是正常的，表示該欄位或索引已經存在，可以忽略這些錯誤。

## 聯繫支援

如果遇到其他問題，請檢查：
1. MySQL 版本是否支援所使用的語法
2. 用戶權限是否足夠
3. 資料庫連接是否正常