Обновления и миграции

Обновления и миграции требуют отдельного планирования и контроля. Изменения стека, зависимостей или API должны быть предсказуемыми, безопасными и допускать откат. Один PR — одна цель: чем меньше PR, тем проще откат.

Цели

• Минимизация рисков при обновлении зависимостей.
• Обеспечение возможности быстрого отката при возникновении проблем.
• Прозрачность процесса миграции для всей команды.
• Изоляция изменений для упрощения Code Review и тестирования.

---

Общие принципы

MUST

1. Изоляция изменений — обновления выполняются в отдельных ветках, PR не содержит сторонних правок.
2. План миграции — для крупных обновлений обязателен документ с шагами и стратегией отката.
3. Согласование — Major-обновления требуют одобрения Tech Lead и PM.
4. CI/CD — все проверки должны проходить успешно перед слиянием.

SHOULD

• Постепенная миграция через период совместимости (@deprecated).
• Использование официальных codemods и автоматизированных скриптов.

---

Разделы документации

• Требования к миграциям — Правила для Minor/Major обновлений, изоляция изменений и процесс депрекации.
• Контроль и автоматизация — Правила Code Review, инструменты автоматизации и чеклист разработчика.