n8n-pilot: Command for Claude Code

Создай database migration следуя лучшим практикам.

ВАЖНО: Миграции - критическая часть. Тестируй все тщательно!

Процесс:

1. Анализ текущей схемы БД

Прочитай и проанализируй:

# Найди файлы схемы БД
find . -name "schema.*" -o -name "*.prisma" -o -name "*migration*"

# Посмотри последние миграции
ls -la supabase/migrations/ || ls -la prisma/migrations/ || ls -la migrations/

Прочитай:

• Текущую схему БД
• Последние миграции
• Database documentation (если есть в ARCHITECTURE.md)

2. Пойми требования

Спроси себя:

• Какие изменения в схеме нужны?
• Есть ли существующие данные, которые нужно сохранить?
• Нужна ли обратная совместимость?
• Есть ли зависимости от других таблиц?

3. Спланируй миграцию

Типы изменений:

Безопасные (можно делать на проде):

• ✅ ADD column (с DEFAULT или NULL)
• ✅ ADD index (concurrent)
• ✅ ADD new table
• ✅ ADD constraint (NOT VALID, потом VALIDATE)

Опасные (требуют осторожности):

• ⚠️ DROP column (может сломать приложение)
• ⚠️ RENAME column (нужна двухфазная миграция)
• ⚠️ CHANGE column type (может потерять данные)
• ⚠️ ADD NOT NULL (сначала заполни данные)

Очень опасные (только с downtime):

• 🔴 DROP table
• 🔴 CHANGE primary key
• 🔴 Большая структурная переделка

4. Создай migration файл

Naming convention:

YYYYMMDDHHMMSS_descriptive_name.sql

Пример: 20250110120000_add_user_preferences_table.sql

Структура миграции:

-- Migration: Add user preferences table
-- Created: 2025-01-10
-- Author: Claude Code
-- Description: Add table to store user preferences with foreign key to users

-- ============================================
-- Up Migration
-- ============================================

BEGIN;

-- Create table
CREATE TABLE IF NOT EXISTS user_preferences (
  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
  user_id UUID NOT NULL REFERENCES users(id) ON DELETE CASCADE,
  theme VARCHAR(20) DEFAULT 'light' CHECK (theme IN ('light', 'dark', 'auto')),
  language VARCHAR(10) DEFAULT 'en',
  notifications_enabled BOOLEAN DEFAULT true,
  created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
  updated_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),

  -- Constraints
  CONSTRAINT unique_user_preferences UNIQUE(user_id)
);

-- Create indexes
CREATE INDEX idx_user_preferences_user_id ON user_preferences(user_id);

-- Add comments
COMMENT ON TABLE user_preferences IS 'Stores user-specific preferences';
COMMENT ON COLUMN user_preferences.theme IS 'UI theme preference';

-- Enable Row Level Security
ALTER TABLE user_preferences ENABLE ROW LEVEL SECURITY;

-- Create RLS policies
CREATE POLICY "Users can view own preferences"
  ON user_preferences
  FOR SELECT
  USING (auth.uid() = user_id);

CREATE POLICY "Users can update own preferences"
  ON user_preferences
  FOR UPDATE
  USING (auth.uid() = user_id);

CREATE POLICY "Users can insert own preferences"
  ON user_preferences
  FOR INSERT
  WITH CHECK (auth.uid() = user_id);

COMMIT;

-- ============================================
-- Down Migration (Rollback)
-- ============================================

-- Uncomment to enable rollback:
-- BEGIN;
-- DROP TABLE IF EXISTS user_preferences CASCADE;
-- COMMIT;