Noções Básicas de Git para Trabalho com Banco de Dados

# Trabalho diário de migração
git checkout main && git pull --ff-only
git checkout -b feat/DB-128-add-orders-priority
# editar db/migrations/V20260709_128__orders_priority.sql
git add db/migrations/
git commit -m "feat(db): add orders.priority column [DB-128]"
git push -u origin feat/DB-128-add-orders-priority
# Abrir PR com seções EXPLAIN + rollback preenchidas

db/
├── migrations/
│   ├── V20260701_100__baseline.sql
│   ├── V20260709_128__orders_priority.sql
│   └── R__views.sql              # repetível (Flyway)
├── rollback/
│   └── V20260709_128__orders_priority_down.sql
└── seeds/
    └── dev_fixtures.sql

-- V20260709_128__orders_priority.sql
-- Ticket: DB-128
-- Risco de bloqueio: médio (índice CONCURRENTLY em arquivo separado)
-- Deploy: antes de orders-api v2.7.0
ALTER TABLE orders ADD COLUMN IF NOT EXISTS priority text NOT NULL DEFAULT 'normal';

-- V20260709_129__orders_priority_index.sql
-- executeInTransaction=false (Flyway)
CREATE INDEX CONCURRENTLY IF NOT EXISTS idx_orders_priority ON orders (priority);

## PR de Banco de Dados
- [ ] Migração flyway em staging aplicada
- [ ] Consulta de monitoramento de bloqueio executada durante a migração
- [ ] SQL de rollback vinculado
- [ ] Ordem de deploy da aplicação documentada (migração antes do código)
- [ ] EXPLAIN anexado se for alteração de consulta/índice

# .github/workflows/db-migrate-staging.yml
- run: flyway -url="${{ secrets.STAGING_JDBC }}" migrate
- run: psql "$STAGING_URL" -c "SELECT version, success FROM flyway_schema_history ORDER BY installed_rank DESC LIMIT 3;"

Correto:  merge da migração → migração staging → migração prod → deploy da aplicação
Errado:    deploy da aplicação primeiro → código espera coluna ausente

SELECT installed_rank, version, description, success
FROM flyway_schema_history ORDER BY installed_rank DESC LIMIT 5;