--- name: "Database Migrations" description: "Manage database schema migrations using Alembic in Python" --- # Skill: Database Migrations ## 1. Purpose To modify the database schemas cleanly and safely, ensuring tables remain in-sync across dev, staging, and production environments. ## 2. When to Use When changing fields, constraints, relations, or tables in the SQLAlchemy ORM models. ## 3. Preconditions * alembic.ini configured and pointing to database instances. * SQLAlchemy models imported in migration script env.py. ## 4. Step-by-Step Checklist 1. Make edits inside target SQLAlchemy model files. 2. Run `alembic revision --autogenerate -m "description"` to auto-detect changes. 3. Open the generated migration file and verify logic. 4. Apply upgrades locally using `alembic upgrade head`. 5. Verify tables compile in MySQL. ## 5. Validation Checklist * Alembic version matches latest migration hash. * Database compiles successfully with zero data truncation warnings. ## 6. Examples ```bash # Generate migration: alembic revision --autogenerate -m "add_technician_rating" # Apply upgrade: alembic upgrade head ``` ## 7. Failure Cases * Making manual DDL edits in MySQL directly, causing Alembic versions to go out-of-sync. * Running migrations containing non-nullable column additions without default values on existing tables.