malllova

購読前に試し読み

提供者が選んだ代表ファイル「.claude/commands/db-migrate.md」の中身です。購読前の参考としてご確認ください。

# データベースマイグレーションフロー

マイグレーションの作成から適用、型生成までの一連のフローを実行してください。

## 事前確認

1. `supabase/MIGRATION_GUIDE.md` の注意事項を確認
2. `.skills/anti-patterns.md` の「DROP TABLE 禁止」ルールを確認
3. 既存マイグレーションファイルとの競合がないか確認

## 実行手順

### Step 1: マイグレーションファイル作成
```bash
npx supabase migration new <migration_name>
```
- 命名規則: `add_<feature>`, `update_<table>_<change>`, `create_<table>` など
- **絶対に `DROP TABLE` を使わないこと** — `ALTER TABLE` のみ

### Step 2: SQL 記述
生成されたマイグレーションファイルに SQL を記述：
- テーブル変更は `ALTER TABLE` を使用
- RLS ポリシーが必要な場合は同じファイルに含める
- インデックスが必要な場合は追加

### Step 3: ローカル適用
```bash
npx supabase db reset
```
- エラーがあれば SQL を修正

### Step 4: 型生成
```bash
npx supabase gen types typescript --local > types/supabase.ts
```
- 生成された型を確認し、新しいテーブル/カラムが含まれていることを確認

### Step 5: ビルド検証
```bash
npm run build
```
- TypeScript の型エラーがないことを確認
- 型エラーがある場合は、関連コードを更新

### Step 6: テスト
```bash
npm run test:unit
```

## 注意事項
- 本番DBには `npx supabase db push` でリモート適用（要確認）
- RLS ポリシーの適用漏れに注意
- `supabase/migrations/` に新ファイルが追加されたことを `git status` で確認

提供者

D3 Studio@d3-studio