チーム開発でDB環境がバラバラ？マイグレーションとシーダーで解決する環境統一手法

# プロジェクト作成と初期設定
npm init -y
npm install prisma @prisma/client
npm install -D typescript tsx @types/node

# Prisma初期化
npx prisma init

// prisma/schema.prisma
generator client {
  provider = "prisma-client-js"
}

datasource db {
  provider = "postgresql"
  url      = env("DATABASE_URL")
}

model User {
  id        Int      @id @default(autoincrement())
  email     String   @unique
  name      String
  role      UserRole @default(USER)
  createdAt DateTime @default(now())
  updatedAt DateTime @updatedAt

  // リレーション
  posts Post[]

  @@map("users")
}

model Post {
  id        Int      @id @default(autoincrement())
  title     String
  content   String?
  published Boolean  @default(false)
  authorId  Int
  createdAt DateTime @default(now())
  updatedAt DateTime @updatedAt

  // リレーション
  author User @relation(fields: [authorId], references: [id], onDelete: Cascade)

  @@map("posts")
}

enum UserRole {
  USER
  ADMIN
  MODERATOR
}

# 環境変数設定（.env）
echo "DATABASE_URL=\"postgresql://username:password@localhost:5432/myapp_dev\"" > .env

# マイグレーション作成・実行
npx prisma migrate dev --name init

# 本番環境用（既存DBがある場合）
npx prisma migrate deploy

// prisma/seed.ts
import { PrismaClient, UserRole } from '@prisma/client'

const prisma = new PrismaClient()

async function main() {
  // 既存データのクリーンアップ（開発環境のみ）
  if (process.env.NODE_ENV === 'development') {
    await prisma.post.deleteMany()
    await prisma.user.deleteMany()
  }

  // 管理者ユーザーの作成
  const adminUser = await prisma.user.create({
    data: {
      email: 'admin@example.com',
      name: '管理者',
      role: UserRole.ADMIN,
    },
  })

  // テストユーザーの作成
  const testUsers = await prisma.user.createMany({
    data: [
      {
        email: 'user1@example.com',
        name: 'テストユーザー1',
        role: UserRole.USER,
      },
      {
        email: 'user2@example.com',
        name: 'テストユーザー2',
        role: UserRole.MODERATOR,
      },
    ],
  })

  // サンプル記事の作成
  const posts = await prisma.post.createMany({
    data: [
      {
        title: 'Prismaマイグレーション入門',
        content: 'マイグレーションの基本的な使い方について...',
        published: true,
        authorId: adminUser.id,
      },
      {
        title: 'シーダーデータの管理方法',
        content: 'シーダーを使った効率的なデータ管理...',
        published: false,
        authorId: adminUser.id,
      },
    ],
  })

  console.log('シード完了:', { adminUser, testUsers, posts })
}

main()
  .catch((e) => {
    console.error(e)
    process.exit(1)
  })
  .finally(async () => {
    await prisma.$disconnect()
  })

{
  "name": "migration-seeder-example",
  "scripts": {
    "dev": "tsx src/index.ts",
    "db:migrate": "prisma migrate dev",
    "db:seed": "tsx prisma/seed.ts",
    "db:reset": "prisma migrate reset --force",
    "db:setup": "npm run db:migrate && npm run db:seed"
  },
  "prisma": {
    "seed": "tsx prisma/seed.ts"
  }
}

# Prismaの自動生成（推奨）
20241019120000_create_users_table
20241019130000_add_email_index_to_users  
20241019140000_create_posts_table

# 手動命名の場合
YYYYMMDD_HHMMSS_action_target_table
例：20241019_120000_create_users_table

// prisma/seeds/index.ts - 環境別シード実行
async function runSeed() {
  const env = process.env.NODE_ENV || 'development'
  
  switch (env) {
    case 'production':
      // 本番環境：最小限のマスターデータのみ
      await seedMasterData()
      break
      
    case 'staging':
      // ステージング：マスターデータ + 少量のテストデータ
      await seedMasterData()
      await seedMinimalTestData()
      break
      
    case 'development':
      // 開発環境：全てのデータ
      await seedMasterData()
      await seedTestData()
      await seedDummyData()
      break
      
    case 'test':
      // テスト環境：テスト専用データ
      await seedTestFixtures()
      break
  }
}

# 開発環境でのロールバック
npx prisma migrate reset

# 本番環境での段階的ロールバック（要注意）
# 1. データバックアップ
pg_dump myapp_prod > backup_$(date +%Y%m%d_%H%M%S).sql

# 2. 特定のマイグレーションまで戻す
npx prisma migrate resolve --rolled-back "20241019130000_add_email_index"

# 3. 新しいマイグレーション作成
npx prisma migrate dev --create-only --name rollback_email_index

# 1. 現在のマイグレーション状態確認
npx prisma migrate status

# 2. 問題のあるマイグレーションをリセット
npx prisma migrate resolve --rolled-back "問題のマイグレーションID"

# 3. 正しい順序で再実行
npx prisma migrate deploy

# 4. チーム内での調整
# - Git でマイグレーションファイルの順序を確認
# - 必要に応じてマイグレーションを再作成

// エラー対処例：重複データ投入エラー
async function safeSeedUsers() {
  try {
    // upsert を使用して重複を回避
    const admin = await prisma.user.upsert({
      where: { email: 'admin@example.com' },
      update: {}, // 既存の場合は何もしない
      create: {
        email: 'admin@example.com',
        name: '管理者',
        role: UserRole.ADMIN,
      },
    })
    
    console.log('Admin user created/found:', admin.id)
  } catch (error) {
    console.error('シードエラー:', error)
    // エラー詳細をログに記録
    if (error.code === 'P2002') {
      console.log('ユニーク制約違反 - データは既に存在します')
    }
  }
}