Upgrade

Миграции БД идемпотентны и запускаются автоматически при старте API.

Zero-downtime upgrade

  1. Запустите новую версию параллельно (например через blue/green за nginx)
  2. Health-check: GET /healthzok после миграций
  3. Переключите трафик на новую версию
  4. Старая остаётся для отката 24-48 часов

Откат

Миграции — only forward (не пишем downgrade). Откат бэкенда возможен только если новая миграция не сломала старый код (мы избегаем drop column / type change в одной версии). Для major-версий — backup перед апгрейдом.